randpaper 0.5.1

A customizable wallpaper daemon for per-monitor cycling, one-shot application, and optional theme synchronization for Waybar and terminals.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

use anyhow::Result;
use async_trait::async_trait;

/// Defines the interface for interacting with different Window Managers or Compositors.
///
/// This trait allows the core logic to remain agnostic of the underlying display protocol
/// (e.g., Wayland vs. X11) or specific compositor implementations (e.g., Hyprland vs. Sway).
#[async_trait]
pub trait Backend {
    /// Returns a list of unique identifiers for monitors that are currently powered on and active.
    ///
    /// These identifiers (e.g., "HDMI-A-1", "eDP-1") are typically used to target
    /// wallpaper updates or coordinate-specific configuration changes.
    ///
    /// # Errors
    ///
    /// Returns an error if the backend fails to communicate with the compositor
    /// or if the monitor list cannot be parsed.
    async fn get_active_monitors(&self) -> Result<Vec<String>>;
}