1XMPPC(1)                                                              XMPPC(1)
2
3
4

NAME

6       xmppc - XMPP Command line Tool
7

SYNOPSIS

9       xmppc [OPTIONS] -m MODE COMMAND [<args>...]
10
11       xmppc [-a ACCOUNT] [-j JID] [-p PASSWORD] -m MODE COMMAND [<args>...]
12

DESCRIPTION

14       xmppc is a XMPP command line tool. You need an XMPP Account to use this
15       tool. The account information can be defined via command line argument
16       -j JID. If no password is provided via -p PASSWORD xmppc will ask the
17       user to enter the password. Another option is to define 1 or more
18       accounts within a configuration file. The option -a ACCOUNT can be used
19       to select the account.
20
21       The argument -m MODE defines the xmppc MODE which should be used
22       (roster, message, pgp, omemo, openpgp, monitor, bookmark, mam,
23       discovery). The COMMAND and the args required by the COMMAND depends on
24       the chosen MODE.
25

OPTIONS

27       -a, --attribute ACCOUNT
28           ACCOUNT is a name of a xmpp account defined within the
29           configuration file.
30
31       -j, --jid JID
32           JID of the XMPP Account.
33
34       -p, --pwd PWD
35           Password of the XMPP Account.
36
37       -v VERBOSE, Verbose flags. -v[v[v[v]]]
38           -v is WARN -vv is INFO --vvv is DEBUG -vvvv is TRACE
39
40       --help
41           Print program version number and help
42

MODES AND COMMANDS

44       xmppc modes.
45
46       -m roster
47           The Roster mode can be used to provided information of the xmpp
48           account’s roster. The roster is the XMPP list of contacts.
49
50           •   list - List all contacts
51
52           •   export - Exports all contacts
53
54       -m message
55           The message mode can be used to send unencrypted messages to
56           another xmpp account.
57
58           •   chat <jid> <message> - Sending unencrypted message to jid
59
60       -m pgp
61           PGP Mode (XEP-0027)
62
63           •   chat <jid> <message> - Sending pgp encrypted message to jid
64
65       -m omemo
66           OMEMO Mode (XEP-0384)
67
68           •   list - List the device IDs and fingerprints
69
70       -m openpgp
71           openpgp mode (XEP-0373)
72
73           •   signcrypt <jid> <message> - Sending pgp signed and encrypted
74               message to jid
75
76       -m monitor
77           Monitot mode
78
79           •   stanza - Stanza Monitor
80
81           •   monitor - microblog Monitor microblog (XEP-0277)
82
83       -m bookmark
84           Bookmark mode (XEP-0048)
85
86           •   list - List bookmarks
87
88       -m mam
89           Message Archive Management (XEP-0313)
90
91           •   list <jid> - List messages from <jid>
92
93       -m discovery
94           Service Discovery (XEP-0030)
95
96           •   info <jid> - info request for <jid>
97
98           •   item <jid> - item request for <jid>
99

ENVIRONMENT VARIABLES

101       •   HOME
102

EXAMPLES

104           xmppc --jid user@domain.tld --pwd "secret" --mode roster list
105           xmppc --jid user@domain.tld --mode pgp chat friend@domain.tld "Hello"
106           xmppc -a account1 --mode discovery item conference@domain.tld
107           xmppc --mode bookmark list
108

FILES

110       Configuration file to setup accounts.
111
112       ~/.config/xmppc.conf
113           Example:
114
115               [default]
116               jid=account1@domain.tld
117               pwd=password1
118
119               [account2]
120               jid=account2@domain.tld
121
122               [account3]
123               jid=account3@domain.tld
124               pwd=password3
125

EXIT STATUS

127       0
128           Success
129
130       1
131           Failure
132

BUGS

134       See https://codeberg.org/Anoxinon_e.V./xmppc/issues
135

AUTHOR

137       •   DebXWoody (OpenPGP: A602F76893F138B4A8EFDDD5C2DC916F35751C24)
138

RESOURCES

140       Source: https://codeberg.org/Anoxinon_e.V./xmppc
141
142       Documentation: https://codeberg.org/Anoxinon_e.V./xmppc/wiki
143

COPYING

145       Copyright (C) 2020 Anoxinon e.V. Free use of this software is granted
146       under the terms of the GNU General Public License (GPL).
147
148
149
150                                  08/23/2023                          XMPPC(1)