NAME

       Poezio - a ncurses jabber client written in python3

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 famous IRC clients, like weechat or irssi.
       The  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 SleekXMPP in DEBUG_FILE. Debug contains incoming and
              outgoing stanzas in addition to various message helping poezio's debugging.

       -h     Display an help message

TABS

       A tab, in Poezio, is the base structure of the interface. A tab may contains one  or  more
       windows, and can be of different types:

              Roster tab
                    It contains a list of your contacts on the left, as well as an info window on
                    the right.

              MUC tab
                    MUC stands for "Multi-User Chat".

              Conversation tab
                    It is used for one-to-one communication, usually when  using  a  real  Jabber
                    account.

              Private tab
                    It is used to privately communicate with someone in a MUC.

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, highlight, 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 window.

              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 currently 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
              /recolor
                   Change  the  color  of  the  nicknames  in the conversation. Useful when a few
                   people are talking and their random color happen to be the  same:  using  this
                   command will let you differentiate them more easily.

              /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://dev.louiz.org/projects/poezio.  You can  also  find  us  on  the  Jabber  chatroom
       poezio@muc.poez.io

AUTHORS

       Written by Florent Le Coz <louiz@louiz.org>

       Later completed by Baptiste Jonglez <baptiste--poezio@jonglez.org>