Rockbox Scripts

A collection of Python scripts for managing and updating Rockbox firmware on Rockbox devices, along with tools for organizing, syncing, and exporting music and playlists.

---

Table of Contents

• Rockbox Scripts
  • Table of Contents
  • Overview
  • Scripts
    • app.py
    • album_art_fix.py
    • mac_playlist_export.py
    • sync_music.py
    • update_rockbox.py
  • Getting Started
  • Dependencies
  • Acknowledgments

---

Overview

This repository provides a suite of utilities to make life easier for Rockbox device users. Automate music synchronization, fix album artwork, export playlists from macOS Music, and keep your Rockbox firmware up to date—all with simple Python scripts.

---

Scripts

app.py

Unified entry point to perform multiple Rockbox-related tasks: music sync, playlist export, device updates, and more.

Usage:

python app.py --playlists-directory-name "Playlists" --music-directory-name "Music" /path/to/rockbox_mount /path/to/music

Parameters:

• mount_point: Mount point of the Rockbox device.
• source_music_directory: Directory containing music files to synchronize.
• playlists_directory_name (optional): Directory to export playlists (default: "Playlists").
• music_directory_name (optional): Directory on device for music sync (default: "Music").

---

album_art_fix.py

Organizes music files and extracts/normalizes cover images (album art) from audio files for consistent format and device compatibility.

Usage:

python album_art_fix.py /path/to/music_directory

---

mac_playlist_export.py

Exports all user playlists from the macOS Music app to a specified directory as .m3u files.

Usage:

python mac_playlist_export.py /path/to/store_playlists

---

sync_music.py

Synchronizes music between a source and a target directory using rsync. Supports two modes:

• dap: Syncs only audio files (filters by extension), preserves album art, and cleans up metadata.
• nas: Performs a full, unfiltered sync for backup to a NAS.

Also integrates album art fixing after sync.

Usage:

python sync_music.py /path/to/source_directory /path/to/target_directory --mode dap

or

python sync_music.py /path/to/source_directory /path/to/target_directory --mode nas

---

update_rockbox.py

Updates the Rockbox firmware on your device. Auto-detects the current device and revision, downloads, and installs the latest daily build if needed.

Usage:

python update_rockbox.py /path/to/rockbox_mount_point

---

Getting Started

1. Clone the repository

   git clone https://github.com/YOUR_USERNAME/rockbox_scripts.git
   cd rockbox_scripts

2. Install dependencies

   pip install -U -r requirements.txt

3. Run the scripts as shown in the Scripts section.

---

Dependencies

• Python 3.8+
• typer
• mutagen
• Pillow (PIL)
• sysrsync
• beautifulsoup4
• requests

Install all dependencies using:

pip install -U -r requirements.txt

---

Acknowledgments

• @SupItsZaire for their Rockbox Cover Art Fixer script

---

Happy Rockboxing!