mapeo-mobile

Monitor and document the world around you

Mapeo Mobile is a mobile app (currently Android only) for offline mapping and monitoring.

⚠ Compatibility & Stability

Mapeo Mobile v2 is unable to sync with Mapeo Mobile v1, due to a change in the way synchronization works. You will need to update all devices to v2 or higher in order to continue syncing.

Due to this sync change, Mapeo Mobile v2 is also unable to sync with Mapeo Desktop v4 or v3. You will need to update Mapeo Desktop to v5 or higher in order to continue syncing.

Mapeo Mobile is currently in Beta. This means that there might be frequent changes to the user interface and there may be changes that break the ability to sync with older versions unless every device updates. We understand that this is an inconvenience if many users are offline and unable to update more easily, and when the sync protocol is more stable we will move Mapeo out of beta and work on a way of updating offline clients offline during sync.

Mapeo Mobile is already being used in the field with dozens of local community partners and is stable and reliable enough for real-world usage, and we work hard to ensure that no data is lost during updates.

You will also see Alpha releases on the releases page. These should be regarded as unstable and likely to crash / not work. We use the Alpha releases for internal testing and once it is stable enough we release it as a Beta. If you don't mind things breaking we really welcome others being able to test the latest Alpha and sending us feedback about any bugs you find.

Install

Download the latest release APK file and install manually on your Android phone.

Usage

Custom presets

Presets must be placed in this folder:

/sdcard/Android/data/com.mapeo/files/presets/default

This folder (default) should contain these files directly in under this default folder (i.e. no sub-folder with a different name):

presets.json
icons/
  myIcon-medium@1x.png
  myIcon-medium@2x.png
  myIcon-medium@3x.png
  ...etc

Offline Maps

Offline maps must be placed in this folder:

/sdcard/Android/data/com.mapeo/files/styles/default

This folder should contain these files derectly under this default folder:

style.json
fonts/
tiles/
  my-offline-tiles.asar
  ...maybe more

Translations

Mapeo is designed to be used in any language, but we rely on volunteers like you to help with translations. You can see current translation status on the Crowdin project page.

If you would like to add translations in your language, you can sign up to Crowdin and being translating immediately.

If you would like your language added to the translations list, please request it.

Maintainers

Community

Connect with the Mapeo community for support & to contribute!

Mailing List (English)
Mailing List (Spanish)
IRC (channel #ddem)
Slack

Contributing

See the contributing file!

PRs accepted.

Small note: If editing the README, please conform to the standard-readme specification.

Supporters

We are extremely grateful to companies that embrace open source and support Mapeo Mobile with services-in-kind:

License

About