{"id":18733600,"url":"https://github.com/pklaus/brother_ql_web","last_synced_at":"2025-10-12T08:33:59.324Z","repository":{"id":41453090,"uuid":"74278575","full_name":"pklaus/brother_ql_web","owner":"pklaus","description":"A Python-based web service to print labels on Brother QL label printers. Based on brother_ql: https://github.com/pklaus/brother_ql","archived":false,"fork":false,"pushed_at":"2023-08-09T13:34:52.000Z","size":372,"stargazers_count":277,"open_issues_count":22,"forks_count":134,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-29T22:05:45.368Z","etag":null,"topics":["brother-ql","label-printing","ql-500","ql-700","ql-710w","web-ui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pklaus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-11-20T14:10:54.000Z","updated_at":"2025-03-25T23:37:23.000Z","dependencies_parsed_at":"2024-11-07T15:10:43.937Z","dependency_job_id":"5753f6c7-3985-4769-a44b-33494321bca8","html_url":"https://github.com/pklaus/brother_ql_web","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fbrother_ql_web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fbrother_ql_web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fbrother_ql_web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pklaus%2Fbrother_ql_web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pklaus","download_url":"https://codeload.github.com/pklaus/brother_ql_web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411231,"owners_count":20934653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brother-ql","label-printing","ql-500","ql-700","ql-710w","web-ui"],"created_at":"2024-11-07T15:10:36.590Z","updated_at":"2025-10-12T08:33:54.289Z","avatar_url":"https://github.com/pklaus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## brother\\_ql\\_web\n\nThis is a web service to print labels on Brother QL label printers.\n\nYou need Python 3 for this software to work.\n\n![Screenshot](./static/images/screenshots/Label-Designer_Desktop.png)\n\nThe web interface is [responsive](https://en.wikipedia.org/wiki/Responsive_web_design).\nThere's also a screenshot showing [how it looks on a smartphone](./static/images/screenshots/Label-Designer_Phone.png)\n\n### Installation\n\n**ProTip™**: If you know how to use Docker, you might want to use my ready-to-use Docker image to deploy this software.\nIt can be found [on the Docker hub](https://hub.docker.com/r/pklaus/brother_ql_web/).  \nOtherwise, follow the instructions below.\n\nGet the code:\n\n    git clone https://github.com/pklaus/brother_ql_web.git\n\nor download [the ZIP file](https://github.com/pklaus/brother_ql_web/archive/master.zip) and unpack it.\n\nInstall the requirements:\n\n    pip install -r requirements.txt\n\nIn addition, `fontconfig` should be installed on your system. It's used to identify and\ninspect fonts on your machine. This package is pre-installed on many Linux distributions.\nIf you're using a Mac, I recommend to use [Homebrew](https://brew.sh) to install\nfontconfig using [`brew install fontconfig`](http://brewformulas.org/Fontconfig).\n\n### Configuration file\n\nCopy `config.example.json` to `config.json` (e.g. `cp config.example.json config.json`) and adjust the values to match your needs.\n\n### Startup\n\nTo start the server, run `./brother_ql_web.py`. The command line parameters overwrite the values configured in `config.json`. Here's its command line interface:\n\n    usage: brother_ql_web.py [-h] [--port PORT] [--loglevel LOGLEVEL]\n                             [--font-folder FONT_FOLDER]\n                             [--default-label-size DEFAULT_LABEL_SIZE]\n                             [--default-orientation {standard,rotated}]\n                             [--model {QL-500,QL-550,QL-560,QL-570,QL-580N,QL-650TD,QL-700,QL-710W,QL-720NW,QL-1050,QL-1060N}]\n                             [printer]\n    \n    This is a web service to print labels on Brother QL label printers.\n    \n    positional arguments:\n      printer               String descriptor for the printer to use (like\n                            tcp://192.168.0.23:9100 or file:///dev/usb/lp0)\n    \n    optional arguments:\n      -h, --help            show this help message and exit\n      --port PORT\n      --loglevel LOGLEVEL\n      --font-folder FONT_FOLDER\n                            folder for additional .ttf/.otf fonts\n      --default-label-size DEFAULT_LABEL_SIZE\n                            Label size inserted in your printer. Defaults to 62.\n      --default-orientation {standard,rotated}\n                            Label orientation, defaults to \"standard\". To turn\n                            your text by 90°, state \"rotated\".\n      --model {QL-500,QL-550,QL-560,QL-570,QL-580N,QL-650TD,QL-700,QL-710W,QL-720NW,QL-1050,QL-1060N}\n                            The model of your printer (default: QL-500)\n\n### Usage\n\nOnce it's running, access the web interface by opening the page with your browser.\nIf you run it on your local machine, go to \u003chttp://localhost:8013\u003e (You can change\nthe default port 8013 using the --port argument).\nYou will then be forwarded by default to the interactive web gui located at `/labeldesigner`.\n\nAll in all, the web server offers:\n\n* a Web GUI allowing you to print your labels at `/labeldesigner`,\n* an API at `/api/print/text?text=Your_Text\u0026font_size=100\u0026font_family=Minion%20Pro%20(%20Semibold%20)`\n  to print a label containing 'Your Text' with the specified font properties.\n\n### License\n\nThis software is published under the terms of the GPLv3, see the LICENSE file in the repository.\n\nParts of this package are redistributed software products from 3rd parties. They are subject to different licenses:\n\n* [Bootstrap](https://github.com/twbs/bootstrap), MIT License\n* [Glyphicons](https://getbootstrap.com/docs/3.3/components/#glyphicons), MIT License (as part of Bootstrap 3.3)\n* [jQuery](https://github.com/jquery/jquery), MIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpklaus%2Fbrother_ql_web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpklaus%2Fbrother_ql_web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpklaus%2Fbrother_ql_web/lists"}