Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Chat application for DisasterRadio
a resilient communications network.

This app connects over BLE to a nearby LoRa node that runs the DisasterRadio firmware. is a collaborative project between Sudo Mesh and Secure Scuttlebutt, with additional support from the Internet Society and Institute For the Future
Except where otherwise noted, this app is licensed under a GNU General Public License v3 license.

Get it on F-Droid Get it on Google Play

Using the app

To be able to use the Android app to connect to a DisasterRadio LoRa node, the node must run the DisasterRadio firmware. Please check the Github repo how to create and flash a DisasterRadio version that supports BLE.

I created a fork of the original code that supports BLE and runs on the Sparkfun ESP32 LoRa board and on the Adafruit ESP32 Huzzah board connected to a Circuitrocks Alora RFM1262 LoRa board.

Using the maps

The maps view is based on OpenStreetMap osmdroid API. By default the app will load the required maps online based on usage. To use an offline map, you have to create a map that is compatible with OSM. You can use e.g. Mobile Atlas Creator (MOBAC) and create a map covering the region you need. At the moment only one map is supported. Read the osmdroid Wiki which map formats are supported, how to create a map and where to store it on your phone. The Wiki says to put the maps into /sdcard/osmdroid/. If you have a phone without SD card just put it into /osmdroid into the phone folder you see when opening the phone on your PC. On my Samsung Galaxy J2 Core the Windows path looks like
On my Huawei M5 tablet the path looks like
Computer\ThisIsMine\Internal storage\osmdroid.
A sample map for Philippines, Metro Manila, Sucat road can be found in the maps folder. As DisasterRadio is designed to communicate in cases where none of the usual communication means are available, it is recommended that you create a map of your region in advance and save it on your phone.


The sources are based on Kai Morich SimpleBluetoothLeTerminal
Thank you Kai for making his very well working code public domain.
REMARK: Kai published his code under MIT license.

The design of the chat box is taken from the Android Chat Tutorial of scaledrone
Thank you scaledrone for writing this nice tutorial

The maps view is based on OpenStreetMap osmdroid API. -REMARK_ osmdroid is published under Apache License 2.0

Build the app

The source code is using AndroidX framework. Minimum SDK version is 19 (KitKat), so it will not work on older phones. But that should not be a problem, as BLE is only supported on newer phones.
The code was made using Android Studio Version 3.5.3


To match with the licenses used in the project, this source code is licensed under the GNU GENERAL PUBLIC LICENSE Version 3


Scan screen Scan screen menu
alt text alt text
About Chat room
alt text alt text
Chat room menu Setup username
alt text alt text