Skip to main content

PomiTerm 🍅

A minimal, beautiful Pomodoro timer that lives in your terminal.

Built with Rich for a clean UI — live countdown, a live clock, and a random quote to keep you going.

Install

pipx install pomiterm

Usage

pomiterm

Features

  • Live countdown with progress bar for work sessions, short breaks, and long breaks
  • A cowsay cat displayed during each session
  • Ticking clock on the main screen
  • Random motivational, wisdom, and silly quotes
  • Sound notifications at the end of each session (cross-platform)
  • Configurable durations and cycles from the menu

Default Settings

Setting Value
Work 25 min
Short break 5 min
Long break 15 min
Cycles 4

Requirements

  • Python 3.10+

Sound

Platform Notification
macOS System sounds via afplay (Glass, Ping, Hero)
Windows System sounds via winsound
Linux Terminal bell

Metadata

Release files for pomiterm 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pomiterm 0.2.2
File Size Uploaded
pomiterm-0.2.2.tar.gz 4.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pomiterm 0.2.2
File Interpreter ABI Platform
pomiterm-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 11.2 kB

Release files / pomiterm-0.2.2.tar.gz

Download URL pomiterm-0.2.2.tar.gz
Size 4.9 kB
Tags Source
SHA-256 checksum
How to use checksums
60bd9ff236fd5af0d2e44cfb651f4119a168cb88c8a99c74dfb3b1fdba03d589
BLAKE2b-256 checksum
How to use checksums
750ad73019f6d39cb989959ed6f4f26eaf0a42a42399dcac5c641b918ba87a17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release files / pomiterm-0.2.2-py3-none-any.whl

Download URL pomiterm-0.2.2-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c10471516d22e7e26d2350a4fe5d69c67e371ef3b2d74453bc9251c39a267546
BLAKE2b-256 checksum
How to use checksums
1b800e897c244afced2ee5cfba107d064b45cfcbda4ea7c9b9088ff6f93b5f74
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page