From ArchWiki

Foot is a fast, lightweight and minimalistic Wayland terminal emulator.


Install the foot package or foot-gitAUR for the development version.


foot loads configuration file at $XDG_CONFIG_HOME/foot/foot.ini (defaulting to $HOME/.config/foot/foot.ini). A template for the configuration file can be found in /etc/xdg/foot/foot.ini, copy the template to $XDG_CONFIG_HOME/foot/foot.ini and uncomment the setting you want to change. Restart foot to apply the new settings.

Manual page foot.ini(5) provides detailed information on how to configure foot.


You can customize colors by modifying [color] section.

Themes can be found in /usr/share/foot/themes. To apply a theme, add an include key under [main].


Server (daemon) mode

  • Advantages to run foot in server mode including reduced memory footprint and startup time.
  • The downside is a performance penalty; all windows' input and output are multiplexed in the same thread (but each window will have its own set of rendering threads). This means that if one window is very busy with, for example, producing output, then other windows will suffer. Also, should the server process crash, all windows will be gone.

When run normally, foot start a new foot process for each window.

foot can also be run in a server mode. In this mode, one process hosts multiple windows. All Wayland communication, VT parsing and rendering is done in the server process.

New windows are opened by running footclient, which remains running until the terminal window is closed, at which point it exits with the exit value of the client process (typically the shell).

The foot package provides the foot-server@.service and foot-server@.socket , however, they are not usable on the default setup because they requires non standard unit files. See pull request #1110 for details.

To run foot in server mode. First create drop-in files to override default WantedBy option of foot-server@.service and foot-server@.socket.


Follow by reloading systemd user configuration with a daemon-reload, then enable the foot-server@${WAYLAND_DISPLAY}.socket user unit.

Tips and tricks


Show borders

Currently, GNOME does not support server side decoration on Wayland. foot running on GNOME will show a plain and flat window. You can configure foot to show borders so that different foot windows can be distinguished more easily.


Rebind URL mode keys

foot has a URL mode, URLs to be launched, however, its default binding, Ctrl+Shift+u conflicts with Unicode input shortcut of IBus, thus making URL mode inaccessible. You can solve this by bind URL mode to other keys.