xmppc - XMPP Command line Tool
Contents
Bugs
See https://codeberg.org/Anoxinon_e.V./xmppc/issues
Copying
Copyright (C) 2020 Anoxinon e.V. Free use of this software is granted under the terms of the GNU General
Public License (GPL).
05/16/2020 XMPPC(1)
Description
xmppc is a XMPP command line tool. You need an XMPP Account to use this tool. The account information can
be defined via command line argument -j JID. If no password is provided via -p PASSWORD xmppc will ask
the user to enter the password. Another option is to define 1 or more accounts within a configuration
file. The option -a ACCOUNT can be used to select the account.
The argument -m MODE defines the xmppc MODE which should be used (roster, message, pgp, omemo, openpgp,
monitor, bookmark, mam, discovery). The COMMAND and the args required by the COMMAND depends on the
chosen MODE.
Environment Variables
• HOME
Examples
xmppc --jid user@domain.tld --pwd "secret" --mode roster list
xmppc --jid user@domain.tld --mode pgp chat friend@domain.tld "Hello"
xmppc -a account1 --mode discovery item conference@domain.tld
xmppc --mode bookmark list
Exit Status
0
Success
1
Failure
Files
Configuration file to setup accounts.
~/.config/xmppc.conf
Example:
[default]
jid=account1@domain.tld
pwd=password1
[account2]
jid=account2@domain.tld
[account3]
jid=account3@domain.tld
pwd=password3
Modes And Commands
xmppc modes.
-mroster
The Roster mode can be used to provided information of the xmpp account’s roster. The roster is the
XMPP list of contacts.
• list - List all contacts
• export - Exports all contacts
-mmessage
The message mode can be used to send unencrypted messages to another xmpp account.
• chat<jid><message> - Sending unencrypted message to jid
-mpgp
PGP Mode (XEP-0027)
• chat<jid><message> - Sending pgp encrypted message to jid
-momemo
OMEMO Mode (XEP-0384)
• list - List the device IDs and fingerprints
-mopenpgp
openpgp mode (XEP-0373)
• signcrypt<jid><message> - Sending pgp signed and encrypted message to jid
-mmonitor
Monitot mode
• stanza - Stanza Monitor
• monitor - microblog Monitor microblog (XEP-0277)
-mbookmark
Bookmark mode (XEP-0048)
• list - List bookmarks
-mmam
Message Archive Management (XEP-0313)
• list<jid> - List messages from <jid>
-mdiscovery
Service Discovery (XEP-0030)
• info<jid> - info request for <jid>
• item<jid> - item request for <jid>
Name
xmppc - XMPP Command line Tool
Options
-a,--attributeACCOUNTACCOUNT is a name of a xmpp account defined within the configuration file.
-j,--jidJIDJID of the XMPP Account.
-p,--pwdPWD
Password of the XMPP Account.
-vVERBOSE, Verbose flags. -v[v[v[v]]]
-v is WARN -vv is INFO --vvv is DEBUG -vvvv is TRACE
--help
Print program version number and help
Resources
Source: https://codeberg.org/Anoxinon_e.V./xmppc
Documentation: https://codeberg.org/Anoxinon_e.V./xmppc/wiki
Synopsis
xmppc [OPTIONS] -m MODECOMMAND [<args>...]
xmppc [-a ACCOUNT] [-j JID] [-p PASSWORD] -m MODECOMMAND [<args>...]
