foot(1)
A fast GPU-based terminal emulator written in C using Wayland and X11.
Synopsis
foot [OPTION]... [COMMAND]...Description
foot is a modern terminal emulator designed for speed and correctness, leveraging GPU acceleration for rendering. It supports both Wayland and X11 servers and features true color support, ligatures, and CJK character handling.
The terminal can be launched with a shell by default or with a custom command. Configuration is managed through a config file (typically ~/.config/foot/foot.ini) and command-line options override config settings.
Common options
| Flag | What it does |
|---|---|
-e, --exec COMMAND | Execute COMMAND instead of the shell; remaining arguments are passed to COMMAND |
-t, --title TITLE | Set the initial window title |
-a, --app-id ID | Set the application ID (useful for wayland window management) |
-w, --window-size-pixels WIDTHxHEIGHT | Set initial window size in pixels, e.g., 1000x600 |
-W, --window-size-chars COLSxROWS | Set initial window size in character cells, e.g., 120x40 |
-s, --server | Start foot as a server (daemon) for faster client spawning |
-c, --client SOCKET_PATH | Connect to an existing foot server socket instead of creating new window |
-d, --working-directory DIR | Set the working directory for the new terminal |
-o, --override OPTION=VALUE | Override a config option, can be used multiple times |
-v, --verbose | Enable verbose logging (useful for debugging) |
Examples
Launch foot terminal emulator with default shell
footOpen vim directly in a new foot window instead of spawning a shell
foot -e vim /path/to/fileCreate a new foot window with 200 columns, 50 rows, and title 'Work Terminal'
foot -W 200x50 -t 'Work Terminal'Start foot server daemon for faster terminal creation via subsequent clients
foot -sConnect to existing foot server and open new window in ~/Projects directory
foot -c ~/.local/run/foot.sock -d ~/ProjectsLaunch foot with custom font size and color scheme via command-line overrides
foot -o font=monospace:size=12 -o colors=dracula