Configuring Wayfire
To
change the configuration of Wayfire,
copy wayfire.ini to ~/.config/wayfire.ini and
edit it with a text editor. For a
complete reference, see the Configuration document.
Setting your keyboard layout
~/.config/wayfire.ini
[input]
xkb_layout = us,fr
xkb_variant = dvorak,bepo
See Input for more information.
Terminal
Open Alacritty, kitty or another terminal:
~/.config/wayfire.ini
[command]
binding_terminal = <super> KEY_ENTER
command_terminal = alacritty
See Command for more information.
Application launcher
Example – Run Wofi, a graphical launcher, similar to dmenu:
~/.config/wayfire.ini
[command]
binding_launcher = <super> <shift> KEY_ENTER
command_launcher = wofi
Note: Add mode=run or mode=drun to ~/.config/wofi/config. You can also specify the mode with --show option.
You might prefer fzf running in a terminal.
Example – Run Launcher with fzf and Alacritty:
~/.config/wayfire.ini
[command]
binding_launcher = <super> <shift> KEY_ENTER
command_launcher = alacritty --command sh -c 'nohup launcher-run $(launcher-list | fzf) > /dev/null'
See Command for more information.
Setting the wallpaper
You
can use wf-background, provided by wf-shell.
~/.config/wayfire.ini
[autostart]
background = wf-background
See Autostart for more information.
If you prefer swaybg, adapt the command as follows.
Example – Simple:
swaybg --image /path/to/wallpaper.webp
Example – Random wallpaper:
find -L /path/to/wallpapers -type f | sort -R | head -n 1 | xargs swaybg --image
Adding a panel and dock
You
can use wf-panel and wf-dock, provided by wf-shell.
~/.config/wayfire.ini
[autostart]
panel = wf-panel
dock = wf-dock
You can also use Waybar if you prefer it.
~/.config/wayfire.ini
[autostart]
bar = waybar
See Autostart for more information.