← 返回 Skills 市场

Denon AVR Control

Name: Denon AVR Control
Author: yuqian-shi

作者 Yuqian Shi · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ 安全检测通过

225

总下载

当前安装

版本数

在 OpenClaw 中安装

/install denon-avr-control

功能描述

Control a network-connected Denon AVR/AVC receiver over its classic IP control interface (TCP telnet-style commands or the goform HTTP endpoint), and expose...

使用说明 (SKILL.md)

Denon AVR Control

Use this skill to control a Denon receiver on the local network.

Quick start

Identify the receiver host or IP address.
Start with a read/query action before making changes.
Use scripts/denon_avr.py for normal operations.
If a model-specific command is missing, read references/commands.md and use --raw.

Default workflow

Query status

Run:

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --status

Power

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --power on
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --power off

Volume

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --volume 35.5
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --volume-up 3
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --volume-down 2

Inputs

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --input tv
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --input game
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --input heos

Mute

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --mute on
python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --mute off

Transport choice

Prefer the default TCP transport first:

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --status

If the receiver only responds on the HTTP control endpoint:

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --transport http --status

Raw commands

Use raw mode for model-specific features or when the canned arguments are not enough:

python3 skills/denon-avr-control/scripts/denon_avr.py --host \x3Cip-or-hostname> --raw PW? --raw MV? --raw SI?

Read references/commands.md for the common command families.

Local computer playback

If the user wants to play local audio files on the computer itself, use scripts/local_audio_jukebox.py together with this receiver-control skill.

Read references/local-playback.md when the task is to:

scan a local directory for songs
play a random song or a short random queue
play tracks that match a user query
build a simple playlist from user-provided terms
stop or inspect the local player state

This workflow plays audio on the local computer, so that machine's system output must already be routed to the receiver if sound should come out of the receiver.

Experimental DLNA push mode

If the user wants the Denon itself to fetch and play a local file over the LAN, use scripts/dlna_push.py.

Read references/dlna-push.md when the task is to:

scan a folder for audio files before choosing one
push a random local track directly to the Denon renderer
push a track chosen by user query
push a specific file path to the Denon
stop the remote playback and shut down the temporary HTTP server
support the same approach on Windows and macOS

This mode is more cross-platform than local-output playback because it uses Python + HTTP + UPnP/DLNA. It is still experimental and currently strongest for single-track push.

Real DLNA media server mode

If ad-hoc URL push is unreliable on a receiver, use scripts/simple_dlna_server.py instead.

Read references/dlna-server.md when the task is to:

expose one or more user-chosen music directories as a real discoverable DLNA MediaServer
let the user decide the music path(s) instead of assuming a fixed folder
let the Denon browse the library through its Local Music / HEOS path
support a more Windows-friendly and standards-based setup
avoid raw one-off URL playback hacks

This mode provides SSDP discovery, a device description, a ContentDirectory service, a ConnectionManager service, and direct HTTP media serving.

Prefer this mode for cross-platform local-library playback.

Guardrails

Query first when you do not know current state.
Send one mutating action at a time unless the user explicitly wants a batch.
Treat input names and sound modes as model-dependent; if a friendly alias fails, switch to --raw.
If the user did not provide the receiver address, ask for the IP/hostname or discover it only if they explicitly want network scanning.

安全使用建议

This skill appears to be what it says, but it will do actions that can affect your local system and LAN: it can scan any directories you point it at, start an HTTP server that serves files from those directories to your LAN, spawn local media players (afplay/ffplay), and write state under ~/.openclaw/state. Only allow it to scan or serve directories you trust (do not point it at your home directory or any folder with sensitive files). When pushing tracks to the receiver, ensure the chosen serve-host/port and firewall settings are what you intend. Note the scripts briefly open a socket to determine a local IP (connect attempt to 8.8.8.8), and they spawn subprocesses — these are normal for this functionality but worth knowing. Finally, the source/homepage is unknown: if you require provenance, request the author/source or prefer a package with a verifiable upstream before enabling autonomous agent invocation.

功能分析

Type: OpenClaw Skill Name: denon-avr-control Version: 0.1.0 The denon-avr-control skill bundle provides legitimate functionality for controlling Denon/Marantz receivers and serving local audio files via DLNA. The scripts (denon_avr.py, dlna_push.py, simple_dlna_server.py, and local_audio_jukebox.py) use standard Python libraries to implement TCP/HTTP control protocols, UPnP/SOAP messaging, and local media serving. While the bundle includes capabilities such as starting local HTTP servers, handling UDP multicast for SSDP discovery, and executing local media players via subprocesses, these actions are explicitly documented and necessary for the stated purpose. No evidence of data exfiltration, malicious prompt injection, or unauthorized persistence was found.

能力评估

✓ Purpose & Capability

The name/description match the included scripts: denon_avr.py implements TCP/HTTP Denon commands, dlna_push.py and simple_dlna_server.py implement local HTTP/DLNA serving, and local_audio_jukebox.py scans/plays local files. No unexpected cloud credentials, unrelated binaries, or opaque install steps are requested.

ℹ Instruction Scope

SKILL.md and the code instruct the agent to scan user-provided directories, start local HTTP servers, spawn local players (afplay/ffplay), and write state to ~/.openclaw/state. Those actions are consistent with the stated features but they do involve reading filesystem paths chosen by the user and serving files over the LAN — the agent should only do those when the user explicitly consents and provides the directories/host info.

✓ Install Mechanism

There is no install spec (instruction-only), so nothing is downloaded or installed automatically. The bundled Python scripts will run directly with the system Python; this is the lowest install risk.

✓ Credentials

The skill requests no environment variables or external credentials. It does create per-user state under the home directory (~/.openclaw/state) which is proportionate to keeping server/process state for stop/status operations.

✓ Persistence & Privilege

always is false and the skill does not modify other skills or system-wide configs. It stores small state files under the user's home directory and launches short-lived subprocesses/HTTP servers as expected for media serving.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install denon-avr-control
安装完成后，直接呼叫该 Skill 的名称或使用 /denon-avr-control 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Initial release of denon-avr-control. - Control Denon AVR/AVC receivers on your network using TCP or HTTP commands. - Power on/off, change volume, mute, switch inputs, and query receiver status. - Send raw Denon commands for advanced or model-specific features. - Play local audio directories through the receiver using DLNA/UPnP or classic network push. - Includes scripts for receiver control, local playback, DLNA push, and a full DLNA media server. - Guidance for safe operation: query state first and use model-specific workarounds as needed. - Tested on MacOS

元数据

Slug denon-avr-control

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题