PRIMITIVUS(1)

💅 PRIMITIVUS — okay bestie, let's talk 💅

So this is PRIMITIVUS(1), a page from Salut à Toi's manual. Yes the NAME section calls it libervia-tui, and yes that's iconic of it. Sit down, grab a boba, we're doing this.

✨ NAME ✨

libervia-tui — Libervia's console interface. That's the whole vibe. 🫶

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

Primitivus is Salut à Toi's console interface, and it's built on Urwid. She's a terminal girlie but make it fashion. 💅

Primitivus is modal (vi-like, no cap), which means you switch from one mode to another exactly the way you do 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. That's your texting mode, bestie. 💬

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. Mouse girls and keyboard girls, we support both. 👑

🎀 OPTIONS 🎀

• --profile=PROFILE — select the profile to use. Pick your girl. 👯
• -p PROFILE — same thing, shorter name, still select the profile to use.
• --help — display a help message and quit.
• -h — display a help message and quit, but tiny.

⌨️ KEYBOARD HANDLING ⌨️

Real talk, we use these shortcuts throughout, so let's get the shorthand down first:

• 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. Goodbye queen, we'll miss you. 😭
• [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. Come thruuu. 🚪✨
• 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). It's giving ritual, honestly.

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

okay so that's the whole page, and yes we kept every single line — every flag, every key, every command, all of it. no skipping. periodt. 💅

Salut à Toi 0.5 🎀 2013-09-19 🦋 and that's the wrap, bestie — go forth and press [Esc]. 💖✨