xmppc1
Xmpp command line tool
Usage
xmppc [OPTIONS]
-m
MODE
COMMAND
[<args> ...]
xmppc [-a
ACCOUNT]
[-j
JID]
[-p
PASSWORD]
-m
MODE
COMMAND
[<args> ...]
Overview
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.
Options
-
-a, --attribute ACCOUNT -
ACCOUNT is a name of a xmpp account defined within the configuration file.
-
-j, --jid JID -
JID of the XMPP Account.
-
-p, --pwd PWD -
Password of the XMPP Account.
-v VERBOSE, 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
Modes and commands
xmppc modes.
-m roster
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
-m message
The message mode can be used to send unencrypted messages to another xmpp account.
• chat <jid> <message> - Sending unencrypted message to jid
-m pgp
PGP Mode (XEP-0027)
• chat <jid> <message> - Sending pgp encrypted message to jid
-m omemo
OMEMO Mode (XEP-0384)
• list - List the device IDs and fingerprints
-m openpgp
openpgp mode (XEP-0373)
• signcrypt <jid> <message> - Sending pgp signed and encrypted message to jid
-m monitor
Monitot mode
• stanza - Stanza Monitor
• monitor - microblog Monitor microblog (XEP-0277)
-m bookmark
Bookmark mode (XEP-0048)
• list - List bookmarks
-m mam
Message Archive Management (XEP-0313)
• list <jid> - List messages from <jid>
-m discovery
Service Discovery (XEP-0030)
• info <jid> - info request for <jid>
• item <jid> - item request for <jid>
Environment
• HOME
Examples
xmppc --jid [email protected] --pwd "secret" --mode roster list xmppc --jid [email protected] --mode pgp chat [email protected] "Hello" xmppc -a account1 --mode discovery item [email protected] xmppc --mode bookmark list
Files
Configuration file to setup accounts.
~/.config/xmppc.conf
Example:
[default] [email protected] pwd=password1
[account2] [email protected]
[account3] [email protected] pwd=password3
Exit status
0
Success
1
Failure
Resources
Source: https://codeberg.org/Anoxinon_e.V./xmppc
Documentation: https://codeberg.org/Anoxinon_e.V./xmppc/wiki
Copying
Copyright (C) 2020 Anoxinon e.V. Free use of this software is granted under the terms of the GNU General Public License (GPL).
Releases
Unchanged in 3 releases since Debian 11 (Bullseye).