Android application for Meshtastic
Find a file
2026-01-30 10:19:08 -06:00
.github chore(build): more downgrades to JDK 17 (#4374) 2026-01-30 10:18:50 -06:00
.idea fix(#1787): handle unknown hardware details crash (#1789) 2025-04-26 19:37:49 -05:00
.run feat: Configure Pre-Commit run for debugging (#4284) 2026-01-21 19:50:27 +00:00
app chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4375) 2026-01-30 10:19:08 -06:00
build-logic chore(build): more downgrades to JDK 17 (#4374) 2026-01-30 10:18:50 -06:00
config chore(lint): Disable ForbiddenComment detekt rule (#4344) 2026-01-27 19:38:14 -06:00
core chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4375) 2026-01-30 10:19:08 -06:00
fastlane feat(fastlane): copypasta typo (#3342) 2025-10-04 16:55:53 -05:00
feature chore: Scheduled updates (Firmware, Hardware, Translations, Graphs) (#4363) 2026-01-29 22:36:33 +00:00
gradle chore(deps): update androidx.activity:activity-compose to v1.12.3 (#4370) 2026-01-30 02:32:39 +00:00
mesh_service_example chore(ci): Remove GitHub Packages publishing workflow (#4368) 2026-01-29 17:56:41 -06:00
.gitignore feat: word-based message filtering with quarantine approach (stored but hidden) (#4241) 2026-01-24 16:41:17 +00:00
.gitmodules Remove design/ git submodule (#3177) 2025-09-23 21:29:33 +00:00
.ruby-version Revert "chore(deps): update ruby to v4" (#4201) 2026-01-13 07:29:17 -06:00
AGENTS.md docs: Overhaul and rename agent guide (#3757) 2025-11-20 14:17:36 -06:00
build.gradle.kts chore(ci): Refactor and optimize GitHub Actions workflows (#4252) 2026-01-18 01:52:04 +00:00
CODE_OF_CONDUCT.md repo: Add Contributor Covenant Code of Conduct (#3941) 2025-12-10 00:03:23 +00:00
codecov.yml ci: add coverage status configuration to codecov.yml (#3104) 2025-09-15 06:59:55 -05:00
compose_compiler_config.conf feat: Mark database models and protobufs as stable (#3982) 2025-12-12 19:02:27 +00:00
config.properties Update VERSION_NAME_BASE to 2.7.12 (#4312) 2026-01-25 17:41:23 +00:00
CONTRIBUTING.md docs: add information about spotless for code formatting (#2622) 2025-08-02 16:10:04 +00:00
crowdin.yml chore(crowdin): Remove preserve_hierarchy option (#3764) 2025-11-20 18:58:24 -06:00
debugging-android.md add instructions on how to capture logcat logs 2020-03-07 17:19:36 -08:00
Gemfile feat(ci): migrate to fastlane for release management (#3038) 2025-09-09 21:08:11 +00:00
Gemfile.lock chore(deps): Update Gradle and library versions (#4309) 2026-01-25 16:04:25 +00:00
gradle.properties chore(build): more downgrades to JDK 17 (#4374) 2026-01-30 10:18:50 -06:00
gradlew chore(deps): update gradle to v9.1.0 (#3143) 2025-09-19 03:22:49 +00:00
gradlew.bat chore(deps): update gradle to v9.1.0 (#3143) 2025-09-19 03:22:49 +00:00
jitpack.yml build: Lower JDK to 17 and minSdk to 21 (#4369) 2026-01-29 20:04:30 -06:00
LICENSE Add license and copyright 2020-03-01 16:39:53 -08:00
README.md Refactor: Create core:api module and set up publishing (#4362) 2026-01-29 13:45:00 -06:00
RELEASE_PROCESS.md ci(release): refactor release workflow to be callable (#3330) 2025-10-04 17:13:05 +00:00
secrets.defaults.properties refactor: maps (#2097) 2025-08-13 17:51:19 +00:00
settings.gradle.kts Refactor: Create core:api module and set up publishing (#4362) 2026-01-29 13:45:00 -06:00

Meshtastic Logo

Meshtastic-Android

GitHub all releases Android CI codecov Crowdin CLA assistant Fiscal Contributors Vercel

This is a tool for using Android with open-source mesh radios. For more information see our webpage: meshtastic.org. If you are looking for the the device side code, see here.

This project is currently beta testing across various providers. If you have questions or feedback please Join our discussion forum or the Discord Group . We would love to hear from you!

Get Meshtastic

The easiest, and fastest way to get the latest beta releases is to use our github releases. It is recommend to use these with Obtainum to get the latest updates.

Alternatively, these other providers are also available, but may be slower to update.

Get it on F-Droid Get it on IzzyOnDroid Get it on GitHub Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh]

The play store is the last to update of these options, but if you want to join the Play Store testing program go to this URL and opt-in to become a tester. If you encounter any problems or have questions, ask us on the discord, create an issue, or post in the forum and we'll help as we can.

Documentation

The project's documentation is generated with Dokka and hosted on GitHub Pages. It is automatically updated on every push to the main branch.

View Documentation

Generating Locally

You can generate the documentation locally to preview your changes.

  1. Run the Dokka task:
    ./gradlew :app:dokkaHtml
    
  2. View the output: The generated HTML files will be located in the app/build/dokka/html directory. You can open the index.html file in your browser to view the documentation.

Translations

You can help translate the app into your native language using Crowdin.

API & Integration

Developers can integrate with the Meshtastic Android app using our published API library via JitPack. This allows third-party applications (like the ATAK plugin) to communicate with the mesh service via AIDL.

For detailed integration instructions, see core/api/README.md.

Building the Android App

Warning

Debug and release builds can be installed concurrently. This is solely to enable smoother development, and you should avoid running both apps simultaneously. To ensure proper function, force quit the app not in use.

https://meshtastic.org/docs/development/android/

Note: when building the google flavor locally you will need to supply your own Google Maps Android SDK api key MAPS_API_KEY in local.properties in order to use Google Maps. e.g.

MAPS_API_KEY=your_google_maps_api_key_here

Contributing guidelines

For detailed instructions on how to contribute, please see our CONTRIBUTING.md file. For details on our release process, see the RELEASE_PROCESS.md file.

Repository Statistics

Alt

Copyright 2025, Meshtastic LLC. GPL-3.0 license