Skip to content

treee111/wahooMapsCreator

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

998fa33 · Jan 19, 2022
Oct 30, 2021
Jan 19, 2022
Jan 16, 2022
Jan 16, 2022
Oct 15, 2021
Jan 19, 2022
Jan 19, 2022
Jan 19, 2022
Jan 15, 2022
Jan 15, 2022
Jan 19, 2022
Nov 8, 2021
Jan 16, 2022
Jan 19, 2022
Jan 19, 2022
Jan 19, 2022
Dec 10, 2021

Repository files navigation

wahooMapsCreator Logo

Wahoo Maps Creator

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

Basic Overview

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.

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

Optional:

  • use a custom theme on your Wahoo

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:

Or use Anaconda to create a Python environment

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 the arguments 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

Set your arguments as required via the window:

wahooMapsCreator GUI

CLI (Command Line Interface)

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

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.

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:

use a custom theme on your Wahoo

You can use a custom theme to control which OSM-tags are displayed in which zoom-level

Contribution

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

More details can be found here: CONTRIBUTING

Thanks to

@Intyre/Hank for the initial version of the script

@Higli and @Ebe66/ebo for the Windows- port