inventree-brother-plugin

A label printing plugin for InvenTree, which provides support for the Brother label printers.

This plugin supports printing to some Brother label printers with network (wired or WiFi) support. Refer to the brother_ql docs 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).

• Dithering Enables grayscale-dithering for nicer logos and watermarks
  (Default = disabled, to avoid surprising users relying on existing behavior)