Skip to content
TakoAPI
Back to skills

media-player

by xejrax

Media & Streaming
1.8kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—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. 1

    Receive the URL from the user

  2. 2

    Call media-player play with the provided URL

  3. 3

    mpv opens and begins streaming the content

  4. 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-player

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links