rxv

What it is and what it does

rxv is a Python library that automates Yamaha AV receivers by discovering them on the local network via SSDP and exposing their control interface as Python objects. You can turn receivers on and off, adjust volume, switch inputs and outputs, and control playback—all through a simple API. The library wraps the receiver's HTTP-based remote control protocol, so it works over standard network connectivity without needing special hardware.

The package is lightweight, depending only on requests for HTTP communication and defusedxml for safe XML parsing. It's marked Production/Stable but dormant since 2021, so while it works for the receivers it was designed for, you should not expect active maintenance or support for newer models.

Use it for:

• Integrate Yamaha receivers into home automation systems to control them alongside other smart devices.
• Build command-line tools or scripts to manage receiver settings without manual remote control.
• Enable playback control from networked applications when the receiver supports it.
• Automate input switching and output management in multi-zone or multi-room audio setups.
• Monitor and log receiver state for diagnostics or analytics.

Worth the install?

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

rxv discovers and controls Yamaha AV receivers over the network, allowing you to manage power, volume, inputs, outputs, and playback through a Python API.

Yes, if you own a compatible Yamaha receiver and need programmatic control. The library is stable and has low install friction. However, be aware that maintenance is dormant—no updates since 2021—so it will not support newer receiver models or adapt to protocol changes. Verify your receiver model is compatible before committing; if you need active support or broader device coverage, consider whether an alternative better fits your needs.

Install

rxv on PyPI

pip install rxv

uv add rxv

poetry add rxv

Installing rxv

Before you install

Low install friction with just two runtime dependencies (requests and defusedxml). Maintenance is dormant—last release was 2021-10-10 and no commits since 2024-08-01—so expect no active bug fixes or feature updates, though the codebase is marked Production/Stable.

License in practice

BSD license is permissive, allowing commercial and private use with minimal restrictions; you may use, modify, and distribute rxv freely provided you retain the license notice.

Quickstart

pip install rxv

import rxv
receivers = rxv.find()
if receivers:
    rx = receivers[0]
    rx.on = True
    rx.input = "HDMI1"

Requires a Yamaha receiver on the local network reachable via SSDP discovery, or manual specification of the receiver's control URL.

Verify before relying

• Which specific Yamaha receiver models are confirmed compatible beyond those listed in the summary.
• Whether SSDP discovery works reliably across different network configurations and firewall setups.
• Current status of Home Assistant integration and whether it still uses rxv or has migrated to an alternative.

Package facts

Evidence: rxv-0.7.0-py2.py3-none-any.whl

Tags

More Libraries packages