1Poezio(1) Poezio(1)
2
6 Poezio - a ncurses jabber client written in python3
7
9 poezio [-f CONFIG_FILE] [-d DEBUG_FILE] [-h]
10
12 Poezio is a console jabber (XMPP) client written in Python and using
13 ncurses to draw its interface. It aims at being similar to the most
14 famous IRC clients, like weechat or irssi. The keyboard shortcuts are
15 inspired from emacs. For more information on XMPP see http://xmpp.org
16 and on Poezio see https://poez.io
17
19 -f, --file CONFIG_FILE
20 Run poezio using CONFIG_FILE as the config file instead of
21 ~/.config/poezio/poezio.cfg
22 -d, --debug DEBUG_FILE
24 Log debug from both poezio and SleekXMPP in DEBUG_FILE. Debug
25 contains incoming and outgoing stanzas in addition to various
26 message helping poezio's debugging.
27 -h Display an help message
29
32 A tab, in Poezio, is the base structure of the interface. A tab may
33 contains one or more windows, and can be of different types:
34 Roster tab
36 It contains a list of your contacts on the left, as well
37 as an info window on the right.
38 MUC tab
40 MUC stands for "Multi-User Chat".
41 Conversation tab
43 It is used for one-to-one communication, usually when
44 using a real Jabber account.
45 Private tab
47 It is used to privately communicate with someone in a MUC.
48
51 While most of the keyboard shortcuts are common to all types of tabs,
52 some of them are tab-specific.
53 Text edition
55 These shortcuts work in any kind of tab; most of them are identical to
56 emacs' ones.
57 Ctrl+A Move the cursor to the beginning of the line.
59 Ctrl+E Move the cursor to the end of the line.
61 Ctrl+W Delete the word before the cursor.
63 Ctrl+K Delete the text from the cursor to the end of the line
65 and save it in the clipboard.
66 Ctrl+U Delete the text from the beginning of the line to the
68 cursor and save it in the clipboard.
69 Ctrl+Y Insert the text in the clipboard after the cursor.
71 Ctrl+D Delete the char after the cursor (same as the Suppr key)
73 Navigation keybindings
76 F5, Ctrl+N
77 Go to the previous tab.
78 F6, Ctrl+P
80 Go to the next tab.
81 Alt+<number>
83 Go to the specified tab (from 0 to 9)
84 Alt+J <two-digits-number>
86 Go to the specified tab (from 00 to 99)
87 Alt+Z Go to the last visited tab.
89 Alt+E Go to the next important tab (private message, high‐
91 light, simple message)
92 F7 Decrease the information window size.
94 F8 Increase the information window size.
96 Alt+R Go to the roster.
98 Ctrl+L Redraw the screen.
100 Up, Down
102 Browse the history of the last messages or commands
103 you've entered.
104 Roster keybindings
107 o Hide or show the offline contacts.
108 s Search through your contact list.
110 Ctrl+G Cancel a search.
112 MUC-specific keybindings
115 Alt+V Move the line separator at the bottom of the text win‐
116 dow.
117 Tab Complete the nickname that you're typing. If nothing has
119 been entered, insert the nickname of the last user who
120 spoke.
121 Alt+/ Complete the word that you're typing, based on the list
123 of the recently said words in the conversation.
124
127 Most commands support tab completion, both for their names and for
128 their arguments. You can use the /help command to list all available
129 commands, and /help <command> for a complete description of <command>.
130 The following is a basic description of the most widely used commands;
132 you should refer to /help inside poezio for more documentation. <foo>
133 denotes a obligatory argument, while [bar] is an optional argument
134 (without argument, the /remove command, for example, acts on the cur‐
135 rently selected contact)
136 Roster commands
138 /add <jid>
139 Add a JID to your roster.
140 /remove [jid]
142 Remove a contact from your roster.
143 /accept [jid]
145 Accept a JID that wants to subscribe to your presence.
146 /deny [jid]
148 The opposite of /accept.
149 MUC-specific commands
152 /recolor
153 Change the color of the nicknames in the conversation. Use‐
154 ful when a few people are talking and their random color
155 happen to be the same: using this command will let you dif‐
156 ferentiate them more easily.
157 /kick <user>
159 Kick the specified user from the room.
160 /show <status> [message]
162 Change your status, and status message, in the current
163 room. You can use “avail”, “busy”, “away” and “xa” as your
164 status, followed by an optional message.
165 /ignore <user>
167 Ignore the specified user.
168 /topic [topic text]
170 View or change the topic of the room.
171 /query <user>
173 Talk privately with the specified participant.
174 /part
176 Leave the current room.
177
180 Sure.
181
184 If you're using a terminal multiplexer such as screen or tmux, it may
185 be setting $TERM to "screen", which breaks 256-color support. Consider
186 setting your $TERM to something like "screen-256color".
187
190 You are encouraged to report bugs or feature requests on
191 https://dev.louiz.org/projects/poezio. You can also find us on the
192 Jabber chatroom poezio@muc.poez.io
193
196 Written by Florent Le Coz <louiz@louiz.org>
197 Later completed by Baptiste Jonglez <baptiste--poezio@jonglez.org>
199Poezio dev team September 26, 2011 Poezio(1)