/hyperboria-android

Android app for mesh networking with cjdns

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

cjdns for Android

Build Status tip for next commit

Meshnet is an Android app that lets you connect to cjdns networks, without the need for a rooted phone—thanks to the android.net.VpnService API introduced with Android 4.0 (Ice Cream Sandwich). Older versions still require root and routes through a TUN device.

Current state: App starts and stops cjdroute and sets up a VPN to access Hyperboria for non-rooted devices. Two public peers are added by default, so you should be able to browse websites and reach services on Hyperboria just by starting the cjdns service with the toggle. All other menus are only populated with mock data at the moment and you cannot add additional peers.

Installation

  1. Install the Android SDK

  2. Clone this application repo

  3. Optionally download the Android NDK version r11c and set ANDROID_NDK_HOME to its path

  4. Build application and install on device by running ./install_debug. This will also clone the cjdns repo and build the native artifacts for Android. If ANDROID_NDK_HOME is not set or the version is incorrect, the Android NDK will also be downloaded.

Note: The cjdns repo is currently cloned from a fork until patches are merged into cjdelisle/cjdns.

Contact

Notes