Pixeldoro

A tiny, fast, always-on-top pixel-art Pomodoro timer for Windows.

Pixeldoro lives in a small frameless window that floats above your work — no browser tab, no bloated Electron app, just a lightweight desktop widget that keeps you in flow.

---

Demo

app-preview.mp4

---

Why Pixeldoro?

• Featherweight — a single ~14 MB standalone .exe with one runtime dependency (pygame). No installer, no background services, no telemetry.
• Efficient by design — locked at a steady 60 FPS with near-idle CPU usage. Every sprite is pre-scaled once at startup and text surfaces are cached, so the render loop performs zero disk I/O and no per-frame scaling.
• Out of your way — a 360×220 frameless window with rounded corners that you can drag anywhere and pin on top of every other window.

Features

• ⏱️ Classic Pomodoro flow: focus → short break, with a long break after a configurable number of cycles
• 🪟 Frameless, draggable window with chroma-key rounded corners
• 📌 Always-on-top toggle (pin button)
• ⚙️ Fully configurable focus, short-break, and long-break durations and cycle count
• 🔁 Auto Mode to chain phases automatically without manual restarts
• 🔊 Sound cues on phase changes
• 🔗 Clickable credits that open the author's links

Controls

Every value on the Settings screen can be changed three ways — use whichever is fastest:

Action	How
Step up / down	Click the + / − buttons (hold to repeat)
Scroll to adjust	Hover a value and scroll the mouse wheel
Type an exact value	Click the number, type with the keyboard, press Enter

Durations are entered in minutes. Press Esc to cancel an edit.

Download

Grab the latest Pixeldoro.exe from the Releases page and run it — no installation required.

Note

On first launch Windows SmartScreen may warn about an unrecognized app (the build is unsigned). Click More info → Run anyway.

Build from source

Requires Windows and Python 3.10+.

# 1. Set up the environment
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

# 2. Run directly
python main.py

# 3. (Optional) Build a standalone executable
pip install pyinstaller
pyinstaller main.spec        # → dist/Pixeldoro.exe

Project structure

main.py             Window setup, input handling, and the render loop
src/config.py       Paths, window geometry, and default durations
src/timer.py        Pomodoro state machine (no UI dependencies)
src/ui_elements.py  Pixel-art button widgets
assets/             Fonts, sprites, and audio

License

Released under the MIT License.

---

Made with pixels by Owarimono