OS Manuals

/usr/bin/footclient

A fast, lightweight and minimalistic Wayland terminal emulator

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

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

Options:
  -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
  -w,--window-size-pixels=WIDTHxHEIGHT     initial width and height, in pixels
  -W,--window-size-chars=WIDTHxHEIGHT      initial width and height, in characters
  -m,--maximized                           start in maximized mode
  -F,--fullscreen                          start in fullscreen mode
  -L,--login-shell                         start shell as a login shell
  -D,--working-directory=DIR               directory to start in (CWD)
  -s,--server-socket=PATH                  path to the server UNIX domain socket (default=$XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock)
  -H,--hold                                remain open after child process exits
  -N,--no-wait                             detach the client process from the running terminal, exiting immediately
  -o,--override=[section.]key=value        override configuration option
  -E, --client-environment                 exec shell using footclient's environment, instead of the server's
  -d,--log-level={info|warning|error|none} log level (warning)
  -l,--log-colorize=[{never|always|auto}]  enable/disable colorization of log output on stderr
  -v,--version                             show the version number and quit
  -e                                       ignored (for compatibility with xterm -e)
Options (20)
OptionDescriptionSource
-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
-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
-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
-D, --working-directory DIRInitial working directory for the client application.help + man
-s, --server-socket PATHpath to the server UNIX domain socket (default=$XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.sock)help + man
-H, --holdRemain open after child process exits.help + man
-N, --no-waitDetach the client process from the running terminal, exiting immediately.help + man
-o, --override section.]key=valueOverride an option set in the configuration file.help + man
-E, --client-environmentThe child process in the new terminal instance will use footclient's environment, instead of the server's.help + man
-l, --log-colorize never|always|autoEnables or disables colorization of log output on stderr.help + man
-v, --versionshow the version number and quithelp + 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
220there is a failure in footclient itself (for example

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