PRIMITIVUS

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).