{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string","enum":["nowPlaying"]},"play":{"anyOf":[{"type":"object","properties":{"platformId":{"type":"string","description":"unique tuple identifying user and device"},"playFirstSeenAt":{"description":"ISO8601 timestamp","type":"string","format":"date-time","examples":["2026-11-13T14:05:00.000Z"]},"playLastUpdatedAt":{"description":"last time play was updated in MS","type":"string","format":"date-time","examples":["2026-11-13T14:05:00.000Z"]},"playerLastUpdatedAt":{"type":"string","format":"date-time","examples":["2026-11-13T14:05:00.000Z"],"description":"last time player self-reported it was updated at"},"createdAt":{"description":"when this specific play/player was created","type":"number"},"position":{"description":"player position, in seconds","type":"number"},"listenedDuration":{"type":"number","description":"Seconds the current track has been listened to"},"status":{"type":"object","properties":{"reported":{"type":"string","description":"what player reported: paused, playing, stopped, unknown"},"calculated":{"type":"string","description":"what MS has derived from watching player behavior: paused, playing, stopped, unknown"},"stale":{"type":"boolean","description":"When player has not reported any new updates for N seconds"},"orphaned":{"type":"boolean","description":"When player has not reported any new updates for N * 2 seconds"}},"required":["reported","calculated","stale","orphaned"],"description":"status of player"},"play":{"type":"object","properties":{"uid":{"type":"string"},"data":{"type":"object","properties":{"track":{"$ref":"#/$defs/Credit"},"artists":{"type":"array","items":{"$ref":"#/$defs/Credit"}},"albumArtists":{"type":"array","items":{"$ref":"#/$defs/Credit"}},"album":{"$ref":"#/$defs/Credit"},"duration":{"description":"The length of the track, in seconds","type":"number","minimum":0},"playDate":{"description":"The date the track was played at","anyOf":[{"type":"string","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d))|(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?)$","format":"date-time"},{"type":"null"}],"examples":["2026-11-13T14:05:00.000Z"]},"playDateCompleted":{"description":"When the track finished playing","anyOf":[{"type":"string","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d))|(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?)$","format":"date-time"},{"type":"null"}],"examples":["2026-11-13T14:05:00.000Z"]},"listenedFor":{"description":"Number of seconds the track was listened to","type":"number","minimum":0},"listenRanges":{"description":"Ranges of the track that were listened to","type":"array","items":{"type":"object","properties":{"start":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d))|(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?)$","format":"date-time"},{"type":"null"}],"description":"ISO8601 timestamp","examples":["2026-11-13T14:05:00.000Z"]},"position":{"description":"Position in the track, in seconds","type":"number"},"positionPercent":{"description":"Position in the track, as a percentage of duration","type":"number"}},"required":["timestamp"]},"end":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d))|(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?)$","format":"date-time"},{"type":"null"}],"description":"ISO8601 timestamp","examples":["2026-11-13T14:05:00.000Z"]},"position":{"description":"Position in the track, in seconds","type":"number"},"positionPercent":{"description":"Position in the track, as a percentage of duration","type":"number"}},"required":["timestamp"]}},"required":["start","end"]}},"repeat":{"description":"Play was detected as a repeat of the previous play","type":"boolean"}}},"meta":{"type":"object","properties":{"source":{"description":"Type of Source that discovered this play","type":"string"},"seenAt":{"description":"When Multi-Scrobbler first saw this play","anyOf":[{"type":"string","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d))|(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?)$","format":"date-time"},{"type":"null"}],"examples":["2026-11-13T14:05:00.000Z"]},"musicService":{"description":"If applicable, the name of the Service providing the track (Spotify, Tidal, etc...)","type":"string"},"parsedFrom":{"description":"Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc...","type":"string","enum":["backlog","now playing","player","history","ingress"]},"trackId":{"description":"Unique ID for this track, given by the Source","type":"string"},"playId":{"description":"Atomic ID for this instance of played tracked IE a unique ID for \"this track played at this time\"","type":"string"},"newFromSource":{"type":"boolean"},"user":{"type":"string"},"mediaType":{"type":"string"},"server":{"type":"string"},"library":{"type":"string"},"trackProgressPosition":{"description":"The position the \"player\" is at in the track at the time the play was reported, in seconds","type":"number"},"mediaPlayerName":{"description":"Name of the media player (program)","type":"string"},"mediaPlayerVersion":{"description":"Version of the media player (program)","type":"string"},"deviceId":{"description":"A unique identifier for the device playing this track","type":"string"},"sessionId":{"description":"The ID/Key for individual sessions on a device/platform","type":"string"},"nowPlaying":{"type":"boolean"},"url":{"type":"object","properties":{"web":{"description":"The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble","type":"string"},"origin":{"description":"The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video","type":"string"}}}}}},"required":["data","meta"],"title":"Play"}},"required":["platformId","playerLastUpdatedAt","listenedDuration","status"],"title":"Player"},{"type":"null"}],"description":"The Player reporting Now Playing, or null when Now Playing is cleared"}},"required":["type","play"],"title":"Blackbox Now Playing Payload","$defs":{"Credit":{"type":"object","properties":{"name":{"type":"string"},"metadata":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"name":{"type":"string","enum":["musicbrainz"]},"image":{"type":"string"},"id":{"type":"string"},"idType":{"type":"string","enum":["recording","release","track","artist","release-group"]}},"required":["name","id"],"title":"MusicBrainz ID"},{"type":"object","properties":{"name":{"type":"string","enum":["spotify","youtube","jellyfin","plex","listenbrainz","rocksky","isrc"]},"image":{"type":"string"},"id":{"type":"string"},"idType":{"type":"string"}},"required":["name","id"],"title":"Music Service ID"}]}},"image":{"type":"string"}},"required":["name"]}}}