meshtastic/docs/software/android/installation.mdx

80 lines
3.9 KiB
Plaintext
Raw Normal View History

2021-04-24 14:32:38 -07:00
---
2022-11-07 20:53:52 -08:00
id: installation
title: Android Application Installation
2022-11-02 14:50:50 -07:00
sidebar_label: Installation
2022-06-30 11:54:38 -07:00
sidebar_position: 1
2021-04-24 14:32:38 -07:00
---
## Installation Methods
2022-09-04 04:33:37 -07:00
Our Android application is available on our F-Droid repo and Google Play Store. This allows you to connect to your Meshtastic device from your Android phone.
2021-04-24 14:32:38 -07:00
The minimum Android version is 5.0 (Lollipop 2014, first BLE support), however Android 6 (Marshmallow 2015) is recommended as Bluetooth is more stable.
### Install with F-Droid
2022-09-04 04:33:37 -07:00
<p float="center">
2023-02-03 17:43:45 -08:00
<a href="https://apt.izzysoft.de/fdroid/repo">
2023-01-19 05:01:57 -08:00
<img
alt="Get it on F-Droid"
2023-02-03 17:36:37 -08:00
src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png"
2023-01-19 05:01:57 -08:00
width="49%"
/>
2022-08-29 08:18:55 -07:00
</a>
</p>
1. Download and Install the F-Droid app from [f-droid.org](https://f-droid.org/)
2023-01-19 05:01:57 -08:00
2. Open the F-Droid app and navigate to `Settings > Repositories`.
3. Click on the `+` icon to add a new repo.
2023-02-03 17:36:37 -08:00
4. Enter the Meshtastic repo address as follows: `https://apt.izzysoft.de/fdroid/repo/` (no fingerprint required)
2023-01-19 05:01:57 -08:00
5. Navigate to the `Categories` page and refresh (scroll down).
6. Search for and install the `Meshtastic` App.
### Install from Play Store
<p float="center">
<a href="https://play.google.com/store/apps/details?id=com.geeksville.mesh">
2023-01-19 05:01:57 -08:00
<img
alt="Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh"
src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png"
2023-01-19 05:01:57 -08:00
width="49%"
/>
</a>
</p>
2021-06-04 17:14:02 -07:00
2023-01-19 05:01:57 -08:00
There is a Play Store [testing program](https://play.google.com/apps/testing/com.geeksville.mesh) with the latest cutting edge changes, though this may come with extra bugs.
2021-06-04 17:14:02 -07:00
It is recommended that you follow the [Meshtastic Discourse Alpha Testers](https://meshtastic.discourse.group/c/development/alpha-testers) channel if you decide to join.
_Google Play and the Google Play logo are trademarks of Google LLC._
2021-04-24 14:32:38 -07:00
### Install by Sideloading
2021-04-24 14:32:38 -07:00
<p float="center">
<a href="https://github.com/meshtastic/Meshtastic-Android/releases/latest">
2023-01-19 05:01:57 -08:00
<img
alt="Download at https://github.com/meshtastic/Meshtastic-Android/releases/latest"
src="/img/android/get-it-on-github.png"
2023-01-19 05:01:57 -08:00
width="49%"
/>
</a>
</p>
2023-01-19 05:01:57 -08:00
The app can also be sideloaded by downloading the .APK from the [Github Releases](https://github.com/meshtastic/Meshtastic-Android/releases/latest) page.
2021-04-24 14:32:38 -07:00
If you do sideload, you may have to give your browser permissions to run a package installer. If you wish to view the code or contribute to development of the app, please visit the app's [GitHub page](https://github.com/meshtastic/Meshtastic-Android)
2022-12-14 19:03:59 -08:00
### Install with Obtainium
1. Download and Install the Obtanium app from [Github](https://github.com/ImranR98/Obtainium).
2. Open the Obtanium app and navigate to `+ Add App`.
3. You can easily search for the Android repo with the search field by typing `Meshtastic-Android` and selecting the `Meshtastic/Meshtastic-Android` repo. You may also manually enter the Meshtastic Android Github Releases address as follows: `https://github.com/meshtastic/Meshtastic-Android/releases`.
2023-01-19 05:01:57 -08:00
4. Under `Additional Options for Github` toggle as desired `Include prereleases`\* or `Fallback to older releases` and press `Add`.
2022-12-14 19:03:59 -08:00
5. The first time you add an application, obtainium will prompt you for permission to install unknown apps, you will need to toggle `Allow from this source` and press back. Obtainium will download the Android .APK from the Github release page.
6. Press `Install`. Android Installer will prompt "Do you want to install this app?" press `Install`.
7. Press `Open`.
Obtainium allows you to install and update Open-Source Apps directly from their releases pages, and receive notifications when new releases are made available.
2023-01-19 05:01:57 -08:00
\*Alpha releases include the latest cutting edge changes which may come with extra bugs. It is recommended that you follow the [Meshtastic Discourse Alpha Testers](https://meshtastic.discourse.group/c/development/alpha-testers) channel if you decide to use these versions.