8 stable releases

3.2.0 Jul 9, 2021
3.1.1 Jul 6, 2021
3.1.0 Jun 30, 2021
2.0.1 Jan 31, 2019
1.0.0 Jul 18, 2018

#707 in Web programming

Download history 143/week @ 2024-07-22 227/week @ 2024-07-29 159/week @ 2024-08-05 240/week @ 2024-08-12 148/week @ 2024-08-19 160/week @ 2024-08-26 177/week @ 2024-09-02 150/week @ 2024-09-09 162/week @ 2024-09-16 197/week @ 2024-09-23 206/week @ 2024-09-30 26/week @ 2024-10-07 128/week @ 2024-10-14 133/week @ 2024-10-21 153/week @ 2024-10-28 110/week @ 2024-11-04

524 downloads per month
Used in 14 crates (13 directly)

Unlicense

21KB
528 lines

wallpaper crate docs

This Rust library gets and sets the desktop wallpaper/background.

The supported desktops are:

  • Windows
  • macOS
  • GNOME
  • KDE
  • Cinnamon
  • Unity
  • Budgie
  • XFCE
  • LXDE
  • MATE
  • Deepin
  • Most Wayland compositors (set only, requires swaybg)
  • i3 (set only, requires feh)

Examples

use wallpaper;

fn main() {
    // Returns the wallpaper of the current desktop.
    println!("{:?}", wallpaper::get());
    // Sets the wallpaper for the current desktop from a file path.
    wallpaper::set_from_path("/usr/share/backgrounds/gnome/adwaita-day.png").unwrap();
    // Sets the wallpaper style.
    wallpaper::set_mode(wallpaper::Mode::Crop).unwrap();
    // Returns the wallpaper of the current desktop.
    println!("{:?}", wallpaper::get());
}

If you want to set an image as background via an URL, make sure you activated the from_url feature of the wallpaper crate on Cargo.toml:

[dependencies]
wallpaper = { version = "3", features = ["from_url"] }

Then, on your main.rs:

use wallpaper;

fn main() {
    // Returns the wallpaper of the current desktop.
    println!("{:?}", wallpaper::get());
    // Sets the wallpaper for the current desktop from a URL.
    wallpaper::set_from_url("https://source.unsplash.com/random").unwrap();
    // Returns the wallpaper of the current desktop.
    println!("{:?}", wallpaper::get());
}

Dependencies

~0.2–12MB
~145K SLoC