The swim-data-analyser is a tool to manipulate and analyze swim workouts from FIT files as provided by Garmin devices. It is heavily inspired by Swimming Watch Tools.
The goal is to provide full client-side parsing and handling of the data, ensuring that no data is transmitted to the server. In the future, long term analysis of workouts is planned. For this use case, an appropriate backend with user handling will be developed. While a database is necessary for this purpose, basic parsing and analysis of single workouts will remain client-side for casual website users.
The project uses Nix flakes to manage developement dependencies. You can follow the setup instructions provided in the section 'Setup' of this tutorial.
dev environment:
nix develop
getting started:
npm install
spin up dev server:
npx webpack --watch
python manage.py runserver
- Clone the repository:
git clone https://github.com/PeterK-end/swim-data-analyser
- adjust
swim_data_analyser/settings.py- change
SECRET_KEYandALLOWED_HOSTS
- change
- Build the Docker Image
docker build -t swim-data-analyser:latest .
- Serve static content and Docker
docker run -p 8000:8000 -v /srv/swim-data-analyser:/app/static swim-data-analyser:latest
- make sure to serve static content
/srv/swim-data-analyservia your webserver and proxy requests to 8000
The project depends on some core libraries listed below:
- parsing
.fitfiles: https://github.com/jimmykane/fit-parser - plots: https://github.com/plotly/plotly.js/
- server and (future) backend: https://www.djangoproject.com/