pyControl4
Python 3 asyncio package for interacting with Control4 systems
Decision gist · record as of 2026-08-14
Yes, if you own a Control4 system and need programmatic control. The library is actively maintained, has no known vulnerabilities, and is already battle-tested in Home Assistant. Install friction is low. The main constraint is Python >=3.11 and network access to your Control4 controller; verify your controller's OS version matches the documented compatibility range.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.11; Control4 controller must be reachable on the local network and support the REST API.
- Low install friction with a pure-Python wheel.
- Maintained actively with recent commits and no known vulnerabilities.
License · maintenance · safety
permissive license (permissive) — Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.
last release 2026-02-23 (172 days) · last repo commit 2026-02-23 · 52 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 75,819 downloads/mo, #14,678 on PyPI
Alternatives
Verify before relying
from pyControl4.account import C4Account
from pyControl4.director import C4Director
import asyncio
account = C4Account(username, password)
token = asyncio.run(account.get_account_bearer_token())
controllers = asyncio.run(account.get_account_controllers())
director = C4Director(ip, bearer_token)
devices = asyncio.run(director.get_all_item_info())- Whether the library works reliably with Control4 OS versions other than 2.10.1.544795-res and 3.0+
- Performance characteristics and concurrency limits when controlling many devices simultaneously
- Whether all Control4 device types are supported or only a subset (lights are documented)
What it is and what it does
pyControl4 is an async Python library that bridges your code to Control4 smart home systems via their built-in REST API. It handles authentication (both account-level and controller-level bearer tokens), device discovery, and direct control of connected devices like lights. The library is built on aiohttp and websocket-client for non-blocking I/O, making it suitable for integration into async applications like Home Assistant.
The package is actively maintained and known to work with Control4 OS 2.10.1.544795-res and OS 3.0+. It provides high-level classes (C4Account, C4Director, C4Light) that abstract the REST API details, so you authenticate once, query your controller's device list, and then send commands to individual devices. The official Home Assistant integration uses this library, indicating production readiness for that use case.
Use it for
- Integrate Control4 device control into a Home Assistant or other home automation platform
- Build custom automation scripts that query and control lights, switches, or other Control4 devices on a schedule
- Discover all devices on a Control4 controller and expose them to a third-party dashboard or API
- Implement scene triggering or device ramping (e.g., dimming lights over a time interval) from external applications
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a Control4 system and need programmatic control.
The library is actively maintained, has no known vulnerabilities, and is already battle-tested in Home Assistant. Install friction is low. The main constraint is Python >=3.11 and network access to your Control4 controller; verify your controller's OS version matches the documented compatibility range.
Install
pycontrol4 on PyPI
Before you install
Low install friction with a pure-Python wheel. Maintained actively with recent commits and no known vulnerabilities. Requires Python >=3.11 and four async-capable runtime dependencies (aiohttp, xmltodict, python-socketio-v4, websocket-client).
Requires Python >=3.11; Control4 controller must be reachable on the local network and support the REST API.
License in practice
Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.
Quickstart
from pyControl4.account import C4Account
from pyControl4.director import C4Director
import asyncio
account = C4Account(username, password)
token = asyncio.run(account.get_account_bearer_token())
controllers = asyncio.run(account.get_account_controllers())
director = C4Director(ip, bearer_token)
devices = asyncio.run(director.get_all_item_info())Verify before relying
- Whether the library works reliably with Control4 OS versions other than 2.10.1.544795-res and 3.0+
- Performance characteristics and concurrency limits when controlling many devices simultaneously
- Whether all Control4 device types are supported or only a subset (lights are documented)
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesaiohttpxmltodictpython-socketio-v4websocket-client |
| Maintenance | Actively maintained 172 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 75,819 / month, #14,678 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: pycontrol4-2.0.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “control4 home automation api”
- pyControl4An async library for controlling Control4 smart home systems through…
- pyfibaroProvides a Python client library to interact with Fibaro home…
- pyswitchbeeA Python library for controlling SwitchBee smart home devices over…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also switchbot-api · aiohue · xknx · elgato · pysensibo · pyisy · fjaraskupan · flux-led · pymiele · aioqsw