muwire

MuWire file sharing client for I2P by zlatinb

Go to file

Zlatin Balevsky 6b717f560e file hashing		2019-11-23 20:28:29 +02:00
cli	Update plugin version to fix bug about shadow jar	2019-11-11 10:52:37 +02:00
cli-lanterna	add clear button	2019-11-20 18:47:14 +00:00
core	add option to select chat server welcome message	2019-11-19 09:02:42 +00:00
doc	file hashing	2019-11-23 20:28:29 +02:00
gradle/wrapper	add gradle wrapper	2019-05-31 17:06:39 +01:00
gui	add option to select chat server welcome message	2019-11-19 09:02:42 +00:00
host-cache	disable all GUI unit tests, enable host-cache unit tests. The 'build' target now succeeds	2019-10-05 04:31:11 +01:00
logging	logging config with all logs turned off	2019-11-02 08:52:29 +00:00
pinger	remove trailing spaces	2019-07-05 16:24:19 +01:00
plug	do not pack200 some jars because of duplicate entries	2019-07-11 20:42:24 +01:00
update-server	stronger sig type	2019-09-22 16:23:01 +01:00
webui	do not include tomcat runtime	2019-07-11 20:41:57 +01:00
.gitignore	ignore eclipse bin directory	2018-07-11 13:18:27 +01:00
LICENSE	Initial commit	2018-07-02 13:42:53 +01:00
README.md	more links	2019-11-17 13:35:40 +00:00
TODO.md	update TODO	2019-10-07 12:38:26 +01:00
build.gradle	make the i2p version a variable	2019-10-21 21:02:37 +01:00
gradle.properties	Release 0.6.6	2019-11-16 17:12:21 +00:00
gradlew	Replace deprecated backticks with $() for command substitution	2019-07-08 06:29:33 +01:00
gradlew.bat	add gradle wrapper	2019-05-31 17:06:39 +01:00
settings.gradle	start a new project for an interactive cli	2019-10-23 19:38:16 +01:00

README.md

MuWire is an easy to use file-sharing program which offers anonymity using I2P technology. 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.6.6 is avaiable for download at https://muwire.com. You can find technical documentation in the doc folder. Also check out the Wiki for various documentation.

Building

You need JDK 9 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 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-all.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-all.jar in a terminal. The CLI will ask you about the router host and port on startup, no need to edit any files. However, the CLI does not have an options window yet, so if you need to change any options you will need to edit the configuration files. The CLI options are documented here cli options

The CLI is under active development and doesn't have all the features of the GUI.

Web UI

If you are a Grails/Scala/JRuby/Kotlin developer and are interested in building a Web UI for MuWire, please get in touch. The MuWire core is written in Groovy and should be easy to integrate with any JVM-based language.

GPG Fingerprint

471B 9FD4 5517 A5ED 101F  C57D A728 3207 2D52 5E41

You can find the full key at https://keybase.io/zlatinb