Skip to content

Home Assistant integration for Extron devices

License

Notifications You must be signed in to change notification settings

NitorCreations/ha-extron

Repository files navigation

ha-extron

Ruff Tests

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Home Assistant integration for Extron switchers and audio processors.

Supported devices

  • SSP 200 surround sound processors
  • SW HD 4K PLUS Series switchers

Requirements

Devices must have Telnet access enabled.

Features

Not every single feature can be controlled, only the basics:

  • Media player support
    • Source selection
    • Volume control (SSP 200 only)
  • Reboot button
  • Temperature sensor (SSP 200 only)

The communication is done using Python's asyncio and requires no external libraries.

Development

For local development, use uv to handle the Python dependencies and virtual env. Install uv with their standalone installer script or with package managers like homebrew.

Use uv sync to automatically create a virtual env and install the dependencies.

Update all dependencies with uv lock --upgrade.

Tests

# Using uv managed virtual env
uv run python -m unittest discover -s tests/ -v
# Manually activated virtual env with necessary dependencies
python3 -m unittest discover -s tests/ -v

Making a new release

  1. Update the version number in manifest.json and pyproject.toml
  2. Tag the release
  3. Make a GitHub release

The new release should be picked up by HACS momentarily.

License

GNU GENERAL PUBLIC LICENSE version 3