yam-tui 0.1.0__tar.gz

yam_tui-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: release
+
+on:
+  push:
+    branches: [main]
+
+concurrency: release
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      version: ${{ steps.tag.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - name: Compute and push next tag
+        id: tag
+        run: |
+          if git describe --exact-match --tags --match 'v*' HEAD 2>/dev/null; then
+            echo "HEAD is already tagged, nothing to release"
+            exit 0
+          fi
+          last=$(git tag --list 'v*' --sort=-v:refname | head -n1)
+          if [ -z "$last" ]; then
+            next="v0.1.0"
+          else
+            IFS=. read -r major minor patch <<< "${last#v}"
+            next="v${major}.${minor}.$((patch + 1))"
+          fi
+          git tag "$next"
+          git push origin "$next"
+          echo "version=$next" >> "$GITHUB_OUTPUT"
+      - name: Build
+        if: steps.tag.outputs.version
+        run: uv build
+      - uses: actions/upload-artifact@v4
+        if: steps.tag.outputs.version
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    if: needs.build.outputs.version
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

yam_tui-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+__pycache__/
+dist/
+src/yam_tui/_version.py

yam_tui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 René Fritze
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yam_tui-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.5
+Name: yam-tui
+Version: 0.1.0
+Summary: Minimal TUI for controlling a Yamaha RX-V475 AV receiver
+Project-URL: Homepage, https://github.com/renefritze/yam-tui
+Author-email: René Fritze <coding@fritze.me>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: Console :: Curses
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# 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 |
+
+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.

yam_tui-0.1.0/README.md

@@ -0,0 +1,29 @@
+# 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 |
+
+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.

yam_tui-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "yam-tui"
+dynamic = ["version"]
+description = "Minimal TUI for controlling a Yamaha RX-V475 AV receiver"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "René Fritze", email = "coding@fritze.me" }]
+requires-python = ">=3.10"
+dependencies = []
+classifiers = [
+    "Environment :: Console :: Curses",
+    "Programming Language :: Python :: 3",
+    "Topic :: Home Automation",
+]
+
+[project.urls]
+Homepage = "https://github.com/renefritze/yam-tui"
+
+[project.scripts]
+yam-tui = "yam_tui.app:cli"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/yam_tui/_version.py"

yam_tui-0.1.0/src/yam_tui/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None

yam_tui-0.1.0/src/yam_tui/app.py

@@ -0,0 +1,199 @@
+#!/usr/bin/env python3
+"""Minimal curses TUI for Yamaha RX-V475 (XML /YamahaRemoteControl/ctrl API).
+
+Usage: yam-tui [receiver-ip]      (default: $YAMAHA_HOST or 192.168.0.94)
+
+Keys:  p power   ↑/↓ volume   m mute   ←/→ or 0-9 input   s sound program
+       o HDMI out on/off   r refresh   q quit
+"""
+import curses
+import os
+import sys
+import urllib.error
+import urllib.request
+import xml.etree.ElementTree as ET
+
+POLL_MS = 2000
+VOL_STEP = 5  # in 0.1 dB units
+VOL_MIN, VOL_MAX = -800, 165
+# number key -> input; 0 is AUDIO, 1-5 are HDMI1-5, 6-9 are AV1-4
+HOTKEYS = {"0": "AUDIO"} | {str(n): f"HDMI{n}" for n in range(1, 6)} | {str(n + 5): f"AV{n}" for n in range(1, 5)}
+PROGRAMS = [
+    "Hall in Munich", "Hall in Vienna", "Chamber", "Cellar Club",
+    "The Roxy Theatre", "The Bottom Line", "Sci-Fi", "Action Game",
+    "Roleplaying Game", "Music Video", "Standard", "Spectacle", "Adventure",
+    "Drama", "Mono Movie", "Surround Decoder", "2ch Stereo", "7ch Stereo",
+]
+
+
+class Receiver:
+    def __init__(self, host):
+        self.url = f"http://{host}/YamahaRemoteControl/ctrl"
+
+    def _send(self, cmd, inner):
+        body = f'<YAMAHA_AV cmd="{cmd}">{inner}</YAMAHA_AV>'.encode()
+        with urllib.request.urlopen(self.url, body, timeout=3) as r:
+            root = ET.fromstring(r.read())
+        rc = root.get("RC", "0")
+        if rc != "0":
+            raise ValueError(f"receiver returned RC={rc}")
+        return root
+
+    def put(self, inner):
+        self._send("PUT", inner)
+
+    def put_main(self, inner):
+        self.put(f"<Main_Zone>{inner}</Main_Zone>")
+
+    def status(self):
+        r = self._send("GET", "<Main_Zone><Basic_Status>GetParam</Basic_Status></Main_Zone>")
+        t = lambda p: (r.findtext(".//" + p) or "").strip()
+        return {
+            "power": t("Power_Control/Power") == "On",
+            "vol": int(t("Volume/Lvl/Val") or 0),
+            "mute": t("Volume/Mute") == "On",
+            "input": t("Input/Input_Sel"),
+            "program": t("Current/Sound_Program"),
+            "straight": t("Current/Straight") == "On",
+            "hdmi_out": t("HDMI/Output/OUT_1") == "On",
+        }
+
+    def inputs(self):
+        r = self._send("GET", "<Main_Zone><Input><Input_Sel_Item>GetParam</Input_Sel_Item></Input></Main_Zone>")
+        return [(i.findtext("Param"), i.findtext("Title").strip())
+                for i in r.find(".//Input_Sel_Item")
+                if i.findtext("RW") == "RW"]
+
+    def set_power(self, on):
+        self.put_main(f"<Power_Control><Power>{'On' if on else 'Standby'}</Power></Power_Control>")
+
+    def set_volume(self, v):
+        v = max(VOL_MIN, min(VOL_MAX, v))
+        self.put_main(f"<Volume><Lvl><Val>{v}</Val><Exp>1</Exp><Unit>dB</Unit></Lvl></Volume>")
+
+    def set_mute(self, on):
+        self.put_main(f"<Volume><Mute>{'On' if on else 'Off'}</Mute></Volume>")
+
+    def set_input(self, name):
+        self.put_main(f"<Input><Input_Sel>{name}</Input_Sel></Input>")
+
+    def set_program(self, name):
+        self.put_main(f"<Surround><Program_Sel><Current><Sound_Program>{name}</Sound_Program></Current></Program_Sel></Surround>")
+
+    def set_hdmi_out(self, on):
+        self.put_main(f"<Sound_Video><HDMI><Output><OUT_1>{'On' if on else 'Off'}</OUT_1></Output></HDMI></Sound_Video>")
+
+
+def draw(scr, host, st, err, inputs):
+    scr.erase()
+    h, w = scr.getmaxyx()
+
+    def put(y, text, attr=0):
+        if y < h - 1:
+            scr.addnstr(y, 2, text, max(w - 3, 0), attr)
+
+    put(0, f"Yamaha RX-V475  {host}", curses.A_BOLD)
+    if err:
+        put(2, f"! {err}", curses.A_REVERSE)
+    if st:
+        db = st["vol"] / 10
+        barw = max(min(w - 30, 40), 5)
+        fill = round(barw * (st["vol"] - VOL_MIN) / (VOL_MAX - VOL_MIN))
+        put(3, f"Power     {'ON' if st['power'] else 'standby'}", curses.A_BOLD if st["power"] else 0)
+        put(4, f"Volume    [{'#' * fill}{'-' * (barw - fill)}] {db:+.1f} dB")
+        put(5, f"Mute      {'ON' if st['mute'] else 'off'}")
+        put(6, f"HDMI out  {'on' if st['hdmi_out'] else 'OFF'}")
+        put(7, f"Program   {st['program']}{' (straight)' if st['straight'] else ''}")
+        put(9, "Input", curses.A_BOLD)
+        for n, (param, title) in enumerate(inputs):
+            cur = param == st["input"]
+            key = next((k for k, v in HOTKEYS.items() if v == param), " ")
+            put(10 + n, f"{'>' if cur else ' '} {key} {param:<10} {title}", curses.A_REVERSE if cur else 0)
+    help_lines = [
+        "p        power",
+        "↑ / ↓    volume",
+        "m        mute",
+        "0-9      input (see list)",
+        "← / →    prev / next input",
+        "s        next sound program",
+        "o        HDMI out on/off",
+        "r        refresh",
+        "q        quit",
+    ]
+    if w >= 78:
+        for n, line in enumerate(help_lines):
+            if 3 + n < h:
+                scr.addnstr(3 + n, 52, line, w - 53, curses.A_DIM)
+    elif h > 1:
+        scr.addnstr(h - 1, 2, "p pwr ↑↓ vol m mute 0-9/←→ input s prog o hdmi r q", max(w - 3, 0), curses.A_DIM)
+    scr.refresh()
+
+
+def main(scr, host):
+    curses.curs_set(0)
+    scr.keypad(True)
+    scr.timeout(POLL_MS)
+    rx = Receiver(host)
+    st, err, inputs = None, None, []
+
+    def refresh():
+        nonlocal st, err, inputs
+        try:
+            st = rx.status()
+            if not inputs:
+                inputs = rx.inputs()
+            err = None
+        except (urllib.error.URLError, OSError, ValueError, ET.ParseError) as e:
+            err = f"{type(e).__name__}: {getattr(e, 'reason', e)}"
+
+    def act(fn, *args):
+        nonlocal err
+        try:
+            fn(*args)
+        except (urllib.error.URLError, OSError, ValueError, ET.ParseError) as e:
+            err = f"{type(e).__name__}: {getattr(e, 'reason', e)}"
+            return
+        refresh()
+
+    refresh()
+    while True:
+        draw(scr, host, st, err, inputs)
+        k = scr.getch()
+        if k in (ord("q"), 27):
+            return
+        if k in (-1, ord("r"), curses.KEY_RESIZE):
+            refresh()
+        elif not st:
+            continue
+        elif k == ord("p"):
+            act(rx.set_power, not st["power"])
+        elif k in (curses.KEY_UP, ord("+"), ord("=")):
+            act(rx.set_volume, st["vol"] + VOL_STEP)
+        elif k in (curses.KEY_DOWN, ord("-")):
+            act(rx.set_volume, st["vol"] - VOL_STEP)
+        elif k == ord("m"):
+            act(rx.set_mute, not st["mute"])
+        elif k == ord("o"):
+            act(rx.set_hdmi_out, not st["hdmi_out"])
+        elif k == ord("s"):
+            cur = PROGRAMS.index(st["program"]) if st["program"] in PROGRAMS else -1
+            act(rx.set_program, PROGRAMS[(cur + 1) % len(PROGRAMS)])
+        elif 0 <= k < 256 and chr(k) in HOTKEYS and HOTKEYS[chr(k)] in dict(inputs):
+            act(rx.set_input, HOTKEYS[chr(k)])
+        elif k in (curses.KEY_RIGHT, curses.KEY_LEFT, ord("\t")) and inputs:
+            names = [p for p, _ in inputs]
+            cur = names.index(st["input"]) if st["input"] in names else 0
+            step = -1 if k == curses.KEY_LEFT else 1
+            act(rx.set_input, names[(cur + step) % len(names)])
+
+
+def cli():
+    host = sys.argv[1] if len(sys.argv) > 1 else os.environ.get("YAMAHA_HOST", "192.168.0.94")
+    try:
+        curses.wrapper(main, host)
+    except KeyboardInterrupt:
+        pass
+
+
+if __name__ == "__main__":
+    cli()

yam_tui-0.1.0/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 5
+requires-python = ">=3.10"
+
+[[package]]
+name = "yam-tui"
+version = "0.1.0"
+source = { editable = "." }