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

A minimal local Pomodoro timer for the terminal (no accounts, no cloud)
from mietkiewski_dev@lemmy.world to selfhosted@lemmy.world on 26 Apr 13:48
https://lemmy.world/post/46086871

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/MPomidoro

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

#selfhosted

threaded - newest

mietkiewski_dev@lemmy.world on 26 Apr 13:52 next collapse

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.

TechnoCat@piefed.social on 26 Apr 14:16 collapse

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

mietkiewski_dev@lemmy.world on 26 Apr 14:33 collapse

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.

abeorch@friendica.ginestes.es on 26 Apr 14:18 next collapse

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

mietkiewski_dev@lemmy.world on 26 Apr 14:34 next collapse

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.

irmadlad@lemmy.world on 26 Apr 14:35 next collapse

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

TechnoCat@piefed.social on 26 Apr 18:56 collapse

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.

mietkiewski_dev@lemmy.world on 27 Apr 07:55 collapse

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.

alexanderniki@lemmy.world on 26 Apr 17:37 next collapse

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

TechnoCat@piefed.social on 26 Apr 19:00 next collapse

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

mietkiewski_dev@lemmy.world on 27 Apr 07:57 collapse

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

starshipwinepineapple@programming.dev on 26 Apr 23:03 collapse

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

rimu@piefed.social on 27 Apr 03:08 next collapse

It’s a bot

mietkiewski_dev@lemmy.world on 27 Apr 08:02 collapse