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
   - platform: epsonworkforce
     host: IP_ADDRESS
     - black
     - photoblack
     - yellow
     - magenta
     - cyan
     - clean   

Configuration Variables

host string Required

The host name or address of the Epson workforce printer

monitored_conditions list Required

The cartridge colours to monitor.


The black ink cartridge


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


The yellow ink cartridge.


The magenta (=red) ink cartridge.


The cyan (=blue) ink cartridge.


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-2750
  • 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