wallr_core/cli/
mod.rs

1use crate::animation::{Effect, EffectOverrides, apply_effect_overrides, effect_from_name};
2use crate::config::{ScalingMode, ThemeProvider};
3use clap::{Args, Parser, Subcommand};
4use std::path::PathBuf;
5
6/// Transition + customization flags shared by `img` / `set` / `preview`.
7#[derive(Args, Debug, Clone, Default)]
8pub struct EffectArgs {
9    /// Transition effect: simple, fade, blur, wipe, slide, left, right, top,
10    /// bottom, zoom, pixelate, ripple, dissolve, wave, grow, center, outer,
11    /// any, random
12    #[arg(long, value_name = "NAME", value_parser = parse_effect_name)]
13    pub effect: Option<String>,
14
15    /// Transition duration, for example 800ms, 1s, or 1.2s
16    #[arg(long, value_name = "DURATION")]
17    pub duration: Option<String>,
18
19    /// Effect origin: a preset (top_left, top, top_right, left, center, right,
20    /// bottom_left, bottom, bottom_right) or a normalized "x,y" (0..1)
21    #[arg(long, value_name = "PRESET|X,Y")]
22    pub origin: Option<String>,
23
24    /// Wipe/wave travel angle in degrees (0 = right, 90 = up)
25    #[arg(long, value_name = "DEG")]
26    pub angle: Option<f32>,
27
28    /// Wipe/slide direction vector "x,y" (e.g. "1,0" for left-to-right)
29    #[arg(long, value_name = "X,Y")]
30    pub direction: Option<String>,
31
32    /// Easing curve: linear, ease_in, ease_out, ease_in_out
33    #[arg(long, value_enum)]
34    pub easing: Option<crate::animation::Easing>,
35
36    /// Start value (fade opacity, blur radius, zoom scale, pixelate size)
37    #[arg(long, value_name = "VALUE")]
38    pub from: Option<f32>,
39
40    /// End value (fade opacity, blur radius, zoom scale, pixelate size)
41    #[arg(long, value_name = "VALUE")]
42    pub to: Option<f32>,
43
44    /// Wave/ripple frequency
45    #[arg(long, value_name = "HZ")]
46    pub frequency: Option<f32>,
47
48    /// Wave/ripple amplitude
49    #[arg(long, value_name = "VALUE")]
50    pub amplitude: Option<f32>,
51
52    /// Ripple expansion speed
53    #[arg(long, value_name = "VALUE")]
54    pub speed: Option<f32>,
55
56    /// Wipe feather / dissolve edge softness
57    #[arg(long, value_name = "VALUE")]
58    pub softness: Option<f32>,
59
60    /// Dissolve noise scale
61    #[arg(long, value_name = "VALUE")]
62    pub scale: Option<f32>,
63}
64
65impl EffectArgs {
66    /// Build an `Effect` from `--effect <name>` + all override flags.
67    /// Falls back to `fallback` when no effect name is given.
68    pub fn to_effect(&self, fallback: Effect) -> Effect {
69        let mut effect = self
70            .effect
71            .as_deref()
72            .and_then(effect_from_name)
73            .unwrap_or(fallback);
74        apply_effect_overrides(&mut effect, &self.to_overrides());
75        effect
76    }
77
78    pub fn to_overrides(&self) -> EffectOverrides {
79        let origin = self.origin.as_deref().and_then(parse_origin);
80        EffectOverrides {
81            origin,
82            origin_preset: if origin.is_none() {
83                self.origin.clone()
84            } else {
85                None
86            },
87            direction: self.direction.as_deref().and_then(parse_vec2),
88            angle: self.angle,
89            easing: self.easing,
90            from: self.from,
91            to: self.to,
92            frequency: self.frequency,
93            amplitude: self.amplitude,
94            speed: self.speed,
95            softness: self.softness,
96            scale: self.scale,
97        }
98    }
99}
100
101/// Validate `--effect` against the known effect names.
102fn parse_effect_name(s: &str) -> Result<String, String> {
103    if crate::animation::effect_names().contains(&s) {
104        Ok(s.to_string())
105    } else {
106        Err(format!(
107            "unknown effect '{}' — expected one of: {}",
108            s,
109            crate::animation::effect_names().join(", ")
110        ))
111    }
112}
113
114/// Parse "x,y" into a normalized origin, or None if it's not numeric.
115fn parse_origin(s: &str) -> Option<(f32, f32)> {
116    let mut parts = s.split(',');
117    let x = parts.next()?.trim().parse::<f32>().ok()?;
118    let y = parts.next()?.trim().parse::<f32>().ok()?;
119    Some((x.clamp(0.0, 1.0), y.clamp(0.0, 1.0)))
120}
121
122/// Parse "x,y" into a direction vector (not normalized here — shader normalizes).
123fn parse_vec2(s: &str) -> Option<[f32; 2]> {
124    let mut parts = s.split(',');
125    let x = parts.next()?.trim().parse::<f32>().ok()?;
126    let y = parts.next()?.trim().parse::<f32>().ok()?;
127    Some([x, y])
128}
129
130#[derive(Parser, Debug)]
131#[command(
132    name = "wallr",
133    about = "Wayland wallpaper engine with animation and theme pipelines",
134    version
135)]
136pub struct WallrCli {
137    #[command(subcommand)]
138    pub command: Commands,
139
140    /// Custom config file path
141    #[arg(global = true, long)]
142    pub config: Option<PathBuf>,
143
144    /// Increase log verbosity
145    #[arg(global = true, short = 'v', long, action = clap::ArgAction::Count)]
146    pub verbose: u8,
147
148    /// Suppress non-error output
149    #[arg(global = true, short = 'q', long)]
150    pub quiet: bool,
151}
152
153#[derive(Subcommand, Debug)]
154pub enum Commands {
155    /// Set wallpaper with animation + theme pipeline
156    Img {
157        /// Path to the wallpaper image
158        path: PathBuf,
159        /// Disable theme generation
160        #[arg(long)]
161        no_theme: bool,
162        /// Theme provider override for this call (matugen, wallust, pywal)
163        #[arg(long, value_enum)]
164        theme: Option<ThemeProvider>,
165        /// Target monitor
166        #[arg(long)]
167        monitor: Option<String>,
168        /// Animation package to use
169        #[arg(long)]
170        animation: Option<String>,
171        /// Scaling mode
172        #[arg(long, value_enum)]
173        mode: Option<ScalingMode>,
174        /// Transition effect + customization flags
175        #[command(flatten)]
176        effect_args: EffectArgs,
177    },
178    /// Alias/superset of img
179    Set {
180        /// Path to the wallpaper image
181        path: PathBuf,
182        /// Disable theme generation
183        #[arg(long)]
184        no_theme: bool,
185        /// Theme provider override for this call (matugen, wallust, pywal)
186        #[arg(long, value_enum)]
187        theme: Option<ThemeProvider>,
188        /// Target monitor
189        #[arg(long)]
190        monitor: Option<String>,
191        /// Animation package to use
192        #[arg(long)]
193        animation: Option<String>,
194        /// Scaling mode
195        #[arg(long, value_enum)]
196        mode: Option<ScalingMode>,
197        /// Transition effect + customization flags
198        #[command(flatten)]
199        effect_args: EffectArgs,
200    },
201    /// Environment diagnostics
202    Doctor,
203    /// Lint animation YAML
204    Validate {
205        /// Path to animation YAML file
206        path: PathBuf,
207    },
208    /// Configuration management
209    Config {
210        #[command(subcommand)]
211        subcommand: ConfigCommands,
212    },
213    /// Cache management
214    Cache {
215        #[command(subcommand)]
216        subcommand: CacheCommands,
217    },
218    /// Re-run reload list without changing wallpaper
219    Reload,
220    /// Monitor management
221    Monitor {
222        #[command(subcommand)]
223        subcommand: MonitorCommands,
224    },
225
226    // Core Daemon & Package commands
227    /// Start the background wallpaper daemon
228    Daemon,
229    /// Create a working animation package starter.
230    New {
231        /// Package name or output directory.
232        name: String,
233        /// Include a raw WGSL shader starter.
234        #[arg(long)]
235        shader: bool,
236    },
237    /// Watch a directory for new images and automatically set them
238    Watch {
239        /// Directory to watch
240        dir: PathBuf,
241    },
242    /// Preview an animation or wallpaper image
243    Preview {
244        /// Path to preview
245        path: PathBuf,
246        /// Watch for changes
247        #[arg(long)]
248        watch: bool,
249        /// Animation package or YAML file to preview
250        #[arg(long, value_name = "PACKAGE|FILE")]
251        animation: Option<String>,
252        /// Transition effect + customization flags
253        #[command(flatten)]
254        effect_args: EffectArgs,
255    },
256    /// Install an animation package from registry or repository
257    Install {
258        /// Package to install
259        package: String,
260    },
261    /// Publish an animation package to the registry
262    Publish,
263    /// Search for packages in the registry
264    Search {
265        /// Query to search for
266        query: String,
267    },
268    /// Control the running daemon via IPC commands
269    Ipc {
270        #[command(subcommand)]
271        subcommand: IpcCommands,
272    },
273    /// Gracefully stop the running daemon (alias for `ipc stop`)
274    Quit,
275}
276
277#[derive(Subcommand, Debug)]
278pub enum ConfigCommands {
279    /// Get a configuration value
280    Get { key: String },
281    /// Set a configuration value
282    Set { key: String, value: String },
283    /// Print the config path
284    Path,
285}
286
287#[derive(Subcommand, Debug)]
288pub enum CacheCommands {
289    /// Clear the cache
290    Clear,
291    /// Show cache info
292    Info,
293}
294
295#[derive(Subcommand, Debug)]
296pub enum MonitorCommands {
297    /// List monitors
298    List,
299    /// Show current monitor
300    Current,
301}
302
303#[derive(Subcommand, Debug)]
304pub enum IpcCommands {
305    /// Pause animations
306    Pause {
307        /// Target specific monitor (default: all)
308        #[arg(long)]
309        monitor: Option<String>,
310    },
311    /// Resume animations
312    Resume {
313        /// Target specific monitor (default: all)
314        #[arg(long)]
315        monitor: Option<String>,
316    },
317    /// Reload wallpaper
318    Reload,
319    /// Preview animation
320    Preview,
321    /// Stop daemon
322    Stop,
323    /// Get daemon status
324    Status,
325    /// Get video decoder and GPU information
326    Info {
327        /// Target specific monitor (default: all outputs)
328        #[arg(long)]
329        monitor: Option<String>,
330    },
331    /// Seek video to timestamp (format: HH:MM:SS or seconds)
332    Seek {
333        /// Timestamp in format HH:MM:SS or seconds
334        timestamp: String,
335        /// Target specific monitor (default: first output)
336        #[arg(long)]
337        monitor: Option<String>,
338    },
339    /// Blank an output without replacing persisted wallpaper
340    Blank {
341        /// Target specific monitor (default: all)
342        #[arg(long)]
343        monitor: Option<String>,
344    },
345    /// Restore a previously blanked output
346    Restore {
347        /// Target specific monitor (default: all)
348        #[arg(long)]
349        monitor: Option<String>,
350    },
351}
wallr_core/cli/mod.rs

wallr_core/cli/
mod.rs
