Icebg is a lightweight wallpaper setter for Wayland compositors. It uses the Wayland layer-shell protocol to display an image as a background surface, providing a relatively simple way to manage static desktop wallpapers.
The application is designed for compositors based on wlroots and Smithay, including Hyprland, Sway and Niri. It is not intended for X11 desktop sessions.
Icebg uses the iced graphical framework for rendering and stores its configuration in a RON file. The configuration specifies the wallpaper image, display target and how the image should fit the screen.
One of its useful capabilities is hot-reloading. Icebg can monitor its configuration file and update the displayed wallpaper when settings change, without requiring the user to restart the program manually.
The software is particularly suited to users who prefer to configure their desktop through text files and compositor startup commands instead of using a graphical wallpaper management application.
This is free and open source software.
Key Features
- Displays static wallpapers using the Wayland layer-shell protocol.
- Designed for wlroots and Smithay compositors, including Hyprland, Sway and Niri.
- Creates a background layer surface for displaying wallpaper images.
- Uses the iced framework for rendering.
- Supports targeting a specific monitor by its output name.
- Can use the active display when no monitor is explicitly configured.
- Reads wallpaper settings from a RON configuration file.
- Automatically creates a default configuration file on first launch.
- Watches configuration changes and reloads the wallpaper without restarting.
- Provides a configurable polling interval for detecting configuration changes.
- Offers Contain mode to fit an image within the screen without cropping.
- Provides Cover mode to fill the screen while allowing cropping.
- Supports Fill mode for stretching images across the display.
- Includes None mode for displaying images without scaling.
- Provides ScaleDown mode to reduce oversized images without enlarging smaller images.
- Can be started automatically through compositor startup configuration.
Website: github.com/HaruNashii/Icebg
Support:
Developer: HaruNashii
License: MIT License
Icebg is written in Rust. Learn Rust with our recommended free books and free tutorials.
Related Software
| Wallpaper Setters | |
|---|---|
| Fantascene | Play video wallpapers on your background |
| Variety | Highly configurable utility that offers a great range of features |
| WallpaperDownloader | Download, change, manage wallpapers with this Java tool |
| Superpaper | Advanced multi monitor wallpaper manager |
| wpgtk | Colorscheme, wallpaper and template manager |
| Waywallen | Dynamic wallpaper manager for Wayland desktop environments |
| Picture Of The Day | Grabs a picture of the day from a variety of sources |
| HydraPaper | Gtk utility to set different backgrounds for each monitor on GNOME |
| Waypaper | Lightweight graphical wallpaper manager |
| pacwall | Live wallpaper showing dependency graph and installed packages |
| chwall | Tiny automatic wallpaper changer |
| swaybg | Wallpaper utility for Wayland compositors |
| mpvpaper | Video wallpaper software |
| Komorebi | Fully customisable image, video, and web page wallpapers |
| Azote | GTK+3 based picture browser and background setter |
| WSelector | Wallpaper selector manager |
| Wall Changer | Automatic wallpaper changer |
| Hyprpaper | Wallpaper utility designed for Hyprland |
| Fondo | Quickly find beautiful wallpapers from Unsplash |
| feh | Mode-based image viewer and cataloger aimed at console users |
| xwallpaper | Wallpaper setting utility |
| Damask | Automatically set wallpaper images |
| wpaperd | Lightweight wallpaper daemon with automatic image rotation |
| Walt | Wallpaper manager for Hyprland |
| awww | Wallpaper daemon for Wayland |
| flowy | Lean privacy-preserving dynamic wallpaper changer |
| hpaper | Advanced wallpaper management for Wayland |
| chwp | Changes the wallpaper from the command line |
| Wallrus | Generate colorful abstract wallpapers |
| awtwall | Fast TUI wallpaper picker for Wayland |
| Tinte | Wallpaper utility and theme generator |
| Nitrogen | Background browser and setter |
| gSlapper | Wallpaper utility for Wayland |
| wewa | Renders web content as desktop wallpaper |
| Walldo | Simple graphical wallpaper changer for Linux desktops |
| randwall | Randomly changes the desktop wallpaper |
| Matuwall | Fast graphical wallpaper picker for Wayland desktops |
| Icebg | Lightweight wallpaper setter for Wayland compositors |
| Clockwork Orange | Manage wallpapers and lock screen backgrounds |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.