Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
A command-line music player that runs a background server for full playback control. Uses pygame for audio and exposes play, pause, resume, and stop commands through a single entry point script. Works with local audio files stored in a configurable directory.
Unlike launching a new audio process per command, the background server architecture enables true pause and resume without restarting playback from the beginning.
When to use it
- Playing background music during a terminal work session
- Pausing music when taking a call without losing your place
- Resuming playback after a break without restarting the track
- Listing available songs in the local music folder
- Stopping music when switching tasks
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: play some music, then pause it
- 1Run ./play-music play to auto-start the server and begin playback
- 2Confirm playback is active with ./play-music status
- 3Run ./play-music pause when the user wants to pause
- 4Confirm paused state with ./play-music status
Music plays from the default song file, then pauses on command while the server stays running
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.