meshtastic/website/docs/software/android/installation.md
2021-06-05 01:37:03 +01:00

3.8 KiB

id title sidebar_label
android-installation Android application installation Installation

Our Android application is available to download on Google Play. Our Google Play listing has been removed by google due to a recent policy change by them with respect to the background location accesss (which our app needs). We've started the 'appeal' process, but for now you'll need to get the app from other places.

The app is also available on the Amazon Appstore. You will need to install the Amazon Appstore onto your phone in order to install the Meshtastic application.

Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh Download at https://www.amazon.com/Geeksville-Industries-Meshtastic/dp/B08CY9394Q

The application may not be found if your phone/Android version are too old. The minimum Android version is 5.0 (Lollipop 2014, first BLE support). However Android 6, Marshmallow 2015, is recommended as the Bluetooth is more stable.

The app can also be sideloaded by downloading the .apk from the GitHub releases page. If you wish to view the code or contribute to development of the app, please visit the app's GitHub page.

On installing the Meshtastic app, load it and navigate to the settings page. The app will ask you to give it permissions to access your location. This is needed for any app to use bluetooth, as the app is then able to scan the local area for bluetooth devices and, in theory, could triangulate your location based the devices it sees. If you give location permissions "only while using the app", the app will only be able to use bluetooth while it is open and visible to the user. This means if the screen is locked, or you are using another app, Meshtastic will not be able to use bluetooth, and will not be able to receive any messages from the node.

Messages page Nodes page Channel page Settings page Debug page

There is a beta program for the app, which will let you test the cutting edge changes, though this may come with extra bugs. You can join this via Google Play. It is recommended that you follow the Meshtastic Discourse Alpha Testers channel if you decide to join this.

The app uses anonymous usage statistics and crash reports to allow us to catch problems with Meshtastic and fix them. Analytics are also required to be able to use the "free" plan of our map provider Mapbox. You can disable this by unticking the checkbox on the settings page.

Settings page with statistics consent box highlighted

Google Play and the Google Play logo are trademarks of Google LLC.