pklaus/brother_ql_web repository overview

This repository contain the application brother_ql_web⁠, a web interface to print labels with Brother's QL-series label printers. The software is based on the Python package brother_ql⁠.

The Dockerfiles used to create the images can be found on Github⁠.

⁠Base Image / Tags

The images created are based on alpine and built for multiple platforms/architectures. Your docker daemon will automatically pick a suitable version when pulling the image. Running this on a Raspberry Pi works like a charm!

• The :latest tag is the most up-to-date version of the code.
• Furthermore, there are tags like :alpine_1234567 available, they contain a specific commit of brother_ql_web if you want to pin your deployment to a specific version.

Check the Tags tab⁠ for a full list of available tags .

⁠Usage

An example running the application with a QL-700 connected via USB:

docker run \
  --name brother_ql_web \
  --detach \
  --device=/dev/usb/lp0 \
  --publish 8013:8013 \
  --restart=always \
  pklaus/brother_ql_web:latest \
  ./brother_ql_web.py --model QL-700 file:///dev/usb/lp0

Then you can access the web interface over via http://your-docker-host-ip:8013⁠.

Instead of --device=/dev/usb/lp0 you might also consider --volume /dev/usb/:/dev/usb/ which should be more robust against device disconnects / reconnects.

If you have a networked printer like the QL-820NWB, you could start the GUI like this:

docker run \
  --name brother_ql_web \
  --detach \
  --publish 8013:8013 \
  --restart=always \
  pklaus/brother_ql_web:latest \
  ./brother_ql_web.py --model QL-820NWB tcp://192.168.0.57

For more options, consult the --help:

docker run --rm \
  pklaus/brother_ql_web:latest \
  ./brother_ql_web.py --help

To stop/kill and remove the container, run:

docker kill brother_ql_web