plexamp-scrobbler/README.md
2022-05-17 21:24:32 -04:00

34 lines
1.9 KiB
Markdown

# plexamp-scrobbler
Scrobbles to Last.fm whenever you scrobble anything via Plexamp.
**NOTE**: This requires a Plex Pass account, as this uses webhooks. Also the code for this is probably bad and I only made it for personal use, if this doesn't work, please make an issue and I'll try to help.
## Setup
1. Get an [API account](https://www.last.fm/api/account/create) for Last.fm. Save the API Key and secret, also have your username and password handy.
2. Go to the [Webhooks section](https://app.plex.tv/desktop/#!/settings/webhooks) of your Plex server. If you aren't changing the port and you're on the same system as the Plex server, set the webhook to be `http://localhost:8087/`. If you do plan on changing the port or you aren't on the same system as your Plex server, change this accordingly.
3. Configure the webhook server accordingly via copying the ``config.example.json`` file to ``config.json``. It should look like this once done.
```json
{
"port": 8087, // HTTP port of your choice
"accepted-players": ["uuid of player"], // Not required. Information on how to get UUID below.
"accepted-users": ["plex username"], // Not required. Your Plex username.
"accepted-libraries": [1], // This is your library ID for Plex. Information on how to get below.
"debug": false, // Determines whether or not stuff other than scrobble successes and errors are put into the console.
"scrobbler": {
"key": "", // Last.fm API key.
"secret": "", // Last.fm API Secret.
"username": "", // Your last.fm username.
"password": "" // Your last.fm password.
}
}
```
You can retrieve the player UUID and Music library ID by playing a song, setting `debug` to `true` and copying down the first and third bits put in the console, as shown in example below.
```
Player UUID | Plex User | Library ID | Webhook Event
4f1dde8b-e19d-4082-a5d4-0679666e1fe5 whytwokay 4 media.play
```