voicemode-dj

Controls background music playback during VoiceMode voice sessions via mpv.

1.3k|189|Updated Jun 8, 2025
One-click install
npx skills add https://github.com/mbailey/voicemode --skill voicemode-dj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voicemode-dj
Source: https://github.com/mbailey/voicemode/tree/main/.claude/skills/voicemode-dj
Command: npx skills add https://github.com/mbailey/voicemode --skill voicemode-dj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing background music during voice-driven coding sessions requires manual media player control, which interrupts hands-free workflows. This Skill lets you play, stop, and navigate music through simple voice or CLI commands without leaving your session.

Core Features & Use Cases

  • Playback Control: Start and stop playback of local files or URLs, adjust volume, and check what is currently playing via voicemode dj commands.
  • Music For Programming Integration: Play curated Music For Programming episodes (defaulting to episode 49) with chapter navigation for skipping tracks.
  • Library Search: Find tracks in your music library with voicemode dj find <query>.
  • Use Case: While pair-programming with a voice assistant, ask it to play focus music, lower the volume during a discussion, and skip to the next chapter when a track does not fit your mood.

Quick Start

Ask the assistant to play background music for programming, and it will run voicemode dj mfp play 49 to start the default Music For Programming episode.

Frequently Asked Questions about voicemode-dj

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play background music during a VoiceMode session?

Run voicemode dj play followed by a file path or URL to start playback through mpv. For coding sessions, voicemode dj mfp play 49 starts the default Music For Programming episode with chapter navigation support.

How do I control music volume and playback from the command line?

Use voicemode dj volume with a value from 0 to 100 to set volume, or without a value to check it. The voicemode dj stop, next, prev, and status commands handle stopping, chapter navigation, and playback status.

What is Music For Programming integration in voicemode dj?

Music For Programming integration lets you browse and play curated MFP episodes directly via voicemode dj mfp list and voicemode dj mfp play <number>. Episodes include chapter metadata so you can skip between tracks with next and prev commands.

Does voicemode dj require mpv to be installed?

Yes, voicemode dj controls playback through mpv using its IPC interface, so mpv must be installed and configured. Setup requirements are documented in the installation reference, and the default startup volume can be set with VOICEMODE_DJ_VOLUME in voicemode.env.

Can I control voicemode dj programmatically from Python?

Yes, the voice_mode package exposes DJController, MfpService, and MusicLibrary classes for programmatic access. These let you integrate playback control, episode management, and library search into your own Python tooling.