KTCrisis/flux7-mods/tree/main/jukebox7
이 mod 소개
jukebox7은 자연어 프롬프트로 세션 안에서 음악을 재생하는 Claude Code 플러그인입니다. 음악 이름이 들어간 프롬프트는 Haiku가 재생, 전환, 다음 곡, 비슷한 곡, 볼륨, 중지 의도로 분류합니다. yt-dlp로 YouTube Music/YouTube를 검색하고 HTTP 인터페이스를 통한 숨겨진 VLC 인스턴스로 오디오를 스트리밍합니다. /music 패널에는 제목, 상태, 볼륨과 장르 라디오 버튼이 표시됩니다. Windows 연동 WSL, PATH의 yt-dlp, 설치된 VLC가 필요합니다.
설치
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add KTCrisis/flux7-mods claude plugin install jukebox7
원문 / 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-dlpsearches 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 ownpl_forcepauseover its HTTP interface, at once, stop isCONTthenTERM, and thevlc.exeit started is terminated by its--meta-title=jukebox7tag, 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
GENRESinhooks/register.tsx. A station belongs to its persona, in avatar7'spersonas/<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
배지 받기
내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.
