Phomemo M02S Python library

This is a basic Python library for controlling the Phomemo M02S bluetooth thermal printer.

It probably only works on Mac & Linux, and it was really only made for me, but if you find it useful that's great!

This isn't published to PyPI, so if you want to install it you can use:

pip install git+https://github.com/theacodes/phomemo_m02s.git

Usage

You'll need to connect your computer to the printer via Bluetooth, this library just uses the Bluetooth serial port to communicate with the printer and therefore avoids any complicated Bluetooth stuff.

The whole library is designed around just printing images through the printer. Although it's totally possible to use the text features, it's just not important to me so I haven't really bothered. To print an image use:

python3 -m phomemo_m02s /path/to/image.png

You can use any format supported by Pillow. There are a few other options available, run python3 -m phomemo_m02s --help to see the full list.

Linux

On linux it needs the MAC address of the printer to work because the serial port utilities were removed from bluez. Just connect to the printer as you would any other bluetooth device and then run bluetoothctl paired-devices, the second column contains the MAC address.

To print an image, use the command as before, just add --mac:

python3 -m phomemo_m02s --mac 00:15:83:37:xx:xx /path/to/image.png

Alternatively, if the above doesn't work, you can connect the Bluetooth device to a serial port with rfcomm, then print direct to that.

First connect the printer using its MAC address (likely needs to be done as root):

rfcomm connect /dev/rfcomm0 aa:bb:cc:dd:ee:ff

This will output text such as:

Connected /dev/rfcomm0 to aa:bb:cc:dd:ee:ff on channel 1
Press CTRL-C for hangup

Leaving that running, print using the created port:

python3 -m phomemo_m02s --port /dev/rfcomm0 /path/to/image.png

When done, press Ctrl-C to remove the rfcomm port.

Contributing

While I don't really expect anyone else to try to use this, by all means, contributions are welcome. File an issue or reach out to us before you write code, so we can make sure it's something that'll be beneficial for all of us. :)

License

Wintertools is published under the MIT License