meshtastic/docs/software/android/installation.mdx

77 lines
3.8 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
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 via Bluetooth, Wi-Fi (if on the same network) or USB On-The-Go (OTG).
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">
2024-04-06 04:50:03 -07:00
<a href="https://f-droid.org/packages/com.geeksville.mesh/">
2023-01-19 05:01:57 -08:00
<img
alt="Get it on F-Droid"
2024-04-06 04:50:03 -07:00
src="https://fdroid.gitlab.io/artwork/badge/get-it-on.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/)
2024-04-06 04:50:03 -07:00
2. Navigate to the `Categories` page and refresh (scroll down).
3. 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.webp"
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.