---
title: "jukebox7"
url: "https://claudemods.dev/ko/builds/jukebox7-bcf9b6"
source: "https://github.com/KTCrisis/flux7-mods/tree/main/jukebox7"
source_type: "github"
repo: "https://github.com/KTCrisis/flux7-mods/tree/main/jukebox7"
author: "KTCrisis"
author_handle: "KTCrisis"
stars: 1
category: "오디오 및 멀티미디어"
categories: ["audio"]
tags: ["claude-code", "hooks", "music", "plugin", "vlc", "wsl", "yt-dlp"]
permission_level: 3
scan_complete: true
install: "claude plugin marketplace add KTCrisis/flux7-mods\nclaude plugin install jukebox7"
added: "2026-10-05T01:57:29.767Z"
updated: "2026-11-10T15:06:05Z"
locale: "ko"
content_locale: "ko"
---

# jukebox7

브라우저 없이 Claude Code 세션 안에서 평범한 말로 음악을 요청해 재생합니다.

## Description

jukebox7은 자연어 프롬프트로 세션 안에서 음악을 재생하는 Claude Code 플러그인입니다. 음악 이름이 들어간 프롬프트는 Haiku가 재생, 전환, 다음 곡, 비슷한 곡, 볼륨, 중지 의도로 분류합니다. yt-dlp로 YouTube Music/YouTube를 검색하고 HTTP 인터페이스를 통한 숨겨진 VLC 인스턴스로 오디오를 스트리밍합니다. /music 패널에는 제목, 상태, 볼륨과 장르 라디오 버튼이 표시됩니다. Windows 연동 WSL, PATH의 yt-dlp, 설치된 VLC가 필요합니다.

## Install

```
claude plugin marketplace add KTCrisis/flux7-mods
claude plugin install jukebox7
```

## Original README

# jukebox7

Music on demand inside a Claude Code session, asked in plain words, played
without a browser.

## What it does

A prompt that names music (`put on some ambient`, `coupe la musique`, `next`)
goes to Haiku first, which answers one intent: play, toggle, next, similar,
volume, stop, or none. Anything else, including requests aimed at play7, keys7, Renoise or a
melody, reaches the session untouched; a prompt without a music word skips
the model call altogether.

- **play**: `yt-dlp` searches YouTube, keeps songs of two to twenty minutes
  (a mood asked in words prefers five and more), and streams the audio into
  Windows' VLC with its dummy interface: no window, no focus taken. The
  track asked for plays whatever its length; next walks the songs alone,
  and past the last one the list ends.
- **toggle / next / stop**: the WSL side runs in a process group of its own
  (`setsid`); pause is VLC's own `pl_forcepause` over its HTTP interface, at once,
  stop is `CONT` then `TERM`, and the `vlc.exe` it started is terminated by
  its `--meta-title=jukebox7` tag, so a VLC opened by hand is never touched.
  A pause VLC does not answer changes nothing and says so. One change of song
  runs at a time (a search takes up to 40 s): a press meanwhile is refused.
  A session that never played leaves the VLC alone when it ends.

The **pane** (`/music`, or opened on the first song) shows the title, its
state and volume, `p` pause, `n` next, `r` similar, `s` stop, `d` and `u` the volume by
10 %, and the genre buttons `1` to `9` and `0`:
ambient, lofi, metal, synth & electro, idm, indie rock, video games, modern classical, hip-hop, post-rock. A genre
is a radio: a random artist from its list, a random song of theirs; next and
the end of a song roll again.

A pick searches YouTube Music's songs tab, which holds tracks only: no
interview, gameplay or full OST. Its listing gives no length: yt-dlp is
asked for it once the song plays, the bar shows the elapsed time until then;
plain YouTube, kept to two to twenty minutes,
is the fallback when it finds nothing.

**Discoveries.** Each genre also holds a few artists beyond the listener's
own, drawn from the lists' neighbors (Grouper and Tim Hecker by Loscil and
Brian Eno, Deathspell Omega and Panopticon by Blut Aus Nord and Agalloch,
Sewerslvt and Machine Girl by Venetian Snares, Car Seat Headrest and Alex G
by Modest Mouse and Elliott Smith). One pick in three comes from there and
its title wears a ✦; strike a name from `discover` to drop it.

**similar** (`r`, `/music similar`, or in words, `plus comme ça`) plays the
YouTube Music radio of the song on: other artists first (the radio lingers
on the same one), covers, tributes and hour-long loops dropped; next walks
that list.

On the terminal the pane is black down to its last row, framed in the
avatar's color, and the room left under the player fills with a green code
rain in the manner of Ghost in the Shell: half-width katakana and digits,
falling five frames a second while a song plays, frozen on pause.

With avatar7 loaded, `a` plays the pick of the avatar on duty: the `station`
of its `persona.json`, which avatar7 publishes in its `station` state. Each
song that starts, asked, from a genre or chained when the last one ends, is
written to this mod's `say` state: avatar7, if loaded, introduces it in the
persona's manner, like a radio host over the intro. While the avatar speaks (its `isVoicing` state) the music drops
to 70 % of its level, then returns.

`/music <search>` plays one named track; `/music pause|next|stop`;
`/music vol 60`, `/music vol +20`. In words, `monte le son` works too.

Only a short prompt (eight words at most) with a music word or phrase goes to
Haiku; a longer one is talk to the assistant and passes untouched, even when
it mentions music.

The volume goes through VLC's HTTP interface on Windows' loopback (port
18797), reached with Windows' own `curl.exe`. The level is kept apart from
the player, survives a stop, and is set again on each new song: a fresh VLC
starts at whatever level Windows kept for it.

## Requirements

WSL with Windows interop, `yt-dlp` on the path, VLC at
`C:\Program Files\VideoLAN\VLC`. VLC rather than `ffplay` on WSLg's
PulseAudio: that server stalls after a sleep (it takes audio at a tenth of
real time and nothing comes out) until `wsl --shutdown`.

## Limits

- The genre lists are one listener's; edit `GENRES` in `hooks/register.tsx`.
  A station belongs to its persona, in avatar7's `personas/<id>/persona.json`.
- A very long pause may let YouTube drop the stream behind VLC, which then
  ends the song early on resume.
- A song that ends moves on within five seconds (the liveness poll).

## Tests

    claude plugin test ~/flux7-mods/jukebox7
