Skip to content
TakoAPI
Back to skills

play-music

by awspace

Media & Streaming
808Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

**Controlled music player with pause/resume/stop support**.

Description

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

INPUT

User asks: play some music, then pause it

AGENT
  1. 1

    Run ./play-music play to auto-start the server and begin playback

  2. 2

    Confirm playback is active with ./play-music status

  3. 3

    Run ./play-music pause when the user wants to pause

  4. 4

    Confirm paused state with ./play-music status

OUTPUT

Music plays from the default song file, then pauses on command while the server stays running

Requirements

  • pygame Python library — install with pip install pygame
  • Local audio files placed in a music/ directory or at the path set by MUSIC_DIR

Installation

clawhub install awspace/play-music

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

Links