[READ-ONLY] Mirror of https://github.com/FoxxMD/multi-scrobbler. Scrobble plays from multiple sources to multiple clients
docs.multi-scrobbler.app
deezer
docker
jellyfin
koito
lastfm
listenbrainz
maloja
mopidy
mpris
music
music-assistant
plex
scrobble
self-hosted
spotify
subsonic
tautulli
youtube-music
docs(plex): Add Musicbrainz stage guidance
#447
+128
+128
docsite/docs/configuration/sources/plex.mdx
+128
docsite/docs/configuration/sources/plex.mdx
···
63
63
64
64
</details>
65
65
66
+
<DetailsAdmo type="tip" summary="Use Plex metadata with Musicbrainz for better scrobbling">
67
+
68
+
<h3>Matching With Plex</h3>
69
+
70
+
In Plex, if the **Plex Music** Agent is set on a Music Library then Plex attempts to match your music with Musicbrainz when it is first imported.
71
+
72
+
<img src={require('/img/plex_music_agent.jpg').default} height="400"/>
73
+
74
+
Plex uses ID3/metdata tags to match or falls back to matching based on file name and folder names. If it cannot find a match it can be fixed through a **Fix Match** option in the album/track context menu. See [plex documentation for more information](https://support.plex.tv/articles/correcting-your-music-content-matches/).
75
+
76
+
You can verify if an Item has been matched by:
77
+
78
+
* Clicking on the Item context menu (...)
79
+
* Get Info
80
+
* View XML
81
+
82
+
If a node like this is present then it has been matched: `<Guid id="mbid://4e631558-13b0..."/>`
83
+
84
+
<h3>Using Musicbrainz With Multi-Scrobbler</h3>
85
+
86
+
The MBID from the above `<Guid>` node is a [Track](https://musicbrainz.org/doc/Track), a special type of ID that specifically identifies a song on a specific album. If this is present then Multi-scrobbler can use it to gaurantee your scrobble, and all its metadata, is matched 1:1 with what is in your Plex library when using the [Musicbrainz Stage](/configuration/transforms/musicbrainz) to enrich your scrobble.
87
+
88
+
To configure MS to use Musicbrainz with your Plex metadata use one of the methods below:
89
+
90
+
<Tabs groupId="configType" queryString>
91
+
<TabItem value="env" label="ENV">
92
+
Add to your multi-scrobbler docker compose file `environment` section for [Musicbrainz ENV Configuration](/configuration/transforms/musicbrainz#env-configuration):
93
+
```yaml
94
+
# a real email that Musicbrainz can use to contact you in case of issues
95
+
- MB_CONTACT=myEmail@myEmailProvider.com
96
+
- MB_PRESETS=id,default
97
+
- PLEX_TRANSFORMS=musicbrainz
98
+
```
99
+
</TabItem>
100
+
101
+
<TabItem value="file" label="File">
102
+
Your [AIO Config](/configuration?configType=aio#configuration-types):
103
+
104
+
```json5 title="config.json"
105
+
{
106
+
// ...
107
+
"transformers": [
108
+
{
109
+
"type": "musicbrainz",
110
+
"name": "MyMB",
111
+
"data": {
112
+
"apis": [
113
+
{
114
+
// a real email that Musicbrainz can use to contact you in case of issues
115
+
"contact": "myEmail@myEmailProvider.com"
116
+
}
117
+
]
118
+
}
119
+
}
120
+
]
121
+
}
122
+
```
123
+
124
+
In your [File Config](/configuration?configType=file#configuration-types):
125
+
126
+
```json5 title="plex.json"
127
+
[
128
+
{
129
+
"name": "MyPlex",
130
+
"data": { /* ... */},
131
+
"options": {
132
+
"playTransform": {
133
+
"preCompare": [
134
+
{
135
+
"type": "musicbrainz",
136
+
"name": "MyMB"
137
+
"searchOrder": ["mbidrecording", "basicOrIds", "basic"]
138
+
}
139
+
]
140
+
}
141
+
}
142
+
}
143
+
]
144
+
```
145
+
</TabItem>
146
+
<TabItem value="aio" label="File AIO">
147
+
Your [AIO Config](/configuration?configType=aio#configuration-types):
148
+
149
+
```json5 title="config.json"
150
+
{
151
+
// ...
152
+
"transformers": [
153
+
{
154
+
"type": "musicbrainz",
155
+
"name": "MyMB",
156
+
"data": {
157
+
"apis": [
158
+
{
159
+
// a real email that Musicbrainz can use to contact you in case of issues
160
+
"contact": "myEmail@myEmailProvider.com"
161
+
}
162
+
]
163
+
}
164
+
}
165
+
]
166
+
// ...
167
+
"sources": [
168
+
// ...
169
+
{
170
+
"name": "MyPlex",
171
+
"type": "plex",
172
+
"data": { /* ... */},
173
+
"options": {
174
+
"playTransform": {
175
+
"preCompare": [
176
+
{
177
+
"type": "musicbrainz",
178
+
"name": "MyMB",
179
+
"searchOrder": ["mbidrecording", "basicOrIds", "basic"]
180
+
}
181
+
]
182
+
}
183
+
}
184
+
}
185
+
]
186
+
}
187
+
```
188
+
</TabItem>
189
+
</Tabs>
190
+
</DetailsAdmo>
191
+
192
+
193
+
66
194
#### Configuration
67
195
68
196
<Config config="PlexApiSourceConfig" fileContent={PlexConfig} name="plex">
docsite/static/img/plex_music_agent.jpg
docsite/static/img/plex_music_agent.jpg
This is a binary file and will not be displayed.