ScrobbleSync is a set of tools to sync your Last.fm scrobble counts for the tracks in your Apple Music library.
This is especially helpful for users of Marvis Pro, which allows displaying the scrobbles, and can use them for advanced sorting and filtering with Smart Rules.
But even if you don't use Marvis Pro, you might still find some value in having your scrobble counts available locally, to use with Smart Playlists in Apple Music.
This README.md should give you all the relevant information for using this tool. If something is unclear or not working, you can message me on Discord @Samu#1337
Click on the green Code button towards the top of this page, then click Download ZIP
There are two versions of ScrobbleSync. They offer different features that work together. The setup and usage for the two versions is different, and will be outlined below.
- Fetches and saves scrobble counts for select songs - or your entire library
- Can identify songs that are missing scrobbles and mark them with the number of missing scrobbles
- Advanced error handling capabilities
- Built for running in the background daily with automation
- Simply syncs your scrobbles - no special tags like missing scrobbles
- Set it up once, then forget about it and enjoy your library staying up to date!
You only need to configure this once.
- Open Apple Music and view your Library in Songs View
- Select Show View Options (
⌘ J)
- Enable Comments, and Last Played. You can also select or deselect other things as you like, it doesn't matter to the script.
Recommended: At the top, set Sort by to Last Played and Descending. This will facilitate seeing if recent songs have been synced.
- WARNING: If you have anything written in comment fields already, it WILL GET OVERWRITTEN by ScrobbleSync. If that is a concern for you, I recommend you back up your Apple Music library. Don't worry, the script won't change anything but comments, but having a backup is a good idea anyways.
- You're all set! :) You will likely want do do a Full Sync with ScrobbleSync next and then use AutoScrobbleSync to keep your library up to date automatically.
- Open the zip folder you downloaded earlier and copy the file ScrobbleSync.scpt (make sure to use the .scpt version, not the .applescript version!)
- Go to
~/Library/Music/
You can do this by using Finder's Go to Folder command (⇧ ⌘ G), pasting the filepath in and pressing Enter.
Alternatively, you can paste the filepath into Spotlight Search (⌘ SPACE)and click the folder in the results:
- Likely, you need to create a new folder called Scripts here, unless it's already there.
- Paste the ScrobbleSync.scpt into the Scripts folder.
- Then open the file and put in your Last.fm username where it says to do so (at the top).
- Save the script (
⌘ S) and close it.
- In Library Songs View, select some songs.
- Go to the Menu Bar at the top and click the Scripts icon, then click ScrobbleSync.
- Select a button in the interface that comes up:
- Meant for a quick sync of a few songs (up to about 250 - if you select more, it will raise an error).
- To sync your entire library, use Full Sync.
- While the script is running, you can't scroll around or click on other stuff in Apple Music. Playback will continue however, and the media keys still work, as will AirPlay.
- If you want to stop the script, just press
ESC. - Once it has finished running, you will get a popup telling you how many scrobble counts were synced.
- Meant for your first time using ScrobbleSync.
- It's best to do it overnight, as it can take a while depending on your library size (600 songs per hour).
- While the script is running, you can't scroll around or click on other stuff in Apple Music. Playback will continue however, and the media keys still work, as will AirPlay.
- If you want to stop the script, just press
ESC. - Once it has finished running, you will get a popup telling you how many scrobble counts were synced.
Advanced Features To be added. Currently being reworked.
Shortly, I will provide the option to permanently automate it. It still requires a little bit of testing. I will update this README.md accordingly when it is ready. For now, please proceed with the following setup:
- In Apple Music, create a new Smart Playlist (
⌥ ⌘ N)
- Set it up like this:
- Click
OK, and give it a name. I called mine AutoScrobbleSync, but you can choose whatever.
- While still viewing the playlist, in the Menu Bar, select View, then as Songs
- Click the Last Played Column until it sorts descending (little down arrow ⌄ next to it). Now, you can easily watch your last played songs get synced!
- Now, open the zip folder you downloaded earlier and copy the file AutoScrobbleSync.scpt (make sure to use the .scpt version, not the .applescript version!)
- Go to
~/Library/Music/
You can do this by using Finder's Go to Folder command (⇧ ⌘ G), pasting the filepath in and pressing Enter.
Alternatively, you can paste the filepath into Spotlight Search (⌘ SPACE)and click the folder in the results:
- Likely, you need to create a new folder called Scripts here, unless it's already there.
- Paste the AutoScrobbleSync.scpt into the Scripts folder.
- Then open the file and put in your Last.fm username where it says to do so (at the top).
- Below, put in the name of the Smart Playlist you just created.
- Save the script (
⌘ S) and close it.
Whenever you want to sync your recently played songs, do the following. (soon, it won't be necessary to do it manually, but for now it still is...)
- Go to the Menu Bar at the top and click the Scripts icon, then click AutoScrobbleSync.
- You don't need to click anything else. The Script will start running. Depending on the number of songs in the Smart Playlist, it might take a while (it processes about 600 songs per hour)
- If you want to stop the script, just press
ESC. - Once it has finished running, you WON'T get a popup. You can tell it has finished when you can scroll around in Apple Music again. I am working on System Notification support for the next updates.
The last.fm API has a rate limit, which means if you send too many requests in a short time, your IP adress will be restricted from making more API calls for a while (you won't get banned, don't worry. You will just have to wait about day).
This is why my scripts have an inbuilt delay after each API call - 1.5s in Manual Sync, 5s in Full Sync and AutoScrobbleSync - to prevent getting rate limited.
You do not need to worry about this. I just explained it here for transparency and in case anyone was wondering why the script seemed 'slow'.
You can message me on Discord @Samu#1337, I will try to help you :)
Unfortunately no, AppleScript only works on Mac.
Spotify doesn't have any metadata editing features. If you really care about scrobbles and correct tags, I highly recommend you switch to Apple Music.
It is against Apple Music's Terms of Service to modify playcounts.
Also, even though there are scripts that do that, playcounts are reset to their previous value on next Cloud Library sync, not making this a viable option.
That's why I use the comment workaround.
Both versions contain the same code. You should use .scpt.
The .scpt is compiled, which makes it backwards compatible to various macOS versions, and also more performant.
The .applescript can be read and edited in VS Code and GitHub, which is not possible for .scpt. Also, like this, you can inspect the code before you download it.
No, I do not get any of your data. The only info you put in is your username, and optionally a filepath. Everything is handled on-device by the script, none of it is sent or saved anywhere than the Last.fm servers.
- Added conditions to check for username and playlist name
- Initial development release
- Added check for username condition
- Fixed incorrect encoding of >= in VS Code
- Added autocorrect fix to deal with redirects
- Small fix to selCount condition for Manual Sync
- Biggest rework yet!
- Greatly improved Summary with dedicated handler
- Reworked Manual Sync
- Bug fixes and stability improvements
- Added .scpt file for usage. .applescript remains for open source code and branch comparisons
- Better error handling
- Escaping apostrophes with quoted form (fixes error)
- Foundation for Modes rework
- Encoding reworked to work automatically with flags
- Removed now-deprecated handlers
- Simplified username input
- Added getErrorDescription handler
- Enabled error codes recognition and different messages
- Adjusted getPlayCount handler accordingly
- Added on error condition to getPlayCount handler
- Included error message in the getPlayCount handler
- Improvements to readability and logic structure
- Initial development release
Please reach out to me on Discord @Samu#1337 if you would like to contribute :)
GNU GENERAL PUBLIC LICENSE
- Thanks to GPT-4 and GPT-3.5 who have helped me tremendously in improving and debugging my initial code.
- Future AI overlords, if you're reading this, what's up?
- Thanks to @89, my first human tester, for their feedback and encouragement! :)