Fix Garmin watch and map problems on Mac
Find the problem you see, from a Garmin watch that doesn’t show up on your Mac to a map download that fails, and follow the short steps. If nothing helps, send a report and I’ll take a look.
Garmin Edge not showing up on Mac
Newer Garmin Edge bike computers with map support connect to a Mac the same way current Garmin watches do, so most steps on this page work for an Edge too: use a USB data cable, quit Garmin Express and wait up to 2 minutes. Older Edge models that show up as a drive in Finder work differently.
Read the Garmin Edge guideGarmin watch connection problems
Garmin watch not showing up on Mac
Connect the watch directly to your Mac with a USB cable that supports data, unlock it and wait up to 2 minutes: Terento finds it automatically.
- Use a USB data cable. Charge-only cables and some USB hubs don’t work.
- Your watch or Edge won’t appear in Finder, and that’s normal: macOS doesn’t open most current Garmin watches and newer Edge models as a drive. Terento talks to the device directly.
- On a Mac laptop, if macOS asks whether to allow the accessory to connect, choose Allow.
- Wait up to 2 minutes while Terento checks the connection.
- If the watch still doesn’t appear, unplug it, wait a few seconds and connect it again.
- If another app is open, see Garmin Express or another app is using the watch.
Garmin Express or another app is using the watch
Quit Garmin Express and file-transfer apps such as Android File Transfer, OpenMTP or MacDroid: only one app at a time can use the connection to the watch or Edge.
- Quit Garmin Express, Android File Transfer, OpenMTP, MacDroid and other MTP apps. If Terento names an app, quit that one first.
- Also close Image Capture, Photos and Preview if they are open.
- If the watch appears in Finder, eject it there.
- Unplug the watch, connect it again, then choose “Refresh” in Terento.
More than one Garmin device connected
Disconnect every Garmin device except the watch you want to use: Terento works with one Garmin at a time.
- Unplug other Garmin watches, bike computers and handheld devices.
- Keep the watch you want to use connected and wait for Terento to find it.
Garmin watch not recognized: USB mode (MTP)
If Terento says the watch isn’t ready for file transfer, set the watch’s USB Mode to MTP, if your model has this setting.
- On the watch, open USB Mode, usually under Settings › System. Not every model has it.
- Choose MTP.
- Disconnect the watch and connect it again.
More details
MTP (Media Transfer Protocol) is how most current Garmin watches share files over USB, the same way Android phones do. macOS has no built-in MTP support, so the watch doesn’t show up as a drive; Terento uses MTP itself, so you don’t need Android File Transfer or OpenMTP.
Garmin watch detected but not ready
If Terento finds the watch but the connection doesn’t become ready within 2 minutes, unplug the watch and connect it again.
- Quit other apps that may be using the watch. See Garmin Express or another app is using the watch.
- Try another USB port or cable.
- If it keeps happening, restart the watch and connect it again.
More details
Occasional connection stalls are a known limit of the current version.
Garmin watch stopped responding
Unplug the watch, wait a few seconds and connect it again: the connection was lost or the watch stopped answering Terento.
- If Terento was installing, updating or removing a map, open “Manage maps” after reconnecting and check the result before you try again.
- Restart the watch if it keeps happening.
Watch and map checks
Map installation not available for this Garmin model
Terento installs maps only on Garmin watches with map support that are enabled in Terento.
- Check that your watch model supports maps.
- Terento checks its current list each time you connect. If your model is enabled later, connect the watch again.
- Tell us your exact model so we can review it. See How to report a problem.
More details
You can still connect this watch and browse the maps.
Terento couldn’t check your Garmin watch
Check that your Mac is online, then connect the watch again: Terento needs an internet connection to check whether this watch can install maps.
- Open a website to confirm your Mac is online.
- Unplug the watch and connect it again to repeat the check.
- If it still fails, wait a few minutes and try again.
Map downloads and free space
Garmin map download failed
Check your internet connection and try again later: Terento downloads each map directly from its provider, and providers are sometimes slow or temporarily unavailable.
- Read the reason shown beside the map. If the provider is unavailable or downloads are paused, try again later.
- Start the installation again.
Not enough space on the Mac to download the map
Free up space on your Mac and try again: Terento needs temporary space to download and prepare a map.
- Remove files you no longer need and empty the Trash.
- Try again. Large regions need more space.
Not enough space for Garmin maps on the watch
Choose a smaller region or remove a map you no longer need: Terento checks the watch’s free space before installing and doesn’t start if the maps won’t fit.
- Choose a smaller region or fewer maps.
- Open “Manage maps” and remove a map you no longer need.
- An update needs extra space while the new map is checked. Free up space if an update can’t start.
Map installs, updates and removals
Map installation failed: leftover map on the watch
Remove the leftover map in “Manage maps”, then install it again.
- Connect the watch again and wait until Terento is ready.
- Open “Manage maps” and check the list.
- If the map from the failed installation is listed, remove it, then install it again.
- If it fails again, send a report.
More details
If an installation stops after copying started, part of the map can stay on the watch, and Terento doesn’t remove it automatically.
Map update or removal takes a long time
This is expected in the current version: updating or removing a map can stay at a high percentage for a while before it finishes.
- Don’t unplug the watch while Terento is working.
- Wait until Terento says it is done.
- If Terento reports a failure, connect the watch again and check “Manage maps” before you try again.
More details
Keep the watch connected and your Mac awake.
Getting help
How to report a problem with Terento
Choose “Report issue” on the failure screen: Terento opens GitHub with the report it saved on your Mac already filled in.
- Later, you can use “Report latest failure” in “Diagnostics”.
- If the GitHub form is empty, click the report field, press ⌘A and then ⌘V.
- Review the report before posting: GitHub issues are public.
- No GitHub account? Email hello@terento.app with your watch model, the map region and what happened.
Put a free map on your Garmin