The PiPod Shuffle is a minimalist offline MP3 player built with a Raspberry Pi. It automatically plays music files from a local folder and includes basic playback controls — perfect for DIY audio enthusiasts.
- 🎵 Plays MP3 files in order or shuffled
- 🔁 Loops your entire playlist forever
- ⏭️ Skip tracks with keyboard input
- 🌟 Save favorite songs
- 🔧 Automatically recovers from frozen audio playback
- 🧠 Works headless (no monitor) or with GUI
- Raspberry Pi 3B or newer
- Raspberry Pi OS (Lite or Desktop)
- Python 3
- vlc (audio player itself)
- rpi_lcd
- MP3 files placed in:
/home/andre/Music/
Install vlc with:
sudo apt update sudo apt install vlc
🚀 Setup & Usage
Clone this repo or copy the play_music.py script to your Pi:
git clone https://github.com/ToasterGithubUser/pipod-shuffle.git
Add your MP3 files to the music folder:
mkdir -p ~/Music cp your_songs/*.mp3 ~/Music/
Run the player:
python3 play_music.py
🎮 Controls (from terminal)
n → Next song
s → Toggle shuffle
f → Save current song as a favorite
- → increase volume
- → decrease volume
d → pause
Favorite tracks are saved to /home/andre/favorites.txt and played after the playlist.
⚙️ Optional: Auto-start on Boot (GUI users) Open the Raspberry menu → Preferences → Session and Startup
Add a new startup entry:
Name: PiPod Shuffle
Command:
python3 /home/pi/pipod-shuffle/play_music.py &