Niimbot Label Printer Custom Integration

eigger · February 9, 2025, 5:41am

Niimbot Label Printer Home Assistant Integration

Installation

Install this integration with HACS (adding repository required), or copy the contents of this
repository into the custom_components/niimbot directory.
Restart Home Assistant.
Go to Settings / Integrations and add integration “Niimbot”
Please select a discovered Niimbot device from the list.

vincen · February 9, 2025, 8:43am

Hi

Thanks for that integration It would be nice to list printers that are supported by it
Also it looks like it supports only their printer that have network no ? I tried to add my 2 bluetooth ones but it doesn’t work

Vincèn

eigger · February 9, 2025, 10:26am

The Bluetooth models B1 and D110 are supported. What is your current printer model?

vincen · February 9, 2025, 11:04am

D110 but it doesn’t detect it, will check while being nearer of my HA computer !
Is it able to work through Proxy BLE with ESPHome ? as it would make it a lot easier to use

vincen · February 9, 2025, 11:26am

I confirm you it doesn’t work here ! Bluetooth is activated and working in HA but it doesn’t detect the Nimbot printer even when it’s just aside the NUC running HA !
Also error message is quite confusing as in French it states it could not find a printer on network…

eigger · February 9, 2025, 1:26pm

Is the Bluetooth device not showing up like this? I will work on making the error message clearer. Also, Bluetooth proxy is supported.

vincen · February 10, 2025, 8:20am

oki so I found out that HAOS is not doing Bluetooth proxy even when bluetooth integration is activated. I have setup a Bluetooth proxy on one of my ESP.
Now when I try to activate the integration it “sees” my Fitness device but the printer doesn’t show up. If I check in ESP logs nothing shows up when I put on the printer aside the ESP
How do you handle the bluetooth part on your side ?

Vincèn

eigger · February 10, 2025, 11:24am

Is your Bluetooth printer paired with another device? If it’s already connected to another device, it may not appear in the list. Try testing it on https://niim.mmote.ru.

vincen · February 10, 2025, 12:14pm

The Niimbot app on my phone but app is closed and not running, and the printer keeps blinking (the blue round) indicating it’s not connected at all !
One thing is sure: my BLE Proxy on ESP doesn’t see it at al
How did you handle the Bluetooth part in your system ?

eigger · February 11, 2025, 10:49am

I am using the built-in Bluetooth of a mini PC and a Bluetooth proxy.

sphirst · February 20, 2025, 2:48pm

This is such a great integration. Thank you!

Is there a way to test the payload (the x y paremeters) before printing?

eigger · February 20, 2025, 2:57pm

Currently, there is no way to test it before printing, but i will consider adding this feature in the future.

vincen · February 21, 2025, 10:29am

Do you plan to publish a custom card that would allow to use it easily ? as so far it’s quite annoying to use with the Action

Thanks

eigger · February 23, 2025, 1:03pm

I haven’t created a custom card before, so I don’t have any plans for it yet. I’ll think about a way to make it easier to use.

vulcanjedi · March 25, 2025, 1:54pm

B21 Supported?

eigger · March 25, 2025, 3:14pm

I can’t say for sure since I don’t have the B21 model, but as far as I know, it works the same way as the B1, so I think it should be possible.

nihao · April 14, 2025, 8:33pm

Thanks for this integration!

Do you know if it’s possible to put these printers (e.g. D110) into always-on mode? I mean, I would like it to be plugged into charger and always ready to print something (without having to turn it on or press any buttons).

eigger · April 15, 2025, 12:15am

I’m using the B1 model, and it can stay powered on continuously when connected to a power source. I think other devices might support this as well, but I haven’t tested them, so I’m not sure.

peterclary · April 17, 2025, 3:06pm

How long do you expect it to take from when the action is triggered to when the printer actually starts moving? I’m seeing 12-17 seconds, and that’s just for two lines of text, no images being downloaded from the web.

EDIT: Looks like it’s about the time to send over my BLE proxy (address obscured). This is the log for sending a bitmap showing 2 lines of text:

[16:38:05][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_CONNECT_EVT
[16:38:05][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_OPEN_EVT
[16:38:05][I][esp32_ble_client:263]: [0] [XX:XX:XX:XX:XX:XX] Connected
[16:38:05][D][esp32_ble_tracker:115]: connecting: 0, discovered: 0, searching: 0, disconnecting: 0
[16:38:05][D][esp32_ble_tracker:282]: Starting scan...
[16:38:05][D][esp32_ble_client:296]: [0] [XX:XX:XX:XX:XX:XX] cfg_mtu status 0, mtu 240
[16:38:05][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_REG_FOR_NOTIFY_EVT
[16:38:05][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_DESCR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:06][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:07][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:07][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:07][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:07][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:08][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:08][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:08][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:08][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:08][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:09][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:10][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:10][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:10][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:10][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:10][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:11][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:11][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:11][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:11][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:11][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:12][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:12][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:12][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:12][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:12][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:13][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:13][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:13][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:13][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:13][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:14][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:14][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:14][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:14][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:14][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:15][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:15][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:15][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:15][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:15][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:16][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:16][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:16][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:16][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:16][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:17][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:17][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:17][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:17][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:17][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:18][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:18][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:18][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:18][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:18][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:19][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:19][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:19][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:19][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:19][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:20][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:20][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:20][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:20][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:20][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:21][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:22][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:22][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:23][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:23][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:23][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_WRITE_CHAR_EVT
[16:38:23][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_NOTIFY_EVT
[16:38:23][D][esp32_ble_client:416]: [0] [XX:XX:XX:XX:XX:XX] Event 39
[16:38:23][I][esp32_ble_client:147]: [0] [XX:XX:XX:XX:XX:XX] Disconnecting (conn_id: 0).
[16:38:23][D][esp-idf:000][BTU_TASK]: W (454765779) BT_HCI: hci cmd send: disconnect: hdl 0x0, rsn:0x13

[16:38:23][D][esp-idf:000][BTU_TASK]: W (454765785) BT_APPL: gattc_conn_cb: if=3 st=0 id=3 rsn=0x16

[16:38:23][D][esp-idf:000][BTU_TASK]: W (454765789) BT_APPL: gattc_conn_cb: if=4 st=0 id=4 rsn=0x16

[16:38:23][D][esp-idf:000][BTU_TASK]: W (454765793) BT_APPL: gattc_conn_cb: if=5 st=0 id=5 rsn=0x16

[16:38:23][D][esp32_ble_client:191]: [0] [XX:XX:XX:XX:XX:XX] ESP_GATTC_CLOSE_EVT

eigger · April 18, 2025, 7:57am

The printer usually starts within 5 seconds. It’s slower than native apps, likely due to some delay in HA’s Bluetooth communication. In your case, the Bluetooth seems to have particularly high latency.