- C# 90.1%
- PowerShell 5.1%
- Inno Setup 4.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| app/NiimDesk | ||
| installer | ||
| release-notes | ||
| .gitignore | ||
| build.ps1 | ||
| README.md | ||
| release.ps1 | ||
Niim Desk
Design and print labels on a NIIMBOT B1 from a Windows PC over Bluetooth. NIIMBOT's own PC software only prints over USB; Niim Desk talks to the printer over Bluetooth LE directly, so no cable, NIIMBOT software or driver is needed.
Features
- Labels built from blocks: text (any installed font, bold/italic/underline, several lines, fit-to-space or fixed size), images (threshold or dithering), QR codes and Code 128 barcodes
- Blocks side by side or stacked top to bottom
- Common B1 label sizes (50 × 30, 40 × 30, ...) or any custom size; rotate the design 0/90/180/270°
- Live preview at the real dot resolution (203 dpi)
- Reads the printer's status: model, battery, lid, and the loaded roll from its RFID tag (type, labels left)
- Print density 1-5, label type (gaps, black mark, continuous, transparent), copies, frame, white-on-black
- Labels are saved as
.niimlabelfiles; the last label is restored at start-up - System / Light / Dark theme, built-in updater, About and Log tabs
Getting started
- Switch the B1 on. Make sure the NIIMBOT phone app is not connected to it (the printer only accepts one connection).
- Start Niim Desk, open Settings and click Search. The printer shows up as
B1-xxxxxxxx. No pairing in Windows is needed. - Click Check printer to read the battery and the loaded roll, design the label and press Print (Ctrl+P).
How it works
The B1 exposes a Bluetooth LE GATT service (e7810a71-73ae-499d-8c15-faa9aef0c3f2) with one
characteristic (notify + write without response) that carries NIIMBOT's packet protocol both ways:
55 55 CMD LEN DATA XOR AA AA. Protocol knowledge comes from the open-source
niimbluelib project.
A print job is: connect (C1, prefixed with 03), set density (21), set label type (23),
print start (01, 7 bytes: total pages + page colour), page start (03), page size (13: rows,
columns, copies), one 85 packet per run of identical dot rows (or 84 for blank rows), page end
(E3), then print status (A3) is polled until every copy is out, and print end (F3).
The head has 384 dots (48 mm) at 203 dpi; rows run along the feed.
Building
Requires the .NET 8 SDK and, for the installer, Inno Setup 6.
.\build.ps1 # app\dist\NiimDesk.exe and installer\output\NiimDesk-Setup-<version>.exe
.\release.ps1 # tags, pushes and publishes a release on Forgejo (needs release-notes\v<version>.md)
Settings and the last label live in %APPDATA%\NiimDesk.
NIIMBOT is a trademark of its owner. This project is not made by or affiliated with NIIMBOT.