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

submitted by

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: https://github.com/Mietkiewski/MPomidoro

Gumroad PWYW $0+: https://mietkiewski.gumroad.com/l/mpomidoro

14
19

Log in to comment

Hot Top New Old

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

 reply
7
he/him

It’s a bot

 reply
2
OP

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.

 reply
1

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

 reply
6
OP

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.

 reply
4
edited

I prefer this technique: https://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.

 reply
4
OP

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.

 reply
1

I thought it was some hairstyle from the 50s coming back.

 reply
4

How’s that connected to “selfhosted”. One does not “selfhost” a terminal app

 reply
8

I think the interpretation here is more about breaking from dependence on others.

 reply
5
OP

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

 reply
1
OP

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.

 reply
3

Is printing to stdout how it alerts you to a timer ending?

 reply
1
OP

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.

 reply
3
Insert image