This is a very simple web interface to create text labels on a Brother QL series label printers supported by pklaus/brother_ql.
Create a virtual environment and install the requirements
$> virtualenv3 env
$> . env/bin/activate
$env> pip install -r requirements.txt
Start the server by providing the model and connection string
$env> ./app.py --model QL-500 tcp://192.168.1.1:9100
Run app.py -h
for more info.
Open your browser on the shown URL (defaults to http://127.0.0.1:8013/
). The application uses modern JavaScript (promises, blobs, etc) and requires a modern browser. It was tested with Chrome only, but probably works in Firefox, too.
Labels are based on HTML templates located in the static/labels/
directory. Templates need to start with a supported label size followed by an underscore. See pklaus/brother_ql for a list of supported sizes.
The templates need to contain exactly one root element, specifying the exact size of the label in pixels (again, check the above site for proper values).
Elements containing an input
class can be edited through the form.
docker buildx build --platform linux/amd64,linux/arm64 -t repo:latest . --push
Divs with the qrcode
class will be converted to a QR Code. They also need the input
class and a data-value
attribute instead of an inner text.
This project uses TailWindCSS as a sane way to build and style the HTML object without having to deal with annoying CSS issues.
After updating a template and using a tailwindCSS helper class, you need to rebuild the CSS file:
npm run build-css
Please feel free to submit feedback in the form of pull requests.
Many thanks to the following projects: