randwall is a command-line wallpaper changer that periodically downloads images from Wallhaven and applies them to your desktop. It selects wallpapers from the service’s toplist, providing a way to discover new backgrounds without manually browsing for images.
The application lets you control which wallpapers are retrieved. You can specify categories, restrict content types and include or exclude particular search terms. An optional Wallhaven API key enables access to additional content where authorised.
randwall also manages its downloaded images. You can configure how frequently it retrieves wallpapers, how many images it retains locally and how many pages of Wallhaven results it searches.
Configuration is stored in a file created automatically on first launch. The project provides a standalone executable, while Arch Linux users can install the AUR package and enable its systemd user service.
This is free and open source software.
Key Features
- Periodically fetch and apply random wallpapers from Wallhaven’s toplist.
- Configure wallpaper retrieval intervals.
- Filter images by Wallhaven categories and content classifications.
- Include or exclude wallpapers using configurable search keywords.
- Set the maximum number of Wallhaven results pages searched.
- Limit the number of downloaded wallpapers retained locally, or keep every image.
- Support optional Wallhaven API authentication.
- Run through a systemd user service when installed using the Arch Linux AUR package.
Website: github.com/arch-anes/randwall
Support:
Developer: Anes Belfodil
License: MIT License

randwall is written in Go. Learn Go 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.