skillfed

epson-projector

Epson projector support for Python

epson-projector v0.6.0 73.9K downloads/30d#14,911 on PyPI32
Permissive license MIT Active released

What it is and what it does

Epson-projector is an async Python library for remote control of Epson projectors over the network. It wraps aiohttp and pyserial-asyncio-fast to provide a non-blocking interface for querying and controlling projector state—power, input, brightness, and other properties—making it suitable for integration into Home Assistant and other automation frameworks.

The library exposes a Projector class that accepts a hostname and aiohttp session, then allows you to call methods like get_property() to read projector state. It maintains an active development history since 2018 and requires Python 3.11 or higher.

Use it for:

  • Integrate Epson projector control into Home Assistant automation workflows
  • Query projector power state and input source from a Python async application
  • Build custom dashboards or control panels that manage multiple networked Epson projectors
  • Monitor and log projector properties in a long-running async service

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Asynchronous Python library for controlling Epson projectors over the network, built on aiohttp and pyserial-asyncio-fast for integration with automation systems like Home Assistant.

Yes. The package has low install friction, active maintenance, no known vulnerabilities, permissive MIT licensing, and fills a specific niche for Epson projector automation. Install if you need to control an Epson projector from Python—particularly in Home Assistant contexts—and can meet the Python 3.11+ requirement.

Install

epson-projector on PyPI

pip

pip install epson-projector

uv

uv add epson-projector

poetry

poetry add epson-projector

Installing epson-projector

Before you install

Low install friction with a pure-Python wheel. Maintained actively as of June 2026 with regular updates since initial release in 2018.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and commercial contexts.

Quickstart

import epson_projector as epson
from epson_projector.const import POWER
import aiohttp
import asyncio

async def main():
    async with aiohttp.ClientSession() as session:
        projector = epson.Projector(host='HOSTNAME', websession=session, encryption=False)
        data = await projector.get_property(POWER)
        print(data)

asyncio.run(main())

Requires Python 3.11 or higher.

Verify before relying

  • Whether encryption=True is supported and what encryption methods are available
  • Full range of projector models and firmware versions supported
  • Whether pyserial-asyncio-fast is used for serial connections or only for network control

Package facts

License MIT (permissive)
Python support not specified
Install friction low — pure-Python wheel
Runtime dependencies 2 — aiohttp, pyserial-asyncio-fast
Maintenance actively maintained — 302 days since the last release
Last repo commit
First released
Downloads 73,901/month — #14,911 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: epson_projector-0.6.0-py3-none-any.whl

Keywords: epson, projector

License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Software Development :: Libraries :: Python Modules

Tags

epson projector control pythonasync projector libraryhome assistant epsonnetwork projector automationepson device control
home-assistantdevice-controlasync-io

More Python Modules packages