Skip to Content
Matuwall

Quick Start

Pick your first wallpaper and set up a config

First Run

Put wallpapers in the default directory:

~/Pictures/Wallpapers

Or use another one with -d ~/Pictures/Photography.

Choose a backend. The default is awww. Use auto to detect a running one:

matuwall -b auto

Open the picker:

matuwall

Move with arrows or h j k l. Press Enter to apply, Escape to cancel.

Try the full-screen preview:

matuwall --preview

Press r a few times to shuffle through wallpapers.

Useful Layouts

Regular grid:

matuwall --no-carousel -c 4 -r 2

Vertical carousel on the left:

matuwall --carousel -p left -c 5

Compact bottom carousel:

matuwall -p bottom -c 4 -w 240 --height 135 -m 20

Transparent panel with a selection ring:

matuwall --background '#11111bcc' --ring '#f2cdcd' --ring-width 3

Open on one monitor:

matuwall -o DP-1

An 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.toml

Edit it, then check the result:

matuwall --print-config
matuwall --diagnose

CLI options apply to one run only. They never edit the config file.

Next: Usage or Configuration

On this page