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)

RELATED TO primitivus…

AUTHORS AND COPYING

Salut à Toi was written by Jérôme Poisson <[email protected]>.

This man page was converted from the help message and Salut à Toi's wiki by Matteo Cypriani <[email protected]> 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).