Our take
Inactiveno commits in over a year- Activity
- 19
- Community
- 15
- Issues
- 21
- Pull requests
- 20
+18 stars in the last 30 days
- Fewer contributors than 86% of the projects we track
This is a useful, specific hardware project for hands-on makers, but its inactive maintenance and explicitly incomplete assets make it better suited to adaptation than a dependable ready-made build.
Good fit if
- You want to build an ESP32 focus timer around an e-paper display and rotary dial.
- You are comfortable with Arduino/PlatformIO firmware and can work with the asset-generation setup, which requires Python 3.13 or newer.
- You are willing to maintain or modify the project yourself, given that most contributions come from one person and there has been no recent development activity.
Look elsewhere if
- You need firmware that is ready to build and flash without recovering or replacing missing assets.
- You need an actively maintained project with recent releases or a recent track record of issue handling.
- You need clear license terms before reusing or distributing the code, since no license is specified in the provided repository information.
All health signals
| Last commit | 2025-06-27 (1.3 years ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 0 |
| Contributors | 2 (top contributor: 95% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 19 months |
Checked on 2026-10-12 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,121Forks
42Change since Nov 14, 2026: +1 stars·+1 forks
Overview
Rukenshia/pomodoro is firmware and build guidance for a physical focus timer based on an ESP32. It uses an e-paper display and rotary encoder to select timer presets, track focus and break periods, and signal when a period ends with an LED.
It is aimed at electronics and 3D-printing hobbyists who want a tactile alternative to a phone or desktop timer. The repository is a starting point rather than a ready-to-flash product: the README says some fonts and other assets have been removed, so users may need to regenerate or adapt them.
Key Features
- Runs on an ESP32 using the Arduino framework and PlatformIO.
- Targets a WaveShare 4.26-inch, 800×480 e-paper display, with a UI designed for that resolution.
- Uses a KY-040 rotary encoder and button for menu and timer input.
- Provides three configurable timer presets, with focus, short-break, and longer-break durations.
- Signals timer completion with an on-screen message and a WS2812 LED.
- Shows statistics during breaks and supports periodic longer breaks.
- Includes a Python script for preparing image, icon, and font assets.
- Documents parts, wiring pin assignments, and a 3D-printed case reference.
Use Cases
- Makers can build a dedicated desk timer when they want a physical control and an at-a-glance display instead of a phone app.
- ESP32 hobbyists can use the project as a base for experimenting with e-paper interfaces, rotary encoder input, and LED alerts.
- A user who already has compatible parts and a 3D printer can adapt the presets and case for a personal focus routine.
- Someone looking for a giftable productivity gadget can follow the documented hardware direction, while allowing time to resolve the missing assets and build details.
What you need
Detected in the repository
- Python >=3.13 (from pyproject.toml)
- A test suite
Getting Started
Install PlatformIO and Python 3.13 or newer. To regenerate the assets, run:
uv sync
uv run scripts/generate_assets.py
See the README for parts, wiring, preset configuration, and development details. The repository notes that assets and fonts have been removed, so this step may not by itself produce a ready-to-use build.
License in Plain Words
No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.
Considerations
The repository is marked inactive: it has had no commits in over a year and no releases in the past year. It has two contributors, with most code attributed to one person, and no recent issue closures or merged pull requests. There is no CI, although tests are indicated as present. These signals suggest planning for self-support rather than relying on timely fixes.
The README explicitly warns that assets and fonts were removed and describes the code as messy, with copied sections and some AI-generated code. The interface is designed for the specified 800×480 display, and the README cautions that other displays may work but are not the intended target. License information is not provided in the input, so confirm the repository's licensing status before reuse or distribution.
Hardware assembly also requires compatible components, wiring, and a case; the README describes a 3D-printed enclosure and notes practical design issues that may need adjustment. Asset regeneration requires Python 3.13 or newer. The firmware itself is C++ on the Arduino framework, managed with PlatformIO.
Found this useful?
Share it with someone who would like pomodoro.