MultiMote/niimblue

GitHub: MultiMote/niimblue

一个隐私优先的 NIIMBOT 标签打印机 Web 客户端，支持在浏览器中直接设计和打印标签。

Stars: 507 | Forks: 72

[![logo](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/eb57734374174602.svg)](https://niim.blue) # NIIMBOT 打印机 WebUI 直接在浏览器中设计和打印标签 [常见问题](https://github.com/MultiMote/niimblue/wiki/Frequently-asked-questions) | [Discord](https://discord.gg/jXPAfZVd8a) | [Telegram](https://t.me/niimblue) | [Boosty](https://boosty.to/multimote) | [NIIMBOT 社区 Wiki](https://printers.niim.blue) 使用 [NiimBlueLib](https://github.com/MultiMote/niimbluelib) 进行通信
## 功能特性 * 隐私优先！此应用程序完全离线运行（在浏览器端），不发送任何数据（下载应用程序文件和导入 ZPL 标签除外）。标签数据存储在您的浏览器中。 * 支持 Bluetooth 和 USB 连接。 * 功能丰富的标签编辑器。支持标签保存、导入/导出。 * 打印预览。您可以看到标签经过后处理后的外观。提供了多种后处理算法。 * Android 应用（基于 Capacitor）。 * 最完整的 [NIIMBOT 协议](https://printers.niim.blue/interfacing/proto/)实现。 您可以在 [Wiki](https://github.com/MultiMote/niimblue/wiki#features) 上查看更完整的已实现和计划功能列表。 演示视频： [![demo video](https://img.youtube.com/vi/u8QX-5e3W_A/mqdefault.jpg)](https://www.youtube.com/watch?v=u8QX-5e3W_A) ## 支持的打印机 本项目没有确切的支持型号列表。该项目的目标是支持尽可能多的型号。 您可以查看 [此处已测试型号列表](https://github.com/MultiMote/niimbluelib/issues/1)。如果您拥有其他型号，请留言评论。 如果您的（新）打印机型号无法打印，请使用官方应用程序进行打印的[数据包转储](https://github.com/MultiMote/niimblue/wiki/Making-packet-capture)。 ## 支持的浏览器 您的浏览器必须支持 Web Bluetooth API：[支持的浏览器](https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API#browser_compatibility)。 对于串行通信：[支持的浏览器](https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API#browser_compatibility)。 现代基于 Chrome 的浏览器通常可以正常工作。 在某些系统上，您需要启用 Chrome 的 `Web Bluetooth` 或 `Experimental Web Platform Features`（导航至 `chrome://flags`）。 ## 图片 图片可能已过时。 ![ui](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/161fda3cb3174603.png)
⬇ 更多图片 ⬇ 标签属性： ![labels](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/68cf346dd2174605.png) 保存/加载菜单： ![save_load](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/c68d89ff55174607.png) 打印预览对话框： ![print_preview](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/79c122510e174608.png) 后处理： ![dither](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/8efce8e920174610.png) 模板： ![templating](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/ae4991ef34174611.png) 动态数据： ![batch](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/00c675eb79174613.png) 实际应用： ![printed_b1](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/e2ae3af981174615.jpg) ![printed_d110](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/fafad6fdc2174617.jpg)
## 开发 ### 启动开发服务器 跳过您已完成的步骤。 1. 安装 [git](https://git-scm.com) 2. 安装 [nodejs](https://nodejs.org) 3. 克隆仓库 git clone https://github.com/MultiMote/niimblue.git 4. 安装依赖 npm i 5. 运行开发服务器 检查代码并运行： npm run dev-check 或者直接运行： npm run dev ### 部署 要运行自己的实例，请构建静态文件（`npm run build`）并托管在您的 Web 服务器上（需要 HTTPS）， 或使用 [Docker 镜像](https://github.com/MultiMote/niimblue/wiki/Running-own-instance-with-Docker)。 ### IDE 设置 项目使用路径别名。 VSCode (settings.json)： ``` { "typescript.preferences.importModuleSpecifier": "non-relative", "javascript.preferences.importModuleSpecifier": "non-relative" } ``` ## 翻译（点击贡献） [![translation](https://weblate.mmote.ru/widget/niimblue/web/multi-auto.svg)](https://weblate.mmote.ru/engage/niimblue/)
标签：Capacitor, DIY工具, MITM代理, NIIMBOT, USB连接, WebUSB, Web客户端, Web蓝牙API, ZPL导入, 前端工具, 办公自动化, 协议实现, 开源硬件, 打印机驱动, 打印预览, 标签打印机, 标签编辑器, 标签设计, 桌面应用, 热敏打印机, 物联网, 离线应用, 移动应用, 自动化攻击, 自定义打印, 蓝牙打印, 请求拦截