---
name: "xmppc"
section: "1"
platform: "linux"
package: "xmppc"
version: "0.1.0-2+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/xmppc"
---

# xmppc(1)

XMPP Command line Tool

## NAME

xmppc - XMPP Command line Tool

## SYNOPSIS

*xmppc* \[*OPTIONS*\] -m *MODE* *COMMAND* \[\<args\>...\]

*xmppc* \[-a *ACCOUNT*\] \[-j *JID*\] \[-p *PASSWORD*\] -m *MODE* *COMMAND* \[\<args\>...\]

## 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*.

## 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 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
```

## 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
```

## EXIT STATUS

**0**

Success

**1**

Failure

## BUGS

See https://codeberg.org/Anoxinon\_e.V./xmppc/issues

## AUTHOR

• DebXWoody (OpenPGP: A602F76893F138B4A8EFDDD5C2DC916F35751C24)

## 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).