# Rukenshia/pomodoro

ESP32-based focus timer with an epaper display and rotary dial

Repository: https://github.com/Rukenshia/pomodoro
Canonical: https://ross.abutalabs.com/products/pomodoro
Language: C
License Family: other
Last push: 2025-06-27T08:35:12+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 28, release rhythm 35, longevity 37
- inputs: {"age_days": 522, "days_push": 432, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1096, forks 37 (observed 2026-08-28T04:03:34.444623+00:00)

## What it is
An ESP32-based physical Pomodoro focus timer with an ePaper display, rotary dial input, and a 3D-printed case. The repository contains the C firmware and hardware build instructions, though some assets and fonts are removed so the code requires adaptation.

## Use cases
- build a physical pomodoro focus timer
- esp32 epaper display project
- diy productivity timer with rotary dial
- learn embedded development with e-paper
- weekend electronics and 3d printing project

## When to choose
- you want to build your own hardware focus timer from scratch
- you have the specific WaveShare 4.26" ePaper display and ESP32 parts
- you enjoy adapting firmware and sourcing your own assets

## When to avoid
- you need a ready-to-use timer out of the box, since assets/fonts are removed
- you use a different display resolution without redesigning the UI
- you want a software-only pomodoro app

## Facets
- artifact type: application
- maturity: active
- function: embedded, gui
- domain: developer-tools, embedded-systems, hardware
- platform: embedded, iot, cpp
- tags: esp32, epaper-display, pomodoro-timer, rotary-encoder, firmware, diy-hardware, 3d-printed-case

## Member repositories
- Rukenshia/pomodoro (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:34.444623+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:46:38.972555+00:00, confidence not recorded.
  - readme: https://github.com/Rukenshia/pomodoro (fetched 2026-08-28T04:03:34.444623+00:00, sha a4e84012c500)
- Data as of 2026-08-30T08:39:29.467469+00:00.