https://github.com/samr1/fittrackee

Self-hosted outdoor activity tracker :bicyclist:
https://github.com/samr1/fittrackee

activity-tracker chartjs flask gpx gpxpy leaflet outdoor-activities python self-hosted vue3 workout-tracker workouts

Last synced: 7 days ago
JSON representation

Self-hosted outdoor activity tracker :bicyclist:

• Host: GitHub
• URL: https://github.com/samr1/fittrackee
• Owner: SamR1
• License: agpl-3.0
• Created: 2017-04-02T18:08:29.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2026-04-15T12:17:52.000Z (11 days ago)
• Last Synced: 2026-04-15T14:23:33.165Z (11 days ago)
• Topics: activity-tracker, chartjs, flask, gpx, gpxpy, leaflet, outdoor-activities, python, self-hosted, vue3, workout-tracker, workouts
• Language: Python
• Homepage: https://docs.fittrackee.org
• Size: 428 MB
• Stars: 1,100
• Watchers: 13
• Forks: 74
• Open Issues: 88
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# FitTrackee

**A simple self-hosted workout/activity tracker.**  

[![Python Version](https://img.shields.io/pypi/pyversions/fittrackee.svg)](https://python.org)

[![Flask Version](https://img.shields.io/badge/flask-3.1-brightgreen.svg)](http://flask.pocoo.org/) 

[![code formatter: ruff](https://img.shields.io/badge/code%20formatter-ruff-d7ff64)](https://docs.astral.sh/ruff/) 

[![type check: mypy](https://img.shields.io/badge/type%20check-mypy-blue)](http://mypy-lang.org/)  

[![Vue Version](https://img.shields.io/badge/vue-3.5-brightgreen.svg)](https://v3.vuejs.org/) 

[![code formatter: prettier](https://img.shields.io/badge/code%20formatter-prettier-ff69b4.svg)](https://github.com/prettier/prettier) 

[![Typescript Version](https://img.shields.io/npm/types/typescript)](https://www.typescriptlang.org/)  

[![PostgreSQL version](https://img.shields.io/badge/PostgreSQL-14_|_15_|_16_|_17_|_18-336791)](https://www.postgresql.org/) [![PostgreSQL version](https://img.shields.io/badge/PostGIS-3.4_|_3.5_|_3.6-5b7b9f)](https://postgis.net/)  

[![PyPI version](https://img.shields.io/pypi/v/fittrackee?logo=pypi)](https://pypi.org/project/fittrackee/) [![docker image version](https://img.shields.io/docker/v/fittrackee/fittrackee?logo=docker)](https://hub.docker.com/r/fittrackee/fittrackee)  

[![Coverage Status](https://coveralls.io/repos/github/SamR1/FitTrackee/badge.svg?branch=main)](https://coveralls.io/github/SamR1/FitTrackee?branch=main)1 [![pipeline status](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-and-publish-python.yml/badge.svg)](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-and-publish-python.yml)

[![pipeline status](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-javascript.yml/badge.svg)](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-javascript.yml)  

[![translation status](https://hosted.weblate.org/widgets/fittrackee/-/svg-badge.svg)](https://hosted.weblate.org/engage/fittrackee/)

[![translation languages](https://hosted.weblate.org/widget/fittrackee/language-badge.svg)](https://hosted.weblate.org/engage/fittrackee/)   

[![Matrix](https://img.shields.io/matrix/fittrackee%3Amatrix.org?logo=matrix)](https://matrix.to/#/#fittrackee:matrix.org)

[![Mastodon Follow](https://img.shields.io/mastodon/follow/109270806934115805?domain=fosstodon.org)](https://fosstodon.org/@FitTrackee)  

---

Web application allowing tracking of outdoor activities (workouts) from files, \

with data on your own server.  

Several mobile apps or devices can store workouts data locally and export them into a file.  

Examples for Android (non-exhaustive list):  

* [FitoTrack](https://codeberg.org/jannis/FitoTrack) (GPLv3)  

* [OpenTracks](https://codeberg.org/OpenTracksApp/OpenTracks) (Apache License)  

* [Runner Up](https://github.com/jonasoreland/runnerup) (GPLv3)  

To get workouts from devices like smartwatches:

* [Amazfish](https://amazfish.github.io/) (Sailfish OS, GPLv3, integration with FitTrackee from v2.9.0)

* [Gadgetbridge](https://gadgetbridge.org) (Android, GPLv3, no integration)

It is also possible to add a workout without a file.

Map data from [OpenStreetMap](https://www.openstreetmap.org).  

## Documentation

- [Features](https://docs.fittrackee.org/en/features/index.html)

- [Installation instructions](https://docs.fittrackee.org/en/installation/index.html)

- [Command line interface](https://docs.fittrackee.org/en/cli.html)

- [Third-party tools](https://docs.fittrackee.org/en/third_party_tools.html)

- [Changelog](https://docs.fittrackee.org/en/changelog.html)

- [Troubleshooting](https://docs.fittrackee.org/en/troubleshooting/index.html)

- [Contributing](https://docs.fittrackee.org/en/contributing.html)

**Under heavy development (some features may be unstable).**  

(see [provisional roadmap](https://github.com/SamR1/FitTrackee/issues/1010), [issues](https://github.com/SamR1/FitTrackee/issues) and [documentation](https://docs.fittrackee.org) for more information)  

![FitTrackee Dashboard Screenshot](https://docs.fittrackee.org/en/_images/dashboard.png)

## Translations

FitTrackee uses [Weblate](https://hosted.weblate.org/engage/fittrackee/) for translation management.

Status (on development branch, may differ from the released version):

[![Translation status](https://hosted.weblate.org/widget/fittrackee/multi-auto.svg)](https://hosted.weblate.org/engage/fittrackee/)

---

1: _test coverage: only for Python API and CLI_