核心用法
TRMNL Content Generator 是一个专为 TRMNL 电子墨水屏设备设计的内容生成与推送工具。用户通过 trmnl CLI 将自定义 HTML 内容发送到 800x480 像素的 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,属硬件限制而非软件缺陷