Support

Report an Issue

Bugs and feature requests go to our GitHub tracker. Issues are public, so you can follow the fix and other people can add to it.

Open a new issue on GitHub

In the app, go to Settings → About & Help and tap Report a bug. It fills in your version and device details, and saves a log file to attach. Add what you did, what you expected and what happened instead.

The repo is for issues only. Our source code isn't published.

Text-to-Speech (TTS)

Which TTS engine should I use?

Pine Maps uses your device's system TTS engine for voice navigation instructions. The default engine varies by device. We recommend RHVoice. It's free, open-source, and available on both Google Play and F-Droid.

Other compatible engines include:

• Google Speech Services: pre-installed on most Android devices with Google services
• eSpeak: lightweight, works well on devices without Google services
• Acapela Voices: commercial, high-quality voices
• Vocalizer: commercial (Nuance), high-quality voices

How to configure TTS

1. Open Settings → Additional Settings → Accessibility
2. Select your preferred TTS engine
3. Adjust speech rate and pitch to your liking
4. In Pine Maps, go to Settings → Voice Instructions and tap Test Voice Directions to verify

TTS not working?

• Make sure a TTS engine is installed and selected in system settings
• On Android 11+ without Google services (e.g. GrapheneOS): install RHVoice from F-Droid
• On LineageOS or custom ROMs: if RHVoice fails to initialize, install eSpeak first, set it as the preferred engine, then install and switch to RHVoice
• On iOS: test TTS by going to Settings → Accessibility → Spoken Content

TTS stops when the app is in the background?

Enable Settings → Accessibility → Select to Speak → Settings → turn on "Read in the background".

TTS Configuration Guide for Android

Pine Maps relies on the Android system TTS engine for spoken turn-by-turn directions. The table below lists supported TTS engines for various languages.

RHVoice is our recommended engine where available. It's free, open-source, and available on Google Play and F-Droid.

How to use Android Auto

Requirements

• Android 9.0 (Pie) or later
• Pine Maps must be installed from Google Play Store (package installer must be com.android.vending)
• Your vehicle or head unit must support Android Auto

Why does it need to be installed from Google Play?

Google requires navigation apps on Android Auto to be installed through the Play Store. Apps installed via F-Droid, Aurora Store, or sideloaded APKs use a different installer source which Android Auto does not recognize. This is a Google restriction, not something Pine Maps controls.

There are community-reported workarounds to make sideloaded apps appear as Play Store installs, but we cannot officially recommend or support these methods.

Setup

1. Install Pine Maps from Google Play
2. Connect your phone to your vehicle via USB or wireless Android Auto
3. Pine Maps should appear in the Android Auto launcher

Advanced Map Editing

Pine Maps includes a simple built-in editor for adding and updating points of interest (POIs) like restaurants, shops and landmarks. For more advanced edits (building outlines, roads, lakes, boundaries) you'll need to use OpenStreetMap editing tools directly.

All edits ultimately go into OpenStreetMap, the free geographic database that powers Pine Maps. Changes you make to OSM appear in Pine Maps after the next map update.

Desktop editing

The easiest way to do advanced editing is the iD Editor in your browser:

1. Go to openstreetmap.org
2. Click Edit and follow the walkthrough tutorial

Mobile editing

Simple edits (recommended for most users):

• StreetComplete (Android): gamified, easy-to-use editor for adding details to existing map features
• Every Door (Android/iOS): quick POI and shop editing

Advanced edits:

• Vespucci (Android): full OSM editor

What happens with my edits?

Changes are instantly added to the public OSM database. Other contributors can see your username and may contact you through OSM's messaging system. Edits are reviewed by the community as part of OSM's moderation process.

Why is the Edit button disabled?

If you don't see the edit button on a place page, the feature may not be editable through the built-in editor. This is common for complex features like buildings, roads and natural areas. Use one of the tools above to edit these in OSM directly.

Help and community

• OSM Community Forum
• OSM Wiki: comprehensive documentation

Frequently Asked Questions

How do I create a route and start navigation?

Once your location is determined on the map, choose your destination:

• tap the search button
• tap the bookmarks button
• tap any place on the map

Once you have chosen a destination, press Route to. The route will be created and you will see the distance and estimated travel time. You can change the route type with the Car, Pedestrian, Subway, Bike or Ruler icon at the top of the screen. To start following the route, tap Start. Press the arrow in the lower right corner of the screen and tap Stop to finish the route.

You can choose a different starting point (Route From) to preview a route, but navigation is only available from your current location.

You can add up to 100 intermediate points to a route. To add an intermediate point, create a route between the start and destination, then tap a point on the map (or select it from bookmarks/search) and tap Add stop.

Some places are missing on the map or have wrong names

Our map data source is OpenStreetMap (OSM), a mapping project similar to Wikipedia but for maps, where anybody can create and edit the map of the world.

If you see incorrect information, or some objects are missing on the map, you can leave a note for OSM volunteers or register and edit the map.

You can also add new places and edit existing POIs and building info (addresses, opening hours, names) directly in Pine Maps. Once you log in with your OSM account, your edits are automatically uploaded to OSM. Please be careful when editing, as your edits are visible to all other users.

The OpenStreetMap database is updated every minute. We aim to update maps in the app 1–4 times per month. Edits you make in OSM appear in future map updates.

The app can't find my position on the map

Make sure your device has GPS, location services are enabled, and location permission is given to Pine Maps.

On your device open Settings → Location. It is better to switch on High accuracy mode, as it enables precise GPS location.

If the app still can't determine your location, enable (or disable) the Google Play Services option in the app settings. This option only appears if Google Play services are installed, and it is used to determine location more precisely.

• Some devices without a built-in GPS receiver (such as WiFi-only tablets) show only an approximate location detected via Wi-Fi while connected to the internet.
• Location detection with GPS satellites alone may take some time. The longer GPS has not been used, the slower the first fix. It works best outdoors with a clear sky; it may struggle indoors, on narrow streets, or in a moving car.

I can't download (update) maps

Your download can fail due to a temporary network error or specific network provider/router settings (firewall blocking). Please try again later or use a different Wi-Fi access point. Also make sure you have enough free space to download maps.

If you have very outdated maps and the app can't update them, deleting the outdated maps and re-downloading them may help.

Search cannot find a place on the map

To search for a place in a specific area, download the relevant map and zoom to that area, or be near that area before you begin the search. For example, to find a place in Vietnam while you are elsewhere, download and open the map of Vietnam first, or mention the country/city name in the search field.

The place may also simply not be on the map yet at OpenStreetMap.org. If you want to help improve the map, follow this guide and add the missing information yourself.

If the place is displayed on the map but search cannot find it, open an issue with the coordinates and an example of your search request.

What can I do if the app has stopped/crashed?

On Android, if you store your maps on an SD card, the most likely cause is a faulty SD card. You can:

1. Delete all downloaded maps and re-download them to the SD card.
2. Delete all downloaded maps, switch to internal device storage, and re-download.
3. Format the SD card and re-download maps.
4. Use a new SD card (recommended).

If the app still crashes, tap Report a bug in Settings → About & Help and attach the log file it saves. Say what you were doing when it crashed. Your version and device details are filled in already.

How do I share (export) favorites?

Tap a place on the map or in a list, then tap Share on the place page.

To share all favorites in a list, open the Favorites page, tap the three-dot menu to the right of the list name and select Export KMZ or Export GPX.

How do I import favorites in KML, KMZ, KMB or GPX format?

You can import favorites sent from Pine Maps or third-party apps if they export in KML, KMZ, KMB or GPX format.

1. Locate the shared file (sent by email, messenger or cloud storage).
2. Tap or tap-and-hold the file and choose Open with Pine Maps.
3. It will open in Pine Maps and you'll see "Favorites loaded successfully!" on the map and in the Favorites screen.

Batch import is also possible: open the Favorites screen, tap Import favorites, and select a folder with KML, KMZ, KMB or GPX files. Pine Maps scans it including subfolders and imports all supported files.

Why are tracks not recorded reliably in the background on Android?

Default battery optimization on Samsung, Huawei, Google, Xiaomi, OnePlus, Meizu, Asus, Wiko, Lenovo, Oppo, Vivo, Realme, Sony, Motorola, HTC and other devices may stop or kill Pine Maps in the background. This is especially true on Android 11 and higher.

The exact steps to make Pine Maps (and other apps) work in the background are listed at dontkillmyapp.com.