- #Lastfm scrobbler how to#
- #Lastfm scrobbler update#
- #Lastfm scrobbler code#
No matter what the HTTP status code is, # you must inspect the content of the response This is the error element's code attribute in the XML returned in the response body.
The lfm error code (when the lfm status was failed) further describes the cause of the error. The lfm status attribute of the lfm XML element returned in the response body. Store the scrobble in the user's profile. A batch request may contain up to 50 scrobbles. Multiple scrobbles may be sent in a single batch request, this is recommended when there are cached scrobbles to be sent in the case of previous errors. The web service method for sending scrobbles is track.scrobble.Īs with all our write web services, requests must be sent as HTTP POST requests to with form urlencoded (using utf-8) parameters in the body of the request. If there is any ambiguity or doubt then don't send this value. from a Last.fm radio stream from some other recommendation service or radio show put together by a DJ or host) then this value should be set to "false". However, if the user is listening to music that is effectively chosen by someone other than themselves (e.g. In most cases where a user is scrobbling their own music you can safely ignore this parameter. This parameter is used to indicate when a scrobble comes from a source that the user doesn't have "direct" control over. # When to set the "chosenByUser" parameter Do not use the corrections returned by the now playing service as input for the scrobble request, unless they have been explicitly approved by the user. Please only use meta data from well-structured sources such as ID3 tags. Do not attempt to determine a track's meta data from its filename. It is often most convenient to send a scrobble request when a track has finished playing. And the track has been played for at least half its duration, or for 4 minutes (whichever occurs earlier.)Īs soon as these conditions have been met, the scrobble request may be sent at any time. 
The track must be longer than 30 seconds. # When is a scrobble a scrobble?Ī track should only be scrobbled when the following conditions have been met: This data is used to show a user's listening history and generate personalised charts and recommendations (and more). The scrobble service lets a client add a track-play to a user's profile. Now Playing requests that fail should not be retried. We recommend that your client logs all failed requests and their responses (HTTP headers, and the xml body) to assist debugging. The lfm error code (when the lfm status was "failed") further describes the cause of the error. Last.fm signals the success or failure of a request by three different means: Return a response to the client indicating the outcome of the request. #Lastfm scrobbler update#
Update the user's Now Playing status with the track and client. Check that the request passes our filters. Once a request has been received by Last.fm the following sequence of events takes place on our side: The web service method for sending Now Playing information is track.updateNowPlaying.Īs with all our write web services, requests must be sent as HTTP POST requests to with form urlencoded parameters in the body of the request. Requests should be sent as soon as a user starts listening to a track. This API method call is optional for scrobbling clients, but recommended. This does not affect a user's charts, but will feature the current track on their profile page, along with an indication of what music player they're using. The "Now Playing" service lets a client notify Last.fm that a user has started listening to a track. Scrobbling 2.0 is not backwards compatible with the old Submissions Protocol 1.2.1 (which is deprecated). A client is anything that plays music, such as desktop music players, mobile apps, websites, etc.įor every track a user listens to the client should send a track.updateNowPlaying request and a track.scrobble request. Scrobbling is a way to send information about the music a user is listening to. #Lastfm scrobbler how to#
This is a guide on how to send scrobbles to Last.fm.
When to set the "chosenByUser" parameter.
0 kommentar(er)
