Brother Printer

The Brother Printer integration allows you to read current data from your local Brother printer.

It usually provides information about the device’s state, the left amount of ink or toner and the remaining life of the drum or other parts of the printer. The integration monitors every supported part.


Adding Brother Printer to your Home Assistant instance can be done via the user interface, by using this My button:

Brother Printer can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Some very old Brother printers use different data format and these models are not supported. The integration will show information about that during configuration.

Configuring the printer

To enable SNMP, navigate to the printer’s web interface (for example: and turn it on under Network / Protocol / SNMP. For some Brother devices, SNMPv3 read-write access and v1/v2c read-only access is the option required (under advanced settings).

SNMP settings on Brother Printer web interface

Sensor Example

You can configure Home Assistant to alert you when the printer jams or runs out of paper as follows. First, add the following to configuration.yaml under the template: section (Note: replace sensor.hl_l2340d_status with the actual name of your sensor):

  - binary_sensor:
    - name: 'Laser Printer Out Of Paper'
      state: >
        {{ is_state('sensor.hl_l2340d_status', 'no paper') }}

  - binary_sensor:
    - name: 'Laser Printer Paper Jam'
      state: >
        {{ is_state('sensor.hl_l2340d_status', 'paper jam') }}

Then, add this under the alert: section:

    name: Laser Printer is Out of Paper
    done_message: Laser Printer Has Paper
    entity_id: binary_sensor.laser_printer_out_of_paper
    can_acknowledge: true
      - my_phone_notify

    name: Laser Printer has a Paper Jam
    done_message: Laser Printer Paper Jam Cleared
    entity_id: binary_sensor.laser_printer_paper_jam
    can_acknowledge: true
      - my_phone_notify

The above will send an alert for paper jam or out of paper whenever the condition is detected, assuming you have the Home Assistant app configured on your phone so that alerts can be sent directly to it. If you don’t use the Home Assistant app, you will need to set up a different notifier.

Change my_phone_notify to the actual notifier you are using.