Setup & Installation
openclaw skills install @xejrax/media-player
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install media-player
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: play https://example.com/stream.m3u8
AGENT
- 1Receive the URL from the user
- 2Call media-player play with the provided URL
- 3mpv opens and begins streaming the content
- 4Confirm playback has started
OUTPUT
The HLS stream plays through mpv on the host machine
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
mpv media player (install via: sudo dnf install mpv)