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 [colors] 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 starts 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).

Enable the user unit foot-server.service or the corresponding foot-server.socket for socket activation to start the foot server automatically on login.

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.