45 lines
1.2 KiB
Markdown
45 lines
1.2 KiB
Markdown
|
# OpenPGP for XMPP Instant Messaging Demo Client
|
||
|
|
||
|
This command line XMPP client is part of my [Summer of Code 2018 project](https://vanitasvitae.github.io/GSOC2018/).
|
||
|
It demonstrates the capabilities of the OX-IM-API I wrote.
|
||
|
|
||
|
### OpenPGP for XMPP: Instant Messaging
|
||
|
|
||
|
The client implements [XEP-0373](https://xmpp.org/extensions/xep-0373.html) and [XEP-0374](https://xmpp.org/extensions/xep-0374.html) in order to encrypt messages using [OpenPGP](https://tools.ietf.org/html/rfc4880).
|
||
|
|
||
|
### Installation
|
||
|
|
||
|
In order to install the client, you have to follow these steps:
|
||
|
```
|
||
|
# create a working directory
|
||
|
mkdir ox
|
||
|
cd ox
|
||
|
|
||
|
# Prepare Smack
|
||
|
git clone https://github.com/vanitasvitae/Smack.git
|
||
|
cd Smack
|
||
|
git checkout c9c22068a3e07d44c88225f04bbf47189caae3f9
|
||
|
gradle install
|
||
|
|
||
|
# Prepare pgpainless
|
||
|
cd ..
|
||
|
git clone https://github.com/vanitasvitae/pgpainless.git
|
||
|
cd pgpainless
|
||
|
git checkout 9af42c7231a6837694461e087ef5b3c51e451ef5
|
||
|
gradle install
|
||
|
|
||
|
# prepare the client
|
||
|
cd ..
|
||
|
git clone https://github.com/vanitasvitae/oxclient.git
|
||
|
cd oxclient
|
||
|
gradle build
|
||
|
```
|
||
|
|
||
|
### Running the client
|
||
|
|
||
|
The last command above generates the executable `build/libs/cmd-1.0-SNAPSHOT.jar`.
|
||
|
That can be executed using
|
||
|
|
||
|
```
|
||
|
java -jar build/libs/cmd-1.0-SNAPSHOT.jar
|
||
|
```
|