Skip to main content

Tracks played on Plex can be scrobbled either by:

  • A Tautulli notification agent with a webhook.
  • Using Plex Webhooks (restricted to Plex Pass users)

Using Tautulli

Create a new Notification Agent

  • Navigate to the Notification Agents page in Settings
  • Click Add a new notification agent
  • Select Webhook

Configure the Agent

The below sections correspond with the tabs available in the notification agent configuration popup.

Configuration

  • Webhook URL -- http://localhost:9078/tautulli (substitute your domain if different than the default)
  • Webhook Method -- POST

Triggers

Select Watched

Conditions

Refer to Tautulli's documentation if you need help here. It may be a good idea to restrict notifications to only one library (if you have a Music library, for instance)

This app will only scrobble an item if media_type is a "track", which is the default for all music.

Data

Expand the Watched dropdown and add the following code block to the JSON Data text field:

{
"artist_name": "{artist_name}",
"track_name": "{track_name}",
"track_artist": "{track_artist}",
"album_name": "{album_name}",
"media_type": "{media_type}",
"title": "{title}",
"duration": "{duration_sec}",
"username": "{username}",
"server": "{server_name}",
"version": "{server_version}",
"library": "{library_name}",
"player": "{player}",
"device": "{device}",
"platform": "{platform}",
"action": "{action}",
"machine_id": "{machine_id}",
"session_key": "{session_key}"
}

Click the Save button to finish.

Your agent is now configured and ready to scrobble.

Using Plex Webhooks

  • Navigate to your Account/Settings and find the Webhooks page
  • Click Add Webhook
  • URL -- http://localhost:9078/plex (substitute your domain if different than the default)
  • Save Changes

Plex is now configured to scrobble.