Skip to content

Tutorial

Jump to bottom Edit New page
Alex Leferry 2 edited this page Feb 21, 2020 · 42 revisions

Tutorial

Table of contents

Default key-bindings

Here is an overview (non-exhaustive) of the key-bindings you can find in the wayfire.ini config file:

  • Super ⇒ Overview all workspaces.
  • Super + Enter ⇒ Open a terminal (Alacritty).
  • Super + Shift + Enter ⇒ Open the launcher (Wofi).
  • Super + w ⇒ Close window.
  • Super + Tab ⇒ Preview windows and select the next window; add Shift for previous.
  • Alt + Escape ⇒ Select the next window.
  • Super + [UpDownLeftRightHomeEnd] ⇒ Arrange window into a grid; add Shift for bottom.
  • Super + [hjkl] ⇒ Switch to adjacent workspace; add Shift to move with the focused window.
  • Super + Control + [hl] ⇒ Switch to the previous or next workspace, by using the cube.
  • Super + o ⇒ Move focus to the next output; add Shift to move with the focused window.

Note that you probably need to adapt the applications, such as the terminal and launcher, in your config file.

Using Wayfire

Opening terminals and moving around

One very basic operation is opening a new terminal. By pressing Super + Enter, a new terminal will be opened. By default, the key-binding opens Alacritty.

open-terminal

Opening other applications

Aside from opening applications from a terminal, you can also use the handy Wofi which is opened by pressing Super + Shift + Enter by default.

open-applications

Additionally, if you have applications you open very frequently, you can create a key-binding for starting the application directly. See the section Configuring Wayfire for details.

Closing windows

If an application does not provide a mechanism for closing (most applications provide a menu, the middle mouse button for tabs, the escape key or a shortcut like Control + w to close), you can press Super + w, Super and middle mouse button or Alt + F4 to close a window.

close-window

Moving windows

By dragging the window’s title bar with your mouse you can move the window around. You can also drag windows by holding down Super and left mouse button.

drag-window

Resizing windows

By grabbing the borders and moving them you can resize the window. You can also do that by holding down Super and right mouse button.

resize-window

Switching between windows

By pressing Super + Tab, you can preview the windows in the current workspace and select the next window; add Shift for previous. To switch without animation, press Alt + Escape.

switch-between-windows

Positioning windows

Press Super and the arrow keys for arranging windows into a grid of 2 cells. Press Super + [HomeEnd] for arranging windows into a grid of 4 cells; add Shift for bottom. You can also use the keypad, which is laid out exactly to match the slots.

grid

Using workspaces

Workspaces are an easy way to group a set of windows. Wayfire allows you to arrange your workspaces spatially, rather than linearly. By default, there is 9 – 3 horizontal and 3 vertical – workspaces, and you are on the first workspace.

To switch to another workspace, press Super + HJKL; add Shift to move with the focused window.

switch-to-workspace

You can also use the cube, by holding Super + Shift and left mouse button, or via the keyboard with Super + Control + [hl].

cube

Pressing Super allows you to preview all workspaces in the current output. You can use your mouse to select a workspace. HJKL, Enter, Home and End can be used to select a workspace with your keyboard.

expo

Moving windows to workspaces

To move a window to another workspace, simply press Super + Shift + HJKL.

Changing the opacity

When the modifier key Super is held down, you can scroll down and up to adjust the opacity of the window.

Reloading the configuration

To reload the configuration, simply save the config file. Most of the options are automatically reloaded.

Exiting Wayfire

Press Control + Alt + Backspace.

TODO: Add a configuration option.

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.

Configuring your outputs

Example configuration:

~/.config/kanshi/config

[eDP-1]
mode = [email protected]
layout = 0,0
transform = normal
scale = 1.000000

See Output for more information.

Example configuration with kanshi:

~/.config/kanshi/config

{
  output eDP-1 mode 1920x1080 position 0,0
}
{
  output eDP-1 mode 1920x1080 position 0,900
  output HDMI-A-1 mode 1440x900 position 0,0
}

You can get the names of your outputs with wlr-randr.

And start kanshi on startup with Autostart.

Idle configuration

Example configuration with swayidle and swaylock:

~/.config/wayfire.ini

[autostart]
idle = swayidle before-sleep swaylock

[idle]
toggle = <super> KEY_Z
screensaver_timeout = 300
dpms_timeout = 600
  • Disables the compositor going idle with Super + z.
  • This will lock your screen after 300 seconds of inactivity, then turn off your displays after another 300 seconds.

See Autostart and Idle for more information.

Screen locker

Lock your screen with swaylock:

~/.config/wayfire.ini

[command]
binding_lock = <super> KEY_ESC
command_lock = swaylock

See Command for more information.

Logout

Logout with wlogout:

~/.config/wayfire.ini

[command]
binding_logout = <super> <shift> KEY_ESC
command_logout = wlogout

See Command for more information.

Changing the volume

Example – Changing the volume with ALSA:

~/.config/wayfire.ini

[command]
repeatable_binding_volume_up = KEY_VOLUMEUP
command_volume_up = amixer set Master 5%+
repeatable_binding_volume_down = KEY_VOLUMEDOWN
command_volume_down = amixer set Master 5%-
binding_mute = KEY_MUTE
command_mute = amixer set Master toggle

Example – Changing the volume with PulseAudio:

~/.config/wayfire.ini

[command]
repeatable_binding_volume_up = KEY_VOLUMEUP
command_volume_up = pactl set-sink-volume 0 +5%
repeatable_binding_volume_down = KEY_VOLUMEDOWN
command_volume_down = pactl set-sink-volume 0 -5%
binding_mute = KEY_MUTE
command_mute = pactl set-sink-mute 0 toggle

See Command for more information.

Changing the screen brightness

Example – Changing the screen brightness with Light:

~/.config/wayfire.ini

[command]
repeatable_binding_light_up = KEY_BRIGHTNESSUP
command_light_up = sudo light -A 5
repeatable_binding_light_down = KEY_BRIGHTNESSDOWN
command_light_down = sudo light -U 5

Note: The command requires sudo.

See Command for more information.

Taking screenshots

Taking screenshots with grim and slurp:

~/.config/wayfire.ini

[command]
binding_screenshot = KEY_PRINT
command_screenshot = grim $(date '+%F_%T').webp
binding_screenshot_interactive = <shift> KEY_PRINT
command_screenshot_interactive = slurp | grim -g - $(date '+%F_%T').webp

See Command for more information.

Creating screencasts

See wf-recorder and wlrobs.

Automatically maximizing windows

You can maximize specific windows by default with the following command:

~/.config/wayfire.ini

[window-rules]
alacritty = app-id Alacritty created -> set maximized

You can get the properties of your applications with the following command:

WAYLAND_DEBUG=1 alacritty 2>&1 | kak

See Window rules for more information.

Add a custom footer
Clone this wiki locally