OS Manuals

/usr/bin/foot

A fast, lightweight and minimalistic Wayland terminal emulator

From foot 1.28.0-r4 (enterprise-packages), captured 2026-11-08 by running foot --help (exit 0). permalink

Usage: /usr/bin/foot [OPTIONS...]
Usage: /usr/bin/foot [OPTIONS...] command [ARGS...]

Options:
  -c,--config=PATH                         load configuration from PATH ($XDG_CONFIG_HOME/foot/foot.ini)
  -C,--check-config                        verify configuration, exit with 0 if ok, otherwise exit with 1
  -o,--override=[section.]key=value        override configuration option
  -f,--font=FONT                           comma separated list of fonts in fontconfig format (monospace)
  -t,--term=TERM                           value to set the environment variable TERM to (foot)
  -T,--title=TITLE                         initial window title (foot)
  -a,--app-id=ID                           window application ID (foot)
     --toplevel-tag=TAG                    set a custom toplevel tag
  -m,--maximized                           start in maximized mode
  -F,--fullscreen                          start in fullscreen mode
  -L,--login-shell                         start shell as a login shell
  --pty=PATH                               display an existing PTY instead of creating one
  -D,--working-directory=DIR               directory to start in (CWD)
  -w,--window-size-pixels=WIDTHxHEIGHT     initial width and height, in pixels
  -W,--window-size-chars=WIDTHxHEIGHT      initial width and height, in characters
  -s,--server[=PATH]                       run as a server (use 'footclient' to start terminals).
                                           Without PATH, $XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock will be used.
  -H,--hold                                remain open after child process exits
  -p,--print-pid=FILE|FD                   print PID to file or FD (only applicable in server mode)
  -d,--log-level={info|warning|error|none} log level (warning)
  -l,--log-colorize=[{never|always|auto}]  enable/disable colorization of log output on stderr
  -S,--log-no-syslog                       disable syslog logging (only applicable in server mode)
  -v,--version                             show the version number and quit
  -e                                       ignored (for compatibility with xterm -e)
Options (24)
OptionDescriptionSource
-c, --config PATHload configuration from PATH ($XDG_CONFIG_HOME/foot/foot.ini)help + man
-C, --check-configVerify configuration and then exit with 0 if ok, otherwise exit with 230 (see EXIT STATUS).help + man
-o, --override section.]key=valueOverride an option set in the configuration file.help + man
-f, --font FONTComma separated list of fonts to use, in fontconfig format (see FONT FORMAT).help + man
-t, --term TERMValue to set the environment variable TERM to (see TERMINFO and ENVIRONMENT).help + man
-T, --title TITLEinitial window title (foot)help + man
-a, --app-id IDValue to set the app-id property on the Wayland window to.help + man
--toplevel-tag TAGset a custom toplevel taghelp
-m, --maximizedStart in maximized mode.help + man
-F, --fullscreenStart in fullscreen mode.help + man
-L, --login-shellStart a login shell, by prepending a '-' to argv[0].help + man
--pty PATHDisplay an existing pty instead of creating one.help + man
-D, --working-directory DIRInitial working directory for the client application.help + man
-w, --window-size-pixels WIDTHxHEIGHTSet initial window width and height, in pixels.help + man
-W, --window-size-chars WIDTHxHEIGHTSet initial window width and height, in characters.help + man
-s, --server PATHrun as a server (use 'footclient' to start terminals).help + man
-H, --holdRemain open after child process exits.help + man
-p, --print-pid FILE|FDPrint PID to this file, or FD, when successfully started.help + man
-l, --log-colorize never|always|autoEnables or disables colorization of log output on stderr.help + man
-S, --log-no-syslogdisable syslog logging (only applicable in server mode)help + man
-v, --versionShow the version number and quit.help + man
-eignored (for compatibility with xterm -e)help + man
--class IDAlias for --app-id. (in the manual page but not in --help)man
-d, --log-level infoLog level, used both for log output on stderr as well as syslog. (in the manual page but not in --help)man
Exit status (1) from the manual page
230there is a failure in foot itself

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.