{"categories":[{"label":"Libraries","url":"https://skillfed.io/packages/category/software-development-libraries/10"},{"label":"Home Automation","url":"https://skillfed.io/packages/category/home-automation"}],"enrichment":{"capability":"An asynchronous Python library for controlling Denon and Marantz HEOS devices over the local network via the HEOS CLI Protocol, supporting device discovery, playback control, and event notifications.","skillfed_tags":["home-automation","async-io","network-audio"],"use_cases":["Automate multi-room audio playback across HEOS devices in a home automation system.","Build a custom control interface or dashboard for Denon/Marantz HEOS speakers and receivers.","Monitor and react to player state changes (play, pause, track changes) via event subscriptions.","Implement failover logic to maintain control when the primary HEOS device becomes unavailable.","Integrate HEOS device control into a larger smart home orchestration platform."],"what_it_does":"pyheos is an async Python library that connects to Denon and Marantz audio products equipped with HEOS Built-in, allowing you to control them programmatically over the local network. It implements the HEOS CLI Protocol (version 1.21) and provides a single connection point to manage all compatible devices on your network, with support for player discovery, playback commands, event subscriptions, and automatic reconnection. The library is designed around async/await patterns and includes options for heart-beat monitoring, event filtering, account sign-in, and failover to alternate hosts.\n\nThe main entry point is the `Heos` class, which you instantiate via `create_and_connect()` with a host IP address and optional configuration. Once connected, you can retrieve available players, subscribe to state changes through a dispatcher, and issue control commands. It requires Python 3.11 or newer and has no external runtime dependencies, making it lightweight to integrate into home automation frameworks or standalone scripts.","worth_installing":"Yes. The package is actively maintained, has no external dependencies, supports current Python versions (3.11+), carries a permissive license, and has no known vulnerabilities. It fills a clear niche for HEOS device automation. Install it if you own compatible Denon or Marantz equipment and need programmatic control; skip it if you have no HEOS devices or prefer a different audio ecosystem."},"id":"pyheos","links":{"html":"https://skillfed.io/packages/pyheos","md":"https://skillfed.io/packages/pyheos.md","pypi":"https://pypi.org/project/pyheos/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-10-12","license_spdx":"Apache-2.0","license_treatment":"permissive","name":"pyheos","python_support":"supports_current","summary":"An async python library for controlling HEOS devices through the HEOS CLI Protocol"},"popularity":{"monthly_downloads":95680,"position":13254,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"1.0.6"}