Important
Before setting up the integration, ensure your Epson WorkForce or EcoTank printer is connected to your network and accessible via HTTP. Visit http://YOUR_PRINTER_IP/PRESENTATION/HTML/TOP/PRTINFO.HTML to verify compatibility.
- Real-time ink level monitoring for all cartridge colors
- Automatic sensor detection (only creates sensors for available cartridges)
- Printer status monitoring
- Easy UI-based configuration
- Professional Epson branding integration
- WF2630, WF2660, WF3540, WF3620, WF3640, WF4820, WF7720
- ET-2650, ET-2750, ET-4750, ET-5150 (51x0), ET-77x0, ET-8500, L6270
- XP-860, XP-2100, XP-2105, XP-2150, XP-2205
- Printer must be connected to your network
- Printer must serve ink level information via HTTP
- Default status page:
/PRESENTATION/HTML/TOP/PRTINFO.HTML
Note
If you have a printer model that you would like added, please create an issue with your printer model and test results.
Via HACS
Get the folder custom_components/epson_workforce in your HA config/custom_components
- Enter your printer's IP address and optionally adjust the status page path.
Tip
Finding Your Printer's IP Address:
- Check your router's admin panel for connected devices
- Use your printer's display panel (Network Settings → TCP/IP)
- Check the Epson printer software on your computer
Sensors are automatically created for each available ink cartridge and printer status. They are named in the format Ink level {Color} for cartridges and Printer Status for the overall printer state.
The integration automatically detects and creates sensors for:
- Ink Levels: Black, Photo Black, Cyan, Magenta, Yellow, Light Cyan, Light Magenta
- Maintenance: Cleaning cartridge level
- Status: Overall printer status
Note
Only sensors available on your specific printer model will be created. The integration queries your printer and only adds sensors for cartridges that are detected.
Example sensor names:
sensor.ink_level_black_192_168_1_100sensor.ink_level_cyan_192_168_1_100sensor.printer_status_192_168_1_100
To troubleshoot your Home Assistant instance, you can add the following configuration to your configuration.yaml file:
logger:
default: warning # Default log level for all components
logs:
custom_components.epson_workforce: debug # Enable debug logging for this integrationWarning
Common Issues:
- Ensure the printer is powered on and connected to your network
- Verify the printer IP address is correct
- Try accessing
http://YOUR_PRINTER_IP/PRESENTATION/HTML/TOP/PRTINFO.HTMLdirectly in your browser - Check Home Assistant logs for any error messages
- Some cartridge types may not be available on all printer models