In this Extra section I will be showing some configurations or things to do that you might find useful.

For example the first thing that I found missing that I required was having the ssh-agent running so we will start with that!


The problem was that ssh-agent is not running by default so you can add these lines to your .bashrc to start an instance and reuse it for the whole session:

# start only one ssh-agent and reuse the created one
# this is used for sway, althou keys added do not persist on reboot
if ! pgrep -u "$USER" ssh-agent > /dev/null; then
    ssh-agent > "$XDG_RUNTIME_DIR/ssh-agent.env"

This will ask for password on first use, so if you reboot you will have to insert it again. If you prefer that it remembers it you could explore solutions with gnome keyring or similiar.

To complement this, I added these settings to the ~/.ssh/config file so I have my key already added:

# ~/.ssh/config

AddKeysToAgent yes
IdentityFile ~/.ssh/my_private_key


This is actually a feature that I could not live without as I find myself sharing often screenshots for work, so it was one of the first things that I setup to mimic my Ubuntu experience.

The dependencies that you will need to install are:

grim allows you to grab images, slurp allows you to select a region of the screen.

wl-clipboard gives you utilities for working with the clipboard like wl-copy and jq is a json parser, these two are dependencies of a script that we will use for simpler screenshotting: grimshot

Install all of these with apt and make sure to have the grimshot script executable:

sudo apt install wl-clipboard
sudo apt install grim
sudo apt install slurp
sudo apt install jq

I have modified this line to have better naming of the saved screenshots:

# before:

# after:
# line 31
FILE=${3:-$(getTargetDirectory)/$(date +"%Y-%m-%d-%H:%M:%S").png}

All that's left is adding these commands to the sway config ~/.config/sway/config.

Here I have grimshot as an executable under ~/.local/bin/grimshot

# Screenshots
# currently having a custom grimshot under .local/bin
set $grimshot ~/.local/bin/grimshot

bindsym Print exec $grimshot --notify save screen
bindsym Ctrl+Print exec $grimshot --notify copy screen
bindsym Shift+Print exec $grimshot --notify save area
bindsym Ctrl+Shift+Print exec $grimshot --notify copy area

And you are set! With these settings you will have:

  • Print - saves the entire screen
  • <Shift> + Print - copy the entire screen
  • <Ctrl> + Print - select an area and save it
  • <Shift>+<Ctrl> + Print - select an area and copy it

You will find the saved screenshot in your ~/Pictures folder.

If you require more control, for example you need to be able to screenshot only a specific window, feel free to add more commands!

You probably noticed the --notify flag that I have set, it will send a notification but if you followed along you probably aren't seeing any. In the next section we will look into installing a notification manager!

Notification Manager (mako)

If you try to send a notification via command line you will see that nothing appears:

notify-send hello


To manage notifications you can install mako via apt:

sudo apt install mako-notifier

Mako can be started by executing the program mako, now if you try to send a notification again you will see it appear by default in the top right of the screen: notify-send hello notification showing hello

You probably noticed that the notification won't disappear because we didn't specify a timeout but don't worry for now.


Instead of starting mako manually it would be nice if sway executed it at startup and it would also be nice to have some commands to dismiss the notifications.

Add these lines to your sway config:

# Mako
bindsym $mod+n exec makoctl dismiss
bindsym $mod+Shift+n exec makoctl dismiss -a

# Start programs
exec mako

With these lines you will have mako running by sway on startup and the following bindings:

  • <mod>+n - dismiss the last notification
  • <mod>+<shift>+n - dismiss all notifications

You can also configure mako, a simple config to use could be:

# ~/.config/mako/config



It is self explanatory, every notification has a default life of 5 seconds except notifications marked with urgency high, those will ignore the configured timeout. You can lookup more settings and customize it further!

If you try to take a screenshot now, you will see the notification for it appear! area screenshot notification


On ubuntu 20.04 there might a problem with apparmor and mako so if you see a strange error on opening the configuration file for mako you can disable apparmor for it with:

sudo apt install apparmor-utils
sudo aa-disable /etc/apparmor.d/fr.emersion.Mako

Blurred Lock Screen

Instead of having a black lock screen I used a script with grim and ffmpeg to take a screenshot and blur it. This might be something totally not functional that you might enjoy.

Install ffmpeg with:

sudo apt install ffmpeg

Then create a script with these contents, I named the script create_lock_image:

#! /bin/sh

# Take a screenshot of the desktop and apply a gaussian blur to create
# an image to use for the lock screen.

grim /tmp/_sway_lock_image.png
ffmpeg -i /tmp/_sway_lock_image.png -filter_complex "gblur=sigma=50" /tmp/sway_lock_image.png -y

Then you can configure your lock screen to run the script and set the resulting image as background:

# ~/.config/sway/config

exec swayidle -w \
         timeout 300 '~/.local/bin/create_lock_image && swaylock -f -i /tmp/sway_lock_image.png' \
         timeout 600 'swaymsg "output * dpms off"' \
              resume 'swaymsg "output * dpms on"' \
         before-sleep 'swaylock -f -c 000000'

The result will be something like this depending on your screen working on docs blurred

and while unlocking:

working on docs blurred

Fzf as application launcher

Fzf is a wonderful tool, it's a fuzzy finder and can be used as an application launcher.

Install fzf with:

sudo apt install fzf

Add the following lines to your sway config:

# Application launcher with fzf
set $menu exec $term --class=launcher -e bash -c 'compgen -c | grep -v fzf | sort -u | fzf --layout=reverse | xargs -r swaymsg -t command exec'

# Windows config
for_window [app_id="^launcher$"] floating enable, border none, opacity 0.8

This will use a terminal with fzf for launching programs in floating mode without border and a little transparent, you can invoke it with the same command as before <mod>+d

fzf as application launcher

Brightness/Volume/Media controls

To use the brightness/volume/media special keys on your keyboard you can install these two tools and add this to your sway configuration:

sudo apt install brightnessctl
sudo apt install pavucontrol
# ~/.config/sway/config

# volume / brightness / media controls
bindsym XF86AudioRaiseVolume exec pactl set-sink-volume @DEFAULT_SINK@ +5%
bindsym XF86AudioLowerVolume exec pactl set-sink-volume @DEFAULT_SINK@ -5%
bindsym XF86AudioMute exec pactl set-sink-mute @DEFAULT_SINK@ toggle
bindsym XF86AudioMicMute exec pactl set-source-mute @DEFAULT_SOURCE@ toggle
bindsym XF86MonBrightnessDown exec brightnessctl set 5%-
bindsym XF86MonBrightnessUp exec brightnessctl set +5%
bindsym XF86AudioPlay exec playerctl play-pause
bindsym XF86AudioNext exec playerctl next
bindsym XF86AudioPrev exec playerctl previous

Firefox wayland native + big mic popup fix

Firefox requires environment variables to be set to know to be run in wayland native mode, the way I went about letting sway know about these variables is with the .pam_environment file but there are probably other ways to do this, as example starting sway with a custom script that already sets the desired environment variables.

Create a .pam_environment file in your home:

# ~/.pam_environment

# Firefox use wayland
# make firefox aware of wayland instance when launched from x11

Now after you restart, firefox will be running in wayland native mode even if launched from x11 windows.

When running in wayland native mode, an annoying bug is that when you are on a page with the mic permission enabled, the indicator will be an entire new window in its full size. full window size firefox mic indicator

As a workaround until the bug is fixed in firefox, add this config in your sway config to make the window floating and small:

# ~/.config/sway/config

# this makes the popup window for mic access small and stickied instead of an
# extra window, this will work until it's fixed in firefox
for_window [title="\ -\ Sharing\ Indicator$"] floating enable, sticky enable

floating small firefox mic indicator

The sticky enable part means that it will follow you even if you switch workspace.

Hide Cursor

The cursor can be hidden after a period of inactivity with this setting:

# ~/.config/sway/config

# Hide cursor
seat seat0 hide_cursor 5000

hide cursor demonstration

Spawn new terminal in current path

An useful setting that I found is that when having <mod>+enter as spawn new terminal, a great addition is having <mod>+<shift>+enter spawn a new terminal in the current path.

With alacritty you can achieve this by setting a new keybind, in my case <mod> is <super> so I set it as:

# ~/.config/alacritty/alacritty.yml

  - { key: Return,   mods: Super|Shift, action: SpawnNewInstance }

new terminal in same path


The bar you have been seeing in my examples is Waybar. styled waybar

To install it:

sudo add-apt-repository ppa:nschloe/waybar
sudo apt update
sudo apt install waybar

# for the icons
sudo apt install fonts-font-awesome

and add to your config:

# ~/.config/sway/config

bar {
    position top

    swaybar_command waybar

To configure it or style it you can look in the waybar wiki or for mine in my dotfiles.

GTK+ applications have long startup

If gtk+ applications are taking a long time to startup (20~ sec), add this at the start of your sway config file:

exec systemctl --user import-environment DISPLAY WAYLAND_DISPLAY SWAYSOCK
exec hash dbus-update-activation-environment 2>/dev/null && \
     dbus-update-activation-environment --systemd DISPLAY WAYLAND_DISPLAY SWAYSOCK

Honorable mentions

Here are other tools that are worth mentioning even if some I haven't tried yet but are under my radar.


Record screen and audio, I used it for the examples of this guide.

sudo apt install wf-recorder


Draw/Edit screenshots.