A local media controller that allows AI agents to manage music playback through the MPV media player and organized local directories.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install player
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install player using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Music Player Skill?
The Music Player Skill is designed to bridge the gap between AI agents and local media environments. By leveraging the power of Openclaw Skills, this tool provides a programmatic interface to control the MPV media player, specifically targeting a dedicated music directory (F:\Music). It allows for seamless integration of music management into a developer's daily workflow without leaving the command environment.
This skill provides comprehensive control over a local audio library, including metadata search and directory-wide playback. It is optimized for users who maintain a high-quality local music collection and require a lightweight, scriptable way to handle audio streams via Openclaw Skills.
Music Player Skill Use Cases
- Automatically playing background music during focused coding sessions.
- Searching and playing specific tracks or artists using natural language commands.
- Managing local audio libraries by querying statistics and directory contents.
- Triggering random shuffle play for music discovery within a personal collection.
How Music Player Skill Works
- The skill scans the configured music library path (F:\Music) to index available audio files.
- When a command is received, the skill parses parameters like song names, artist names, or directory paths.
- It uses the Python subprocess module to initialize the MPV media player located at a specific binary path.
- Commands for playback, pausing, or stopping are sent as arguments or signals to the MPV process.
- The skill returns status updates or library information to the user interface via Openclaw Skills protocols.
Music Player Skill Setup
To get started with this skill, ensure your environment meets the following requirements:
- Install Python 3.x on your system.
- Install the MPV player. Ensure the executable is located at
E:\software\mpv-x86_64\mpv.exeor update the skill configuration accordingly. - Place your audio files in the
F:\Musicdirectory. - Register the skill within your agent configuration to enable Openclaw Skills functionality.
# Standard Python libraries used:
# - subprocess (for process management)
# - json (for data handling)
Music Player Skill Data Schema & Taxonomy
The skill organizes data based on the filesystem structure of the music library and the MPV execution parameters:
| Attribute | Description |
|---|---|
| Binary Path | The absolute path to the mpv.exe file used for playback. |
| Library Path | The root directory where music files are stored (F:\Music). |
| Search Keys | Metadata used for matching, including song titles and artist names. |
| Statistics | Data regarding the total number of files and directory hierarchy. |
Music Player Skill Advanced Features
- Support for recursive directory playback to listen to entire albums or genres.
- Randomized 'Shuffle' mode for non-linear music discovery.
- Real-time library info summaries to track your collection size and structure.
- Low-latency control via direct subprocess manipulation, compatible with most Openclaw Skills workflows.
SKILL.md
Loading
Related Openclaw Skills
QA Reviewer
A comprehensive quality assurance framework for AI agents to perform automated code reviews, execute tests, and track project health.
UniFuncs Web & Deep Research Skill
A powerful suite of web tools for AI agents to browse, search, and research the internet with high precision.
iCloud CalDAV Integration
A secure, direct integration for managing iCloud Calendars using the CalDAV protocol without third-party middleware.
Immanent Metaphysics Framework
A foundational framework for reasoning within Forrest Landry's Immanent Metaphysics, enabling structured team onboarding and ethical agent interaction.
Telegram Analyzer Skill
A professional toolset for AI agents to search SaaS contacts, retrieve recent Telegram messages, and manage contact metadata like stages and tags.
Git Sync Daemon
A background service for macOS and Linux that provides automated, periodic synchronization for a list of Git repositories with built-in failure isolation.
Featured*
