Skip to main content

yam-tui

Minimal terminal UI for controlling a Yamaha RX-V475 AV receiver on your LAN (uses the receiver's XML /YamahaRemoteControl/ctrl API; no dependencies).

uv tool install yam-tui     # or: pipx install yam-tui
yam-tui 192.168.0.94        # or set YAMAHA_HOST
Key Action
p power
↑ / ↓ volume
m mute
0–9 jump to input (0 AUDIO, 1–5 HDMI1–5, 6–9 AV1–4)
← / → previous / next input
s next sound program
o HDMI out on/off
q quit

Command line

Pass any of these switches to skip the TUI and just perform the action(s):

yam-tui --power on --input HDMI1 --volume=-35
yam-tui --mute toggle
yam-tui --vol-up 4            # 4 steps of 0.5 dB
yam-tui --program "Chamber" --hdmi-out off
yam-tui 192.168.0.94 --status

Switches: -p/--power, -v/--volume DB, --vol-up [N], --vol-down [N], -m/--mute, -i/--input, --next-input, --prev-input, -s/--program, --next-program, -o/--hdmi-out, --list-inputs, --list-programs, --status. on|off|toggle apply to power, mute and HDMI out. Put the host before --vol-up/--vol-down, or use YAMAHA_HOST.

Other RX-V models using the same XML protocol will probably work, but only the RX-V475 is tested.

Releases

Every merge to main bumps the patch version from the latest v* git tag (starting at v0.1.0), tags the commit and publishes to PyPI. For a minor/major bump, push the tag yourself (e.g. git tag v0.2.0 && git push --tags) before merging.

Metadata

Release files for yam-tui 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yam-tui 0.1.1
File Size Uploaded Provenance Actions
yam_tui-0.1.1.tar.gz 7.3 kB With provenance Details for yam_tui-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for yam-tui 0.1.1
File Interpreter ABI Platform Actions
yam_tui-0.1.1-py3-none-any.whl Python 3 none any Details for yam_tui-0.1.1-py3-none-any.whl

Total release size: 15.1 kB

Release files / yam_tui-0.1.1.tar.gz

Download URL yam_tui-0.1.1.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
caa590c2f05013bdb842ad62a536d549d3604118ba4874999d3684733dec0cc8
BLAKE2b-256 checksum
How to use checksums
9dda596a54a0722868794cad52029a8eeeea5b2f97f3821b1410cebc9a45ac42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / yam_tui-0.1.1-py3-none-any.whl

Download URL yam_tui-0.1.1-py3-none-any.whl
Size 7.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f994acc857c66156c5d264408c6f00b7780293091a9a8f0ce2432425adc4b08
BLAKE2b-256 checksum
How to use checksums
a0b7a51f1e30a506da7f4a52ead93c4298d1706a32dbbb605d70730ea742df42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for yam-tui 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for yam_tui-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page