poezio/doc/en/keys.txt

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 that 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 tab number x.

*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 (highlight = private message > message > non-empty input).

*Alt-z*:: Go to the previous tab.

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

*F7*:: Shrink the information buffer.

*F8*:: Grow the information buffer.

*Ctrl-l*:: Refresh the screen.

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

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

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

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*:: Likfe Page Up, but down.

*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.

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

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

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.

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.

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

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

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.


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 keys

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