apple-media

⚠Review·Scanned 2/18/2026

This skill scans the local network for AirPlay/Apple TV devices and wraps pyatv/atvremote and Airfoil for discovery and playback/volume control. It runs local shell commands like atvremote scan and node ./scripts/scan-json.js, and the scanner extracts service Password fields into JSON.

from clawhub.ai·va63edb4·7.7 KB·0 installs

Scanned from 0.1.1 at a63edb4 · Transparency log ↗

$ vett add clawhub.ai/officialpm/apple-mediaReview findings below

apple-media

Discover and control AirPlay / Apple media devices from macOS.

This repo contains the Clawdbot skill located in SKILL.md plus helper scripts under scripts/.

Author

Parth Maniar — @officialpm

What it does

Scan the local network for AirPlay devices (HomePod, Apple TV, AirPlay TVs)
Provide a JSON summary of discovered devices
Delegate speaker volume/routing control to Airfoil (reliable for HomePods)
Use pyatv (atvremote) for Apple TV / supported device control

Install / setup

pyatv (recommended via pipx)

brew install pipx
pipx install pyatv || pipx upgrade pyatv

# Pin to Python 3.12 to avoid Python 3.14 asyncio issues
pipx reinstall pyatv --python python3.12

Verify:

atvremote --help | head

Airfoil (optional but recommended for HomePods)

Install Airfoil and grant Accessibility permissions.

brew install --cask airfoil

Usage

Scan (text)

./scripts/scan.sh 5

Scan (JSON)

node ./scripts/scan-json.js 5

Faster scan (known IPs)

./scripts/scan-hosts.sh "10.0.0.28,10.0.0.111" 3

Control HomePod volume (Airfoil)

# Requires Airfoil + the Clawdbot airfoil skill scripts
./scripts/connect.sh "Living Room"
./scripts/volume.sh "Living Room" 35

Privacy / safety

This repo intentionally avoids committing any personal data (no resume paths, no tokens, no device credentials).
The scan output includes IP addresses at runtime; do not commit scan outputs.