Flipper Zero 红外电子价签研究工具包
协议研究 • 信号分析 • 数字艺术
TagTinker 是一个用于 Flipper Zero 的红外电子价签 (ESL) 协议探索应用。它允许你向支持的图形标签发送自定义图像和文本。一个配套的 Web 图片预处理工具 完全在浏览器中运行，让你无需安装即可拖放、抖动并下载 Flipper 可用的 BMP 文件。
正如 Flipper Zero 团队所指出的：
"仅供参考：这是纯红外信号，和你电视遥控器用的是同一种。整个安全性完全依赖于协议的模糊性。"
本工具面向物联网安全好奇心、学习不常见协议以及在电子墨水硬件上展示数字艺术的场景而生。
[!WARNING] 硬件警告： 许多红外电子价签将固件、地址和显示数据存储在易失性 RAM 中，以降低成本与能耗。如果你取下电池或让其完全放电，标签将丢失所有程序并变得无响应（"死亡"）。通常无法在没有原始基站的情况下恢复。
TagTinker Flipper 应用： 高性能、零分配 RLE 流式红外引擎。
TagTinker 图片预处理 (Web)： 单文件、无依赖的 HTML 页面，列出每个支持的标签型号，运行完整的图像处理流程（色调、对比度、细节、锐化、抖动、专业级 Oklab 三色量化），并导出 Flipper 适用的 BMP。托管于 i12bp8.github.io/TagTinker（源码见 web-image-prep/）。
拖放文件夹图片流程： 将预处理好的 BMP 放入 Flipper SD 卡的 apps_data/tagtinker/dropped/ 文件夹，然后打开 定向载荷 → <标签> → 设置图像 并选取。Flipper 会即时缩放任意 BMP，因此单个文件可适配任何标签和任何页面。
NFC 标签扫描： 通过扫描电子价签的 NFC 标签即可立即识别目标——无需手动输入条形码。
WiFi 插件（可选）： 将 Flipper WiFi 开发板 (ESP32-S2) 插入 GPIO 接口，可解锁实时网络渲染的标签设计——加密货币价格卡片、天气磁贴、身份图像等——由 FAP 自动发现。新插件完全运行在云端 Worker 上；添加插件时无需重新刷写 Flipper 固件。
显示文本、自定义图像和测试图案。
支持单色和强调色（红/黄）图形标签。
ufbt 安装。首次启动会在 SD 卡上创建 apps_data/tagtinker/dropped/ 文件夹。apps_data/tagtinker/dropped/ 中（通过 qFlipper、USB MTP 或任何你使用的方式）。定向载荷 → <你的标签> → 设置图像，选择 BMP 文件，选择页面，发送。这需要 Flipper Zero 吗？
不，完全不需要！你可以用不到 5 美元的微控制器硬件（例如 ESP32 加一个红外 LED）来实现。Flipper Zero 恰好是我最喜欢的安全研究工具，因此我为这个平台构建了该应用。
.fap 发布版在哪里？
Flipper 应用采用源码优先的方式。请从本仓库使用 ufbt 自行构建 .fap 文件，以便与你当前的固件和本地工具链匹配。
如果崩溃或行为异常怎么办？
如果你使用的是自定义固件分支、自定义资源包或经过重度修改的设备配置，请先从一个干净的基准固件进行测试。
本项目的根本基础是 furrtek 所做的出色公开逆向工程工作。 请阅读他的研究以了解底层协议、信号结构和历史：
NFC 标签解码由 7h30th3r0n3 贡献。
[!CAUTION] 严禁用于非法用途
TagTinker 是一个独立项目，严格限于教育研究、安全探索以及在你合法拥有的硬件上展示数字艺术。
在任何情况下，本软件均不得用于非法活动。严禁使用 TagTinker 篡改零售显示屏、修改商店中的电子价签、干扰第三方基础设施，或造成任何形式的破坏或经济损失。
TagTinker 的创建者对任何滥用本软件的行为概不负责。使用本软件即表示您同意对自己的行为负全部责任，并合法、负责任地使用它。
基于 GNU General Public License v3.0 (GPL-3.0) 许可。详见 LICENSE 文件。