Quick Start
Pick your first wallpaper and set up a config
First Run
Put wallpapers in the default directory:
~/Pictures/WallpapersOr use another one with -d ~/Pictures/Photography.
Choose a backend. The default is awww. Use auto to detect a running one:
matuwall -b autoOpen the picker:
matuwallMove with arrows or h j k l. Press Enter to apply, Escape to cancel.
Try the full-screen preview:
matuwall --previewPress r a few times to shuffle through wallpapers.
Useful Layouts
Regular grid:
matuwall --no-carousel -c 4 -r 2Vertical carousel on the left:
matuwall --carousel -p left -c 5Compact bottom carousel:
matuwall -p bottom -c 4 -w 240 --height 135 -m 20Transparent panel with a selection ring:
matuwall --background '#11111bcc' --ring '#f2cdcd' --ring-width 3Open on one monitor:
matuwall -o DP-1An unknown output is an error. Matuwall prints the available names.
Create a Config
Write the built-in defaults to a file:
mkdir -p ~/.config/matuwall
matuwall --no-config --print-config > ~/.config/matuwall/config.tomlEdit it, then check the result:
matuwall --print-config
matuwall --diagnoseCLI options apply to one run only. They never edit the config file.
Next: Usage or Configuration