8 Usage
DebXWoody edited this page 5 months ago

xmppc

Config

Configfile: ~/.config/xmppc.conf

[default]
jid=account1@domain.tld
pwd=password1

[account2]
jid=account2@domain.tld
pwd=password2

[account3]
jid=account3@domain.tld
pwd=password3

Usage

xmppc can be used with --jid and --pwd or with --account. If no --jid and no --pwd and no account is provided, xmppc will try to load the [default] account.

xmppc --jid user@domain.tld --pwd "password" --mode roster list
xmppc --account account1 --mode roster list
xmppc --mode roster list 			// requires the default account
xmppc -m roster list
xmppc -m roster export
xmppc -m message chat friend@domain.tld "Message"
xmppc -m pgp chat friend@domain.tld "Message"
xmppc -m openpgp signcrypt friend@domain.tld "Message"
xmppc -m omemo list
xmppc -m monitor stanza
xmppc -m bookmark list
xmppc -m mam list friend@domain.tld
xmppc -m discovery info domain.tld
xmppc -m discovery item conference.domain.tld
 

Modes

OMEMO

$ xmppc --account bob -m omemo list
xmpp:bob@anoxinon.me?omemo-sid-909908307=02fa1fdec5919f3de93c711387a7e66c5e0642aa8234da5a07df17c506d8c657
xmppc -m omemo|while read line; do echo $line | qrencode -o $line.png ;done

qr

Monitor

monitor stanza

Send a chat

Send a chat message from Alice to Bob.

  • -m message chat - Normal XMPP chat message
  • -m openpgp signcrypt - signed and encrypted message with XEP-0373: OpenPGP for XMPP
  • -m pgp chat - encrypted message with with XEP-0027: Current Jabber OpenPGP Usage
xmppc -a alice -m message chat bob@anoxinon.me "Hallo Bob!"
xmppc -a alice -m openpgp signcrypt bob@anoxinon.me "Hallo Bob!"
xmppc -a alice -m pgp chat bob@anoxinon.me "Hallo Bob!"

pgp

To send a encrypted pgp chat message, you need an own public key and a public key of the recipient. It’s required to have a UID with the JID in E-Mail pack. This XEP is obsolete. Maybe we should also use the xmpp-URI format.

openpgp

To send a signed an encrypted you need a private and public key for your account and a public key for the recipient. The keys need a UID with the xmpp URI as name:

gpg --quick-add-uid 8BF9FCF-YOUR-FINGERPRINT-336F5C145 xmpp:alice@anoxinon.me

xmppc will look for a key with the name xmpp:user@domain.tld.

Bookmark

The command -m bookmark list shows the bookmarks.

Bookmark

MAM

The command -m mam <JID> shows the Message Archive from a JID.

MAM

Discovery

The commands -m discovery info <jid> and -m discovery item <jid> provides Discovery Service information.

Discovery-Info

Discovery-Item