summaryrefslogtreecommitdiff
path: root/doc/en/keys.txt
blob: 616468f5f1601e8d59a3029526b34dee18d195ad (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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
Keys
====

This file describes the default keys of poezio and explains how to
configure them.

By default, most keys manipulating the input (where you type your
messages and commands) behave like emacs does.

NOTE: keys are case sensitive. Ctrl-X is not the same than Ctrl-x


Key bindings listing
--------------------
Some key bindings are available only in some tabs, others are global.


Global keys
~~~~~~~~~~~
These keys work in *any* tab.

*Ctrl-n*:: Go to the next tab.

*Ctrl-p*:: Go to the previous tab.

*Alt-number*:: Go to the tab with that number.

*Alt-j*:: Waits for you to type a two-digits number. Go to tab number xx.

*Alt-e*:: Go to the tab with a higher priority (private message >
 highlight > message > non-empty input).

*Alt-z*:: Go to the previously selected tab.

*Alt-r*:: Go to the roster tab.

*F7*:: Shrink the information buffer.

*F8*:: Grow the information buffer.

*Ctrl-l*:: Refresh the screen.

*Alt-d*:: Scroll the information buffer up.

*Alt-c*:: Scroll the information buffer down.

Input keys
~~~~~~~~~~
These keys concern only the inputs.

NOTE: The clipboard is common to all inputs. This lets you cut a text
from one input to paste it into an other one.

*Ctrl-a*:: Move the cursor to the beginning of line.

*Ctrl-e*:: Move the cursor to the end of line.

*Ctrl-u*:: Delete the text from the start of the input until the cursor
 and save it to the clipboard.

*Ctrl-k*:: Delete the text from the cursor until the end of the input
 and save it to the clipboard.

*Ctrl-y*:: Insert the content of the clipboard at the cursor position.

*Ctrl-Enter*:: Insert a line break. Since the input is only one line,
 the line break is represented by the character _|_ in it but will be
 sent as the real _\n_ character.


Chat tab input keys
~~~~~~~~~~~~~~~~~~~~~
These keys work in any conversation tab (MultiUserChat, Private or
Conversation tabs).

*Key Up*:: Use the previous message from the message history.

*Key Down*:: Use the next message from the message history.

*Page Up*:: Scroll up in the conversation by x lines, where x is the
height of the conversation window - 1.

*Page Down*:: Like Page Up, but down.

*Ctrl-b*:: Go one line up in the buffer.

*Ctrl-f*:: Go one line down in the buffer.

*Alt-/*:: Complete what you’re typing using the "recent" words from the
 current conversation, if any.

*Alt-v*:: Move the separator at the bottom of the tab.


MultiUserChat tab input keys
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

These keys work only in the MultiUserChat tab.

*Alt-u*:: Scroll the user list down.

*Alt-y*:: Scroll the user list up.

*tabulation*:: Complete a nick.

*Ctrl-c*:: Insert xhtml formatting. You have to press Ctrl-c then a character
 listed below:
- 1: Red
- 2: Green
- 3: Yellow/Orange
- 4: Blue
- 5: Pink
- 6: Turquoise
- b: Bold
- o: Stop formatting


MultiUserChat List tab input keys
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
These keys work only in the MultiUserChat List tab (obtained with /list <server>).

*Up*:: Go up one row.

*Down*:: Go down one row.

*j*:: Join the MultiUserChat currently selected.

*J*:: Join the MultiUserChat currently selected, without giving focus to iuts tab.

*Ctrl-M*:: Join the MultiUserChat currently selected (same as "j").

*PageUp*:: Scroll a page of chats up.

*PageDown*:: Scroll a page of messages down.


Roster tab input keys
~~~~~~~~~~~~~~~~~~~~~

These keys work only in the Roster tab (the tab number 0).

*/*:: Open a prompt for commands.

*s*:: Start a search on the contacts.

*S*:: Start a (slow) search with approximation on the contacts.

*Alt-u*:: Move the cursor to the next group.

*Alt-y*:: Move the cursor to the previous group.

*Ctrl-c*:: Cancel the input (search or command)

NOTE: The following will not work if you can still write things in the
input (meaning you previously typed _s_ or _/_):

*Space*:: Fold/Unfold the current item.

*Up*:: Move the cursor down one contact.

*Down*:: Move the cursor up one contact.

*o*:: Show the offline contacts.

*PageUp*:: Scroll a page of contacts up.

*PageDown*:: Scroll a page of contacts down.


Data Forms tab keys
~~~~~~~~~~~~~~~~~~~
*Ctrl+y*:: Validate the form, send it and close the tab.

*Ctrl+g*:: Cancel that form (do not send your changes) and close the
 tab.

*Up*:: Select the next field.

*Down*:: Select the previous field.

*Right/Left*:: Switch between possible values, in a jid-multi,
 list-multi, list-single or text-multi field.

*Space*:: Select that option


MultiUserChat List tab input keys
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
These keys work only in the MultiUserChat List tab (obtained with /list
<server>).

*Up*:: Go up one row.

*Down*:: Go down one row.

*j*:: Join the MultiUserChat currently selected.

*J*:: Join the MultiUserChat currently selected, without giving focus to
 iuts tab.

*Ctrl-M*:: Join the MultiUserChat currently selected (same as _j_).


Key configuration
-----------------
Bindings are keyboard shortcut aliases. You can use them
to define your own keys to replace the default ones.
where _^x_ means _Control + x_
and _M-x_ means _Alt + x_

To know exactly what the code of a key is, just run
==================
python3 src/keyboard.py
==================
And enter any key.

.Turn Alt-i into a tab key (completion, etc)
==================
M-i = ^I
==================