nutomic
/
ensichat
Archived
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
This repository has been archived on 2019-12-07. You can view files and clone it, but cannot push or open issues or pull requests.
301 Commits 3 Branches 17 Tags 2 MiB
Scala 92.1%
Java 6%
Gradle 1.9%
Go to file
Felix Ableitner f579608f6b Don't crash if we can't bind to server socket 2016-09-24 19:03:49 +09:00
android Fixed possible crash in Bluetooth code 2016-09-24 18:59:24 +09:00
core Don't crash if we can't bind to server socket 2016-09-24 19:03:49 +09:00
docs Added bachelor thesis 2016-08-26 17:37:14 +02:00
gradle Updated dependencies. 2016-01-27 21:23:09 +01:00
graphics Fixed screenshot size 2016-08-27 01:51:08 +02:00
integration Uncommented integration test code 2016-09-24 18:51:02 +09:00
server Bumped version to 0.5.1 2016-09-23 21:40:58 +09:00
.gitignore Added .apk files to .gitignore. 2016-01-25 22:47:20 +01:00
LICENSE Changed license to MPLv2 (fixes #47) 2016-08-27 02:00:15 +02:00
PROTOCOL.md Allow adding other device by address, auto request public key 2016-09-13 01:48:58 +02:00
README.md Changed license to MPLv2 (fixes #47) 2016-08-27 02:00:15 +02:00
build.gradle Updated dependencies 2016-09-19 16:48:51 +09:00
gradlew Initial commit. 2014-10-03 12:55:35 +03:00
gradlew.bat Initial commit. 2014-10-03 12:55:35 +03:00
settings.gradle Implemented AODVv2, including integration test (fixes #33). 2016-05-29 18:35:50 +02:00

README.md

Ensichat

Instant messenger for Android that is fully decentralized. Messages are encrypted and sent directly between devices via Bluetooth or Internet, without any central server. Relay nodes are used to ensure message delivery, even if the target node is offline.

For details on how Ensichat works, you can check out my bachelor thesis, and read the protocol definition.

screenshot 1 screenshot 2 screenshot 3

Get it on Google Play Get it on F-Droid

Building

To setup a development environment, just install Android Studio and import the project.

Alternatively, you can use the command line. To create a debug apk, run ./gradlew assembleDevDebug. This requires at least Android Lollipop on your development device. If you don't have 5.0 or higher, you have to use ./gradlew assembleRelDebug. However, this results in considerably slower incremental builds. To create a release apk, run ./gradlew assembleRelRelease.

Testing

You can run the unit tests with ./gradlew test. After connecting an Android device, you can run the Android tests with ./gradlew connectedDevDebugAndroidTest (or ./gradlew connectedRelDebugAndroidTest if your Android version is lower than 5.0).

To run integration tests for the core module, use ./gradlew integration:run. If this fails (or is very slow), try changing the value of Crypto#PublicKeySize to 512 (in the core module).

License

The project is licensed under the MPLv2.

The launcher icon is based on the Bubbles Icon created by Paomedia which is available under CC BY 3.0.