PotatoTimer

A simple desktop Pomodoro app that forces you to take the break — built with Electron. Full-screen break nag, so you can't quietly ignore it.

Features

• Forces the break with a hard-to-ignore prompt when the work interval ends
• Remembers your settings between runs (electron-store)
• Runs on Windows, macOS and Linux from the same codebase

Run from source

git clone https://github.com/p32929/PotatoTimer.git
cd PotatoTimer
npm install
npm start

Build an installer for your OS:

npm run dist

Download

Prebuilt installers: https://github.com/p32929/PotatoTimer/releases

Thanks

Thanks to mcaubrey for his Pomodoro Clock project, which this one is based on.

License

MIT License — Copyright (c) 2018 Fayaz Bin Salam. See LICENSE for the full text.

Contributing

Contributions are warmly welcomed and greatly appreciated! Whether it's a bug fix, new feature, or improvement, your input helps make this project better for everyone.

Before submitting a pull request, please:

1. Create an issue describing the feature or bug fix you'd like to work on
2. Wait for discussion and approval to ensure alignment with project goals
3. Fork the repository and create your feature branch
4. Submit your pull request with a clear description of changes

This approach helps avoid duplicate efforts and ensures smooth collaboration. Thank you for considering contributing!

Share

Sharing this repository with your friends is just one click away from here

---

Support

If this saved you time, you can buy me a coffee — it keeps these projects maintained and free. Other payment options: https://p32929.github.io/SendMoney2MeV1/

---

💼 Using this at a company?

I do fixed-price delivery work on my own projects. One invoice, one date, no hourly billing:

White-label build — this project rebranded, extended and deployed as yours	$6,500 · 3 weeks
Custom app from scratch on my own stack, signed and auto-updating	$12,500 · 6 weeks
Production-hardening sprint — 72 hours on this project, for your load and your security review	$999
Ongoing capacity — one project-week of my time reserved every month	$9,000 / month

Full details → p32929.github.io/hire · Email fayazdevinbox@uberip.com — scoping and quotes are free and I answer within one business day.