# MBID Mapper version 2.0 preview has finally arrived!
**URL:** https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908
**Category:** ListenBrainz
**Created:** [December 20, 2025, 10:34am UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908 "2025-12-20T10:34:29Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 10:34am UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/1 "2025-12-20T10:34:29Z")
The new MBID mapper, which supports using releases for lookup has finally appeared in an early preview:
[https://mapper.listenbrainz.org](https://mapper.listenbrainz.org)
Check the supported use cases to see what is already working. If you find a use case that should work, but doesn’t please post the following pieces of data here in a response:
- inputs: artist\_credit\_name, release\_name, recording\_name
- expected outputs: artist\_mbids, release\_mbid, recording\_mbid
So far, this new mapper is wicked fast and muuuch better in actually mapping things. 🙂
---
### Author:  [@chaban](https://community.metabrainz.org/u/chaban)
#### Post date: [December 20, 2025, 12:48pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/2 "2025-12-20T12:48:14Z")
Will aliases be supported?
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 12:59pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/3 "2025-12-20T12:59:25Z")
Artist aliases are supported. And recording\_aliases are being added, which is why its down right now. Stay tuned.
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 2:50pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/4 "2025-12-20T14:50:37Z")
Back up, but expect wobbles.
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 3:40pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/5 "2025-12-20T15:40:34Z")
Also check out the test cases that are supported:
[Supported Test Cases - MBID Mapper](https://mapper.listenbrainz.org/supported)
---
### Author:  [@chaban](https://community.metabrainz.org/u/chaban)
#### Post date: [December 20, 2025, 4:06pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/6 "2025-12-20T16:06:35Z")
I’m loving it and it’s so fast too.
`https://mapper.listenbrainz.org/?artist_credit_name=DUSTCELL&release_name=&recording_name=Anemone`
> Search completed in 4 ms
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 4:18pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/7 "2025-12-20T16:18:43Z")
Written in C++ – what a pain, but was worth it.
---
### Author:  [@Deleted\_Editor\_2599073](https://community.metabrainz.org/u/Deleted_Editor_2599073)
#### Post date: [December 20, 2025, 4:37pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/8 "2025-12-20T16:37:08Z")
Robert
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 5:07pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/9 "2025-12-20T17:07:39Z")
If only things were that easy, lol.
This mapper is an entirely new project that has no resemblance to the old version. It didn’t exist, so it wasn’t a job to just port it to C++.
---
### Author:  [@Alioth](https://community.metabrainz.org/u/Alioth)
#### Post date: [December 20, 2025, 6:13pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/10 "2025-12-20T18:13:54Z")
This is impressive. Thank you for the work you put in it.
If you don’t mind me asking, what are the next steps? When do you plan to integrate it with ListenBrainz?
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 20, 2025, 6:17pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/11 "2025-12-20T18:17:29Z")
First it needs more testing to make sure it doesn’t tip over the second we put it under load and it needs to be integrated with ListenBrainz. Neither of these tasks are too hard.
The more tricky part is making sure that its indexes stay up to date with the MusicBrainz data – also not that hard, just more work.
My guess, if all goes well, this could go live in January or February.
---
### Author:  [@chaban](https://community.metabrainz.org/u/chaban)
#### Post date: [December 20, 2025, 7:45pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/12 "2025-12-20T19:45:25Z")
`https://mapper.listenbrainz.org/?artist_credit_name=%21%21%21&release_name=As+If&recording_name=Ooo`
> Search completed in 0 ms
I think you need to display it in microseconds 😄
---
### Author:  [@Libra](https://community.metabrainz.org/u/Libra)
#### Post date: [December 21, 2025, 12:14pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/13 "2025-12-21T12:14:03Z")
I’m so happy that aliases will be used for matching finally. Because I add YT video releases, which don’t have any proper way of naming, and it always was pain to link them in LB, because I cleared titles according to MB guidelines (removed artist names, other artists, parts as “German cover”, “Guitar cover” etc) and added full release/recording names as aliases. But because LB ignored them it was hard to link my listens to MB recordings. So I’m really thankful for this change.
And yeah, it works really fast and well. Just to illustrate how powerful this new version is: it was impossible to link [this recording](https://musicbrainz.org/recording/4999a91d-d886-406c-892c-af0661fa8523) without adding mbid manually or knowing how I called it in db.
**Recording name on YT:** [Free Flight] Delvirta – Skyclad no Kansokusha [Steins;Gate VN OP, anime ED3 RUS Cover]
**Artist name on YT:** Free Flight – переводы песен из аниме и не только!
In its description and video itself a Russian name for this release was specified: “Непредвзятый наблюдатель”. Because it is the Russian cover, I used the Russian name as its main name for storing. So in MB it is stored as “Free Flight - Непредвзятый наблюдатель” and all other options are stored as aliases. And of course, every scrobbler only used original YT credits, so there wasn’t any chance, that LB will suggest the recording that I need.
And in this version it already can find it in any possible combination:
- **Artist:** Free Flight | **Recording:** Непредвзятый наблюдатель | [ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=free+flight&release_name=&recording_name=%D0%9D%D0%B5%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B7%D1%8F%D1%82%D1%8B%D0%B9+%D0%BD%D0%B0%D0%B1%D0%BB%D1%8E%D0%B4%D0%B0%D1%82%D0%B5%D0%BB%D1%8C)
- **Artist:** Free Flight | **Recording:** Skyclad no Kansokusha | [ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=free+flight&release_name=&recording_name=Skyclad+no+Kansokusha)
- **Artist:** Free Flight – переводы песен из аниме и не только! | **Recording:** [Free Flight] Delvirta – Skyclad no Kansokusha [Steins;Gate VN OP, anime ED3 RUS Cover] | [ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=Free+Flight+%E2%80%93+%D0%BF%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4%D1%8B+%D0%BF%D0%B5%D1%81%D0%B5%D0%BD+%D0%B8%D0%B7+%D0%B0%D0%BD%D0%B8%D0%BC%D0%B5+%D0%B8+%D0%BD%D0%B5+%D1%82%D0%BE%D0%BB%D1%8C%D0%BA%D0%BE%21&release_name=&recording_name=%5BFree+Flight%5D+Delvirta+%E2%80%93+Skyclad+no+Kansokusha+%5BSteins%3BGate+VN+OP%2C+anime+ED3+RUS+Cover%5D)
Even if I mix different release and recording names and languages:
- **Artist:** Free Flight – переводы песен из аниме и не только! | **Release:** Непредвзятый наблюдатель | **Recording:** Skyclad no Kansokusha - [ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=Free+Flight+%E2%80%93+%D0%BF%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4%D1%8B+%D0%BF%D0%B5%D1%81%D0%B5%D0%BD+%D0%B8%D0%B7+%D0%B0%D0%BD%D0%B8%D0%BC%D0%B5+%D0%B8+%D0%BD%D0%B5+%D1%82%D0%BE%D0%BB%D1%8C%D0%BA%D0%BE%21&release_name=%D0%9D%D0%B5%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B7%D1%8F%D1%82%D1%8B%D0%B9+%D0%BD%D0%B0%D0%B1%D0%BB%D1%8E%D0%B4%D0%B0%D1%82%D0%B5%D0%BB%D1%8C&recording_name=Skyclad+no+Kansokusha)
Again, thanks for this fantastic work! 😀
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 21, 2025, 4:30pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/14 "2025-12-21T16:30:20Z")
Crap. Too many restarts caused let’s encrypt to issue too many certs and I can’t restart on this domain. For the next 24 hours at least, the server will be WITHOUT https:
[http://mapper.listenbrainz.org/](http://mapper.listenbrainz.org/)
We’ll put it behind our infra tomorrow.
---
### Author:  [@rob](https://community.metabrainz.org/u/rob)
#### Post date: [December 22, 2025, 11:13pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/15 "2025-12-22T23:13:07Z")
Now on our own infra:
[https://mapper.listenbrainz.org/](https://mapper.listenbrainz.org/)
What problems have people found?
---
### Author:  [@VBZPPlNQyJ](https://community.metabrainz.org/u/VBZPPlNQyJ)
#### Post date: [December 23, 2025, 12:43am UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/16 "2025-12-23T00:43:38Z")
Thank you! This is much anticipated.
[https://mapper.listenbrainz.org/?artist\_credit\_name=Johann+Sebastian+Bach&release\_name=Goldberg-Variationen&recording\_name=Aria+mit+30+Veränderungen%2C+BWV+988+“Goldberg+Variations”%3A+Aria](https://mapper.listenbrainz.org/?artist_credit_name=Johann+Sebastian+Bach%2C+Andrei+Gavrilov&release_name=Goldberg-Variationen&recording_name=Goldberg+Variations%2C+BWV+988%3A+Aria) doesn’t work as I would have expected. As far as I know, this is how [https://open.spotify.com/track/7H9knJFkDQ9XCmWXcHBWkk](https://open.spotify.com/track/7H9knJFkDQ9XCmWXcHBWkk) would appear in LB.
inputs:
- artist: `Johann Sebastian Bach, Andrei Gavrilov`
- release: `Goldberg-Variationen`
- recording name: `Goldberg Variations, BWV 988: Aria`
expected outputs:
- [https://musicbrainz.org/artist/6624e455-c745-4ca8-bebb-146cdfe89359](https://musicbrainz.org/artist/6624e455-c745-4ca8-bebb-146cdfe89359)
- [https://musicbrainz.org/release/4fa9976f-d800-4627-8638-7857f2ace7e3](https://musicbrainz.org/release/1f8a0577-0416-4580-ab42-6a207586af5a) (or one of the other 4 releases with the same name and artists)
- [https://musicbrainz.org/recording/44df9b3f-8524-4945-ba73-bcbd6089efff](https://musicbrainz.org/recording/44df9b3f-8524-4945-ba73-bcbd6089efff)
---
### Author:  [@Alioth](https://community.metabrainz.org/u/Alioth)
#### Post date: [January 2, 2026, 3:16pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/17 "2026-01-02T15:16:41Z")
I think I’m good at finding nasty edge cases. Sorry for that. 😉
This release group [Release group “Moments” by Lull - MusicBrainz](https://musicbrainz.org/release-group/741494c1-c3a3-3128-bc2b-f913a8e30db5) consists of releases where each recording is named “Moment `xx`”, where `xx` is a number between 1 and 100. The recordings are officially untitled, but they all have a recording name alias “Moment `xx`”.
It appears that the mapper always finds the same recording, no matter which number there is in the search term, and the result is always [“Moment 1”](https://musicbrainz.org/recording/e69037d9-5c69-4bc0-b4fe-dc353cc71dfd). I could swear that in my previous testing few days ago the result was always “Moment 35”, but it changed now. Example search: [ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=lull&release_name=moments&recording_name=moment+49).
The one exception is “Moment 100”. Maybe it’s because the recording is not untitled?
* * *
In general, any release where there is more than one recording with the same title will be problematic. But I don’t think there’s a solution for that if the only input data for the matching algorithm is artist name, album name and track title.
Examples:
- [Subconscious Terror / Dark Is the Season](https://musicbrainz.org/release/0cff83fc-3cb2-44a3-a404-62058ee9feff) (tracks 6 and 15)
- [Na wszystkich frontach świata](https://musicbrainz.org/release/bef47d60-8842-4316-acbb-ef10c4eb8140) (e.g. tracks 4, 22 and 29)
Edit: I found a nastier example. Two releases with the same title and the same track titles, but the tracks correspond to different recordings. Good luck with that!
- [Release “Archimetrical Universe” by Atomine Elektrine - MusicBrainz](https://musicbrainz.org/release/92fdc0bb-4236-41e5-af53-97f7970c17e1)
- [Release “Archimetrical Universe” by Atomine Elektrine - MusicBrainz](https://musicbrainz.org/release/030e8944-d993-4217-87b5-f2a1b4173c9f)
---
### Author:  [@debtPLUS](https://community.metabrainz.org/u/debtPLUS)
#### Post date: [January 2, 2026, 4:49pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/18 "2026-01-02T16:49:27Z")
I was browsing other users pages when I hit play on “Easy Goodbye” by Flume and Emma Louise. This (copied) playlist plays the correct song. [ListenBrainz](https://listenbrainz.org/playlist/2eed1b0f-9900-4e71-b890-2c5646ae99a0/)
When using [mapper.listenbrainz.org](http://mapper.listenbrainz.org) with the inputs:
- Artist Name: Flume, Emma Louise
- Recording Name: Easy Goodbye
it returns the Recording MBID: [1c551c0a-8634-485a-b83c-f47aecb8bf4b](https://musicbrainz.org/recording/1c551c0a-8634-485a-b83c-f47aecb8bf4b)
Clicking “Play on ListenBrainz” through that link brings up an instant playlist on ListenBrainz, with a seemingly correct listing. Hitting play plays a remix( [https://soundcloud.com/officialmissinglink/emma-louise-flume-easy-goodbye-missing-link-remix](https://soundcloud.com/officialmissinglink/emma-louise-flume-easy-goodbye-missing-link-remix) ).
It plays for all listings on the ListenBrainz track page.
Sorry if this is a known issue with an easy solution. I’ve only been using this service for a couple hours. If it matters, I’m using ListenBrainz signed in and I’ve linked my SoundCloud account.
---
### Author:  [@chaban](https://community.metabrainz.org/u/chaban)
#### Post date: [January 2, 2026, 9:26pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/19 "2026-01-02T21:26:26Z")
Found a case where the new mapper has no result:
> **[ListenBrainz MBID Mapper 2.0](https://mapper.listenbrainz.org/?artist_credit_name=Mox+%E0%B2%A0+%E1%B4%A5+%E0%B2%A0&release_name=Brat&recording_name=Brat)**
Expected recording: [Recording “Brat” by MoxiFloxi - MusicBrainz](https://musicbrainz.org/recording/244a8af9-5e3c-4ff1-b907-95c22daf92d6)
I can find it with advanced MB search:
> **[Search results - MusicBrainz](https://musicbrainz.org/search?query=artistname%3A%28Mox+%E0%B2%A0+%E1%B4%A5+%E0%B2%A0%29+%26%26+recording%3A%28Brat%29+%26%26+release%3A%28Brat%29&type=recording&limit=25&method=advanced)**
Also with simple indexed search:
> **[Search results - MusicBrainz](https://musicbrainz.org/search?query=%28Brat%29+%28Mox+%E0%B2%A0+%E1%B4%A5+%E0%B2%A0%29&type=recording&limit=25&method=indexed)**
Does it not consider the artist name in the database?
---
### Author:  [@mr\_monkey](https://community.metabrainz.org/u/mr_monkey)
#### Post date: [January 9, 2026, 6:50pm UTC](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908/20 "2026-01-09T18:50:00Z")
An interesting mapping issue reported on social media: the user’s top song is unknown to them, and matched to a suspicious looking track named “?” by artist “©”.
See track 5 of [this album](https://listenbrainz.org/album/34c2fc69-2e2e-3346-9028-84d9b0875d01/), which seems to have wayy too many listens compared to other on the album/artist level, suggesting this issue is happening to other users as well.
I just confirmed this issue with another user as well.
Additiponal information after checking in the database:
1. all of the tracks matched to this, don’t have any alphanumeric character in them (see examples below)
2. there are ~1500 of them atm
Examples of listens matched to this recording:
- “ㅤ” by “࿇” (title is not an empty space, it’s unicode [U+3164](https://unicode-explorer.com/c/3164))
- “✺✷✩ ❁✫ ✾✰✺ ✾✳✷✷✺✵” by “✹✾✶❋✩✳✹✾❈✷×”
- “✶✷ ✳✷✹✾✶❃✵✺ ✶❋✾❈✫✶❊✾” by “✹✾✶❋✩:eight\_spoked\_asterisk:✹✾❈✷×”
- “?? ??? ???” by “???”
[Next page](https://community.metabrainz.org/t/mbid-mapper-version-2-0-preview-has-finally-arrived/813908.md?page=2)