Usage
Keys, favorites, lists and applying wallpapers without the picker
Keyboard
| Key | Action |
|---|---|
Arrows, h j k l | Move the selection. Carousel movement wraps |
Page Up, Page Down | Move one page. Disabled in carousel mode |
Home, g | First tile |
End, G | Last tile |
r | Random tile |
f | Mark as favorite |
Backspace | Go back to the wallpaper you started with |
Enter | Apply and close |
Escape | Cancel and close |
Mouse
Mouse input is off by default:
[input]
mouse = trueHover selects, the wheel moves and left click applies. With preview on, clicking outside the panel cancels.
Without the Picker
These apply a wallpaper and exit. No window opens. Backend and hooks run exactly like Enter.
| Command | Action |
|---|---|
matuwall --restore | Apply the last wallpaper again |
matuwall --random | Apply a random wallpaper, never the current one |
matuwall --next | Apply the next wallpaper |
matuwall --prev | Apply the previous wallpaper |
Restore wallpaper and colors at login, e.g. in your compositor autostart:
matuwall --restore--next and --prev follow sort and wrap at both ends. They combine with other options:
matuwall --random -d ~/Pictures/PhotographyFavorites
Press f to mark the selected wallpaper. Marked wallpapers are written to the favorites file when the picker closes:
~/.config/matuwall/favorites.txtOpen them later:
matuwall --list ~/.config/matuwall/favorites.txtTo remove a favorite, edit the file.
Wallpaper Lists
Pick from a file with one path per line instead of a directory. - reads stdin:
matuwall --list ~/favorites.txt
fd -e jpg sunset ~/Pictures | matuwall --list -# favorites.txt
~/Pictures/Wallpapers/forest.jpg
city/night.png- Relative paths are inside the first
directory. From stdin, they use the current directory - Blank lines and
#comments are skipped - The grid keeps the list order unless
sort = "color" --next,--prevand--randomwork on lists too
Stay Open After Apply
[window]
close_on_apply = falseEnter applies in the background, so you can try several wallpapers in a row. Backspace goes back and re-applies the starting wallpaper.
Files
| Path | Contents |
|---|---|
~/.config/matuwall/config.toml | Config |
~/.config/matuwall/favorites.txt | Favorites |
~/.local/state/matuwall/last-selection | Last applied wallpaper |
~/.local/state/matuwall/matuwall.log | Log, limited to 256 KiB plus two rotations |
~/.cache/matuwall/thumbs/ | Thumbnail cache |
~/.cache/matuwall/colors | Learned colors for sort = "color" |
XDG base directory variables are respected.
Maintenance
matuwall --diagnose # check config, Wayland, backends, hooks and paths
matuwall --clear-cache # remove cached thumbnails only