{"id":15651759,"url":"https://github.com/lymanepp/ha-epson-workforce","last_synced_at":"2026-06-09T20:00:26.151Z","repository":{"id":237706316,"uuid":"795091617","full_name":"lymanepp/ha-epson-workforce","owner":"lymanepp","description":"Home Assistant Epson WorkForce Printer integration","archived":false,"fork":false,"pushed_at":"2026-05-18T17:04:59.000Z","size":231,"stargazers_count":20,"open_issues_count":3,"forks_count":7,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-18T17:12:08.301Z","etag":null,"topics":["epson","home-assistant","homeassistant","integration","workforce"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lymanepp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-02T15:09:10.000Z","updated_at":"2026-05-18T16:58:16.000Z","dependencies_parsed_at":"2024-05-03T02:03:01.530Z","dependency_job_id":"ac507d2e-84d5-4942-a9f7-304560c4cc39","html_url":"https://github.com/lymanepp/ha-epson-workforce","commit_stats":null,"previous_names":["lymanepp/ha-epson-workforce"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/lymanepp/ha-epson-workforce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lymanepp%2Fha-epson-workforce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lymanepp%2Fha-epson-workforce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lymanepp%2Fha-epson-workforce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lymanepp%2Fha-epson-workforce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lymanepp","download_url":"https://codeload.github.com/lymanepp/ha-epson-workforce/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lymanepp%2Fha-epson-workforce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34123172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["epson","home-assistant","homeassistant","integration","workforce"],"created_at":"2024-10-03T12:40:03.512Z","updated_at":"2026-06-09T20:00:26.135Z","avatar_url":"https://github.com/lymanepp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!IMPORTANT]\n\u003e 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.\n\n# Epson WorkForce Integration for Home Assistant\n\n### Printer Monitoring Made Simple\n#### Monitor your Epson printer's ink levels and status directly in Home Assistant\n\n* Real-time ink level monitoring for all cartridge colors\n* Automatic sensor detection (only creates sensors for available cartridges)\n* Printer status monitoring\n* Easy UI-based configuration\n* Professional Epson branding integration\n\n\u003cimg src=\"images/ha_example.png\" alt=\"Home Assistant Epson WorkForce Integration Example\" width=\"300\"\u003e\n\n### Supported Devices\n\n**Epson printer series likely to work:**\n\n* WorkForce: WF-26xx, WF-27xx, WF-28xx, WF-35xx, WF-36xx, WF-48xx, WF-77xx, WF-78xx\n* EcoTank: ET-26xx, ET-27xx, ET-28xx, ET-47xx, ET-48xx, ET-49xx, ET-51xx, ET-77xx, ET-85xx\n* Expression: XP-8xx, XP-21xx, XP-22xx\n\n**Confirmed working:**\n\n* WorkForce: WF-2630, WF-2660, WF-2760, WF-2835, WF-3540, WF-3620, WF-3640, WF-4820, WF-7720, WF-7830, WF-7840\n* EcoTank: ET-2650, ET-2750, ET-2820, ET-4750, ET-4800, ET-4950, ET-5150, ET-77x0, ET-8500, L6270\n* Expression: XP-860, XP-2100, XP-2105, XP-2150, XP-2205\n\n\u003e [!NOTE]\n\u003e Please [open an issue](https://github.com/lymanepp/ha-epson-workforce/issues/new) only if you have:\n\u003e\n\u003e * A printer from an **Epson series not listed above** (working or not), or  \n\u003e * A confirmed failure with a listed-series model, including logs and the printer status page HTML.\n\u003e\n\u003e Please do **not** open issues to report additional working models within the listed series.\n\n### Requirements\n\n* Printer must be connected to your network\n* Printer must serve ink level information via HTTP\n* Default status page: `/PRESENTATION/HTML/TOP/PRTINFO.HTML`\n\n## Installation\n\n### Via [HACS](https://hacs.xyz/)\n\u003ca href=\"https://my.home-assistant.io/redirect/hacs_repository/?owner=lymanepp\u0026repository=ha-epson-workforce\u0026category=integration\" target=\"_blank\"\u003e\u003cimg src=\"https://my.home-assistant.io/badges/hacs_repository.svg\" alt=\"Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.\" /\u003e\u003c/a\u003e\n\n### Manually\n\nGet the folder `custom_components/epson_workforce` in your HA `config/custom_components`\n\n## Configuration\n\u003ca href=\"https://my.home-assistant.io/redirect/config_flow_start/?domain=epson_workforce\" target=\"_blank\"\u003e\u003cimg src=\"https://my.home-assistant.io/badges/config_flow_start.svg\" alt=\"Open your Home Assistant instance and start setting up a new integration.\" /\u003e\u003c/a\u003e\n\n* Enter your printer's IP address and optionally adjust the status page path.\n\n\u003e [!TIP]\n\u003e **Finding Your Printer's IP Address:**\n\u003e * Check your router's admin panel for connected devices\n\u003e * Use your printer's display panel (Network Settings → TCP/IP)\n\u003e * Check the Epson printer software on your computer\n\n## Sensor Naming\n\nSensors 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.\n\nThe integration automatically detects and creates sensors for:\n\n* **Ink Levels**: Black, Photo Black, Cyan, Magenta, Yellow, Light Cyan, Light Magenta\n* **Maintenance**: Cleaning cartridge level\n* **Status**: Overall printer status\n\n\u003e [!NOTE]\n\u003e 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.\n\nExample sensor names:\n* `sensor.epson123456_ink_level_black`\n* `sensor.epson123456_printer_status`\n* `sensor.epson123456_cleaning_level`\n* `sensor.epson123456_wifi_network`\n\n## Troubleshooting\n\nTo troubleshoot your Home Assistant instance, you can add the following configuration to your configuration.yaml file:\n\n```yaml\nlogger:\n  default: warning  # Default log level for all components\n  logs:\n    custom_components.epson_workforce: debug    # Enable debug logging for this integration\n```\n\n\u003e [!WARNING]\n\u003e **Common Issues:**\n\u003e * Ensure the printer is powered on and connected to your network\n\u003e * Verify the printer IP address is correct\n\u003e * Try accessing `http://YOUR_PRINTER_IP/PRESENTATION/HTML/TOP/PRTINFO.HTML` directly in your browser\n\u003e * Check Home Assistant logs for any error messages\n\u003e * Some cartridge types may not be available on all printer models\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flymanepp%2Fha-epson-workforce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flymanepp%2Fha-epson-workforce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flymanepp%2Fha-epson-workforce/lists"}