本文来源:https://mp.weixin.qq.com/s/ZHxquSJc5bW1Uqkjy4BHyQ
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
Rukenshia/pomodoro 是一台自制桌面专注计时器:ESP32 驱动一块 4.26 英寸电子墨水屏,一颗旋钮包办全部输入,屏幕旁藏着一颗 WS2812 提示灯。作者做它是为了送朋友——一个被多任务和碎片注意力困住的人。项目目前在 GitHub 上约 1.1k Star,结构件、外壳 CAD、代码全部公开,MakerWorld 上还能直接下载打印模型。
🔗 开源地址
https://github.com/Rukenshia/pomodoro
3D 打印模型(含打印参数)在 MakerWorld:https://makerworld.com/de/models/1264318-pomodoro-focus-timer
内容说明
硬件:模块都很常见,取舍见功夫
- 主控:ESP32(作者用的是 AZDelivery 的 NodeMCU 开发板)
- 屏幕:WaveShare 4.26 寸墨水屏 HAT,800×480,整套 UI 就是按这个分辨率设计的;换别的屏能跑,但布局要自己调
- 输入:KY-040 旋转编码器(带按键)
- 提示:一颗 WS2812(可用普通 RGB LED 替代)
- 供电:USB-C 母座。作者提醒:两线制的连接器可能要用 USB-A 转 USB-C 线才点得亮,他猜是缺了供电协商
- 阻容件:LED 限流电阻、按键上拉电阻、编码器 CLK/DT 引脚各一枚 0.1uF 电容(滤掉抖动)
为什么偏偏是墨水屏
作者的核心诉求是「不打扰」:这台设备大部分时间在待机,他不想要任何背光。选 4.26 寸这档有三个理由——分辨率在爱好者级墨水屏里算高的、尺寸放在桌上刚好、支持 0.3 秒局部刷新,刷屏时不会整屏黑白闪烁。他最初想要黑白红三色屏,但那种屏刷新要 16 秒、不支持局部刷新,直接放弃。还有一个附赠的「特性」:晚上光线不够就看不清屏幕——作者的原话是,天黑了就该停止工作。
旋钮与提示灯:交互的两条腿
旋钮是唯一的输入方式,代价是菜单逻辑变复杂,而且必须认真消抖(所以才有那两颗 0.1uF 电容)。提示灯则是试错试出来的:先试蜂鸣器——「会吓人一跳,体验极差」;又试喇叭——底噪和啸叫压不住,作者自嘲是手艺问题;最后落在手头就有的 WS2812 上,NeoPixel 库驱动简单,还不用多占引脚。外壳上专门给它做了遮光罩,前面再加一层扩散片,见下图。
外壳:作者自己交代的两处返工
外壳分底座和盖板两件,CAD 挂在 Onshape,STL 也在仓库里。作者很实在地写了自己踩的两个坑:一是屏幕边框和底座做成了一体打印,顶边打印时容易翘;二是旋钮放在正面,可机身太轻,一按旋钮整个设备往后滑——最后靠橡胶脚垫加轮胎动平衡用的配重块才压住。这两条对想复刻的人都是现成的经验。
软件:PlatformIO + GxEPD2,但源码不能直接烧
代码是 C++,Arduino 框架,PlatformIO 管理,显示驱动重度依赖 GxEPD2。要特别提醒的是:仓库里的代码不是拿来就能用的——作者删掉了一部分素材和字体,需要自己跑 scripts/generate_assets.py 重新生成(依赖用 uv 管,Python 3.13+)。预设直接定义在 src/main.cpp 里:Emails 15 分钟、Coding 45 分钟、Focus 25 分钟,想改从这里下手。作者也坦言代码有点乱——为了赶工期有复制粘贴,部分代码还是 Claude 帮忙生成的;这份坦诚反而让仓库更真实。
用起来是什么样
开机后进预设选择,旋钮转一转、按一下就开始计时。屏幕上会随机冒出一条冷知识——在一台本该帮你专注的设备上放小知识,听起来很反直觉,但作者觉得这就是他要的「好玩」。时间一到,LED 闪烁加屏幕提示;休息时可以翻看统计,默认每 4 个循环给一次更长的休息。
许可与复刻提醒
仓库里没有 LICENSE 文件,GitHub 的 license 字段也是空的。作者把代码、CAD、STL 全部公开了,自己照着做一台没问题;但拿去二创发布或商用前,边界需要先和作者确认。另外整套 UI 是按 800×480 定制的,换屏就得重新排版。
总结说明
这是一个「完成度」远高于「技术难度」的项目:模块都是常见货,但屏幕选型、消抖、配重这些细节想得比大多数同类作品细。README 值得单独一读——作者把每次返工和取舍的原因都写清楚了,比代码本身更有参考价值。想复刻的人要注意:代码不能直接烧,得先过一遍素材生成脚本。门槛主要在 3D 打印和接线,ESP32 + 墨水屏的玩家上手应该很快。
本文来源:https://mp.weixin.qq.com/s/ZHxquSJc5bW1Uqkjy4BHyQ
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
Rukenshia/pomodoro is a DIY desktop focus timer: an ESP32 drives a 4.26-inch e-paper display, a single rotary knob handles all input, and a WS2812 indicator light hides beside the screen. The author built it as a gift for a friend — someone trapped by multitasking and fragmented attention. The project currently has around 1.1k stars on GitHub; the structural parts, enclosure CAD, and code are all public, and the 3D-printable model can be downloaded directly from MakerWorld.
Open-Source Repository
https://github.com/Rukenshia/pomodoro
3D-printed model (with print settings) on MakerWorld: https://makerworld.com/de/models/1264318-pomodoro-focus-timer
Overview
Hardware: Common modules, thoughtful trade-offs
- Main controller: ESP32 (the author used an AZDelivery NodeMCU dev board)
- Display: WaveShare 4.26-inch e-paper HAT, 800×480; the entire UI is designed for this resolution. Other screens will run but require layout adjustments
- Input: KY-040 rotary encoder (with push button)
- Indicator: one WS2812 (can be replaced with a regular RGB LED)
- Power: USB-C female connector. The author warns: a two-wire connector may need a USB-A to USB-C cable to light up — he suspects missing power negotiation
- Passive components: LED current-limiting resistor, button pull-up resistor, one 0.1uF capacitor on each encoder CLK/DT pin (to filter bounce)
Why e-paper specifically
The author's core requirement is "non-intrusive": the device is mostly on standby and he doesn't want any backlight. There are three reasons for choosing the 4.26-inch size — the resolution is relatively high among hobbyist e-paper, the size fits perfectly on a desk, and it supports 0.3-second partial refresh with no full-screen black-white flicker. He initially wanted a black-white-red tri-color screen, but that type takes 16 seconds to refresh and doesn't support partial refresh, so he dropped it. There's also a bonus "feature": in low light at night the screen becomes unreadable — in the author's words, when it gets dark you should stop working.
Knob and indicator: the two legs of interaction
The knob is the only input method, at the cost of more complex menu logic and the need for careful debouncing (hence the two 0.1uF capacitors). The indicator was found through trial and error: first a buzzer — "startles you, terrible experience"; then a speaker — bottom noise and howling he couldn't suppress, self-deprecatingly calling it a craftsmanship issue; finally landing on the WS2812 he had on hand, driven simply by the NeoPixel library without occupying extra pins. The enclosure has a dedicated light shield for it, with a diffuser layer added in front, as shown below.
Enclosure: two reworks the author confessed
The enclosure is two pieces — base and cover — with CAD on Onshape and STL also in the repo. The author honestly wrote about two pitfalls he hit: first, the screen bezel and base were printed as one piece, and the top edge warped easily during printing; second, the knob is on the front, but the body is too light, so pressing the knob slides the whole device backward — finally held down with rubber feet plus a counterweight from tire dynamic balancing. These two points are ready-made experience for anyone wanting to replicate it.
Software: PlatformIO + GxEPD2, but the source can't be flashed directly
The code is C++, Arduino framework, managed by PlatformIO, with the display driver heavily relying on GxEPD2. One important warning: the code in the repo is not ready to use out of the box — the author removed some assets and fonts, and you need to run scripts/generate_assets.py to regenerate them (Python 3.13+ managed by uv). Presets are defined directly in src/main.cpp: Emails 15 min, Coding 45 min, Focus 25 min — change from there. The author also admits the code is a bit messy — some copy-paste to meet deadlines, and part of the code was generated by Claude; this honesty actually makes the repo more genuine.
What it's like to use
After powering on, you enter preset selection; turn the knob and press to start timing. A random fun fact pops up on screen — putting trivia on a device meant to help you focus sounds counterintuitive, but the author thinks that's exactly the "fun" he wanted. When time is up, the LED blinks and the screen prompts; during breaks you can check stats, with a longer break given by default every 4 cycles.
License and replication notes
There's no LICENSE file in the repo, and GitHub's license field is also empty. The author made the code, CAD, and STL all public, so building one for yourself is fine; but before using it for derivative publishing or commercial use, the boundaries need to be confirmed with the author first. Also, the entire UI is customized for 800×480, so a different screen means re-layout.
Summary
This is a project whose "completeness" far exceeds its "technical difficulty": the modules are all common goods, but details like screen selection, debouncing, and counterweighting are thought through more carefully than most similar works. The README is worth reading on its own — the author clearly wrote down the reasons for each rework and trade-off, which is more valuable than the code itself. Those who want to replicate should note: the code can't be flashed directly; you must first run through the asset generation script. The main barrier is 3D printing and wiring; ESP32 + e-paper enthusiasts should get up to speed quickly.