.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "foot" "1" "2024-04-26"
.PP
.SH NAME
.PP
foot - Wayland terminal emulator
.PP
.SH SYNOPSIS
.PP
\fBfoot\fR [\fIOPTIONS\fR]
.br
\fBfoot\fR [\fIOPTIONS\fR] <\fIcommand\fR> [\fICOMMAND OPTIONS\fR]
.PP
All trailing (non-option) arguments are treated as a command, and its
arguments, to execute (instead of the default shell).\&
.PP
.SH DESCRIPTION
.PP
\fBfoot\fR is a Wayland terminal emulator.\& Running it without arguments
will start a new terminal window with your default shell.\&
.PP
You can override the default shell by appending a custom command to
the foot command line
.PP
.RS 4
\fBfoot sh -c "echo hello world && sleep 5"\fR
.PP
.RE
.SH OPTIONS
.PP
\fB-c\fR,\fB--config\fR=\fIPATH\fR
.RS 4
Path to configuration file, see \fBfoot.\&ini\fR(5) for details.\&
.PP
.RE
\fB-C\fR,\fB--check-config\fR
.RS 4
Verify configuration and then exit with 0 if ok, otherwise exit
with 230 (see \fBEXIT STATUS\fR).\&
.PP
.RE
\fB-o\fR,\fB--override\fR=[\fISECTION\fR.\&]\fIKEY\fR=\fIVALUE\fR
.RS 4
Override an option set in the configuration file.\& If \fISECTION\fR is not
given, defaults to \fImain\fR.\&
.PP
.RE
\fB-f\fR,\fB--font\fR=\fIFONT\fR
.RS 4
Comma separated list of fonts to use, in fontconfig format (see
\fBFONT FORMAT\fR).\&
.PP
The first font is the primary font.\& The remaining fonts are
fallback fonts that will be used whenever a glyph cannot be found
in the primary font.\&
.PP
The fallback fonts are searched in the order they appear.\& If a
glyph cannot be found in any of the fallback fonts, the dynamic
fallback list from fontconfig (for the primary font) is
searched.\&
.PP
Default: \fImonospace\fR.\&
.PP
.RE
\fB-w\fR,\fB--window-size-pixels\fR=\fIWIDTHxHEIGHT\fR
.RS 4
Set initial window width and height, in pixels.\& Default: \fI700x500\fR.\&
.PP
.RE
\fB-W\fR,\fB--window-size-chars\fR=\fIWIDTHxHEIGHT\fR
.RS 4
Set initial window width and height, in characters.\& Default: \fInot set\fR.\&
.PP
.RE
\fB-t\fR,\fB--term\fR=\fITERM\fR
.RS 4
Value to set the environment variable \fBTERM\fR to (see \fBTERMINFO\fR
and \fBENVIRONMENT\fR).\& Default: \fIfoot\fR.\&
.PP
.RE
\fB-T\fR,\fB--title\fR=\fITITLE\fR
.RS 4
Initial window title.\& Default: \fIfoot\fR.\&
.PP
.RE
\fB-a\fR,\fB--app-id\fR=\fIID\fR
.RS 4
Value to set the \fBapp-id\fR property on the Wayland window
to.\& Default: \fIfoot\fR (normal mode), or \fIfootclient\fR (server mode).\&
.PP
.RE
\fB-m\fR,\fB--maximized\fR
.RS 4
Start in maximized mode.\& If both \fB--maximized\fR and \fB--fullscreen\fR
are specified, the \fIlast\fR one takes precedence.\&
.PP
.RE
\fB-F\fR,\fB--fullscreen\fR
.RS 4
Start in fullscreen mode.\& If both \fB--maximized\fR and \fB--fullscreen\fR
are specified, the \fIlast\fR one takes precedence.\&
.PP
.RE
\fB-L\fR,\fB--login-shell\fR
.RS 4
Start a login shell, by prepending a '\&-'\& to argv[0].\&
.PP
.RE
\fB--pty\fR
.RS 4
Display an existing pty instead of creating one.\& This is useful
for interacting with VM consoles.\&
.PP
This option is not currently supported in combination with
\fB-s\fR,\fB--server\fR.\&
.PP
.RE
\fB-D\fR,\fB--working-directory\fR=\fIDIR\fR
.RS 4
Initial working directory for the client application.\& Default:
\fICWD of foot\fR.\&
.PP
.RE
\fB-s\fR,\fB--server\fR[=\fIPATH\fR|\fIFD\fR]
.RS 4
Run as a server.\& In this mode, a single foot instance hosts
multiple terminals (windows).\& Use \fBfootclient\fR(1) to launch new
terminals.\&
.PP
This saves some memory since for example fonts and glyph caches
can be shared between the terminals.\&
.PP
It also saves upstart time since the config has already been
loaded and parsed, and most importantly, fonts have already been
loaded (and their glyph caches are likely to already have been
populated).\&
.PP
Each terminal will have its own rendering threads, but all Wayland
communication, as well as input/output to the shell, is
multiplexed in the main thread.\& Thus, this mode might result in
slightly worse performance when multiple terminals are under heavy
load.\&
.PP
Also be aware that should one terminal crash, it will take all the
others with it.\&
.PP
The default path is
\fB$XDG_RUNTIME_DIR/foot-$WAYLAND_DISPLAY.\&sock\fR.\&
.PP
If \fB$XDG_RUNTIME_DIR\fR is not set, the default path is instead
\fB/tmp/foot.\&sock\fR.\&
.PP
If \fB$XDG_RUNTIME_DIR\fR is set, but \fB$WAYLAND_DISPLAY\fR is not,
the default path is \fB$XDG_RUNTIME_DIR/foot.\&sock\fR.\&
.PP
Note that if you change the default, you will also need to use the
\fB--server-socket\fR option in \fBfootclient\fR(1) and point it to your
custom socket path.\&
.PP
If the argument is a number, foot will interpret it as the file descriptor
of a socket provided by a supervision daemon (such as systemd or s6), and
use that socket as it'\&s own.\&
.PP
Two systemd units (foot-server.\&{service,socket}) are provided to use that
feature with systemd.\& To use socket activation, only enable the
socket unit.\&
.PP
Note that starting \fBfoot --server\fR as a systemd service will use
the environment of the systemd user instance; thus, you'\&ll need
to import \fB$WAYLAND_DISPLAY\fR in it using \fBsystemctl --user
import-environment WAYLAND_DISPLAY\fR.\&
.PP
.RE
\fB-H\fR,\fB--hold\fR
.RS 4
Remain open after child process exits.\&
.PP
.RE
\fB-p\fR,\fB--print-pid\fR=\fIFILE\fR|\fIFD\fR
.RS 4
Print PID to this file, or FD, when successfully started.\& The file
(or FD) is closed immediately after writing the PID.\& When a \fIFILE\fR
as been specified, the file is unlinked at exit.\&
.PP
This option can only be used in combination with \fB-s\fR,\fB--server\fR.\&
.PP
.RE
\fB-d\fR,\fB--log-level\fR={\fBinfo\fR,\fBwarning\fR,\fBerror\fR,\fBnone\fR}
.RS 4
Log level, used both for log output on stderr as well as
syslog.\& Default: \fIwarning\fR.\&
.PP
.RE
\fB-l\fR,\fB--log-colorize\fR=[{\fBnever\fR,\fBalways\fR,\fBauto\fR}]
.RS 4
Enables or disables colorization of log output on stderr.\& Default:
\fIauto\fR.\&
.PP
.RE
\fB-S\fR,\fB--log-no-syslog\fR
.RS 4
Disables syslog logging.\& Logging is only done on stderr.\& This
option can only be used in combination with \fB-s\fR,\fB--server\fR.\&
.PP
.RE
\fB-v\fR,\fB--version\fR
.RS 4
Show the version number and quit.\&
.PP
.RE
\fB-e\fR
.RS 4
Ignored; for compatibility with \fBxterm -e\fR.\&
.PP
This option was added in response to several program launchers
passing \fB-e\fR to arbitrary terminals, under the assumption that
they all implement the same semantics for it as \fBxterm\fR(1).\&
Ignoring it allows foot to be invoked as e.\&g.\& \fBfoot -e man foot\fR
with the same results as with xterm, instead of producing an
"invalid option" error.\&
.PP
.RE
.SH KEYBOARD SHORTCUTS
.PP
The following keyboard shortcuts are available by default.\& They can be
changed in \fBfoot.\&ini\fR(5).\& There are also more actions (disabled by
default) available; see \fBfoot.\&ini\fR(5).\&
.PP
.SS NORMAL MODE
.PP
\fBshift\fR+\fBpage up\fR/\fBpage down\fR
.RS 4
Scroll up/down in history
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBc\fR, \fBXF86Copy\fR
.RS 4
Copy selected text to the \fIclipboard\fR
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBv\fR, \fBXF86Paste\fR
.RS 4
Paste from \fIclipboard\fR
.PP
.RE
\fBshift\fR+\fBinsert\fR
.RS 4
Paste from the \fIprimary selection\fR
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBr\fR
.RS 4
Start a scrollback search
.PP
.RE
\fBctrl\fR+\fB+\fR, \fBctrl\fR+\fB=\fR
.RS 4
Increase font size
.PP
.RE
\fBctrl\fR+\fB-\fR
.RS 4
Decrease font size
.PP
.RE
\fBctrl\fR+\fB0\fR
.RS 4
Reset font size
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBn\fR
.RS 4
Spawn a new terminal.\& If the shell has been configured to emit the
\fIOSC 7\fR escape sequence, the new terminal will start in the
current working directory.\&
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBo\fR
.RS 4
Activate URL mode, allowing you to "launch" URLs.\&
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBu\fR
.RS 4
Activate Unicode input.\&
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBz\fR
.RS 4
Jump to the previous, currently not visible, prompt.\& Requires
shell integration.\&
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBx\fR
.RS 4
Jump to the next prompt.\& Requires shell integration.\&
.PP
.RE
.SS SCROLLBACK SEARCH
.PP
\fBctrl\fR+\fBr\fR
.RS 4
Search \fIbackward\fR for the next match.\& If the search string is
empty, the last searched-for string is used.\&
.PP
.RE
\fBctrl\fR+\fBs\fR
.RS 4
Search \fIforward\fR for the next match.\& If the search string is
empty, the last searched-for string is used.\&
.PP
.RE
\fBctrl\fR+\fBw\fR
.RS 4
Extend current selection (and thus the search criteria) to the end
of the word, or the next word if currently at a word separating
character.\&
.PP
.RE
\fBctrl\fR+\fBshift\fR+\fBw\fR
.RS 4
Same as \fBctrl\fR+\fBw\fR, except that the only word separating
characters are whitespace characters.\&
.PP
.RE
\fBctrl\fR+\fBv\fR, \fBctrl\fR+\fBshift\fR+\fBv\fR, \fBctrl\fR+\fBy\fR, \fBXF86Paste\fR
.RS 4
Paste from clipboard into the search buffer.\&
.PP
.RE
\fBshift\fR+\fBinsert\fR
.RS 4
Paste from primary selection into the search buffer.\&
.PP
.RE
\fBescape\fR, \fBctrl\fR+\fBg\fR, \fBctrl\fR+\fBc\fR
.RS 4
Cancel the search
.PP
.RE
\fBreturn\fR
.RS 4
Finish the search and copy the current match to the primary
selection.\& The terminal selection is kept, allowing you to press
\fBctrl\fR+\fBshift\fR+\fBc\fR to copy it to the clipboard.\&
.PP
.RE
.SS URL MODE
.PP
\fBt\fR
.RS 4
Toggle URL visibility in jump label.\&
.PP
.RE
\fBescape\fR, \fBctrl\fR+\fBg\fR, \fBctrl\fR+\fBc\fR, \fBctrl\fR+\fBd\fR
.RS 4
Exit URL mode without launching a URL.\&
.PP
.RE
.SS MOUSE SHORTCUTS
.PP
\fBleft\fR, single-click
.RS 4
Drag to select; when released, the selected text is copied to the
\fIprimary\fR selection.\& This feature is normally \fBdisabled\fR whenever
the client has enabled \fImouse tracking\fR, but can be forced by
holding \fBshift\fR.\&
.PP
Holding \fBctrl\fR will create a block selection.\&
.PP
.RE
\fBleft\fR, double-click
.RS 4
Selects the \fIword\fR (separated by spaces, period, comma,
parenthesis etc) under the pointer.\& Hold \fBctrl\fR to select
everything under the pointer up to, and until, the next space
characters.\&
.PP
.RE
\fBleft\fR, triple-click
.RS 4
Selects the everything between enclosing quotes, or the entire row
if not inside a quote.\&
.PP
.RE
\fBleft\fR, quad-click
.RS 4
Selects the entire row
.PP
.RE
\fBmiddle\fR
.RS 4
Paste from the \fIprimary\fR selection
.PP
.RE
\fBright\fR
.RS 4
Extend current selection.\& Clicking immediately extends the
selection, while hold-and-drag allows you to interactively resize
the selection.\&
.PP
.RE
\fBctrl\fR+\fBright\fR
.RS 4
Extend the current selection, but force it to be character wise,
rather than depending on the original selection mode.\&
.PP
.RE
\fBwheel\fR
.RS 4
Scroll up/down in history
.PP
.RE
\fBctrl\fR+\fBwheel\fR
.RS 4
Increase/decrease font size
.PP
.RE
.SS TOUCHSCREEN
.PP
\fBtap\fR
.RS 4
Emulates mouse left button click.\&
.PP
.RE
\fBdrag\fR
.RS 4
Scrolls up/down in history.\&
.PP
Holding for a while before dragging (time delay can be configured)
emulates mouse dragging with left button held.\&
.PP
.PP
.RE
.SH FONT FORMAT
.PP
The font is specified in FontConfig syntax.\& That is, a colon-separated
list of font name and font options.\&
.PP
\fIExamples\fR:
.PD 0
.IP \(bu 4
Dina:weight=bold:slant=italic
.IP \(bu 4
Courier New:size=12
.PD
.PP
.SH URLs
.PP
Foot supports URL detection.\& But, unlike many other terminal
emulators, where URLs are highlighted when they are hovered and opened
by clicking on them, foot uses a keyboard driven approach.\&
.PP
Pressing \fBctrl\fR+\fBshift\fR+\fBo\fR enters \fI"Open URL mode"\fR, where all currently
visible URLs are underlined, and is associated with a
\fI"jump-label"\fR.\& The jump-label indicates the \fIkey sequence\fR
(e.\&g.\& \fB"AF"\fR) to use to activate the URL.\&
.PP
The key binding can, of course, be customized, like all other key
bindings in foot.\& See \fBshow-urls-launch\fR and \fBshow-urls-copy\fR in
\fBfoot.\&ini\fR(5).\&
.PP
\fBshow-urls-launch\fR by default opens the URL with \fBxdg-open\fR.\& This can
be changed with the \fBurl-launch\fR option.\&
.PP
\fBshow-urls-copy\fR is an alternative to \fBshow-urls-launch\fR, that changes
what activating a URL \fIdoes\fR; instead of opening it, it copies it to
the clipboard.\& It is unbound by default.\&
.PP
Jump label colors, the URL underline color, and the letters used in
the jump label key sequences can be configured.\&
.PP
.SH ALT/META CHARACTERS
.PP
By default, foot prefixes meta characters with \fBESC\fR.\& This corresponds
to XTerm'\&s \fBmetaSendsEscape\fR option set to \fBtrue\fR.\&
.PP
This can be disabled programmatically with \fBE[?\&1036l\fR (and enabled
again with \fBE[?\&1036h\fR).\&
.PP
When disabled, foot will instead set the 8:th bit of meta character
and then UTF-8 encode it.\& This corresponds to XTerm'\&s \fBeightBitMeta\fR
option set to \fBtrue\fR.\&
.PP
This can also be disabled programmatically with \fBrmm\fR (Reset Meta Mode,
\fBE[?\&1034l\fR), and enabled again with \fBsmm\fR (Set Meta Mode,
\fBE[?\&1034h\fR).\&
.PP
.SH BACKSPACE
.PP
Foot transmits DEL (\fB^?\&\fR) on backspace.\& This corresponds to XTerm'\&s
\fBbackarrowKey\fR option set to \fBfalse\fR, and to DECBKM being \fIreset\fR.\&
.PP
To instead transmit BS (\fB^H\fR), press \fBctrl\fR+\fBbackspace\fR.\&
.PP
Note that foot does \fBnot\fR implement DECBKM, and that the behavior
described above \fBcannot\fR be changed.\&
.PP
Finally, pressing \fBalt\fR will prefix the transmitted byte with ESC.\&
.PP
.SH KEYPAD
.PP
By default, \fBNum Lock\fR overrides the run-time configuration keypad
mode; when active, the keypad is always considered to be in
\fInumerical\fR mode.\& This corresponds to XTerm'\&s \fBnumLock\fR option set to
\fBtrue\fR.\&
.PP
In this mode, the keypad keys always sends either numbers (Num Lock is
active) or cursor movement keys (up, down, left, right, page up, page
down etc).\&
.PP
This can be disabled programmatically with \fBE[?\&1035l\fR (and enabled
again with \fBE[?\&1035h\fR).\&
.PP
When disabled, the keypad sends custom escape sequences instead of
numbers, when in \fIapplication\fR mode.\&
.PP
.SH CONFIGURATION
.PP
foot will search for a configuration file in the following locations,
in this order:
.PP
.RS 4
.PD 0
.IP \(bu 4
\fBXDG_CONFIG_HOME/foot/foot.\&ini\fR (defaulting to
\fB$HOME/.\&config/foot/foot.\&ini\fR if unset)
.IP \(bu 4
\fBXDG_CONFIG_DIRS/foot/foot.\&ini\fR (defaulting to
\fB/etc/xdg/foot/foot.\&ini\fR if unset)
.PD
.PP
.RE
An example configuration file containing all options with their default value
commented out will usually be installed to \fB/etc/xdg/foot/foot.\&ini\fR.\&
.PP
For more information, see \fBfoot.\&ini\fR(5).\&
.PP
.SH SHELL INTEGRATION
.PP
.SS Current working directory
.PP
New foot terminal instances (bound to \fBctrl\fR+\fBshift\fR+\fBn\fR by default)
will open in the current working directory, if the shell in the
"parent" terminal reports directory changes.\&
.PP
This is done with the OSC-7 escape sequence.\& Most shells can be
scripted to do this, if they do not support it natively.\& See the wiki
(https://codeberg.\&org/dnkl/foot/wiki#user-content-spawning-new-terminal-instances-in-the-current-working-directory)
for details.\&
.PP
.PP
.SS Jumping between prompts
.PP
Foot can move the current viewport to focus prompts of already
executed commands (bound to \fBctrl\fR+\fBshift\fR+\fBz\fR/\fBx\fR by default).\&
.PP
For this to work, the shell needs to emit an OSC-133;A
(\fB\eE]133;A\eE\e\e\fR) sequence before each prompt.\&
.PP
In zsh, one way to do this is to add a \fIprecmd\fR hook:
.PP
.RS 4
\fBprecmd() {
.RS 4
print -Pn "\ee]133;A\ee\e\e"
.RE
}\fR
.PP
.RE
See the wiki
(https://codeberg.\&org/dnkl/foot/wiki#user-content-jumping-between-prompts)
for details, and examples for other shells.\&
.PP
.SS Piping last command's output
.PP
The key binding \fBpipe-command-output\fR can pipe the last command'\&s
output to an application of your choice (similar to the other
\fBpipe-*\fR key bindings):
.PP
.RS 4
\fB[key-bindings]
.br
pipe-command-output=[sh -c "f=$(mktemp); cat - > $f; footclient emacsclient -nw $f; rm $f"] Control+Shift+g\fR
.PP
.RE
When pressing \fBctrl\fR+\fBshift\fR+\fBg\fR, the last command'\&s output is written
to a temporary file, then an emacsclient is started in a new
footclient instance.\& The temporary file is removed after the
footclient instance has closed.\&
.PP
For this to work, the shell must emit an OSC-133;C (\fB\eE]133;C\eE\e\e\fR)
sequence before command output starts, and an OSC-133;D
(\fB\eE]133;D\eE\e\e\fR) when the command output ends.\&
.PP
In fish, one way to do this is to add \fIpreexec\fR and \fIpostexec\fR hooks:
.PP
.RS 4
\fBfunction foot_cmd_start --on-event fish_preexec
.RS 4
echo -en "\ee]133;C\ee\e\e"
.RE
end\fR
.PP
\fBfunction foot_cmd_end --on-event fish_postexec
.RS 4
echo -en "\ee]133;D\ee\e\e"
.RE
end\fR
.PP
.RE
See the wiki
(https://codeberg.\&org/dnkl/foot/wiki#user-content-piping-last-commands-output)
for details, and examples for other shells
.PP
.SH TERMINFO
.PP
Client applications use the terminfo identifier specified by the
environment variable \fBTERM\fR (set by foot) to determine terminal
capabilities.\&
.PP
Foot has two terminfo definitions: \fBfoot\fR and \fBfoot-direct\fR, with
\fBfoot\fR being the default.\&
.PP
The difference between the two is in the number of colors they
describe; \fBfoot\fR describes 256 colors and \fBfoot-direct\fR 16.\&7 million
colors (24-bit truecolor).\&
.PP
Note that using the \fBfoot\fR terminfo does not limit the number of
usable colors to 256; applications can still use 24-bit RGB colors.\& In
fact, most applications work best with \fBfoot\fR (including 24-bit
colors).\& Using \fB*-direct\fR terminfo entries has been known to crash
some ncurses applications even.\&
.PP
There are however applications that need a \fB*-direct\fR terminfo entry
for 24-bit support.\& Emacs is one such example.\&
.PP
While using either \fBfoot\fR or \fBfoot-direct\fR is strongly recommended, it
is possible to use e.\&g.\& \fBxterm-256color\fR as well.\& This can be useful
when remoting to a system where foot'\&s terminfo entries cannot easily
be installed.\&
.PP
Note that terminfo entries can be installed in the user'\&s home
directory.\& I.\&e.\& if you do not have root access, or if there is no
distro package for foot'\&s terminfo entries, you can install foot'\&s
terminfo entries manually, by copying \fBfoot\fR and \fBfoot-direct\fR to
\fB~/.\&terminfo/f/\fR.\&
.PP
.SH XTGETTCAP
.PP
\fBXTGETTCAP\fR is an escape sequence initially introduced by XTerm, and
also implemented (and extended, to some degree) by Kitty.\&
.PP
It allows querying the terminal for terminfo classic, file-based,
terminfo definition.\& For example, if all applications used this
feature, you would no longer have to install foot'\&s terminfo on remote
hosts you SSH into.\&
.PP
XTerm'\&s implementation (as of XTerm-370) only supports querying key
(as in keyboard keys) capabilities, and three custom capabilities:
.PP
.PD 0
.IP \(bu 4
TN - terminal name
.IP \(bu 4
Co -  number of colors (alias for the colors capability)
.IP \(bu 4
RGB - number of bits per color channel (different semantics from
the RGB capability in file-based terminfo definitions!\&).\&
.PD
.PP
Kitty has extended this, and also supports querying all integer and
string capabilities.\&
.PP
Foot supports this, and extends it even further, to also include
boolean capabilities.\& This means foot'\&s entire terminfo can be queried
via \fBXTGETTCAP\fR.\&
.PP
Note that both Kitty and foot handles responses to multi-capability
queries slightly differently, compared to XTerm.\&
.PP
XTerm will send a single DCS reply, with ;-separated
capability/value pairs.\& There are a couple of issues with this:
.PP
.PD 0
.IP \(bu 4
The success/fail flag in the beginning of the response is always 1
(success), unless the very first queried capability is invalid.\&
.IP \(bu 4
XTerm will not respond at all to an invalid capability, unless it'\&s
the first one in the XTGETTCAP query.\&
.IP \(bu 4
XTerm will end the response at the first invalid capability.\&
.PD
.PP
In other words, if you send a large multi-capability query, you will
only get responses up to, but not including, the first invalid
capability.\& All subsequent capabilities will be dropped.\&
.PP
Kitty and foot on the other hand, send one DCS response for each
capability in the multi query.\& This allows us to send a proper
success/fail flag for each queried capability.\& Responses for all
queried capabilities are always sent.\& No queries are ever dropped.\&
.PP
.SH EXIT STATUS
.PP
Foot will exit with code 230 if there is a failure in foot itself.\&
.PP
In all other cases, the exit code is that of the client application
(i.\&e.\& the shell).\&
.PP
.SH ENVIRONMENT
.PP
.SS Variables used by foot
.PP
\fBSHELL\fR
.RS 4
The default child process to run, when no \fIcommand\fR argument is
specified and the \fBshell\fR option in \fBfoot.\&ini\fR(5) is not set.\&
.PP
.RE
\fBHOME\fR
.RS 4
Used to determine the location of the configuration file, see
\fBfoot.\&ini\fR(5) for details.\&
.PP
.RE
\fBXDG_CONFIG_HOME\fR
.RS 4
Used to determine the location of the configuration file, see
\fBfoot.\&ini\fR(5) for details.\&
.PP
.RE
\fBXDG_CONFIG_DIRS\fR
.RS 4
Used to determine the location of the configuration file, see
\fBfoot.\&ini\fR(5) for details.\&
.PP
.RE
\fBXDG_RUNTIME_DIR\fR
.RS 4
Used to construct the default \fIPATH\fR for the \fB--server\fR
option, when no explicit argument is given (see above).\&
.PP
.RE
\fBWAYLAND_DISPLAY\fR
.RS 4
Used to construct the default \fIPATH\fR for the \fB--server\fR
option, when no explicit argument is given (see above).\&
.PP
.RE
\fBXCURSOR_THEME\fR
.RS 4
The name of the \fBXcursor\fR(3) theme to use for pointers (typically
set by the Wayland compositor).\&
.PP
.RE
\fBXCURSOR_SIZE\fR
.RS 4
The size to use for \fBXcursor\fR(3) pointers (typically set by the
Wayland compositor).\&
.PP
.RE
.SS Variables set in the child process
.PP
\fBTERM\fR
.RS 4
terminfo/termcap identifier.\& This is used by client applications
to determine which capabilities a terminal supports.\& The value is
set according to either the \fB--term\fR command-line option or the
\fBterm\fR config option in \fBfoot.\&ini\fR(5).\&
.PP
.RE
\fBCOLORTERM\fR
.RS 4
This variable is set to \fBtruecolor\fR, to indicate to client
applications that 24-bit RGB colors are supported.\&
.PP
.RE
\fBPWD\fR
.RS 4
Current working directory (at the time of launching foot)
.PP
.RE
\fBSHELL\fR
.RS 4
Set to the launched shell, if the shell is valid (it is listed in
\fB/etc/shells\fR).\&
.PP
.RE
In addition to the variables listed above, custom environment
variables may be defined in \fBfoot.\&ini\fR(5).\&
.PP
.SS Variables *unset* in the child process
.PP
\fBTERM_PROGRAM\fR
\fBTERM_PROGRAM_VERSION\fR
.RS 4
These environment variables are set by certain other terminal
emulators.\& We unset them, to prevent applications from
misdetecting foot.\&
.PP
.RE
In addition to the variables listed above, custom environment
variables to unset may be defined in \fBfoot.\&ini\fR(5).\&
.PP
.SH BUGS
.PP
Please report bugs to https://codeberg.\&org/dnkl/foot/issues
.PP
Before you open a new issue, please search existing bug reports, both
open and closed ones.\& Chances are someone else has already reported
the same issue.\&
.PP
The report should contain the following:
.PP
.PD 0
.IP \(bu 4
Foot version (\fBfoot --version\fR).\&
.IP \(bu 4
Log output from foot (run \fBfoot -d info\fR from another terminal).\&
.IP \(bu 4
Which Wayland compositor (and version) you are running.\&
.IP \(bu 4
If reporting a crash, please try to provide a \fBbt full\fR backtrace
with symbols.\&
.IP \(bu 4
Steps to reproduce.\& The more details the better.\&
.PD
.PP
.SH IRC
.PP
#foot on irc.\&libera.\&chat
.PP
.SH SEE ALSO
.PP
\fBfoot.\&ini\fR(5), \fBfootclient\fR(1)