Support: ScrobbleDock
Help with ScrobbleDock. Replies usually within two business days, in English or German.
Direct contact
Send an email with the app version, your macOS version and a short description. For bugs, a step-by-step description helps most.
kontakt@stigler-ai.comResponse time: usually two business days
System requirements
- macOS 14.0 or later
- Languages: English, German, French, Spanish, Italian, Portuguese, Dutch, Japanese
- Version 1.0
How the import works
Which files are read
As soon as a removable volume appears, ScrobbleDock looks for
.scrobbler.log, .scrobbler-timeless.log and scrobbler.log — in the root
directory and under .rockbox/. Nothing is written to the player unless you
have enabled archiving or deleting the log.
How device and firmware are detected
The app reads rockbox-info.txt for the Rockbox version, the CLIENT header
of the log for the player type, and on iPods also iPod_Control to identify
the model. If none of these are present, the device keeps its volume name.
How duplicates are prevented
For every device ScrobbleDock remembers the timestamp of the last transferred track and only submits what comes after it. That watermark advances after every successfully transferred batch — if an import is interrupted, at most the current batch is affected, and it is sent again on the next attempt.
How tracks are submitted
Listens go to api.listenbrainz.org as POST /1/submit-listens, in batches
rather than one by one. If a batch fails, the app retries it with exponentially
increasing delays instead of hammering ListenBrainz with repeats.
Why tracks are skipped
Many Rockbox players have no real-time clock. After a battery swap or a reset they write timestamps before 2002 or in the future. ListenBrainz rejects those entries. ScrobbleDock detects them up front, leaves them out and lists them in the result instead of dropping them silently.
What happens to the log afterwards
Configurable per device: leave it in place, back it up to the archive folder on the Mac and remove it from the player, or delete it. Optionally ScrobbleDock then ejects the player — with a 15 second countdown you can cancel.
Frequently asked questions
- Which devices are supported?
- Any player running Rockbox firmware that mounts on the Mac as a removable volume — for example iPod Video, iPod Classic, Sansa Clip or iRiver. ScrobbleDock only reads the log file Rockbox writes itself.
- Do I need a ListenBrainz account?
- Yes. ListenBrainz is free and run by the non-profit MetaBrainz Foundation. On first launch you paste the user token from your ListenBrainz settings; the username is detected automatically.
- Where is my token stored?
- In the macOS keychain, not in the preferences. It leaves the Mac only as an Authorization header to api.listenbrainz.org.
- Can listens end up duplicated on ListenBrainz?
- No. ScrobbleDock remembers the timestamp of the last transferred track per device and only submits what comes after it.
- Why are some tracks skipped?
- Many Rockbox players have no real-time clock and write timestamps before 2002 or in the future. ListenBrainz rejects those, so ScrobbleDock reports them in the result instead of dropping them silently.
- Does the app record what I play on the Mac?
- No. ScrobbleDock only reads what ListenBrainz already reports as playing and uploads log files from connected players. It does not listen in on the Mac.
- Does it work without an internet connection?
- The import needs a connection to ListenBrainz. Ratings made offline are queued and submitted automatically once you are back online.
- Is ScrobbleDock an official ListenBrainz app?
- No. ScrobbleDock is an independent, unofficial client and is not affiliated with the MetaBrainz Foundation.
Privacy
What the app stores and sends is described in the privacy policy for this app.
License terms
This app is covered by the standard Apple Media Services licence (Licensed Application End User License Agreement).
View the licence agreementScrobbleDock is an independent, unofficial client. It is not affiliated with, endorsed by, or sponsored by the MetaBrainz Foundation, which runs ListenBrainz. Rockbox is a project of the Rockbox community.