Tools and games

Terminal Pomodoro Timer in C++

A terminal Pomodoro timer written in C++17 that draws the countdown inside an ASCII iMac frame with ANSI color themes. It reads keys through POSIX termios without blocking, so you can pause, resume or skip, and it logs each completed session to session_log.txt.

Stack
C++17, POSIX termios
Code
github.com/ADM1SH/pomodoro-timer

Overview

Install

Start the timer from your terminal:

./pomodoro

Controls

  • Space: Pause or resume current countdown.
  • s: Skip current interval (transition focus to break).
  • q: Quit timer and write session summary to log.

Session History

Completed sessions are automatically preserved in session_log.txt:

==================================================
Date: 2026-03-08 14:30:00 | Duration: 50 min | Focus
Date: 2026-03-08 15:20:00 | Duration: 10 min | Break
==================================================

Updates

  • docs: update README with comprehensive documentation
  • docs: expand README to open source standards
  • docs: add detailed README with project overview and build instructions

Docs

The full documentation covers how it works, configuration and results.