Home Assistant Home Assistant

Epson Workforce

The epson workforce platform allows you to monitor the ink levels of a Epson Workforce printer from Home Assistant.

To add Epson Workforce to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
   - platform: epsonworkforce
     host: IP_ADDRESS
     monitored_conditions:
     - black
     - photoblack
     - yellow
     - magenta
     - cyan
     - clean

Configuration Variables

Looking for your configuration file?
host string Required

The host name or address of the Epson workforce printer

monitored_conditions list Required

The cartridge colours to monitor.

black

The black ink cartridge

photoblack

The photo black ink cartridge (not supported by all printers).

yellow

The yellow ink cartridge.

magenta

The magenta (=red) ink cartridge.

cyan

The cyan (=blue) ink cartridge.

clean

The cleaning cartridge.

Supported devices:

  • Epson Workforce (and some EcoTank) printers who publish a HTTP page containing the ink cartridge levels

Tested devices:

  • Epson WF2630
  • Epson WF2660
  • Epson WF3540
  • Epson WF3620
  • Epson WF3640
  • Epson WF4820
  • Epson EcoTank ET-77x0
  • Epson ET-2650
  • Epson ET-4750
  • Epson EcoTank ET-5150 (51x0)
  • Epson Expression Home XP-2100
  • Epson Expression Home XP-2105

To make this module work you need to connect your printer to your LAN. The best is to navigate to the status page of the printer to check if it shows the page with the ink levels on the URL http://<IP_ADDRESS>/PRESENTATION/HTML/TOP/PRTINFO.HTML