Files
muwire/README.md

40 lines
1.4 KiB
Markdown
Raw Normal View History

2018-07-02 13:52:15 +01:00
# MuWire - Easy Anonymous File-Sharing
2018-07-02 15:54:52 +01:00
MuWire is an easy to use file-sharing program which offers anonymity using [I2P technology](http://geti2p.net).
2018-07-02 13:52:15 +01:00
It is inspired by the LimeWire Gnutella client and developped by a former LimeWire developer.
2018-07-02 15:54:52 +01:00
2019-05-30 15:42:06 +01:00
The project is in development. You can find technical documentation in the "doc" folder.
### Building
You need Gradle and a JDK 8 or newer. After installing those and setting up the appropriate paths, just type
2019-05-31 07:16:31 +01:00
```
gradle assemble
```
If you want to run the unit tests, type
```
gradle build
```
2019-05-31 07:16:31 +01:00
Some of the UI tests will fail because they haven't been written yet :-/
### Running
2019-05-31 12:29:31 +01:00
You need to have an I2P router up and running on the same machine. After you build the application, look inside "gui/build/distributions". Untar/unzip one of the "shadow" files and then run the jar contained inside.
2019-05-31 12:40:54 +01:00
The first time you run MuWire it will ask you to select a nickname. This nickname will be displayed with search results, so that others can verify the file was shared by you.
2019-05-31 07:16:31 +01:00
At the moment there are very few nodes on the network, so you will see very few connections and search results. It is best to leave MuWire running all the time, just like I2P.
2019-05-31 07:16:31 +01:00
### Known bugs and limitations
2019-05-31 12:29:31 +01:00
* Any shared files get re-hashed on startup
2019-05-31 07:16:31 +01:00
* Sometimes the list of shared files gets lost
* Many UI features you would expect are not there yet
2018-07-26 01:06:32 +01:00
2019-05-30 15:42:06 +01:00