No description
  • C# 90.1%
  • PowerShell 5.1%
  • Inno Setup 4.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
TomTom f39e177626 Niim Desk 1.0.1
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-04 02:43:12 +02:00
app/NiimDesk Niim Desk 1.0.1 2026-10-04 02:43:12 +02:00
installer Niim Desk 1.0.0: label app for the NIIMBOT B1 over Bluetooth 2026-10-04 01:50:44 +02:00
release-notes Niim Desk 1.0.1 2026-10-04 02:43:12 +02:00
.gitignore Niim Desk 1.0.0: label app for the NIIMBOT B1 over Bluetooth 2026-10-04 01:50:44 +02:00
build.ps1 Niim Desk 1.0.0: label app for the NIIMBOT B1 over Bluetooth 2026-10-04 01:50:44 +02:00
README.md Niim Desk 1.0.0: label app for the NIIMBOT B1 over Bluetooth 2026-10-04 01:50:44 +02:00
release.ps1 Niim Desk 1.0.0: label app for the NIIMBOT B1 over Bluetooth 2026-10-04 01:50:44 +02:00

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 .niimlabel files; the last label is restored at start-up
  • System / Light / Dark theme, built-in updater, About and Log tabs

Getting started

  1. Switch the B1 on. Make sure the NIIMBOT phone app is not connected to it (the printer only accepts one connection).
  2. Start Niim Desk, open Settings and click Search. The printer shows up as B1-xxxxxxxx. No pairing in Windows is needed.
  3. 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.