A fast, lightweight and minimalistic Wayland terminal emulator
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

164 lines
4.1 KiB

foot - Wayland terminal emulator
*foot* [_OPTIONS_]++
*foot* [_OPTIONS_] -- <_command_>
All trailing (non-option) arguments are treated as a command to
execute (instead of the shell).
Path to configuration file. Default: _XDG_RUNTIME_DIR/footrc_.
Comma separated list of fonts to use, in fontconfig format (see
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.
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
Default: _monospace_.
Set initial window width and height.
Value to set the environment variable _TERM_ to. Default: _foot_.
Run as a server. In this mode, a single foot instance hosts
multiple terminals (windows). Use *footclient*(1) to launch new
This saves some memory since for example fonts and glyph caches
can be shared between the terminals.
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
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
Also be aware that should one terminal crash, it will take all the
others with it.
You may optionally override the default socket path,
_XDG\_RUNTIME\_DIR/foot.sock_. If you do so, you will need to use
the *--server-socket* option in *footclient*(1).
Show the version number and quit.
*foot* is a Wayland terminal emulator. Running it without arguments
will start a new terminal window with your default shell.
You can override the default shell by appending a custom command to
the foot command line. To ensure foot does not touch the shell
arguments, use *--*:
foot -- sh -c "echo hello world && sleep 5"
The following keyboard shortcuts are available. Note that they cannot
be changed.
*shift*+*page up*/*page down*
Scroll up/down in history
Copy selected text to the _clipboard_
Paste from _clipboard_
Start a scrollback search
Search _backward_ for the next match
Search _forward_ for the next match
Extend current selection (and thus the search criteria) to the end
of the word, or the next word if currently at a word separating
Same as *ctrl*+*w*, except that the only word separating
characters are whitespace characters.
*escape*, *ctrl*+*g*
Cancel the search
Finish the search and copy the current match to the primary
selection. The terminal selection is kept, allowing you to press
*ctrl*+*shift*+*c* to copy it to the clipboard.
*left*, single-click
Drag to select; when released, the selected text is copied to the
_primary_ selection. This feature is normally *disabled* whenever
the client has enabled _mouse tracking_, but can be forced by
holding *shift*.
Holding *ctrl* will create a block selection.
*left*, double-click
Selects the _word_ (separated by spaces, period, comma,
parenthesis etc) under the pointer. Hold *ctrl* to select
everything under the pointer up to, and until, the next space
*left*, triple-click
Selects the entire row
Paste from the _primary_ selection
Scroll up/down in history
The font is specified in FontConfig syntax. That is, a colon-separated
list of font name and font options.
- Dina:weight=bold:slant=italic
- Courier New:size=12
See *foot*(5)
*foot*(5), *footclient*(1)