---
id: epson-projector
version: "0.6.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# epson-projector — Epson projector support for Python

License: permissive · Maintenance: active · Downloads: 73.9K/mo

## 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 above — 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

pip install epson-projector
uv add epson-projector
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: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 73.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

epson projector control python, async projector library, home assistant epson, network projector automation, epson device control, home-assistant, device-control, async-io

[View on SkillFed](https://skillfed.io/packages/epson-projector) · [View on PyPI](https://pypi.org/project/epson-projector/)