README.md

 1# xmppc
 2
 3CLI for XMPP written in C and using [libstrophe](http://strophe.im/libstrophe/).
 4This repo is a fork (likely hard) of the original
 5[xmppc](https://codeberg.org/Anoxinon_e.V./xmppc) and might get renamed.
 6
 7## Dependencies
 8
 9- [libc6-dev](https://packages.debian.org/trixie/libc6-dev) (2.28-10)
10- [libglib2.0-dev](https://packages.debian.org/trixie/libglib2.0-dev) (2.58.3)
11- [libstrophe-dev](https://packages.debian.org/trixie/libstrophe-dev) (0.9.2-2)
12- [libgpgme-dev](https://packages.debian.org/trixie/libgpgme-dev) (1.12.0)
13- [automake](https://packages.debian.org/trixie/automake) (1.17)
14
15## Build
16
17```
18# on Debian/Ubuntu
19apt install -y automake libstrophe-dev libc6-dev libglib2.0-dev libgpgme-dev
20./bootstrap.sh
21./configure
22make
23# mv xmppc $HOME/.local/bin/ or somewhere else in your PATH
24```
25
26## Config file
27
28`~/.config/xmppc.conf`
29
30`[default]` is used when neither account nor JID is provided.
31
32```
33[default]
34jid=user@domain.tld
35pwd=YourSecret
36
37[account1]
38jid=account1@domain.tld
39pwd=YourSecret
40```
41
42## Usage
43
44```
45xmppc --jid user@domain.tld --pwd "password" --mode roster list
46xmppc -j user@domain.tld -p "password" -m roster list
47xmppc -a alice -m mam list bob@domain.tld
48xmppc -m bookmark list
49xmppc -h
50```
51
52## Issues
53
54Do not report them to upstream `xmppc`! Send me a message somewhere (it's pretty
55easy to find how), then I'll decide whether it's a bug in my fork I should fix
56or something I should report upstream. Please don't bother the original
57maintainer with issues I might have introduced.