1Poezio(1)                                                            Poezio(1)
2
3
4

NAME

6       Poezio - a ncurses jabber client written in python3
7

SYNOPSIS

9       poezio [-f CONFIG_FILE] [-d DEBUG_FILE] [-h]
10

DESCRIPTION

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

OPTIONS

19       -f, --file CONFIG_FILE
20              Run  poezio  using  CONFIG_FILE  as  the  config file instead of
21              ~/.config/poezio/poezio.cfg
22
23       -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
28       -h     Display an help message
29
30

TABS

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
35              Roster tab
36                    It  contains  a list of your contacts on the left, as well
37                    as an info window on the right.
38
39              MUC tab
40                    MUC stands for "Multi-User Chat".
41
42              Conversation tab
43                    It is used  for  one-to-one  communication,  usually  when
44                    using a real Jabber account.
45
46              Private tab
47                    It is used to privately communicate with someone in a MUC.
48
49

KEY BINDINGS

51       While  most  of the keyboard shortcuts are common to all types of tabs,
52       some of them are tab-specific.
53
54   Text edition
55       These shortcuts work in any kind of tab; most of them are identical  to
56       emacs' ones.
57
58              Ctrl+A  Move the cursor to the beginning of the line.
59
60              Ctrl+E  Move the cursor to the end of the line.
61
62              Ctrl+W  Delete the word before the cursor.
63
64              Ctrl+K  Delete  the  text from the cursor to the end of the line
65                      and save it in the clipboard.
66
67              Ctrl+U  Delete the text from the beginning of the  line  to  the
68                      cursor and save it in the clipboard.
69
70              Ctrl+Y  Insert the text in the clipboard after the cursor.
71
72              Ctrl+D  Delete the char after the cursor (same as the Suppr key)
73
74
75   Navigation keybindings
76              F5, Ctrl+N
77                      Go to the previous tab.
78
79              F6, Ctrl+P
80                      Go to the next tab.
81
82              Alt+<number>
83                      Go to the specified tab (from 0 to 9)
84
85              Alt+J <two-digits-number>
86                      Go to the specified tab (from 00 to 99)
87
88              Alt+Z   Go to the last visited tab.
89
90              Alt+E   Go  to  the  next  important tab (private message, high‐
91                      light, simple message)
92
93              F7      Decrease the information window size.
94
95              F8      Increase the information window size.
96
97              Alt+R   Go to the roster.
98
99              Ctrl+L  Redraw the screen.
100
101              Up, Down
102                      Browse the history of  the  last  messages  or  commands
103                      you've entered.
104
105
106   Roster keybindings
107              o       Hide or show the offline contacts.
108
109              s       Search through your contact list.
110
111              Ctrl+G  Cancel a search.
112
113
114   MUC-specific keybindings
115              Alt+V   Move  the  line separator at the bottom of the text win‐
116                      dow.
117
118              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
122              Alt+/   Complete the word that you're typing, based on the  list
123                      of the recently said words in the conversation.
124
125

COMMANDS

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
131       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
137   Roster commands
138              /add <jid>
139                   Add a JID to your roster.
140
141              /remove [jid]
142                   Remove a contact from your roster.
143
144              /accept [jid]
145                   Accept a JID that wants to subscribe to your presence.
146
147              /deny [jid]
148                   The opposite of /accept.
149
150
151   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
158              /kick <user>
159                   Kick the specified user from the room.
160
161              /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
166              /ignore <user>
167                   Ignore the specified user.
168
169              /topic [topic text]
170                   View or change the topic of the room.
171
172              /query <user>
173                   Talk privately with the specified participant.
174
175              /part
176                   Leave the current room.
177
178

BUGS

180       Sure.
181
182

KNOWN ISSUES

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
188

FEEDBACK

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
194

AUTHORS

196       Written by Florent Le Coz <louiz@louiz.org>
197
198       Later completed by Baptiste Jonglez <baptiste--poezio@jonglez.org>
199
200
201
202Poezio dev team               September 26, 2011                     Poezio(1)
Impressum