https://github.com/splitbrain/bql-label-printer
Brother Label Printer UI
https://github.com/splitbrain/bql-label-printer
brother-ql label-printing labels ql-500 ql-550 ql-570 ql-700
Last synced: about 1 month ago
JSON representation
Brother Label Printer UI
- Host: GitHub
- URL: https://github.com/splitbrain/bql-label-printer
- Owner: splitbrain
- Created: 2017-10-03T16:16:21.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-01T20:19:34.000Z (about 2 years ago)
- Last Synced: 2025-04-14T10:05:42.438Z (about 1 month ago)
- Topics: brother-ql, label-printing, labels, ql-500, ql-550, ql-570, ql-700
- Language: HTML
- Homepage: https://www.splitbrain.org/blog/2017-10/06-weekend_project_label_designer
- Size: 37.1 KB
- Stars: 27
- Watchers: 4
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Brother Label Printer UI
This is a very simple web interface to create text labels on a Brother QL series label printers supported by [pklaus/brother_ql](https://github.com/pklaus/brother_ql).
## Installation
Create a virtual environment and install the requirements
$> virtualenv3 env
$> . env/bin/activate
$env> pip install -r requirements.txt
## Running
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.
## Using
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.
## Label Templates
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](https://github.com/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.
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.
## Feedback
Please feel free to submit feedback in the form of pull requests.
## Credits
Many thanks to the following projects:
* [pklaus/brother_ql](https://github.com/pklaus/brother_ql)
* [1904labs/dom-to-image-more](https://github.com/1904labs/dom-to-image-more)
* [oxalorg/sakura](https://github.com/oxalorg/sakura)
* [KeeeX/qrcodejs](https://github.com/KeeeX/qrcodejs)