This is a tool for using Android with open-source mesh radios.
 
 
Go to file
andrekir b445faf574 remove mapbox reference 2022-08-29 11:06:47 -03:00
.github remove mapbox reference 2022-08-29 11:06:47 -03:00
.idea Remove files about to be added to .gitignore 2022-02-08 14:48:58 -08:00
.settings Don't include firmware in development builds (speeds install time) 2020-06-28 14:55:02 -07:00
app remove mapbox reference 2022-08-29 11:06:47 -03:00
deprecated update to latest launcher icon from @thepoweroftwo 2021-02-01 10:31:24 +08:00
design@a810741521 update to latest launcher icon from @thepoweroftwo 2021-02-01 10:31:24 +08:00
geeksville-androidlib@74b05e465b updating androidlib submodule to latest 2022-07-12 00:02:41 -03:00
gradle/wrapper update gradle 2022-06-07 08:31:29 -03:00
images Fix amazon button 2021-05-28 10:21:20 +08:00
scripts map analytics optional 2020-04-11 13:20:30 -07:00
.gitignore remove mapbox reference 2022-08-29 11:06:47 -03:00
.gitmodules update libs 2021-01-29 13:44:30 +08:00
.project Don't include firmware in development builds (speeds install time) 2020-06-28 14:55:02 -07:00
LICENSE Add license and copyright 2020-03-01 16:39:53 -08:00
README.md Remove all references to MapBox, MapBox tokens, and credentials 2022-08-23 22:49:46 -04:00
TODO.md WIP update to android 30 2021-06-10 10:02:28 -07:00
build.gradle Remove all references to MapBox, MapBox tokens, and credentials 2022-08-23 22:49:46 -04:00
debugging-android.md add instructions on how to capture logcat logs 2020-03-07 17:19:36 -08:00
gradle.properties update to latest IDE 2020-01-20 16:13:40 -08:00
gradlew update gradle to 6.4 2020-05-29 14:11:43 -07:00
gradlew.bat update gradle to 6.4 2020-05-29 14:11:43 -07:00
settings.gradle Pull in geeksville-androidlib via git submodule 2020-03-02 10:02:50 -08:00

README.md

Meshtastic-Android

GitHub all releases Android CI 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, if you have questions or feedback please Join our discussion forum. We would love to hear from you!

The production version of our application is here:

Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh

To join the beta program for the app go to this URL to opt-in to the alpha/beta test. If you encounter any problems or have questions, post in the forum and we'll help.

The app is also distributed via F-Droid repo: https://mesh.tastic.app/fdroid/repo

However, if you must use 'raw' APKs you can get them from our github releases. This is not recommended because if you manually install an APK it will not automatically update.

Build instructions

If you would like to develop this application we'd love your help! These build instructions are brief and should be improved, please send a PR if you can.

  • Use Android Studio to build/debug
  • Use "git submodule update --init --recursive" to pull in the various submodules we depend on
  • There are a few config files which you'll need to copy from templates included in the project. Run the following commands to do so:
rm ./app/google-services.json
cp ./app/google-services-example.json ./app/google-services.json
rm ./app/src/main/res/values/curfirmwareversion.xml
cp ./app/special/curfirmwareversion.xml ./app/src/main/res/values/
  • Now you should be able to select "Run / Run" in the IDE and it will happily start running on your phone or the emulator. Note: The emulators don't support bluetooth, so some features can not be used in that environment.

Analytics setup

  • analytics are included but can be disabled by the user on the settings screen

  • on dev devices

adb shell setprop debug.firebase.analytics.app com.geeksville.mesh
adb shell setprop log.tag.FirebaseCrashlytics DEBUG

for verbose logging:

adb shell setprop log.tag.FA VERBOSE

Credits

This project is the work of volunteers:

  • @artemisoftnian: Contributed Spanish translations.
  • @CycloMies: Contributed Swedish, Finnish and German translations.
  • @eriktheV-king: Contributed Dutch and French translations.
  • @Lgoix: Contributed tooltip for radio mode
  • @Eugene: Contributed Russian translation.
  • @Jinx17: Contributed Slovenian translation.
  • @Konradrundfunk: Contributed German fixes.
  • @Mango-sauce: Contributed Chinese translation.
  • @NEKLAN: Contributed Japanese translation.
  • @Ohcdh: Contributed Irish and Italian translations.
  • @Slavino: Contributed Slovak translation.
  • @Zone: Contributed Turkish translation.

Copyright 2022, Geeksville Industries, LLC. GPL V3 license