Komoot - Personal Heatmap

Quickly map all the places you have been on one map.

Visit Website · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. Contact

About The Project

🚀 Try the tool: Komoot - Personal Heatmap

📰 Read the story: Komoot Heatmap: Combining Cycling and Programming

Welcome to the Komoot - Personal Heatmap! This project aims to provide cyclists with an interactive and informative tool for visualizing their riding experiences. This program generates heatmaps that showcase all cycling routes over time, allowing users to explore and visualize their popular paths and hotspots.

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• Docker (x86 / x64)

Installation

NOTE: Sadly, Komoot does not give independent and small developers access to their API. Therefore, I rely on a community-made solution. (Thank you @matiyau for komPYoot) This however, does not support OAuth2 and only allows verification through email and password. I am not interested in your data and will not use it for any other purposes than to authenticate you. It will not be stored on any server. If you are still not comfortable with this, feel free to host the project yourself.

1. Clone the repo

   git clone https://github.com/oskarkraemer/komootHeatmap.git

2. Build Docker image

   docker build -t komoot-heatmap:latest .

3. Create Docker container and run

    docker run -p 80:80 komoot-heatmap:latest

4. Access http://localhost:80 through an internet browser

(back to top)

Usage

1. Log in with your credentials at http://localhost:80.

2. You may choose from 4 different visualizations:

   • Heatmap: Displays routes in an opaque red shade, allowing you to see the most used paths
   • Speed: Gradient from blue to red, indicating the speed at certain points
   • Incline: Gradient from blue to red, indicating the incline in percent
   • Elapsed Time: Shows how long you have already been on the tour at a certain point

Roadmap

• Get access to Komoot's official API and OAuth2
• Offer a hosted solution for easy access [Visit hosted version]
• Social features
  • Sharing your heatmap with friends
  • Comparing your heatmap with other people

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contact

Oskar Krämer - [email protected]