Back to skills
media-player
by xejrax
Media & Streaming—Not yet rated
Your rating
Brief
Play audio/video locally on the host.
Description
What This Skill Does
Plays audio and video files locally on the host using mpv. Accepts local file paths and remote URLs, including HTTP streams and HLS playlists.
mpv runs without a GUI, making it usable over SSH or in minimal environments where desktop media players are unavailable.
When to Use It
- Playing local MP3 or video files from the terminal
- Streaming an HLS or online radio URL without opening a browser
- Quick media preview during a shell session
- Controlling playback with pause and stop commands from scripts
- Playing media on a headless or SSH-connected machine
Example Workflow
INPUT
User asks: play https://example.com/stream.m3u8
AGENT
- 1
Receive the URL from the user
- 2
Call media-player play with the provided URL
- 3
mpv opens and begins streaming the content
- 4
Confirm playback has started
OUTPUT
The HLS stream plays through mpv on the host machine
Requirements
- mpv media player (install via: sudo dnf install mpv)
Installation
clawhub install xejrax/media-playerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.