This program is a simple python tool to help me get rid of the hustle around tracking my training sessions. You can easily enter information through the CLI (Command Line Interface) and it will be saved in a TinyDB database ready for analysis.
Once you tracked your exercise, you can create a detailed analysis to understand your own habits better*.
None of your data will be shared and there is no internet connection required for usage, it is how ever neccessary during the installation process.
*Future feature, see Roadmap
Download one of the executables from the assets of a release suiting your system. Follow the release notes' instructions.
-
git installed and working
-
python (only tested with 3.12 and 3.13) >= 3.12, <=4.0 installed and working (conda recommended)
-
pip installed and working
Install poetry via pip (recommended to do so in a conda environment for cleaner Python version management):
pip install poetryClone the project to a destination of your liking:
git clone https://github.com/tilhammer/Workout-Tracker.gitNow, switch into the directory and install the dependencies it with poetry:
cd Workout-Tracker
poetry installTo run, type:
poetry run python workout-tracker.pyClone the project to a destination of your liking:
git clone https://github.com/tilhammer/Workout-Tracker.gitNow, switch into the directory and install the requirements. It is recommended to use conda or a similar python installation manager:
cd Workout-Tracker
pip install requirements.txtTo run, type:
python workout-tracker.pyIf the installation or running fails, check python --version and pip --version. You might have python3 and pip3 installed, especially under Linux. In that case substitute python3 and pip3 for all python and pip commands.
If this still doesn't work using Method B, please check if the requirements.txt file located at the head of the project is up to date with the project.dependencies in the pyproject.toml file. I have to manually generate the requirements.txt file, so there could be mistakes. Contact me in that case or open an issue please and try using Option A to ensure the poetry install works.
It is further recommended to create a simple script for running the project, especially if you use conda and have a nested home directory structure.
- Creating tracking functionality with the CLI
- Adding custom types of exercise
- Removing workouts afterwards
- Adding functionality to analyse specific time intervals (custom intervals still missing)
- Adding basic analysing functionality with CLI (most stats done)
- Adding diagram analysation
- Adding export functionality for statistics and diagrams
- Commenting code for easier understanding and improvement
- Writing tests
- Adding recurring and customised time intervals for analysis
- Adding custom diagrams
- Adding comparison of different timeframes and exercise-categories
If you have downloaded an executable, simply delete it combined with the data folder next to it.
If you used python to run the project, delete the cloned project folder to get rid of all data.
That's it!
If you need help with the installation, feel free to reach out to me or create a GitHub issue. Check if there have been similar issues that were already closed.
You are always allowed to edit the code and make changes to the program. If you would like to contribute to the project, either create a fork or contact me.
Feature suggestions are always welcome, but there is no guarantee for implementation as I might be busy. You are always free to implement them by yourself.