Skip to main content

Help

Getting Useful Data​

Logs​

Multi-scrobbeler has a real-time log that is accessible from anywhere in the app. These are the same logs you would find in docker logs. Use the Terminal icon in the top-right of the app to open the floating log window.

The Copy icon in the top-right of the log window will copy all logs to your clipboard. Alternatively, you can select and copy any logs.

When creating an issue please include all logs at the lowest Level possible (TRACE) to help provide context for your issue. You should try to include logs that occurred before and after your issue/error occurs as this can help determine if MS was behaving normally.

Debug Mode​

If possible, turn on Debug Mode and replicate your issue. Debug Mode enables much more logging that can reveal additional data for troubleshooting.

This mode will make your logs very noisy, though, so it's recommended to turn it off after collecting logs.

Copy Play Debug Data​

Open the details page for the Source/Client experiencing an issue. Then, search or scroll to find the Play/Scrobble that where the problem is occurring.

Click on the Debug icon to copy debugging data relevant to that Play. This data should be included in any issue you create.

To include this data in an issue either paste the copied data into a text file and save as debugdata.json, attaching to the issue.

Or directly paste the copied data into an issue/comment using fenced code blocks markdown to preserve the structure like:

This is the contents of my comment/issue text on github.

I am explaining my issue here. Here is the debug data:

```json
{
  "input": {
    "aProperty: 123,
    "foo": "bar"
  }
}
```

Thank you for your time.

Copy Error Data​

If the issue is occurring with a Source/Client itself, or there is an Error/Warning available, click the icon shown below to copy the error data to your clipboard.

Include this in your issue using the code blocks, like shown in the Debug Data section above:

{
  "name": "Authentication Check",
  "message": "Authentication test failed!",
  "stack": "Authentication Check: Authentication test failed!\n..."
  }
}

Finding Help​

FAQ​

Check the FAQ to see if your issue is a known issue or a commonly-experienced issue with Multi-Scrobbler. The FAQ also includes fixes or ways to help troubleshoot these common issues.

Existing Issues​

On the github repository for Multi-Scrobbler, search existing issues and discussions to see if anyone else has had this issue and if it has already been solved.

Reporting an Issue​

Before reporting an issue please consider:

If none of the above apply to you then create a new bug report. Please include all logs and play debug data relevant to your issue. The more logs the better. If possible, replicate the issue with debug mode turned on.