Skip to content

Add setup-phoniebox: Raspberry Pi RFID jukebox setup workflow - #13

Open
RazHadas wants to merge 1 commit into
wshobson:mainfrom
RazHadas:add-setup-phoniebox
Open

Add setup-phoniebox: Raspberry Pi RFID jukebox setup workflow#13
RazHadas wants to merge 1 commit into
wshobson:mainfrom
RazHadas:add-setup-phoniebox

Conversation

@RazHadas

Copy link
Copy Markdown

Summary

  • Adds a complete end-to-end workflow for setting up Phoniebox v2 — a popular open-source RFID jukebox for Raspberry Pi
  • Handles all remote work via SSH so the user never needs to type on the Pi directly; works from Windows, Mac, or Linux
  • Documents every real-world pitfall discovered during an actual setup, with exact fixes

What it covers

  1. Hardware checklist and SD card flashing (Raspberry Pi Imager settings)
  2. SSH key authentication via Python paramiko (works on Windows without sshpass)
  3. Non-interactive Phoniebox installation using PhonieboxInstall.conf
  4. Post-install fixes: evdev module, MPD volume normalization, startup volume, ALSA PCM on boot
  5. RFID reader detection and deviceName.txt registration (critical printf vs echo note)
  6. udev rule for auto-restart on USB reconnect
  7. YouTube audio downloading via yt-dlp with Node.js JS runtime
  8. RFID card-to-folder and card-to-command registration
  9. Full health-check command and troubleshooting table

Test plan

  • Workflow file renders correctly in Claude Code as /workflows:setup-phoniebox
  • All bash commands are syntactically valid
  • Troubleshooting table covers the most common failure modes

🤖 Generated with Claude Code

Complete step-by-step workflow for setting up Phoniebox v2 on a Raspberry Pi from any OS. Covers SSH key auth via paramiko, non-interactive installation, RFID reader registration, YouTube audio downloading, and card-to-folder linking. Includes all known pitfalls discovered through a real setup session: evdev missing, deviceName.txt trailing-newline bug, MPD volume normalization, udev auto-restart, and yt-dlp JS challenge solving.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant