Poezio(1) Poezio(1)
NAME
Poezio - a ncurses jabber client written in python
SYNOPSIS
poezio [-f CONFIG_FILE] [-d DEBUG_FILE] [-h]
DESCRIPTION
Poezio is a console jabber (XMPP) client written in Python and using
ncurses to draw its interface. It aims at being similar to the most fa-
mous IRC clients, like weechat or irssi. Some keyboard shortcuts are
inspired from emacs. For more information on XMPP see http://xmpp.org
and on Poezio see https://poez.io
OPTIONS
-f, --file CONFIG_FILE
Run poezio using CONFIG_FILE as the config file instead of
~/.config/poezio/poezio.cfg.
-d, --debug DEBUG_FILE
Log debug from both poezio and slixmpp in DEBUG_FILE. Debug con-
tains incoming and outgoing stanzas in addition to various mes-
sage helping poezio's debugging.
-c, --check-config
Display the list of modified/unmodified config options, with
their changes from the default.
-h, --help
Display the poezio help message.
BASICS
The following sections will give you a short overview on how to use
poezio. Poezio has many more options, commands and key bindings, please
refer to poezio.cfg(7), poezio.commands(7), poezio.keys(7) or the full
documentation which should have been provided alongside the source
code, or check it online at https://doc.poez.io/.
A tab, in Poezio, is the base structure of the interface. A tab may
contains one or more windows, the main types are:
Roster tab
It contains a browsable list of your contacts on the left,
as well as an info window on the right.
Chatroom tab
This tab displays the contents of a multi-user chat.
Conversation tab
It is used for one-to-one communication, usually when us-
ing a real Jabber account.
KEY BINDINGS
While most of the keyboard shortcuts are common to all types of tabs,
some of them are tab-specific.
Text edition
These shortcuts work in any kind of tab; most of them are identical to
emacs' ones.
Ctrl+A Move the cursor to the beginning of the line.
Ctrl+E Move the cursor to the end of the line.
Ctrl+W Delete the word before the cursor.
Ctrl+K Delete the text from the cursor to the end of the line
and save it in the clipboard.
Ctrl+U Delete the text from the beginning of the line to the
cursor and save it in the clipboard.
Ctrl+Y Insert the text in the clipboard after the cursor.
Ctrl+D Delete the char after the cursor (same as the Suppr key)
Navigation keybindings
F5, Ctrl+N
Go to the previous tab.
F6, Ctrl+P
Go to the next tab.
Alt+<number>
Go to the specified tab (from 0 to 9)
Alt+J <two-digits-number>
Go to the specified tab (from 00 to 99)
Alt+Z Go to the last visited tab.
Alt+E Go to the next important tab (private message, high-
light, simple message)
F7 Decrease the information window size.
F8 Increase the information window size.
Alt+R Go to the roster.
Ctrl+L Redraw the screen.
Up, Down
Browse the history of the last messages or commands
you've entered.
Roster keybindings
o Hide or show the offline contacts.
s Search through your contact list.
Ctrl+G Cancel a search.
MUC-specific keybindings
Alt+V Move the line separator at the bottom of the text win-
dow.
Tab Complete the nickname that you're typing. If nothing has
been entered, insert the nickname of the last user who
spoke.
Alt+/ Complete the word that you're typing, based on the list
of the recently said words in the conversation.
COMMANDS
Most commands support tab completion, both for their names and for
their arguments. You can use the /help command to list all available
commands, and /help <command> for a complete description of <command>.
The following is a basic description of the most widely used commands;
you should refer to /help inside poezio for more documentation. <foo>
denotes a obligatory argument, while [bar] is an optional argument
(without argument, the /remove command, for example, acts on the cur-
rently selected contact)
Roster commands
/add <jid>
Add a JID to your roster.
/remove [jid]
Remove a contact from your roster.
/accept [jid]
Accept a JID that wants to subscribe to your presence.
/deny [jid]
The opposite of /accept.
MUC-specific commands
/kick <user>
Kick the specified user from the room.
/show <status> [message]
Change your status, and status message, in the current
room. You can use “avail”, “busy”, “away” and “xa” as your
status, followed by an optional message.
/ignore <user>
Ignore the specified user.
/topic [topic text]
View or change the topic of the room.
/query <user>
Talk privately with the specified participant.
/part
Leave the current room.
BUGS
Sure.
KNOWN ISSUES
If you're using a terminal multiplexer such as screen or tmux, it may
be setting $TERM to "screen", which breaks 256-color support. Consider
setting your $TERM to something like "screen-256color".
FEEDBACK
You are encouraged to report bugs or feature requests on
https://lab.louiz.org/poezio/poezio. You can also find us on the Jab-
ber chatroom xmpp:poezio@muc.poez.io?join
AUTHORS
Written by Florent Le Coz <louiz@louiz.org>
Later completed by Baptiste Jonglez <baptiste--poezio@jonglez.org>
Poezio dev team May 31, 2020 Poezio(1)
Generated by dwww version 1.15 on Tue Aug 26 09:40:29 CEST 2025.