MultiMote/niimblue

MultiMote/niimblue has 827 GitHub stars and 134 forks. GitHot measured +1 stars in 24 hours and +6 in 7 days. Last checked 2026-11-10 03:24 UTC. Last push 2026-11-02.

How these counts are measured

🖨 NIIMBOT custom web client/app. Design and print labels with NIIMBOT printers directly from your PC or mobile web browser!

827 stars 134 forks +1 in 24h

What you can do

Privacy first! This application works completely offline (at browser side) and does not send any data (except for downloading application files and importing ZPL labels). Label data is stored in your browser.
Support for both Bluetooth and USB connections.
Rich label editor. Label saving, import/export.
Print preview. You can see how your label will look like after post-processing. Several post-processing algorithms are available.

Measured star growth

in 24h: +1
in 7 days: +6
in 15 days: Update delayed
in 1 month: Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

NIIMBOT printers webui

Design and print labels right from your browser

FAQ | Discord | Telegram | NIIMBOT Community Wiki

NiimBlueLib is used for communication

Deployments:

niim.blue main | dev.niim.blue dev | 2.niim.blue main

Give thanks:

Boosty | Lava (less fees)

Features

Privacy first! This application works completely offline (at browser side) and does not send any data (except for downloading application files and importing ZPL labels). Label data is stored in your browser.
Support for both Bluetooth and USB connections.
Rich label editor. Label saving, import/export.
Print preview. You can see how your label will look like after post-processing. Several post-processing algorithms are available.
Standalone apps:
- Android (Capacitor based)
- Windows (Tauri based, uses Edge backed)
Most complete implementation of NIIMBOT protocol.

You can see more complete list of implemented and planned features on the Wiki.

Demonstration video:

Supported printers

There is no exact list of supported models in this project. This project aims to support the maximum number of models.

You can check a list of tested models here. If you own other model, please write a comment.

If your (new) printer model does not print, please make a packet dump of print with official application.

[!NOTE] If you have printing problems, try different print task versions in print preview dialog. Make if default by pressing "Lock" button.

Supported browsers

Your browser must support Web Bluetooth API: supported browsers.

For serial communication: supported browsers.

Modern Chrome-based browsers should usually work.

In some systems you need to enable Chrome Web Bluetooth or Experimental Web Platform Features (navigate to chrome://flags).

Safari: while, this browser has no native Web Bluetooth, there is beacio extension that enables Web Bluetooth under Safari. Setup details available here.

Images

Images may be outdated.

⬇ More images ⬇

Label properties:

labels

Save/load menu:

save_load

Print preview dialog:

print_preview

Post-processing:

dither

Templating:

templating

Dynamic data:

batch

In real life:

printed_b1

printed_d110

Development

Launching development server

Skip steps you have done.

Install git
Install nodejs

Clone repository

git clone https://github.com/MultiMote/niimblue.git

Install dependencies
```
npm i
```
Run dev server

Check code and run:
```
npm run dev-check
```
Or just run:
```
npm run dev
```

Deployment

Here are some options. HTTPS is required for non-localhost deployments.

Serving static files

To get static files run npm run build (result builds to dist) or download niimblue-dist.zip from Releases.

Using Docker Image

Follow the instructions in the wiki.

IDE setup

Project uses path aliases.

VSCode (settings.json):

{
  "typescript.preferences.importModuleSpecifier": "non-relative",
  "javascript.preferences.importModuleSpecifier": "non-relative"
}