NAME

       libervia-tui - Libervia's console interface

SYNOPSIS

       primitivus [ --profile=PROFILE | --help ]

DESCRIPTION

       Primitivus is Salut à Toi's console interface, based on Urwid.

       Primitivus is modal (vi-like), one can switch from one mode to another in the same way as in vi/vim:

       •   From any mode, press [Esc] to switch to normal mode.

       •   From normal mode, press : to switch to command mode.

       •   From  normal  mode,  press  i  to  switch  to insert mode — the one you use to write messages to your
           contacts.

       Primitivus can be handled either with the mouse, in a very intuitive  way,  or  with  the  keyboard.  The
       keyboard shortcuts are explained in the section KEYBOARD HANDLING.

OPTIONS

       --profile=PROFILE
       -p PROFILE
              select the profile to use

       --help
       -h     display a help message and quit

KEYBOARD HANDLING

       In the sequel we use the following shortcuts:

       •   C stands for Ctrl

       •   M means Meta, on a PC it is usually the Alt key

       •   S stands for Shift

   Main keys
       C-x    quit Primitivus

       [tab]
       C-up/down arrow
              change focus

       C-f 1
       C-f m  focus on the menu

       C-f 2
       C-f b  focus on the roster or the chat window

       C-f 3
       C-f e  focus on the edition line

       M-m    display/hide the menu

       C-n    show the next notification

       C-s    hide/redisplay a pop-up window temporarily

       F2     hide/display the roster

       C-l    refresh the screen

   Chat rooms
       M-j    join a chat room

       M-p    hide/display the list of participants

       M-t    hide/display timestamps

       M-n    use/don't use short nicks

       M-l    hide/display frame decorations

       M-s    change the room's topic appearance by switching between:

              •   one single line (the topic is cut if it's too long)

              •   the full topic

              •   topic hidden

   Edition line
       C-a
       [home] move the cursor at the beginning of the line

       C-e
       [end]  move the cursor at the end of the line

       C-k    erase the line, starting at the cursor's position

       C-w    erase the last word

       S-[tab]
              invoke completion (dependent on the context)

       up/down arrows
              browse sent messages history

   Contacts
       M-d    hide/display offline contacts

       M-s    hide/display contacts' status messages

   Card game
       space  select a card

COMMANDS

       The  following commands must be typed in command mode (type [Esc] to switch to normal mode, then the : at
       the beginning of the command will switch to command mode).

       :quit  quit Primitivus

       :messages
              display log messages (see also the SAT_LOG_LEVEL environment variable in sat(1))

       :presence [status]
              set your presence status. Invoked without argument,  a  pop-up  will  allow  you  to  choose  your
              presence status; otherwise, you can use the following arguments:

              online

              chat   (free to chat)

              away   (away from keyboard)

              dnd    (do not disturb)

              xa     (extended away)

       :status [message]
              set your status message. Invoked without argument, a pop-up will allow you to enter a message.

       :history
              set the number of lines of history to display in the chat window (:history 0 to clear the window)

SEE ALSO

       sat(1)

AUTHORS AND COPYING

       Salut à Toi was written by Jérôme Poisson <goffi@goffi.org>.

       This  man page was converted from the help message and Salut à Toi's wiki by Matteo Cypriani <mcy@lm7.fr>
       for the Debian distribution (2013).  It is released under the terms of the Creative Commons  Attribution-
       ShareAlike 3.0 Unported license (CC-By-SA 3.0).

Salut à Toi 0.5                                    2013-09-19                                      PRIMITIVUS(1)