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
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use crate::cli::{Config, RendererType};
use crate::daemon::render::native::NativeRenderer;
use crate::wallpaper::WallpaperCache;
use tokio::process::Child;

pub mod awww;
pub mod native;
mod swaybg;

/// Manages the lifecycle and execution of wallpaper rendering backends.
///
/// The `Renderer` abstracts over different wallpaper utilities (like `awww` or `swaybg`),
/// handling process management for long-running children and binary detection.
pub struct Renderer {
    /// Holds a reference to the active `swaybg` process, if running.
    /// This allows the renderer to kill the old process before starting a new one.
    swaybg_child: Option<Child>,
    /// The path to the detected `awww` binary.
    awww_bin: Option<String>,
    /// Handles for the per-monitor native renderer threads.
    native: NativeRenderer,
}

impl Renderer {
    /// Creates a new `Renderer` instance based on the user's CLI configuration.
    ///
    /// If the `Awww` renderer is selected, this method will:
    /// 1. Detect the `awww` binary in the system path.
    /// 2. Ensure the `awww` daemon is initialized and running.
    ///
    /// # Errors
    ///
    /// Returns an error if the renderer initialization (e.g., starting the daemon) fails.
    pub async fn new(config: &Config) -> anyhow::Result<Self> {
        let awww_bin = match config.renderer {
            RendererType::Awww => {
                let bin = awww::detect_awww_binary().await;
                awww::ensure_awww_daemon(&bin).await?;
                Some(bin)
            }
            RendererType::Swaybg | RendererType::Native => None,
        };
        Ok(Self {
            swaybg_child: None,
            awww_bin,
            native: NativeRenderer::new(),
        })
    }

    /// Applies the current wallpaper configuration to the specified monitors.
    ///
    /// This method routes the request to the appropriate backend module based on
    /// the `RendererType` provided in the CLI arguments.
    ///
    /// # Arguments
    ///
    /// * `cli` - The global command-line configuration.
    /// * `cache` - The cache containing the wallpaper images to be displayed.
    /// * `monitors` - A list of monitor names (e.g., "eDP-1", "DP-2") to update.
    ///
    /// # Panics
    ///
    /// Panics if the renderer is set to `Awww` but the binary path was never initialized.
    pub async fn apply(
        &mut self,
        config: &Config,
        cache: &WallpaperCache,
        monitors: &[String],
    ) -> anyhow::Result<()> {
        match config.renderer {
            RendererType::Swaybg => swaybg::apply(cache, monitors, &mut self.swaybg_child).await,
            RendererType::Awww => {
                let bin = self.awww_bin.as_deref().expect("Renderer::new sets this");
                awww::apply(config, cache, monitors, bin).await
            }

            RendererType::Native => {
                self.native.apply(cache, monitors);
                Ok(())
            }
        }
    }
}