Wahoo Maps Creator

A tool to create up-to-date maps for your Wahoo ELEMNT BOLT and Wahoo ELEMNT! It runs on macOS, Unix as well as on Windows!

Basic Overview

WahooMapsCreator is a tool to create updated maps for Wahoo ELEMNT BOLT and Wahoo ELEMNT devices for your country.
The maps of your device may be old because Wahoo did not release a newer version in the last years. OSM maps are constantly updated and with this program, the updated maps can be used on our Wahoo bike-computers.

Get it running

The instructens are intended to be suitable for beginners.
If anything is unclear or just wrong, write an issue!

Overview of the steps

The steps for all OS are similar:

Download and Install required programs
Download a release of wahooMapsCreator or clone Repository
Run wahooMapsCreator for your country
Copy the map-files to your device

Download and Install required programs

The initial setup takes some minutes but is only a one-timer!

Follow the Quick Start guide depending on your OS:

Get wahooMapsCreator

Download the latest Release from the "Releases" Section and Save the folder on your drive. You can also clone the repository and have the latest coding.

Run wahooMapsCreator

wahooMapsCreator can be used in two different ways.

Both ways support the same arguments to be used for the map-creation process. You can choose them via GUI or as CLI-arguments.

GUI (Graphical User Interface)

From the root folder of wahooMapsCreator, run:

python3 wahoo_map_creator.py or
python wahoo_map_creator.py

CLI (Command Line Interfaces)

From the root folder of wahooMapsCreator, run:

python3 wahoo_map_creator.py <country_name> or
python wahoo_map_creator.py <country_name>

Run wahooMapsCreator for your country

It might be a good idea to run wahooMapsCreator first for a small country e.g. Malta to check if everything is running fine.
In a next step you can run it for your own country.

Basic CLI-Usage

from the root folder of wahooMapsCreator, run:

python3 wahoo_map_creator.py <country_name> or
python wahoo_map_creator.py <country_name>

Examples:

for Malta: python3 wahoo_map_creator.py malta
for Ireland: python3 wahoo_map_creator.py ireland

Advanced CLI-Usage

The script supports many arguments.
For a list of all supported arguments, run:

python3 wahoo_map_creator.py -h or
python wahoo_map_creator.py -h

Examples:

for Malta, download new maps if existing maps are older than 100 days and process files even if files exist
- python3 wahoo_map_creator.py malta -md 100 -fp
for Germany, download and process whole tiles which involves other countries than the given
- python3 wahoo_map_creator.py germany -bc

Copy the map-files to your device

When file-creation is finished copy the map-files to your device:

Copy maps files to Wahoo

Contribution

You are welcome to provide input via Pull Requests, Issues or in any other way!
Discussion goes on:

in this telegram channel: https://t.me/joinchat/TaMhjouxlsAzNWZk
in this google group: https://groups.google.com/g/wahoo-elemnt-users/c/PSrdapfWLUE

More details can be found here: CONTRIBUTING

Thanks to

@Intyre/Hank for the initial version of the script

@Higli and @ebo for the Windows- port

mweirauch/wahooMapsCreator