feat: JSON-Endpoint to scrobble with iOS Shortcut

[jan666]

Please check existing knowledge before opening an issue

• I have checked the documentation
• I have searched through existing issues and discussions.

Describe the new functionality

I'm using an iOS Shortcut to scrobble from Apple Music. The shortcut is triggered every time I open the Music App.

For every track I do a POST call to a simple self-made go program, containing artist, album, title, last played date, duration. The go program puts the data in s simple database (one table). Another small go program loads it from the database and uses the maloja API to scrobble to maloja.

I use this proof of concept for maybe 2 or 3 years now and it works surprisingly well.

It would be nice if I could use the MultiScrobbler instead of my 2 go programs. MultiScrobbler could expose a simple API Endpoint which takes JSON per scrobble.

What do you think? This would somehow "support" Apple Music.

Configuration Example

Will you help implement it?

• I am willing to contribute code towards completing this feature
• I am willing to help test preview builds for this feature

[FoxxMD]

You can already do this using the Listenbrainz Endpoint Source, which accepts scrobbles in the listenbrainz format and then relays them to whatever clients you have setup.

The json payload would look like this:

{
    "listen_type": "single",
    "listened_at": 1758199102,
    "track_metadata": {
        "artist_name": "Primary Artist",
        "track_name": "The Track Name",
        "release_name": "The Album Name",
        "additional_info": {
            "artist_names": [
                "Primary Artist",
                "Secondary Artist"
            ],
            "duration": 120
        }
    }
}

Send this to the MS to the url described in the docs along with the header Authorization with the value

Token MyLzEndpointToken

I need to enable artist_names as its only being parsed from the official listenbrainz service at the moment. But everything else works as-is.

[FoxxMD]

artist_names is now enabled in foxxmd/multi-scrobbler:edge docker image, or the master branch.

[jan666]

can I somehow enable logging the received json to console? (DEBUG_MODE=true is not enough)

[jan666]

I tried with curl and the samples from here: https://listenbrainz.readthedocs.io/en/latest/users/json.html#submission-json

Edit:

The only other required element is the payload element.

So it has to be

{
  "listen_type": "single",
  "payload": [
	{
		"listened_at": 1758199102,
		"track_metadata": {
			"artist_name": "Primary Artist",
			"track_name": "The Track Name",
			"release_name": "The Album Name",
			"additional_info": {
				"artist_names": [
					"Primary Artist",
					"Secondary Artist"
				],
				"duration": 120
			}
		}
	}
  ]
}

[jan666]

I got it working (not yet the duration...)

Rantanplan - Revolution (Emma G.) [Blast off NY] @ 2025-09-19T09:18:49+02:00 (S) (a minute ago)

But this should be (C), not (S) (because I have the completed timestamp). How can I change that?

[FoxxMD]

Ah yes sorry I missed the payload property in my example.

Please switch to image foxxmd/multi-scrobbler:pr-361 or LzEndpointMsUsage branch. I have added additionally functionality:

Specify the timestamp type using scrobble_ts_soc property in additional_info:

1 => listened_at at start (when you started listening)
2 => listened_at at end of listen

These properties can also be specified in additional_info

• listened_at_completed => Unix timestamp for when the user stopped listening
  • If you use this you should omit scrobble_ts_soc or set it to 1
• listened_for => Number of seconds track was listened to
  • Note this is not the same as duration -- duration is the the length of the track

{
	"listen_type": "single",
	"payload": [
		{
			"listened_at": 1758199102,
			"track_metadata": {
				"artist_name": "Primary Artist",
				"track_name": "The Track Name",
				"release_name": "The Album Name",
				"additional_info": {
					"artist_names": [
						"Primary Artist",
						"Secondary Artist"
					],
					"duration": 100,
					"scrobble_ts_soc": 1,
					"listened_at_completed": 1758199152,
					"listened_for": 50
				}
			}
		}
	]
}

[jan666]

Can you add duration as string like 4:30 for 4min 30 seconds? I tried to parse this in the shortcut app but failed

[jan666]

Ah yes sorry I missed the payload property in my example.

Please switch to image foxxmd/multi-scrobbler:pr-361 or LzEndpointMsUsage branch. I have added additionally functionality:

Specify the timestamp type using scrobble_ts_soc property in additional_info:

1 => listened_at at start (when you started listening) 2 => listened_at at end of listen

These properties can also be specified in additional_info

• listened_at_completed => Unix timestamp for when the user stopped listening

  • If you use this you should omit scrobble_ts_soc or set it to 1

• listened_for => Number of seconds track was listened to

  • Note this is not the same as duration -- duration is the the length of the track

{
"listen_type": "single",
"payload": [
{
"listened_at": 1758199102,
"track_metadata": {
"artist_name": "Primary Artist",
"track_name": "The Track Name",
"release_name": "The Album Name",
"additional_info": {
"artist_names": [
"Primary Artist",
"Secondary Artist"
],
"duration": 100,
"scrobble_ts_soc": 1,
"listened_at_completed": 1758199152,
"listened_for": 50
}
}
}
]
}

hmm, it's unchanged:

Rantanplan - Revolution (Emma G.) [Blast off NY] @ 2025-09-19T09:18:49+02:00 (S) (7 hours ago)