FitTrackee/README.md

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

[![PyPI version](https://img.shields.io/pypi/v/fittrackee.svg)](https://pypi.org/project/fittrackee/) 
[![Python Version](https://img.shields.io/badge/python-3.8+-brightgreen.svg)](https://python.org)
[![Flask Version](https://img.shields.io/badge/flask-3.0-brightgreen.svg)](http://flask.pocoo.org/) 
[![code style: black](https://img.shields.io/badge/code%20style-black-black)](https://github.com/psf/black) 
[![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.4-brightgreen.svg)](https://v3.vuejs.org/) 
[![Typescript Version](https://img.shields.io/npm/types/typescript)](https://www.typescriptlang.org/) 
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)  
[![pipeline status](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-python.yml/badge.svg)](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-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/)  

---

This web application allows you to track your outdoor activities (workouts) from gpx files and keep your data on your own server.  
No mobile app has been developed yet, but several existing mobile apps can store workouts data locally and export them into a gpx file.  
Examples for Android (non-exhaustive list):  
* [Runner Up](https://github.com/jonasoreland/runnerup) (GPL v3)  
* [OpenTracks](https://github.com/OpenTracksApp/OpenTracks) (Apache License)  
* [FitoTrack](https://codeberg.org/jannis/FitoTrack) (GPL v3)  

Maps are displayed using [Open Street Map](https://www.openstreetmap.org).  
It is also possible to add a workout without a gpx file.

**Still under heavy development (some features may be unstable).**  
(see [issues](https://github.com/SamR1/FitTrackee/issues) and [documentation](https://samr1.github.io/FitTrackee) for more information)  

![FitTrackee Dashboard Screenshot](https://samr1.github.io/FitTrackee/en/_images/fittrackee_screenshot-01.png)
'mpwo' renamed to 'FitTrackee' 2018-06-07 15:40:22 +02:00			`# FitTrackee`
README.me update + minor changes 2018-05-30 17:48:58 +02:00			`A simple self-hosted workout/activity tracker.`
dashboard - first version 2017-04-02 20:12:15 +02:00
update README.md 2021-01-03 10:25:05 +01:00			`[![PyPI version](https://img.shields.io/pypi/v/fittrackee.svg)](https://pypi.org/project/fittrackee/)`
bump to version 0.7.18 2023-06-25 14:00:35 +02:00			`[![Python Version](https://img.shields.io/badge/python-3.8+-brightgreen.svg)](https://python.org)`
bump to version 0.7.24 2023-10-04 17:40:59 +02:00			`[![Flask Version](https://img.shields.io/badge/flask-3.0-brightgreen.svg)](http://flask.pocoo.org/)`
update README.md 2019-08-31 14:17:47 +02:00			`[![code style: black](https://img.shields.io/badge/code%20style-black-black)](https://github.com/psf/black)`
update README.md 2021-01-03 09:54:36 +01:00			`[![type check: mypy](https://img.shields.io/badge/type%20check-mypy-blue)](http://mypy-lang.org/)`
bump to version 0.7.29 2024-01-06 17:57:58 +01:00			`[![Vue Version](https://img.shields.io/badge/vue-3.4-brightgreen.svg)](https://v3.vuejs.org/)`
update documentation 2021-11-03 12:41:23 +01:00			`[![Typescript Version](https://img.shields.io/npm/types/typescript)](https://www.typescriptlang.org/)`
update README.md 2019-08-31 14:17:47 +02:00			`[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)`
bump version to 0.6.4 2022-04-23 08:28:41 +02:00			`[![pipeline status](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-python.yml/badge.svg)](https://github.com/SamR1/FitTrackee/actions/workflows/.tests-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)`
bump version to 0.6.9 2022-07-03 17:27:43 +02:00			`[![translation status](https://hosted.weblate.org/widgets/fittrackee/-/svg-badge.svg)](https://hosted.weblate.org/engage/fittrackee/)`
API: minor fix 2017-12-17 12:07:25 +01:00
README.me update + minor changes 2018-05-30 17:48:58 +02:00			`---`

API - replace 'Activity' with 'Workout' - #58 2021-01-10 11:16:43 +01:00			`This web application allows you to track your outdoor activities (workouts) from gpx files and keep your data on your own server.`
Fix grammar issue 2022-07-29 08:27:55 +02:00			`No mobile app has been developed yet, but several existing mobile apps can store workouts data locally and export them into a gpx file.`
Docs - remove proprietary app from list of examples of tracking apps 2021-06-06 11:30:51 +02:00			`Examples for Android (non-exhaustive list):`
README.me update + minor changes 2018-05-30 17:48:58 +02:00			`* [Runner Up](https://github.com/jonasoreland/runnerup) (GPL v3)`
update documentation 2020-07-15 17:19:37 +02:00			`* [OpenTracks](https://github.com/OpenTracksApp/OpenTracks) (Apache License)`
			`* [FitoTrack](https://codeberg.org/jannis/FitoTrack) (GPL v3)`
Update README.md 2018-05-30 18:40:24 +02:00
Update README.md 2018-06-15 11:37:30 +02:00			`Maps are displayed using [Open Street Map](https://www.openstreetmap.org).`
			`It is also possible to add a workout without a gpx file.`
README.me update + minor changes 2018-05-30 17:48:58 +02:00
update documentation 2020-09-19 13:56:14 +02:00			`Still under heavy development (some features may be unstable).`
update README.md to add link to documentation - #21 2019-07-14 19:54:44 +02:00			`(see [issues](https://github.com/SamR1/FitTrackee/issues) and [documentation](https://samr1.github.io/FitTrackee) for more information)`
README.me update + minor changes 2018-05-30 17:48:58 +02:00
bump to version 0.7.18 2023-06-25 14:00:35 +02:00			`![FitTrackee Dashboard Screenshot](https://samr1.github.io/FitTrackee/en/_images/fittrackee_screenshot-01.png)`