Scrobbox

By Roy

A desktop companion app for Rockbox players and music libraries. Scrobbles your listening history, manages your Rockbox device, and handles your music collection — tag editing, file renaming, format conversion, cover art, spectrograms, and more.

---

Screenshots

<p align="center"> <img src="screenshots/statistics.png" alt="statistics" width="100%" /> <img src="screenshots/scrobble.png" alt="scrobble" width="100%" /> </p> <p align="center"> <img src="screenshots/Tidal-dl.png" alt="TIDAL Downloader" width="100%" /> <img src="screenshots/spectrogram.png" alt="Spectrogram" width="100%" /> </p> <p align="center"> <img src="screenshots/Api-platforms.png" alt="API Platforms" width="48%" /> <img src="screenshots/rsync.png" alt="Rsync" width="48%" /> </p> <p align="center"> <img src="screenshots/file-converter.png" alt="File Converter" width="48%" /> <img src="screenshots/tag-editor.png" alt="Tag Editor" width="48%" /> </p> <p align="center"> <img src="screenshots/database.png" alt="Database Rebuilder" width="48%" /> <img src="screenshots/coverextractor.png" alt="Cover Extractor" width="48%" /> </p>

---

Download

Grab the AppImage from the Releases page. No install required.

chmod +x Scrobbox-x86_64.AppImage
./Scrobbox-x86_64.AppImage

Requires a Linux distro with glibc 2.35+ (Ubuntu 22.04+, Fedora 36+, Arch, CachyOS, Manjaro, etc.).

---

What it does

Scrobbling

Submit your Rockbox .scrobbler.log to Last.fm, Libre.fm, or ListenBrainz. Tracks already-submitted entries to avoid duplicates. Optional log archiving after submission. Dry run mode. For Libre.fm put anything you want in api and shared secret sections and press "Connect to Libre.fm"

Statistics

Local stats from your submission history — total tracks, play time, sessions, top artists, albums, and tracks with album art.

Submission History

Full searchable, paginated log of everything you've submitted across all platforms, with timestamps.

Tag Editor

Bulk tag editor for MP3, FLAC, M4A, AAC, OGG, Opus, WMA, WAV, and AIFF. Edit title, artist, album artist, album, year, track number, disc, genre, and comment. Cover art viewer with resize and revert. Bulk cover resize with bulk revert. Strip ReplayGain tags. Verify file integrity. File renaming from tag templates. Sort by filename, title, artist, album, or date.

File Converter

FFmpeg-powered converter. Accepts MP3, FLAC, M4A, AAC, OGG, Opus, WMA, WAV, and AIFF as input. Output formats: FLAC, MP3, AAC/M4A, OGG Vorbis, Opus, WAV, and AIFF. Tracks already-converted files per preset so re-scans only queue new or changed files. Optional EBU R128 loudness normalization. Configurable bitrate and sample rate. Saveable presets.

Album Cover Extractor

Scan a library folder and extract embedded cover art to folder images alongside each album. Optional BMP output sized for Rockbox displays.

Spectrogram

Drag-and-drop audio file inspection. Visualizes frequency content so you can check whether a "lossless" file is genuine or an upsampled transcode.

TIDAL Downloader

Search TIDAL by track, album, or artist and download. Quality falls back automatically from Hi-Res Lossless → CD Lossless → 320k depending on availability. Embeds full tags and cover art.

Rockbox Tools

• Database Rebuilder — rebuild Rockbox tagcache .tcd files on your PC without booting into Rockbox. The AppImage includes a pre-compiled binary. When running from source, the tool is compiled automatically on first use by cloning the official Rockbox repository — requires git, gcc, and make.
• config.cfg Editor — editor for every Rockbox setting with descriptions and validation.
• tagnavi.config Editor — visual tree editor for Rockbox database navigation menus. Generates valid chained syntax.

Rsync

GUI for rsync with saved profiles. Presets for mirror, backup, and SSH remote sync. Safe revert using timestamped backup dirs. Filename sanitizer to strip characters that cause issues on FAT32.

Appearance

Accent color presets (Amber, Teal, Crimson, Violet, Cobalt, Sage, Rose, Slate, Sunset, Forest) with custom color picker and full per-color override. Font size control.

---

Running from source

git clone https://github.com/RoyLikesAudio/Scrobbox.git
cd Scrobbox
pip install -r requirements.txt
python scrobbox.py

System packages needed:

• ffmpeg — file conversion, spectrogram, integrity check
• libmpv — audio playback (e.g. libmpv2 on Ubuntu/Debian, mpv on Arch)
• rsync — only if you use the Rsync page

---

"Built with AI assistance. Works well for its intended purpose but may have rough edges — contributions and bug reports welcome."

Credits

Made by Roy.

Third-party libraries

• Rockbox — database tool compiled from source for tagcache rebuilding — GPL v2+
• hifi-api by sachin senal — TIDAL download functionality — MIT License
• rsync — file sync engine used by the Rsync page — GPL v3
• python-mpv — Python binding for libmpv — LGPL v2.1+
• mutagen — audio tag reading and writing — GPL v2
• ffmpeg — audio conversion, spectrogram rendering, integrity checking — LGPL v2.1+
• Pillow — image processing for cover art — HPND License
• numpy — spectrogram computation — BSD License

---

License

MIT