btluckprinter

Quick and dirty GUI for Bluetooth thermal label printers that use the com.luckprinter.sdk_new SDK.

Note

You probably want to use the considerably more polished fichero-printer repository. The main difference is that this repository is designed to operate in the Bluetooth Classic mode.

Usage instructions

1. Use your OS bluetooth settings to pair with the printer. If the name ends in _BLE, wait a bit until it shows up without the BLE suffix.
2. Run the program. There is a PyInstaller packed binary of the GUI in the Releases tab. Alternatively pip install escpos and run gui.py.
3. Enter the serial port name in the Port box. On Windows, you can get this by opening Device Manager.

On Linux, use ls /dev/rfcomm*. In most cases the default will work. 4. Select an image file. JPG and PNG should work. Your image should be resized to:

• 96x207 (for 14x30mm paper)
• 96x276 (for 14x40mm paper)
• 96x344 (for 14x50mm paper)

5. Click Print.

More info

Whether this printer (i.e. the Fichero) is 175DPI or 203DPI is unclear. It's probably 203DPI but image dimensions (which are pulled from the app) seem to match 175DPI.

Since the printer seems to always crop off a bit of the image, try to leave at least a 5-7px gap around what's important. The app kind of reveals this by drawing a safe zone over the canvas area.

For some unclear reason, you can't buy 14x30mm white paper refills - the ones sold are 14x50mm, and the only other option is blue/pink/yellow 14x30mm. While AliExpress seems to sell them, they seem to be more expensive - sometimes one roll costs as much as buying a pack of 3 rolls of white 14x50mm labels locally.

Known printers

Tested with:

• Fichero Label Printer - Action PL

Seems identical, so will likely work:

• Silvercrest Label Printer - blog post