pixel-player

Reviewed at commit 6ebf729

A docked pane that streams a YouTube or local playlist through mpv and yt-dlp while an animated pixel-art skin of your choice dances beside the conversation.

Made by
chrisluo5311
What we checked

Adds a /music command and a pane with an animated pixel-art character and player controls, and plays the links or files in your playlist through mpv and yt-dlp, which you install yourself; mpv streams those links from YouTube or wherever they point. It keeps the playlist in ~/.claude/pixel-play/playlist.txt and stores track titles, skin and volume. It does not read your prompts or Claude's tool calls.

Review details

Static review of the source at the pinned commit; not run. Hooks: session.start (registers the music command, restores state from $.store and the playlist file), command.run for music (play, pause, resume, stop, next, prev, add, reload, skins, skin, vol, help), ui.render for its own pane, and session.end (stops playback, removes its own IPC socket with /bin/rm -f, and on /clear carries the player state over to the new session). Runtime calls: $.command.register, $.ui.open, $.ui.resolve, $.fs.exists/read/write (only ~/.claude/pixel-play/playlist.txt, seeded once from a legacy playlist.txt in the plugin folder), $.env.get for HOME and TMPDIR, $.store.get/set for titles, skin and volume, $.clock.every/after for the animation and the /clear carry-over, $.session.id, and $.process. $.process.spawn starts mpv (found only in /opt/homebrew/bin, /usr/local/bin or /usr/bin) with --no-video, the bundled mpv/progress.lua script (it only prints position, duration, pause state and media title to stdout), a JSON IPC socket in TMPDIR and the track URL as the last argument; yt-dlp is passed to mpv's ytdl hook when found. $.process.run calls /usr/bin/nc -U on that socket to pause and resume. The mod itself makes no network requests; mpv and yt-dlp fetch the playlist URLs. If mpv is missing it shows 'mpv not found: brew install mpv yt-dlp' and installs nothing. The Unix-only paths mean it will not work on Windows. hooks/skins.gen.ts is generated pixel data only (palettes and frame strings, no code); scripts/png2sprite.mjs is a development script that is not loaded.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of pixel-player

A pixel-art music player pane that streams a playlist through mpv

Made this mod? Add a badge to your README

modsforClaude badge for pixel-player

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/pixel-player.svg)](https://modsforclaude.com/mods/pixel-player/)

← All mods