48 lines
2.0 KiB
Markdown
48 lines
2.0 KiB
Markdown
# MuWire - Easy Anonymous File-Sharing
|
|
|
|
MuWire is an easy to use file-sharing program which offers anonymity using [I2P technology](http://geti2p.net). It works on any platform Java works on, including Windows,MacOS,Linux.
|
|
|
|
It is inspired by the LimeWire Gnutella client and developped by a former LimeWire developer.
|
|
|
|
The current stable release - 0.5.3 is avaiable for download at https://muwire.com. You can find technical documentation in the "doc" folder.
|
|
|
|
### Building
|
|
|
|
You need JDK 8 or newer. After installing that and setting up the appropriate paths, just type
|
|
|
|
```
|
|
./gradlew clean assemble
|
|
```
|
|
|
|
If you want to run the unit tests, type
|
|
```
|
|
./gradlew clean build
|
|
```
|
|
|
|
If you want to build binary bundles that do not depend on Java or I2P, see the https://github.com/zlatinb/muwire-pkg project
|
|
|
|
### Running the GUI
|
|
|
|
After you build the application, look inside `gui/build/distributions`. Untar/unzip one of the `shadow` files and then run the jar contained inside by typing `java -jar gui-x.y.z.jar` in a terminal or command prompt.
|
|
|
|
If you have an I2P router running on the same machine that is all you need to do. If you use a custom I2CP host and port, create a file `i2p.properties` and put `i2cp.tcp.host=<host>` and `i2cp.tcp.port=<port>` in there. On Windows that file should go into `%HOME%\AppData\Roaming\MuWire`, on Mac into `$HOME/Library/Application Support/MuWire` and on Linux `$HOME/.MuWire`
|
|
|
|
[Default I2CP port]\: `7654`
|
|
|
|
### Running the CLI
|
|
|
|
Look inside `cli-lanterna/build/distributions`. Untar/unzip one of the `shadow` files and then run the jar contained inside by typing `java -jar cli-lanterna-x.y.z.jar` in a terminal. The CLI will ask you about the router host and port on startup, no need to edit any files.
|
|
|
|
The CLI is under active development and doesn't have all the features of the GUI.
|
|
|
|
### GPG Fingerprint
|
|
|
|
```
|
|
471B 9FD4 5517 A5ED 101F C57D A728 3207 2D52 5E41
|
|
```
|
|
|
|
You can find the full key at https://keybase.io/zlatinb
|
|
|
|
|
|
[Default I2CP port]: https://geti2p.net/en/docs/ports
|