Terminal Running Tracker

A minimalist, terminal-based running tracker built with Python and curses. Log your daily runs, track performance metrics, and visualize trends — all from your terminal.

Features

• Log daily running data: distance, pace, heart rate, cadence
• Mark quality runs
• View 15-day trend line charts (distance, heart rate, pace)
• Keyboard-driven navigation and editing
• Data stored locally in a CSV file
• Fully offline, no cloud, no accounts

Last 15 Days - Distance
12.0 -●--------●-----
10.0 -●---●----●-----
8.0 -●--------●-----

Requirements

• Python 3.8+
• Terminal that supports curses (Unix, macOS, or Windows Terminal/WSL)

🚀 Installation

# Pip
pip install runtracked

# (Optional) GitHub
git clone https://github.com/bearenbey/run-tracker.git
cd run-tracker
pip install .
runtracked

Usage

↑ / ↓: Navigate entries
Enter: Edit selected entry
D: Delete selected entry
Q: Quit and save

Data is saved to runs.csv in the project folder.

Data Format (CSV)

Each run entry is stored with the following fields:

Dev Notes

• ASCII-only characters are used for full terminal compatibility.
• Charts scale dynamically to fit screen height.
• No external dependencies required beyond Python standard library.

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.

© 2025 Eren Öğrül termapp@pm.me