aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 2a4f8822891541e1c542982d31162e3729f9e9ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
# foot

**foot** is a fast Wayland terminal emulator.


## Requirements

### Running

* fontconfig
* freetype
* pixman
* wayland (_client_ and _cursor_ libraries)
* xkbcommon


### Building

In addition to the dev variant of the packages above, you need:

* meson
* ninja
* wayland protocols
* ncurses
* scdoc


## Fonts

**foot** supports all fonts that can be loaded by freetype, including
**bitmap** fonts and **color emoji** fonts.

Foot uses its own font fallback mechanism, rather than relying on
fontconfig's fallback. This is because fontconfig is quite bad at
selecting fallback fonts suitable for a terminal (i.e. monospaced
fonts).

Instead, foot allows you to specify a font fallback list, where _each_
font can be configured independently (for example, you can configure
the size for each font individually).

If a glyph cannot be found in _any_ of the user configured fallback
fonts, _then_ fontconfig's list is used.


## Shortcuts

At the moment, all shortcuts are hard coded and cannot be changed. It
is **not** possible to define new key bindings.


### Keyboard

* <kbd>shift</kbd>+<kbd>page up</kbd>/<kbd>page down</kbd>

  Scroll up/down in history

* <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>c</kbd>

  Copy selected text to the _clipboard_

* <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>v</kbd>

  Paste from _clipboard_

* <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>r</kbd>

  Start a scrollback search

While doing a scrollback search, the following shortcuts are
available:

* <kbd>ctrl</kbd>+<kbd>r</kbd>

  Search for next match

* <kbd>escape</kbd>

  Cancel the search

* <kbd>ctrl</kbd>+<kbd>g</kbd>

  Cancel the search (same as `esc`)

* <kbd>return</kbd>

  Finish the search and put the current match to the primary selection

### Mouse

* <kbd>left</kbd> - **single-click**

  Drag to select; when released, the selected text is copied to the
  _primary_ selection. Note that this feature is normally disabled
  whenever the client has enabled mouse tracking, but can be forced by
  holding `shift`.

* <kbd>left</kbd> - **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 characters.

* <kbd>left</kbd> - **triple-click**

  Selects the entire row

* <kbd>middle</kbd>

  Paste from _primary_ selection