foot(1) General Commands Manual foot(1) (NAME) foot - Wayland (SYNOPSIS) foot [OPTIONS] foot [OPTIONS] [COMMAND OPTIONS] () ( ) . (DESCRIPTION) foot Wayland . . foot : foot htop (OPTIONS) -c,--config=PATH foot.ini(5) . spawn-terminal ( foot.ini(5) ). -C,--check-config 0 230 ( (EXIT STATUS) ). -o,--override=[SECTION.]KEY=VALUE . SECTION main . -f,--font=FONT fontconfig ( FONT FORMAT ). . (fallback) . . fontconfig ( ) . : monospace. -w,--window-size-pixels=WIDTHxHEIGHT . : 700x500. -W,--window-size-chars=WIDTHxHEIGHT (). : . -t,--term=TERM TERM ( TERMINFO ENVIRONMENT ). : foot. -T,--title=TITLE . : foot. -a,--app-id=ID app-id Wayland . : foot ( ) footclient ( ). --class=ID --app-id. toplevel-tag=TAG toplevel-tag Wayland . . : -m,--maximized (). --maximized --fullscreen . -F,--fullscreen . --maximized --fullscreen . -L,--login-shell (login shell) '-' argv[0]. --pty pty . (VM) . -s,--server . -D,--working-directory=DIR . : CWD of foot ( foot). -s,--server[=PATH|FD] . foot () . footclient(1) . . ( ). (rendering threads) Wayland / (multiplex) . . . $XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock . $XDG_RUNTIME_DIR /tmp/foot.sock . $XDG_RUNTIME_DIR $WAYLAND_DISPLAY $XDG_RUNTIME_DIR/foot.sock . --server-socket footclient(1) . foot (file descriptor) ( systemd s6) . systemd (foot-server.{service,socket}) systemd . (socket activation) socket . foot --server systemd systemd $WAYLAND_DISPLAY systemctl --user import-environment WAYLAND_DISPLAY . -H,--hold . -p,--print-pid=FILE|FD PID FD . ( FD) PID . FILE (unlink) ..PP -s,--server . -d,--log-level={info,warning,error,none} stderr syslog . : warning. -l,--log-colorize=[{never,always,auto}] stderr . : auto. -S,--log-no-syslog syslog . stderr . -s,--server . -v,--version . -e xterm -e. -e xterm(1) . foot foot -e man foot xterm "invalid option" . (KEYBOARD SHORTCUTS) . foot.ini(5) . ( ) foot.ini(5) . (NORMAL MODE) shift+page up/page down / ctrl+shift+c, XF86Copy ctrl+shift+v, XF86Paste shift+insert (primary selection) ctrl+shift+r (scrollback) ctrl++, ctrl+= ctrl+- ctrl+0 ctrl+shift+n . OSC 7 . ctrl+shift+o URL << >> URL . ctrl+shift+u (Unicode). ctrl+shift+z (prompt) . (shell integration) . ctrl+shift+x (prompt) . (shell integration) . (SCROLLBACK SEARCH) : ctrl+r . . ctrl+s . . shift+right . shift+left . ctrl+w, ctrl+shift+right ( ) . ctrl+shift+w ctrl+w (whitespace) . ctrl+shift+left . shift+down shift+up . ctrl+v, ctrl+shift+v, ctrl+y, XF86Paste . shift+insert (primary selection) . escape, ctrl+g, ctrl+c return (primary selection). ctrl+shift+c . (scrollback-search) : ctrl+b . ctrl+left, alt+b ..PP ctrl+f . ctrl+right, alt+f . Home, ctrl+a . End, ctrl+e . alt+backspace, ctrl+backspace . alt+delete, ctrl+delete . ctrl+u ctrl+k scrollback-search : shift+page-up / . shift+page-down / . (URL MODE) t URL . escape, ctrl+g, ctrl+c, ctrl+d URL . (MOUSE SHORTCUTS) left, single-click primary . mouse tracking shift . ctrl . left, double-click ( ) . ctrl . left, triple-click . left, quad-click middle primary right . . ctrl+right . wheel / ctrl+wheel / tap . drag / . ( ) . (FONT FORMAT) FontConfig . (:) . : o Dina:weight=bold:slant=italic o Courier New:size=12 (URLs) foot URL . foot . ctrl+shift+o << URL>> << >> . ( "AF") . foot . show-urls-launch show-urls-copy foot.ini(5) . show-urls-launch xdg-open . url-launch . show-urls-copy show-urls-launch . . URL . ALT/META (ALT/META CHARACTERS) foot meta ESC . metaSendsEscape XTerm true . E[?1036l ( E[?1036h ). foot meta UTF-8 . eightBitMeta XTerm true . rmm ( E[?1034l) smm ( E[?1034h) . BACKSPACE (BACKSPACE) foot backspace DEL (^?) . backarrowKey XTerm false DECBKM . BS (^H) ctrl+backspace . foot DECBKM . alt ESC . (KEYPAD) Num Lock . numLock XTerm true . ( Num Lock) ( page up page down ) . E[?1035l ( E[?1035h ). (application) . (CONFIGURATION) foot : o XDG_CONFIG_HOME/foot/foot.ini ( $HOME/.config/foot/foot.ini) o XDG_CONFIG_DIRS/foot/foot.ini ( /etc/xdg/foot/foot.ini) /etc/xdg/foot/foot.ini . foot.ini(5) . foot ( ctrl+shift+n ) <<>> . OSC-7 . . : (https://codeberg.org/dnkl/foot/wiki#user-content-spawning-new-terminal-instances-in-the-current-working-directory) Foot ( ctrl+shift+z/x ). OSC-133;A (\E]133;A\E\\) . zsh precmd : precmd() { print -Pn "\e]133;A\e\\" } : (https://codeberg.org/dnkl/foot/wiki#user-content-jumping-between-prompts) pipe-command-output (pipe) ( pipe-*): [key-bindings] pipe-command-output=[sh -c "f=$(mktemp); cat - > $f; footclient emacsclient -nw $f; rm $f"] Control+Shift+g ctrl+shift+g emacsclient footclient . footclient . OSC-133;C (\E]133;C\E\\) OSC-133;D (\E]133;D\E\\) . fish preexec postexec : function foot_cmd_start --on-event fish_preexec echo -en "\e]133;C\e\\" end function foot_cmd_end --on-event fish_postexec echo -en "\e]133;D\e\\" end : (https://codeberg.org/dnkl/foot/wiki#user-content-piping-last-commands-output) (TERMINFO) terminfo TERM ( foot ) . Foot terminfo : foot foot-direct foot . foot foot-direct ( truecolor) . terminfo foot RGB . foot ( ). terminfo *-direct ncurses . terminfo *-direct . Emacs . foot foot-direct xterm-256color . terminfo foot . terminfo . (root) terminfo foot foot foot-direct ~/.terminfo/f/ terminfo foot . XTGETTCAP XTGETTCAP XTerm Kitty ( ) . terminfo . terminfo foot SSH . XTerm ( XTerm-370 ) ( ) : o TN - o Co - ( colors) o RGB - ( RGB terminfo !) Kitty . Foot (boolean) . terminfo foot XTGETTCAP . Kitty foot XTerm . XTerm DCS / ; . : o / () . o XTerm XTGETTCAP . o XTerm . . . Kitty foot DCS . / . . foot 230 . ( ) . (ENVIRONMENT) foot SHELL command shell foot.ini(5) . HOME foot.ini(5) . XDG_CONFIG_HOME foot.ini(5) . XDG_CONFIG_DIRS foot.ini(5) . XDG_RUNTIME_DIR PATH --server ( ). WAYLAND_DISPLAY PATH --server ( ). XCURSOR_THEME Xcursor(3) ( Wayland ). XCURSOR_SIZE Xcursor(3) ( Wayland ). TERM terminfo/termcap. . --term term foot.ini(5) . COLORTERM truecolor 24-bit RGB . PWD ( foot) SHELL ( /etc/shells ). foot.ini(5) . ** TERM_PROGRAM TERM_PROGRAM_VERSION . (unset) foot . foot.ini(5) . (SIGNALS) foot : o SIGUSR1: ([colors-dark]). o SIGUSR2: ([colors-light]). : SIGUSR1/SIGUSR2 foot --server . . SIGUSR1/SIGUSR2 footclient footclient(1) . https://codeberg.org/dnkl/foot/issues . ( ) . . : o Foot (foot --version). o foot ( foot -d info ). o Wayland ( ) . o (crash) backtrace (bt full) . o . . IRC #foot irc.libera.chat (SEE ALSO) foot.ini(5), footclient(1) 2026-09-03 foot(1)