Struct Config 

pub struct Config {

    pub desktop: Desktop,
    pub directories: Vec<PathBuf>,
    pub extensions: Vec<String>,
    pub interval: u64,
    pub min_dimension: u64,
    pub max_dimension: u64,
    pub min_size: u64,
    pub max_size: u64,
    pub monitors: Vec<Monitor>,
    pub monitor_orientation: Orientation,
    pub once: bool,
    pub path_feh: PathBuf,
    pub sort: bool,
    pub effect: ProceduralEffect,
    pub effects: EffectsConfig,
    pub wallpaper: PathBuf,
    pub dry_run: bool,
    pub transition_type: String,
    pub transition_duration: u16,
    pub transition_fps: u16,
    pub transition_angle: u16,
    pub transition_pos: String,
    pub verbose: bool,
}

Configuration variables

Fields

desktop: Desktop

Desktops: gnome, xfce, openbox, …

directories: Vec<PathBuf>

Directories containing image files

extensions: Vec<String>

Image file extension (identify -list format)

interval: u64

Interval (in seconds) between each wallpaper displayed

min_dimension: u64

Minimum dimension

max_dimension: u64

Maximum dimension

min_size: u64

Minimum file size

max_size: u64

Maximum file size

monitors: Vec<Monitor>

Monitor properties

monitor_orientation: Orientation

Attach images to monitors in the Horizontal or Vertical orientation

once: bool

Run a single wallpaper update cycle and exit

path_feh: PathBuf

feh binary path

sort: bool

Sort the images found

effect: ProceduralEffect

Selected procedural overlay effect (none, fractal, star, random)

effects: EffectsConfig

Configurable parameters and custom presets for mathematical overlays

wallpaper: PathBuf

Wallpaper file path used by gnome desktop

dry_run: bool

Run without actually applying wallpapers (Simulation mode)

transition_type: String

Animation transition type for awww daemon

transition_duration: u16

Duration of awww transition in seconds

transition_fps: u16

Framerate of the awww transition animation

transition_angle: u16

Angle for wipe/wave transitions

transition_pos: String

Starting position for center/outer transitions

verbose: bool

Show intermediate runtime messages

Implementations

impl Config

pub fn new(args: &Arguments, env: &Environment<'_>) -> WallSwitchResult<Self>

Merges settings from the JSON configuration file with parsed command-line overrides.

Errors

Returns a WallSwitchResult if config reading or validation fails.

pub fn default_with_env(env: &Environment<'_>) -> Self

Initializes a default configuration aligned with the active environment context.

impl Config

pub fn in_range(&self, value: u64) -> bool

Check if the value is in the range

pub fn print(&self) -> WallSwitchResult<()>

Print Config

pub fn validate_config(self) -> WallSwitchResult<Self>

Validate configuration

pub fn write_config_file( self, path: &Path, read_default_config: bool, ) -> WallSwitchResult<Self>

Write config file path:: “/home/user_name/.config/wallswitch/wallswitch.json”

To ensure atomic write and protect against sudden crashes or interruptions, the configuration is written to a temporary file in the target directory and then renamed.

pub fn get_number_of_images(&self) -> usize

Get the number of images per cycle

Trait Implementations

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.