nitrogen

Browse wallpapers from a directory

$ nitrogen [path/to/directory]

$ nitrogen --set-auto [path/to/file]

$ nitrogen --restore

$ nitrogen --set-scaled [path/to/file]

$ nitrogen --set-centered [path/to/file]

$ nitrogen --set-tiled [path/to/file]

nitrogen [--restore] [--set-auto|--set-scaled|--set-centered|--set-tiled|--set-zoom file] [directory]

nitrogen is a wallpaper browser and setter for X Window desktops. It provides a graphical interface for browsing and selecting wallpapers, with support for multiple monitor configurations.
The tool saves wallpaper settings that can be restored on login using the --restore flag. It supports various scaling modes and works with Xinerama/RandR multi-monitor setups.

--restore

Restore previously set wallpaper

Set wallpaper with automatic sizing

Set wallpaper scaled to fill screen

Set wallpaper centered on screen

Set wallpaper tiled across screen

Set wallpaper zoomed to fill

Set wallpaper zoomed and cropped to fill

Save current settings

Set wallpaper on specific monitor (Xinerama)

Only works with X Window System, not Wayland. Settings are stored in ~/.config/nitrogen/. For startup restoration, add "nitrogen --restore &" to autostart scripts.

nitrogen was developed as a lightweight wallpaper setter for window managers that don't include built-in wallpaper functionality. It is commonly used with tiling window managers like i3, bspwm, and openbox.

feh(1), xwallpaper(1), hsetroot(1)