tm-timer 2.2

Minimalistic terminal-based timer with Study/Train tracking

In The Name of God

---

⏱️ tm-timer

Minimalistic Terminal timer with dynamic activity tracking

Features

• Countdown timer:
  • tm 10s, tm 25m, tm 1h30m
• Dynamic Activity modes (track anything):
  • tm -a study -> track study sessions
  • tm -a train -> track training sessions
  • tm -a reading -> track custom activities (resets daily, accumulates across multiple runs)
• Daily logging:
  • Records totals in ~/.tm_timer/data.json
  • Each day resets at midnight (splits time correctly if a session crosses midnight)
• Statistics:
  • Average daily hours
  • Standard Deviation of Time
  • Status report:
    • Very Good (SD < AVG/2)
    • Good (SD = AVG/2)
    • Not Good (SD > AVG/2)
• Export & Management:
  • tm -s study -> show study table + stats
  • tm --list -> list all tracked activities and their total time
  • tm -t -> export all activity tables to tables.md
• Controls:
  • p -> pause/resume
  • q -> quit and save

---

Installation

sudo apt install pipx       # if not installed
pipx install tm-timer       # install tm-timer
pipx ensurepath             # add tm to PATH
exec $SHELL                 # reload shell

---

Example Usage

# Start a study session
tm -a study

# Check study stats
tm -s study

# Start a train session
tm -a train

# Start a custom activity session (e.g., reading)
tm -a reading

# List all recorded activities
tm --list

# Export tables to tables.md
tm -t

---

Example Tables Output

## STUDY Table

| Date       | Day | Time   |
| ---------- | --- | ------ |
| 2025-10-03 | FRI | 05:00:00 |
| 2025-10-02 | THU | 02:50:00 |
| 2025-09-29 | MON | 04:05:00 |
| 2025-09-27 | SAT | 03:36:00 |

[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good


## TRAIN Table

| Date       | Day | Time   |
| ---------- | --- | ------ |
| 2025-10-03 | FRI | 00:57:00 |
| 2025-10-02 | THU | 00:50:00 |
| 2025-09-30 | SUN | 00:35:00 |
| 2025-09-28 | SAT | 01:36:00 |

[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good