为 TRMNL 电子墨水屏设备生成内容,通过 CLI 工具推送个性化仪表盘、通知和数据展示。
说明:
## 核心用法
TRMNL Content Generator 是一个专为 TRMNL 电子墨水屏设备设计的内容生成与推送工具。用户通过 `trmnl` CLI 将自定义 HTML 内容发送到 800×480 像素的 2-bit 灰度电子墨水屏上,实现个性化信息展示。
**典型工作流程:**
1. 安装 `trmnl-cli` 并配置 webhook 插件
2. 使用 TRMNL CSS 框架(flexbox、grid、表格、进度条等)编写 HTML
3. 通过 `trmnl send –file` 推送内容至设备
4. 利用 `trmnl validate` 验证 payload 大小(免费版 2KB,Plus 版 5KB)
**关键特性:**
– 10 列网格系统与垂直/水平布局引擎
– 专用排版类如 `value–tnums`(数字等宽对齐)、`value–xxxlarge`(主指标)
– 抖动灰度类(`bg–gray-*`、`text–gray-*`)替代内联颜色
– 自动文本缩放(`data-fit-value`)与溢出管理
– 速率限制:免费版 12 次/小时,Plus 版 30 次/小时
## 显著优点
– **专用优化**:针对电子墨水屏的对比度、刷新率和功耗特性深度优化
– **成熟框架**:提供完整的 CSS 工具类体系,无需从零设计低功耗显示样式
– **CLI 原生**:与开发者工作流无缝集成,支持验证、历史查询、多插件管理
– **结构约束清晰**:强制单一 `.layout` + `.title_bar` 模式,降低布局出错率
## 潜在缺点与局限性
– **硬件门槛**:需购买 TRMNL 物理设备(约 $150-250)才能使用
– **payload 限制严格**:2-5KB 上限对复杂可视化构成挑战
– **灰度限制**:仅 2-bit(4 级灰度),不支持彩色或丰富渐变
– **速率限制**:每小时 12-30 次更新,不适合实时高频数据场景
– **生态封闭**:主要支持官方设备,通用性不如普通网页推送方案
## 适合人群
– 已拥有或计划购买 TRMNL 设备的智能家居/量化自我爱好者
– 偏好物理仪表盘而非手机 App 查看关键数据的用户
– 追求极简、低干扰信息展示的设计师和开发者
– 需要长期静态显示(日历、待办、股票、天气)而不希望屏幕常亮的场景
## 常规风险
– **配置失误**:webhook URL 错误导致推送失败,需通过 `trmnl config` 核查
– **超限截断**:HTML 超过 payload 限制可能被静默截断,务必先用 `trmnl validate` 检查
– **视觉错位**:数字未加 `value–tnums` 类会导致表格或指标列不对齐
– **刷新残影**:电子墨水屏固有特性,频繁更新会产生 ghosting,属硬件限制而非软件缺陷









