pixel-player
pixel-player · by chrisluo5311
mpv로 재생목록을 재생하면서 음악에 맞춰 반응하는 픽셀 아트 캐릭터를 패널에 표시해요.
❯ /plugin marketplace add SeongGwangJu/k-mods ❯ /plugin install pixel-player@k-mods
$ claude plugin marketplace add SeongGwangJu/k-mods $ claude plugin install pixel-player@k-mods
이미 열려 있는 세션에는 /reload-plugins로 바로 적용돼요. Claude Code 2.1.287 이상이 필요해요.
알아 둘 점
- 재생목록(
~/.claude/pixel-play/playlist.txt)에 유튜브 링크·직접 오디오 URL·로컬 파일 경로를 한 줄씩 추가해요. mpv가 그 주소로 직접 접속해 재생할 뿐, 모드 자체가 다른 곳에 접속하지는 않아요. - 재생목록 파일은 플러그인 폴더가 아니라
~/.claude/아래 저장돼 업데이트해도 유지돼요. - 재생 제어(일시정지·재개)는 로컬 유닉스 소켓(IPC)으로만 이뤄지고 네트워크를 쓰지 않아요.
- mpv 실행 인자 끝에
--구분자가 없어서, 재생목록 줄이--로 시작하면 mpv 옵션(예:--script=로 임의 Lua 스크립트 로드)으로 해석될 수 있어요. 재생목록은 본인이 직접 적는 로컬 파일이라 위험은 낮지만, 남이 준 재생목록 줄을 그대로 붙여넣지 않는 게 안전해요. - Windows는 지원하지 않고 macOS에서만 테스트됐어요.
준비물
- mpv (필수. 없으면 설치 안내만 뜨고 재생되지 않아요)
- yt-dlp (유튜브 링크를 재생하려면 권장)
이 mod가 내 컴퓨터에서 하는 일
mod는 샌드박스 없이 내 권한으로 실행돼요. 정적 분석으로 확인한 범위예요.
프로그램 실행/bin/rm파일 쓰기환경·설정 읽기파일 읽기
정적 분석 결과
다루는 이벤트
읽는 환경 변수
