Update README

This commit is contained in:
vanitasvitae 2017-08-20 17:56:38 +02:00
parent 0676688c04
commit 9503e0ef1f
Signed by: vanitasvitae
GPG Key ID: 62BEE9264BF17311
2 changed files with 28 additions and 5 deletions

View File

@ -1,14 +1,37 @@
# GSoC 2017 - Jingle File Transfer Demo App
## File synchronisation via XMPP.
xmpp_sync has two modes: Master and Slave mode. A client started in master mode will send files
out, while clients in slave mode will receive files.
This application demonstratest the possibilities of Jingle File Transfer via XMPP. xmpp_sync can be used to mirror the contents of one directory across several computers.
In order to use the program, you need at least two XMPP accounts (which might be on different
servers). I recommend using a server, which supports Socks5 proxies.
### Building
Since some of the code I wrote for Smack is not yet merged, you'll have to build it yourselves.
```
git clone git@github.com:vanitasvitae/Smack.git
cd Smack
git checkout jingle3
gradle install
```
Next clone the repository of xmpp_sync.
```
cd ..
git clone git@github.com:vanitasvitae/xmpp_sync.git
cd xmpp_sync
gradle build
```
The resulting executable jar file can be found in `build/libs` afterwards.
### Available options and commands:
xmpp_sync has two modes: Master and Slave mode. A client started in master mode will send files
out, while clients in slave mode will receive files.
In order to use the program, you need at least two XMPP accounts (which might be on different
servers). I recommend using a server, which supports Socks5 proxies.
The application has the following options available when being started.
```
usage: client [-d] -D <arg> [-h] [-m] -p <swordfish> -u <user@server.tld>

View File

@ -49,7 +49,7 @@ public class Slave extends Client {
}
}
}
target.getParentFile().mkdirs();
offer.accept(connection, target);
} catch (InterruptedException | XMPPException.XMPPErrorException | SmackException.NoResponseException | SmackException.NotConnectedException | IOException e) {