本部分收录了基于 ESP32-S3 等硬件平台的开源固件项目,可直接编译运行于极趣墨水屏设备。
数据采集时间:2026年5月31日(排行榜 Stars 更新时间:2026年5月31日 16:54)
补充更新:2026年7月7日新增 vibecoding-plus;2026年7月23日新增 TransitInk OS;2026年7月27日新增 xiaozhi-zectrix;2026年7月29日新增“今天是周五吗?”与 TRMNL Firmware;2026年8月4日补充 TRMNL v1.8.10 正式 Release 信息及 NOTE4 真机图;2026年8月13日新增 Zectrix NOTE4 4BP Gallery型号提示: NOTE4 使用 400 × 300 黑白墨水屏,NOTE4C 使用 400 × 300 四色墨水屏,两者的屏幕驱动和固件不可互换。刷写前请确认设备型号、分支与目标环境,并备份原厂 Flash。同时支持两种型号的项目会在两个索引中重复列出。
| 序号 | 项目 | 开发者 | Stars | 语言 | 分类 | 链接 |
|---|---|---|---|---|---|---|
| 1 | vibecoding-voice | mac20777 | 21 | C | 语音驱动编程遥控器 | GitHub |
| 2 | 单词机 | li-wendian | - | C | 单词机固件 | GitHub |
| 3 | 家庭记账本 | quellogs (anonysoul) | 5 | C | 家庭记账固件 | GitHub |
| 4 | Slate · 墨笺 | qiujun8023 | 4 | C | 全栈墨水屏框架 | GitHub |
| 5 | vibecoding-plus | MaydayV | 0 | C / Swift | 语音驱动 AI 编程助手 | GitHub |
| 6 | TransitInk OS | Zerie55699 | 1 | C++ / Python | 香港交通到站看板 | GitHub |
| 7 | xiaozhi-zectrix | cattei | 0 | C++ | 小智 AI 语音助手固件 | GitHub |
| 8 | TRMNL Firmware | LitoMore / TRMNL | 2 | C++ | TRMNL 墨水屏客户端 | GitHub |
| 9 | Zectrix NOTE4 4BP Gallery | LazyYoun | 0 | C / Python / TypeScript | 16 灰阶相册与 NAS 照片推送 | GitHub |
| 序号 | 项目 | 开发者 | Stars | 语言 | 分类 | 链接 |
|---|---|---|---|---|---|---|
| 1 | 今天是周五吗? | eyaeya | 1 | C | 低功耗趣味日历 | GitHub |
| 2 | TRMNL Firmware | LitoMore / TRMNL | 2 | C++ | TRMNL 墨水屏客户端 | GitHub |
作者:mac20777
最后更新时间:2026-05-06
链接:https://github.com/mac20777/vibecoding-voice
基于 ESP32 电子墨水屏的语音驱动 AI 编程遥控器,按键说话即驱动 Codex/Claude Code,无需抢麦、不打断键盘。
原文链接:https://x.com/mac20777/status/2038541419691028735
![]()
![]()
作者:li-wendian
最后更新时间:N/A
链接:https://github.com/danleegle/egga-word-machine-offline
这是 Zectrix S3 4.2 英寸电子墨水屏单词机的 ESP-IDF 固件工程。仓库根目录就是可直接编译的固件项目,不包含上一级目录里的本地整理文件。
当前固件内置考研英语词库,主界面是单词卡片复习,支持顺序/随机背词、每日目标、复习进度保存和 NFC 入口链接。代码中保留了 Wi-Fi 配网与 OTA 相关配置基础,但当前使用方式以离线背词为主。
效果预览
作者:quellogs (anonysoul) · 泉流迹 / Quellog
最后更新时间:2026-05-26
客户端固件:https://github.com/quellogs/quellog-eink
基于 Zectrix S3 4.2 英寸电子墨水屏的家庭记账固件与自建服务端。
固件采用分层架构(Board / Display / Application / UiPage),内置统计看板、最近记录、设备设置三个页面,支持 SoftAP Web 配网。内置思源黑体字库,无需额外字体分区即可流畅显示中文。数据通过设备 API 从自建服务端获取,金额单位统一为分。
服务端基于 Fastify + Vue 3 + Postgres,提供看板统计(月/季/年)与交易明细接口,并集成微信 Bot 聊天记账与 LLM(OpenAI/DeepSeek)自动分类功能。支持 docker-compose 一键部署,数据完全自控,无云服务依赖。
效果预览
作者:qiujun8023 JUN QIU
最后更新时间:2026-05-31
项目地址:https://github.com/qiujun8023/slate
基本已经做到目前官方版本的平替状态,适合注重隐私、需要使用自己大模型API的用户。
Slate 是一个面向 400 x 300 黑白墨水屏设备的开源相框 / 信息看板 / 语音玩具项目。仓库同时包含设备固件、后端 API、Web 管理端和前后端共享 schema。
当前形态:
firmware/:ESP-IDF 5.5.x 固件,目标板为 ZecTrix Note4 V1.0(ESP32-S3 + 4.2" EPD + ES8311 音频 + 按键 + 电池)。
backend/:Bun + NestJS 11 + Fastify + Prisma 7 + MySQL 8,负责账号、设备、内容组、内容、动态帧渲染、音频转码和设备同步协议。
frontend/:React 19 + Vite 8 + Tailwind v4 的 Web 管理端。
shared/:前后端共享的 zod schema、动态内容配置、dither 和图像预处理纯函数。
效果预览
作者:MaydayV
最后更新时间:2026-07-05
项目地址:https://github.com/MaydayV/vibecoding-plus
vibecoding-plus 是基于 Zectrix S3 4.2 英寸墨水屏设备的局域网语音编程助手项目,可把设备变成面向 Codex / Claude Code 等 AI 编程工具的实体语音遥控器。
项目包含 ESP32 固件和 macOS 原生客户端:设备端负责按键检测、PCM 录音、WebSocket 音频上行和墨水屏状态显示;macOS 客户端负责语音转写、文本注入、设备管理、待办管理和服务配置。典型流程是长按 BOOT 键说话,音频通过局域网上传到客户端,转写后自动输入到当前光标位置,也可发送给 Codex CLI 或 Claude Code CLI。
固件侧支持 LAN UDP 自动发现、WebSocket 通信、可选 HMAC-SHA256 鉴权、Wi-Fi 配网、心跳保活、断线重连、Wi-Fi 恢复和深度睡眠省电;客户端支持 OpenAI Whisper 兼容接口、Volcengine ASR、Qwen ASR、whisper.cpp 本地转写,以及苹果提醒事项双向同步。
适合希望把 AI 编程语音输入、待办管理和墨水屏状态显示结合起来的开发者用户,也适合作为 Zectrix Note4 / S3 墨水屏设备的二次开发参考。
效果预览
作者:Zerie55699
最后更新时间:2026-07-23
项目地址:https://github.com/Zerie55699/transitink-os
浏览器安装器:https://zerie55699.github.io/transitink-os/
TransitInk OS 是为 Zectrix Note 4 硬件配置开发的 ESP32-S3 公共交通到站看板固件,适配 400 × 300 黑白墨水屏。设备可同时显示四个独立配置的组件,并提供繁体中文机上设置门户。
项目支持九巴、龙运巴士、城巴到站时间,港岛、九龙及新界专线小巴到站时间,港铁重铁与轻铁到站时间,以及运输署行车时间指标。首次启动时,设备会建立带密码的 Wi-Fi 热点;用户连接后即可在浏览器中配置网络和四个组件位置。固件还支持每日唤醒时段、定时低功耗休眠、离线路线目录,以及通过浏览器安装器刷写发布版本。
默认 PlatformIO 环境为 zectrix_note4,使用 SSD1683 类 400 × 300 屏幕配置。刷写前应核对设备型号、Flash 容量和串口,并先备份原有 16 MiB Flash;项目也提供备份、刷写与恢复脚本。
许可提示:这是独立的源码公开项目,与 Zectrix 没有从属或认可关系。原创源码采用 PolyForm Noncommercial License 1.0.0,仅限非商业用途;商业使用需另行取得书面许可,第三方字体、组件和交通数据按各自条款使用。
效果预览
作者:cattei
最后更新时间:2026-07-27
项目分支:https://github.com/cattei/xiaozhi-zectrix/tree/zectrix
xiaozhi-zectrix 是基于小智 AI 聊天机器人固件制作的 Zectrix 适配分支。zectrix 分支新增 zectrix-s3-epaper-4.2 板卡配置,面向 ESP32-S3、4.2 英寸 400 × 300 黑白墨水屏设备,并接入 ES8311 音频、按键、电池与充电状态、电源管理、PCF8563 RTC 和 NFC。
项目保留小智固件的语音交互能力,包括 ESP-SR 离线语音唤醒、WebSocket 与 MQTT + UDP 通信、Opus 音频流、ASR + LLM + TTS / Realtime 语音模型,以及设备端和云端 MCP 扩展。固件默认可连接小智官方服务,也可按照上游文档配置兼容服务。
该适配加入了双固件切换逻辑:设备启动早期同时按住上键与下键约 500 ms,会尝试把启动项切换到另一个 OTA 分区并重启,用于在小智固件与 Zectrix 固件之间切换。此功能需要设备已经采用匹配的双 OTA 分区和固件布局,刷写前请先确认分区方案并备份原有固件。
当前主线推荐 ESP-IDF 6.0.2,构建板型名称为 zectrix-s3-epaper-4.2。项目采用 MIT 许可证,可用于学习、修改和商业用途;开发时请以 zectrix 分支的最新代码及说明为准。
MCP 架构示意
作者:LitoMore / TRMNL
最后更新时间:2026-08-03
项目分支:https://github.com/LitoMore/trmnl-firmware/tree/zectrix
Zectrix 构建说明:https://github.com/LitoMore/trmnl-firmware/blob/zectrix/docs/zectrix.md
最新版本:https://github.com/LitoMore/trmnl-firmware/releases/tag/zectrix-v1.8.10
TRMNL Firmware 是一套开源墨水屏客户端固件。zectrix 分支的 NOTE4 目标为 zectrix_note4,使用 EP42B_400x300 黑白屏配置,仅适用于 ESP32-S3 N16R8 版本的 Zectrix NOTE4。该适配包含屏幕供电、GPIO17 整机电源保持、Home / OK 按键唤醒、电池电压和充电状态等板级映射。
设备可通过 TRMNL 配网页面连接 Wi-Fi,获取并显示 400 × 300 的自定义屏幕内容,随后进入定时休眠。zectrix-v1.8.10 Release 提供 zectrix-note4-v1.8.10-merged-firmware.bin 和 zectrix-note4-v1.8.10-firmware.bin:首次安装或完整重装使用合并镜像并写入 0x0;只有设备已安装该 Zectrix TRMNL 分区布局时,才可用应用镜像在 0x20000 更新。
NOTE4 真机效果
刷写提醒: 只能使用
zectrix-note4-*镜像,不可与 NOTE4C 镜像混用。首次安装前请完整备份 16 MiB 原厂 Flash;首次启动时持续按住物理电源键,直到新固件开始运行。上游 TRMNL 自动 OTA 已为 Zectrix 目标禁用,Release 也不包含 Zectrix 原厂固件。项目采用 GPL-3.0 License;该仓库是
usetrmnl/trmnl-firmware的分支,Zectrix 适配以zectrix分支代码与docs/zectrix.md为准。
作者:LazyYoun
最后更新时间:2026-08-13
项目地址:https://github.com/LazyYoun/zectrix-note4-4bp-gallery
预编译固件:https://github.com/LazyYoun/zectrix-note4-4bp-gallery/blob/main/zectrix-note4-4bp-gallery.bin
SHA-256:https://github.com/LazyYoun/zectrix-note4-4bp-gallery/blob/main/zectrix-note4-4bp-gallery.bin.sha256
Zectrix NOTE4 4BP Gallery 是为 400 × 300 黑白 NOTE4 开发的 ESP32-S3 电子相册与 NAS 照片管理系统。这里的 4BP 表示 4 bits/pixel,即 16 灰阶;设备端使用 NOTE4 SSD2683 面板的校准波形显示 60,000 字节 gray4bpp 图像,也支持 15,000 字节 1bpp 黑白图。预编译固件只适用于黑白 NOTE4,不适用于 NOTE4C 四色屏。
项目包含 ESP-IDF 固件、FastAPI + PostgreSQL 后端和 Vue 3 管理端。NAS 可只读扫描家庭照片,按 EXIF 日期生成“往年今日”候选,并可选用 AI 生成描述与评分;管理端可选择照片和输出格式,设备定时领取任务、校验 SHA-256、保存到本地相册、刷新屏幕后深度休眠。设备也可建立 InkScreen-AP,在 http://192.168.4.1 通过手机上传图片、管理相册、设置轮播与 NAS 同步周期。
界面预览(仓库使用虚构演示数据)
刷写提醒: 仓库根目录的
zectrix-note4-4bp-gallery.bin是从0x0写入的完整合并镜像,包含 bootloader、分区表、OTA 初始数据和应用固件。刷写前请确认设备为黑白 NOTE4、备份完整 16 MiB 原厂 Flash,并按仓库中的.sha256文件校验镜像。仓库说明该固件已使用 ESP-IDF 5.4.2 在真实 NOTE4 上完成构建、刷写和启动验证;当前不建议用 ESP-IDF 6 绕过上游波形哈希校验问题。项目采用 MIT License;第三方组件、NOTE4 驱动与测试照片仍按各自许可证和署名要求使用。
作者:eyaeya
最后更新时间:2026-07-29
项目地址:https://github.com/eyaeya/today-is-friday
最新版本:https://github.com/eyaeya/today-is-friday/releases/latest
“今天是周五吗?”是一套专为 Zectrix NOTE4C 四色版开发的 ESP32-S3 趣味日历固件,适配 4.2 英寸 400 × 300 SSD2683 BWRY 墨水屏。它按照星期与时间段显示简短答案,内置 9 个文案池、共 450 条中文文案;同一文案池采用持久化洗牌机制,在一轮用完前不会重复。BOOT 短按可更换当前文案,四色界面仅使用黑、白、红、黄四种颜色。
首次启动时,设备会建立无密码热点并提供 Captive Portal,用户可通过手机完成 2.4 GHz Wi-Fi 与时间初始化。固件使用 PCF8563 RTC 离线走时,在日期或时段边界自动唤醒刷新,完成后回到 Deep-sleep;也可长按 Down 重新进入设置。正常显示期间不会持续联网,周四进入当天状态时会尝试联网校时。
当前 Release 为 v0.1.1,提供从 0x0 写入的单文件合并镜像、从 0x20000 写入的 app-only 镜像、四分段恢复包及 SHA-256 校验文件。v0.1.1 的 app-only 升级、正常页面与 BOOT 短按已通过 NOTE4C 真机冒烟测试;完整合并镜像的结构与分段已校验,但尚未作为完整组合重新烧录真机。
真机效果
刷写提醒: 本项目只适用于 NOTE4C 四色版,不可刷入 NOTE4 黑白屏。
merged-offset-0x0.bin必须写入0x0,app.bin只能在兼容分区布局下写入0x20000;文件与地址不能混用。第一次安装或不确定现有分区时,请先完整备份 16 MiB Flash,并以仓库 README 和 Release 说明为准。项目采用 MIT License,基于
LazyYoun/youn-ink-fourcolor-firmware的2bp分支开发。
作者:LitoMore / TRMNL
最后更新时间:2026-08-03
项目分支:https://github.com/LitoMore/trmnl-firmware/tree/zectrix
Zectrix 构建说明:https://github.com/LitoMore/trmnl-firmware/blob/zectrix/docs/zectrix.md
最新版本:https://github.com/LitoMore/trmnl-firmware/releases/tag/zectrix-v1.8.10
该 zectrix 分支为 TRMNL 开源墨水屏客户端提供 Zectrix NOTE4 与 NOTE4C 支持。上游维护者已于 2026 年 8 月 3 日将该适配标记为稳定阶段,并发布 zectrix-v1.8.10 正式 Release。它提供两个独立的 PlatformIO 构建目标:NOTE4 使用 zectrix_note4 与 EP42B_400x300 黑白屏配置,NOTE4C 使用 zectrix_note4c 与 EP42YR_400x300 四色屏配置。两种目标均仅面向 ESP32-S3 N16R8 版本,并加入了屏幕供电、GPIO17 整机电源保持、Home / OK 按键唤醒、电池电压和充电状态等 Zectrix 板级映射。
接入 TRMNL 服务后,设备可通过配网页面连接 Wi-Fi,获取并显示 400 × 300 的 TRMNL 自定义屏幕内容,然后进入定时休眠。zectrix-v1.8.10 已提供 NOTE4 和 NOTE4C 各自的 merged-firmware.bin 与 firmware.bin:首次安装或完整重装使用合并镜像并写入 0x0;只有设备已安装该 Zectrix TRMNL 分区布局时,才可用应用镜像在 0x20000 更新。Release 页面同时提供四个镜像的 SHA-256 校验值。
真机效果
刷写提醒: Release 镜像仅适用于 ESP32-S3 N16R8 版本的 NOTE4 / NOTE4C,两种型号的屏幕驱动与镜像不可互换。首次安装前请完整备份 16 MiB 原厂 Flash;首次启动时持续按住物理电源键,直到新固件开始运行。上游 TRMNL 自动 OTA 仍为这两个目标禁用,官方 Zectrix 原厂固件也不包含在 Release 中。
项目采用 GPL-3.0 License;该仓库是
usetrmnl/trmnl-firmware的分支,Zectrix 适配以zectrix分支代码与docs/zectrix.md为准。