Libervia CLI¶
Libervia CLI is the Command Line Interface of Libervia
libervia-cli
is the command to launch it.
li
is short alias for libervia-cli
, it is the command used through this
documentation.
Overview¶
li
is a powerful tool to work with Libervia/XMPP.
With it you can send chat messages, share files, retrieve avatars, write blog entries, etc.
Usage¶
To get help on commands or their options, use:
$ li --help
which can be used on any command, so if you need help on message send
command, just do:
$ li message send --help
With li, you always enter commands first, then options and arguments.
There are several levels of commands: first one is the main category (message
,
blog
, avatar
, etc.), then there are often subcommands (e.g. message send
).
After the commands come the options. For instance if you want to send a message, you can
get the available options with --help
as explained above:
$ li message send --help
usage: li message send [-h] [-p PROFILE] [--pwd PASSWORD] [-c] [-l LANG] [-s]
[-n] [-S SUBJECT] [-L SUBJECT_LANG]
[-t {chat,error,groupchat,headline,normal,auto}]
[-e ALGORITHM] [--encrypt-noreplace] [-x | -r]
jid
positional arguments:
jid the destination jid
optional arguments:
-h, --help show this help message and exit
-p PROFILE, --profile PROFILE
Use PROFILE profile key (default: @DEFAULT@)
--pwd PASSWORD Password used to connect profile, if necessary
-c, --connect Connect the profile before doing anything else
-l LANG, --lang LANG language of the message
-s, --separate separate xmpp messages: send one message per line
instead of one message alone.
-n, --new-line add a new line at the beginning of the input (usefull
for ascii art ;))
-S SUBJECT, --subject SUBJECT
subject of the message
-L SUBJECT_LANG, --subject_lang SUBJECT_LANG
language of subject
-t {chat,error,groupchat,headline,normal,auto}, --type {chat,error,groupchat,headline,normal,auto}
type of the message
-e ALGORITHM, --encrypt ALGORITHM
encrypt message using given algorithm
--encrypt-noreplace don't replace encryption algorithm if an other one is
already used
-x, --xhtml XHTML body
If you want to send a message to, say, pierre@example.net
, and encrypt it with OMEMO,
just do the following:
echo "hi, I'm writing with li" | li message send -e omemo pierre@example.net
(note that with OMEMO, you need to have previously validated fingerprint of your contact for this to work).
The different commands are explained in dedicated sections.
li commands:
- common arguments
- account: XMPP account management
- ad-hoc: Ad-Hoc commands
- application: external applications management
- avatar: retrieve/upload avatars
- blocking: entities blocking
- blog: (micro)blogging management
- blog/attachments: (un)attach Metadata to Blog Items
- bookmarks: get/set bookmarks
- call: A/V Calls
- debug: tools to help debugging/monitoring Libervia
- encryption: encryption sessions handling
- event: events management
- event/invitee: event invitees management
- file: files sending/receiving/management
- file/share: advanced files sharing
- file/share/affiliations: file sharing affiliations management
- file/share/configuration: file sharing node configuration
- forums: forums topics handling
- identity: identity management
- info: retrieve various information
- input: automatise commands using external inputs
- invitation: invite people without XMPP account
- list: create and manage lists
- merge-request: create and manage merge requests
- message: chat message management
- notification: notifications handling
- param: manage Libervia parameters
- ping: get response time of an XMPP entity
- pipe: send/receive data stream through shell pipes
- profile: Libervia profile handling
- pubsub: PubSub management
- pubsub/attachments: (Un)Attach Metadata to Pubsub Items
- pubsub/cache: PubSub Cache Management
- pubsub/hook: PubSub hooks management
- pubsub/node: PubSub nodes management
- pubsub/node/affiliations: nodes affiliations management
- pubsub/node/schema: nodes schema handling
- pubsub/node/affiliations: nodes subscriptions management
- pubsub/secret: share, revoke or rotate node secrets
- pubsub/signature: Sign and Check Items Signatures
- roster: manager an entity roster
- shell: use Libervia with REPL
- uri: XMPP URI parsing/generation
Tutorial¶
You can check this third party tutorial: https://blog.agayon.be/sat_jp.html