Py-Tabata-Timer 0.1.3

A minimal and practical Tabata Timer

Tabata Desktop App

🎯 Overview

Tabata Desktop App is a high-precision, configurable timing tool designed for athletes and practitioners of the Tabata protocol. Developed in Python 3.11, this application provides a minimalist yet robust interface to manage High-Intensity Interval Training (HIIT) sessions directly from your desktop.

• Author: Marco Baturan
• Version: v0.1.0
• Status: Stable / Production Ready
• License: Creative Commons Zero (CC0)

🖼️ Visuals

🔬 Scientific Foundation

The Tabata protocol is a specialized form of HIIT characterized by 20 seconds of ultra-high-intensity exercise followed by 10 seconds of rest, repeated for a specific number of cycles (typically 8).

This application is engineered to respect these precise physiological requirements, ensuring accurate timing to maximize both aerobic and anaerobic capacity improvements as established in sports science literature.

Key Evidence & References

• [Original Study (1996)]: Effects of moderate-intensity endurance and high-intensity intermittent training on anaerobic capacity and VO2max - The foundational research by Dr. Izumi Tabata.
• [HIIT & Metabolism]: High-Intensity Intermittent Training and Fat Loss - Comprehensive review on metabolic impact.
• [Professional Analysis]: American Council on Exercise (ACE) - Clinical breakdown of protocol effectiveness.

⚙️ Installation

This application is optimized for Python 3.11.2. Compatibility with other versions is not guaranteed.

Previously

$ sudo apt install python3-tk

Using UV (Recommended)

UV is the fastest way to manage dependencies and execute the application:

# Sync dependencies from uv.lock
uv sync

# Run the application
uv run app.py

Traditional Installation (pip)

# Create and activate environment
python -m venv env
source env/bin/activate  # On Windows: .envScriptsactivate

# Install requirements
pip install -r requirements.txt

# Execute
python app.py

📖 Usage Instructions

1. Define Intervals: Set the "Active Duration" (Work) and "Break Duration" (Rest) in seconds.
2. Set Rounds: Choose the number of cycles/sets for your session.
3. Data Persistence: Use the Save button to store your current configuration in a local file. Use Delete to clear stored settings.
4. Session Control:
   • START: Begins the workout sequence.
   • PAUSE: Suspends the timer (ideal for unexpected interruptions).
   • RESTART: Resumes the session from the current state.
   • STOP: Safely terminates the session and exits the cycle.

Disclaimer: High-intensity interval training can be physically demanding. Consult a physician before beginning any new exercise regimen.