Skip to main content

A minimal local Pomodoro timer for the terminal (no accounts, no cloud)

I wanted a simple Pomodoro timer that works locally, offline, and doesn’t require an account or sync anything to the cloud. Most Pomodoro apps I tried were SaaS‑based or came with way more features than I needed... So I built MPomidoro.

It runs entirely in the terminal and keeps everything on your machine.

What it does:
- runs locally, no cloud, no telemetry
- no accounts, no sync
- configurable work/break intervals and cycle count
- guides you through each Pomodoro stage
- generates a small session report at the end

works on Windows and Linux (Python, no external deps)

It’s not a “self‑hosted service”, but it is a local‑first alternative to Pomodoro apps that store data online. Sharing it here in case anyone prefers lightweight, offline tools.

GitHub: github.com/Mietkiewski/MPomido…

Gumroad PWYW $0+: mietkiewski.gumroad.com/l/mpom…


GitHub - Mietkiewski/MPomidoro: MPomidoro is a minimal, console‑based Pomodoro timer for Windows and Linux. It offers structured work and break intervals, clear cycle progression, and clean session reports — all inside a fast, distraction‑free terminal wo

MPomidoro is a minimal, console‑based Pomodoro timer for Windows and Linux. It offers structured work and break intervals, clear cycle progression, and clean session reports — all inside a fast, di...
GitHub
#selfhosted
in reply to mietkiewski_dev

mietkiewski_dev
mietkiewski_dev
• •
For anyone wondering how a session looks, here’s a small example:
Title: Plan the weekly tasks
Work interval time in Minutes: 15
Break interval time in Minutes: 5
Intervals Count: 3
Pomidoro
Plan the weekly tasks
3 x 15min 5min

WORK #1 15min
BREAK #1 5min
WORK #2 15min
BREAK #2 5min
WORK #3 15min
BREAK #3 5min

Conclusions: This session helped me organize my thoughts.

The tool asks for a short conclusion at the end — I found that part surprisingly helpful for wrapping up a session.
in reply to TechnoCat

mietkiewski_dev
mietkiewski_dev
• •
It prints the stage transitions, but the actual countdown runs in the terminal as MM:SS.
When a work or break interval finishes, it marks the line in green so it’s easy to spot.
in reply to mietkiewski_dev

abeorch
abeorch
•
I had to search to see what a #Pomodoro was .. interesting - a time management technque - en.wikipedia.org/wiki/Pomodoro…
#pomodoro

Selfhosted reshared this.

in reply to abeorch

mietkiewski_dev
mietkiewski_dev
• •
Yeah, it’s a pretty simple time‑management method — short focused work blocks with breaks in between.
I just wanted a minimal version of it that works in the terminal.
in reply to abeorch

irmadlad
irmadlad
• •
I thought it was some hairstyle from the 50s coming back.
in reply to abeorch

TechnoCat
TechnoCat
• •

I prefer this technique: app.flowmo.io/

You start a timer. When you're done with your task or just need a break you stop the timer and your break length is proportional to how long your work timer went for.

So if you work for 20 you then get 5 minutes of break. But then if you work for an hour you get 15 minutes of break.


Flowmo

Flowmo Web App
app.flowmo.io
This entry was edited (1 day ago)
in reply to TechnoCat

mietkiewski_dev
mietkiewski_dev
• •
That’s a cool approach. MPomidoro is simpler — for me it’s meant for longer tasks like coding or app design, so I kept it minimal: fixed work interval + fixed break, no adaptive logic. app.flowmo.io is more for multitasking I see.
in reply to mietkiewski_dev

alexanderniki
alexanderniki
• •
How's that connected to "selfhosted". One does not "selfhost" a terminal app
in reply to alexanderniki

TechnoCat
TechnoCat
• •
I think the interpretation here is more about breaking from dependence on others.
in reply to alexanderniki

mietkiewski_dev
mietkiewski_dev
• •
Yeah, for me it’s just a local, minimal tool for longer tasks like coding or app design. Nothing cloud‑based, nothing fancy.
in reply to mietkiewski_dev

starshipwinepineapple
starshipwinepineapple
• •
Your github has no source code or licensing. Not sure if that was intentional or not since i see your github acct is only a few days old
in reply to starshipwinepineapple

mietkiewski_dev
mietkiewski_dev
• •
Yeah, intentional — I wiped my old GitHub and started fresh for new projects. Files are distributed as PWYW 0$+, so default “all rights reserved” for now.
⇧