pytrainer is a desktop application for logging and graphing sporting activities such as running or cycling sessions. Data can be imported from GPS devices, files or input manually. Currently pytrainer supports GPX, TCX, and FIT files.

Most popular Linux distributions (Debian, Ubuntu, Fedora and so on) already contain a pytrainer package, use that if available. If a package is not available for your system you can install from source, see below.

Copy tarball file to a location where you have write and execution rights (e.g. your $HOME directory).

tar -xzf pytrainer-X.Y.Z.tar.gz
cd pytrainer-X.Y.Z
pip install ."[gui]"
pytrainer

This installation method is very similar to the basic source install above. For development it makes more sense to start from a git clone instead of a tarball, and also makes more sense to install into a virtual Python environment.

git clone https://github.com/pytrainer/pytrainer.git
cd pytrainer
python3 -m venv .venv
.venv/bin/pip install -e ".[gui]"
.venv/bin/pytrainer

For map functionality the GIR bindings for WebKit2 need to be installed.

Certain plugins and extensions also need additional software:

• FAQ https://github.com/pytrainer/pytrainer/wiki/FAQ
• Distribution list: [email protected]
• Development guide: https://github.com/pytrainer/pytrainer/wiki/Development-guide
• Localization guide: https://github.com/pytrainer/pytrainer/wiki/Localization-guide
• Report an Issue: https://github.com/pytrainer/pytrainer/issues