WahooMapsCreator is a tool to create maps based on the latest OSM data for your Wahoo devices. You can generate maps for the countries you like and you can control which OSM-tags are included.
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.
The instructens are intended to be suitable for beginners. If anything is unclear or just wrong, write an issue!
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
Optional:
- use a custom theme on your Wahoo
The initial setup takes some minutes but is only a one-timer!
Follow the Quick Start guide depending on your OS:
Or use Anaconda to create a Python environment
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.
wahooMapsCreator can be used in two different ways:
- as graphical window programm
- as command line programm
Both ways support the same arguments to be used for the map-creation process. You can choose the arguments via GUI or as CLI-arguments.
From the root
folder of wahooMapsCreator, run:
python3 wahoo_map_creator.py
orpython wahoo_map_creator.py
Set your arguments as required via the window:
From the root
folder of wahooMapsCreator, run:
python3 wahoo_map_creator.py <country_name>
orpython wahoo_map_creator.py <country_name>
Examples:
- for Malta:
python3 wahoo_map_creator.py malta
- for Ireland:
python3 wahoo_map_creator.py ireland
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.
The script supports many arguments. For a list of all supported arguments, run:
python3 wahoo_map_creator.py -h
orpython 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
When file-creation is finished copy the map-files to your device:
You can use a custom theme to control which OSM-tags are displayed in which zoom-level
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
@Intyre/Hank for the initial version of the script
@Higli and @Ebe66/ebo for the Windows- port