dlna

# DLNA - Media Device Control Control DLNA/UPnP MediaRenderer devices on your local network. ## Quick Start ```bash # Discover devices uv run dlna discover # Set default device (optional but convenient) uv run dlna config --device "HT-Z9F" # Play with default device (no need to specify device name) uv run dlna play "http://example.com/video.mp4" # Or play with specific device uv run dlna play "http://example.com/video.mp4" "Living Room TV" # Stop playback uv run dlna stop ``` ## Commands | Command | Description | |---------|-------------| | `discover` | Scan for DLNA devices | | `play <url> [device]` | Play media URL on device | | `stop [device]` | Stop playback | | `status [device]` | Get playback status | | `config` | Show configuration | | `config --device <name>` | Set default device | | `config --unset-device` | Clear default device | ## Configuration Default device is saved in `.dlna/config.json` inside the skill directory. ```bash # Set default device uv run dlna config --device "HT-Z9F" # Show current config uv run dlna config # Clear default device uv run dlna config --unset-device ``` ## Playing Local Files DLNA devices can only play URLs, not local file paths. To play local files, you need to serve them via HTTP. ### IMPORTANT: Use Background Task for HTTP Server **Always use a background task (Bash with run_in_background) to start the HTTP server.** This ensures: 1. **No zombie processes**: When Claude Code session ends, the server is automatically terminated 2. **Clean resource management**: Server lifecycle is tied to the session 3. **No port conflicts**: Server stops when done, freeing the port ### Example: Play Local File ```python # Step 1: Start HTTP server in background # This runs in background and auto-stops when session ends # Step 2: Get your local IP import socket def get_ip(): s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) s.connect(("8.8.8.8", 80)) ip = s.getsockname()[0] s.close() return ip # Step 3: Construct URL and play url = f"http://{get_ip()}:8000/video.mp4" # uv run dlna play url ``` ### Python API ```python import asyncio from dlna import discover_devices, find_device, play_url, set_default_device async def main(): # Set default device set_default_device("Living Room TV") # Find device (uses default if no name provided) device = await find_device() # Uses default if device: # Play remote URL await play_url(device, "http://example.com/video.mp4") asyncio.run(main()) ``` ## Supported Devices - Smart TVs (Sony, Samsung, LG, etc.) - Soundbars and speakers with DLNA support - Any UPnP MediaRenderer device