[](https://opensource.org/licenses/MIT)

# inventree-brother-plugin
A label printing plugin for [InvenTree](https://inventree.org), which provides support for the [Brother label printers](https://www.brother.com.au/en/products/all-labellers/labellers).
This plugin supports printing to *some* Brother label printers with network (wired or WiFi) support. Refer to the [brother_ql docs](https://github.com/pklaus/brother_ql/blob/master/brother_ql/models.py) for a list of label printers which are directly supported.
## Installation
### Minimum Requirements
> [!IMPORTANT]
> This plugin now requires the "modern" InvenTree UI - version `0.18.0` or newer. The plugin will not function correctly on an InvenTree instance below version `0.18.0`
### Installation Procedure
Install this plugin manually as follows:
```
pip install inventree-brother-plugin
```
Or, add to your `plugins.txt` file to install automatically using the `invoke install` command:
```
inventree-brother-plugin
```
Now open your InvenTree's "Admin Center > Plugins" page to activate the plugin. Next, read below for instructions on setting up a printer via "Admin Center > Machines".
## Setup a machine instance for a Brother Label Printer
This plugin provides a driver for the machine registry in InvenTree, where multiple instances of this driver can
be set up for each physical label printer you want to connect to. Each machine has its own individual configuration set.
To set up a new machine, go to "Admin Center > Machines" and hit the "+" button. Now choose a name for this specific printer, select "Label Printer" as machine type and "Brother Label Printer Driver" as a driver, then submit. The new printer will now be listed in the machines table. To configure the printer, click on its line to open the "Machine detail" panel where you can set the "Driver Settings" to match your label printer.
## Configuration Options
The following list gives an overview of the available settings. Also check out the `brother-ql` package for more information.
* **Printer Model**
Currently supported models are:
QL-500, QL-550, QL-560, QL-570, QL-580N, QL-600, QL-650TD, QL-700, QL-710W, QL-720NW, QL-800, QL-810W, QL-820NWB, QL-1050, QL-1060N, QL-1100, QL-1100NWB, QL-1115NWB, PT-P750W, PT-P900W, PT-P950NW
* **Label Media**
Size and type of the label media. Supported options are (not all labels are available on all printers):
12, 18, 29, 38, 50, 54, 62, 62red, 102, 103, 104, 17x54, 17x87, 23x23, 29x42, 29x90, 39x90, 39x48, 52x29, 54x29, 60x86, 62x29, 62x100, 102x51, 102x152, 103x164, d12, d24, d58, pt12, pt18, pt24, pt36
* **IP Address**
If connected via TCP/IP, specify the IP address here.
* **USB Device**
If connected via USB, specify the device identifier here (VENDOR_ID:PRODUCT_ID/SERIAL_NUMBER, e.g. from `lsusb`).
* **Auto Cut**
Cut label after printing.
* **Rotation**
Rotation angle, either 0, 90, 180 or 270 degrees.
* **Compression**
Set image compression (required for some printers).
* **High Quality**
Print in high quality (required for some printers).
Raw data
{
"_id": null,
"home_page": "https://github.com/inventree/inventree-brother-plugin",
"name": "inventree-brother-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "inventree label printer printing inventory",
"author": "Oliver Walters",
"author_email": "oliver.henry.walters@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3b/ee/691518d88e50c1d0a06b9be237d33abeae3d61ee45104ffdda1ee54f2c25/inventree_brother_plugin-2.0.4.tar.gz",
"platform": null,
"description": "[](https://opensource.org/licenses/MIT)\n\n\n\n# inventree-brother-plugin\n\nA label printing plugin for [InvenTree](https://inventree.org), which provides support for the [Brother label printers](https://www.brother.com.au/en/products/all-labellers/labellers).\n\nThis plugin supports printing to *some* Brother label printers with network (wired or WiFi) support. Refer to the [brother_ql docs](https://github.com/pklaus/brother_ql/blob/master/brother_ql/models.py) for a list of label printers which are directly supported.\n\n## Installation\n\n### Minimum Requirements\n\n> [!IMPORTANT]\n> This plugin now requires the \"modern\" InvenTree UI - version `0.18.0` or newer. The plugin will not function correctly on an InvenTree instance below version `0.18.0`\n\n### Installation Procedure\n\nInstall this plugin manually as follows:\n\n```\npip install inventree-brother-plugin\n```\n\nOr, add to your `plugins.txt` file to install automatically using the `invoke install` command:\n\n```\ninventree-brother-plugin\n```\n\nNow open your InvenTree's \"Admin Center > Plugins\" page to activate the plugin. Next, read below for instructions on setting up a printer via \"Admin Center > Machines\".\n\n## Setup a machine instance for a Brother Label Printer\n\nThis plugin provides a driver for the machine registry in InvenTree, where multiple instances of this driver can\nbe set up for each physical label printer you want to connect to. Each machine has its own individual configuration set.\n\nTo set up a new machine, go to \"Admin Center > Machines\" and hit the \"+\" button. Now choose a name for this specific printer, select \"Label Printer\" as machine type and \"Brother Label Printer Driver\" as a driver, then submit. The new printer will now be listed in the machines table. To configure the printer, click on its line to open the \"Machine detail\" panel where you can set the \"Driver Settings\" to match your label printer.\n\n## Configuration Options\nThe following list gives an overview of the available settings. Also check out the `brother-ql` package for more information.\n\n* **Printer Model**\nCurrently supported models are: \nQL-500, QL-550, QL-560, QL-570, QL-580N, QL-600, QL-650TD, QL-700, QL-710W, QL-720NW, QL-800, QL-810W, QL-820NWB, QL-1050, QL-1060N, QL-1100, QL-1100NWB, QL-1115NWB, PT-P750W, PT-P900W, PT-P950NW\n\n* **Label Media**\nSize and type of the label media. Supported options are (not all labels are available on all printers): \n12, 18, 29, 38, 50, 54, 62, 62red, 102, 103, 104, 17x54, 17x87, 23x23, 29x42, 29x90, 39x90, 39x48, 52x29, 54x29, 60x86, 62x29, 62x100, 102x51, 102x152, 103x164, d12, d24, d58, pt12, pt18, pt24, pt36\n\n* **IP Address**\nIf connected via TCP/IP, specify the IP address here.\n\n* **USB Device**\nIf connected via USB, specify the device identifier here (VENDOR_ID:PRODUCT_ID/SERIAL_NUMBER, e.g. from `lsusb`).\n\n* **Auto Cut**\nCut label after printing.\n\n* **Rotation**\nRotation angle, either 0, 90, 180 or 270 degrees.\n\n* **Compression**\nSet image compression (required for some printers).\n\n* **High Quality**\nPrint in high quality (required for some printers).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Brother label printer plugin for InvenTree",
"version": "2.0.4",
"project_urls": {
"Homepage": "https://github.com/inventree/inventree-brother-plugin"
},
"split_keywords": [
"inventree",
"label",
"printer",
"printing",
"inventory"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9130f4ee556deb21d8aed0e18b4b04b98ac41d377fa6502f81202ac0e0b15272",
"md5": "8d57a03a61c6140f0613c79520a2a082",
"sha256": "58b413ce096eda35a2cb74d3765dd13163f470a4647339f2a69c5fad394446d6"
},
"downloads": -1,
"filename": "inventree_brother_plugin-2.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d57a03a61c6140f0613c79520a2a082",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7300,
"upload_time": "2025-08-17T12:37:50",
"upload_time_iso_8601": "2025-08-17T12:37:50.222175Z",
"url": "https://files.pythonhosted.org/packages/91/30/f4ee556deb21d8aed0e18b4b04b98ac41d377fa6502f81202ac0e0b15272/inventree_brother_plugin-2.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3bee691518d88e50c1d0a06b9be237d33abeae3d61ee45104ffdda1ee54f2c25",
"md5": "742231d33f78f3d760e40038dabfdd9e",
"sha256": "6b8f4e328ab4225fe581e5bd80ee6a7344b4f590fff7e797a08caf2c160ee10f"
},
"downloads": -1,
"filename": "inventree_brother_plugin-2.0.4.tar.gz",
"has_sig": false,
"md5_digest": "742231d33f78f3d760e40038dabfdd9e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6828,
"upload_time": "2025-08-17T12:37:51",
"upload_time_iso_8601": "2025-08-17T12:37:51.241733Z",
"url": "https://files.pythonhosted.org/packages/3b/ee/691518d88e50c1d0a06b9be237d33abeae3d61ee45104ffdda1ee54f2c25/inventree_brother_plugin-2.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 12:37:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "inventree",
"github_project": "inventree-brother-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "inventree-brother-plugin"
}