Guides / Userscripts
Userscripts run in a users web browser and make on-the-fly local changes to specific web pages. In MusicBrainz they are generally used to change the display of pages, facilitating editing.
These scripts and tools are user-made, and are not officially supported by MetaBrainz.
Other resources
- External Resources page: For standalone/non-script tools, websites, programs and resources
- Picard Resources page: Tools, scripts and links related to MusicBrainz Picard
Userscript manager
To run userscripts, you need to install an in-browser userscript manager, and then install the script.
Chrome/Chromium can run userscripts without installing a userscript manager extension, however many userscripts will not work properly. It is recommended that you install a userscript manager.
Chrome / Chromium / Vivaldi | Edge | Firefox | Maxthon | Opera | Safari | Open Source | Data Collection* | |
---|---|---|---|---|---|---|---|---|
Greasemonkey | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | ✓ | ✗ |
Violentmonkey | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ | ✗ |
Tampermonkey | ✓ | ✓ | ✓ | ✗ | ✓ | ✓ | ✗ | ✓ |
ScriptCat | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✓ | |
FireMonkey | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | ✓ | ✗ |
Stay | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ | ✓ | |
Userscripts Safari | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ | ✓ | ✗ |
*Whether their privacy policy indicates that they collect user data, or not.
Thanks to Colbydray for starting the following script list.
Userscripts: Importers
These scripts import (seed) releases, events, or other entities from other websites or databases into the MusicBrainz editor.
Name | Status | Info | Site | Author | DL | Src | Bug |
---|---|---|---|---|---|---|---|
Import ARD radio dramas to MusicBrainz | Import album data from ARD radio drama database pages to add a new release on MusicBrainz. | ARD-Hörspieldatenbank | kellnerd | ||||
Import Bandcamp releases to MusicBrainz | Import album data from Bandcamp/album pages to add a new release on MusicBrainz. | Bandcamp | murdos | ||||
Import Beatport releases to MusicBrainz | Import album data from Beatport/release pages to add a new release on MusicBrainz. | Beatport | VxJasonxV | ||||
Import Deezer releases to MusicBrainz | Import album data from Deezer to add a new release on MusicBrainz. | Deezer | atj | ||||
Import Discogs releases to MusicBrainz | Import album data from Discogs to add a new release on MusicBrainz. Adds links to matching MusicBrainz entities for various Discogs entities (artist, release, master, label). | Discogs | murdos | ||||
Import Free Music Archive releases to MusicBrainz | Import album data from Free Music Archive to add a new release on MusicBrainz. | Free Music Archive | madmouser1 | ||||
Import Encyclopedisque releases to MusicBrainz | Import album data from Encyclopedisque to add a new release on MusicBrainz. | Encyclopedisque | murdos | ||||
Import Hyperion/Helios releases to MusicBrainz | Import album data from Hyperion/Helios to add a new release on MusicBrainz. | Hyperion | loujine | ||||
Import Idiago releases to MusicBrainz | Import album data from Idiago to add a new release on MusicBrainz. | Idiago | loujine | ||||
Import iTunes releases to MusicBrainz | Import album data from iTunes to add a new release on MusicBrainz. | iTunes | dufferzafar/ damienmauchamp | ||||
Import Juno Download releases to MusicBrainz | Import album data from junodownload.com/products to add a new release on MusicBrainz. | Juno Download | zas | ||||
Import Loot releases to MusicBrainz | Import album data from Loot.co.za to add a new release on MusicBrainz. | Loot | madmouser1 | ||||
Import Metal Archives releases to MusicBrainz | Import album data from Metal Archives to add a new release on MusicBrainz. | Metal Archives | l-maxime | ||||
Import Music Forest releases to MusicBrainz | Import album data from Music Forest to add a new release on MusicBrainz. | minc.or.jp | y-young | ||||
Import Naxos releases into MusicBrainz | Import album data from Naxos Music Library to add a new release on MusicBrainz. | Naxos | loujine | ||||
Import Netease releases to MusicBrainz | Adds a button to import or find NetEase releases in MusicBrainz | music.163 | garylaski | ||||
Import Qobuz releases to MusicBrainz | Import album data from Qobuz to add a new release on MusicBrainz. | Qobuz | zas | ||||
Import setlist.fm setlists to MusicBrainz | Import setlist data from setlist.fm to add a new event on MusicBrainz. | setlist.fm | Dvir Yitzchaki | ||||
Import Soundcloud releases to MusicBrainz | Import album data from Soundcloud to add a new release on MusicBrainz. | Soundcloud | garylaski | ||||
Import Spotify releases to MusicBrainz | Import album data from Spotify to add a new release on MusicBrainz, via a-tisket or Harmony. | Spotify | garylaski, RustyNova | ||||
Import Supraphonline releases to MusicBrainz | Import album data from Supraphonline to add a new release on MusicBrainz. | Supraphonline | scarlett-blake | N/A | |||
Import T-Series releases to MusicBrainz | Import album data from T-Series to add a new release on MusicBrainz. | T-Series | dufferzafar | ||||
Import Takealot releases to MusicBrainz | Import album data from Takealot to add a new release on MusicBrainz. | Takealot | madmouser1 | ||||
Import THBWiki releases to MusicBrainz | Import album data from THBWiki to add a new release on MusicBrainz. | THBWiki | y-young | ||||
Import VGMdb releases to MusicBrainz (Ame) | Import album data from VGMdb to add a new release on MusicBrainz. Batch download album art, add links from VGMdb to Ongaku no Mori and MusicBrainz releases. | VGMdb | SuperSaltyGamer | ||||
Import Wolfgang's releases to MusicBrainz | Import album data from Wolfgang's to add a new release on MusicBrainz. | Wolfgang's | lazybookwyrm | ||||
Import videos from YouTube (release) | Import videos from YouTube as a release. | YouTube | Freso/RustyNova | ||||
Import videos from YouTube (recording) | Import videos from YouTube as a recording. | YouTube | Freso | ||||
JASRAC. work importer/editor into MusicBrainz + MB-JASRAC-音楽の森-NexTone links + MB back search links | One click imports JASRAC works into MusicBrainz (name, iswc, type, credits, edit note, sort name, search hint) and マス歌詞®(mass-lyrics) and wikipedia links. It will do the same magic in work editor. Work links to both JASRAC and 音楽の森 / ongakunomori / music forest / minc / magic db and back to MB. | JASRAC | jesus2099 | ||||
Import Amazon releases to MusicBrainz | broken? | Import album data from Amazon to add a new release on MusicBrainz. | Amazon | Goram | |||
broken | dufferzafar | ||||||
Import events from Facebook | broken | opatel99 | N/A | ||||
Import Internet Archive releases to MusicBrainz | broken | Import album data from the Internet Archive to add a new release on MusicBrainz. | Internet Archive | JensBee | N/A | ||
Import VGMdb releases to MusicBrainz | broken? | Import album data from VGMdb to add a new release on MusicBrainz. | VGMdb | augustjanse | |||
Edition lookup by CD TOC [on Gazelle torrent trackers] | In (some?) Gazelle torrent trackers, look up CD TOC's in MusicBrainz, GnuDb and in CUETools DB. Has features for attaching the TOC to a MusicBrainz release, and creating a new MusicBrainz release based on the TOC. | Gazelle sites/trackers | Anakunda |
Userscripts: Misc
Name | Status | Info | Site | Author | DL | Src | Bug |
---|---|---|---|---|---|---|---|
Add a-tisket button to Deezer | Adds a button to Deezer interface to load the current release into a-tisket. | Deezer | atj | ||||
Add a-tisket import link to Spotify | Adds a link to Spotify to import a release into MusicBrainz via a-tisket | Spotify | atj | ||||
Add a link to MusicBrainz to import ISRCs | Adds an "import ISRCs" link on MusicBrainz releases which have a Spotify URL. | atj | |||||
Add release(group) links from level above | Add release(group) links from an artist, label or series page. Compatible with expand/collapse release groups script. | RandomMushroom128 | |||||
ALL LINKS | Customisable quick links/searches, including web search, last.fm, Discogs, lyrics, social media, streaming services, etc. Shows begin/end dates on URLs, and a edit link. Expands Wikidata links into Wikipedia articles. | jesus2099 | |||||
ALL RELEASE GROUPS | It will always display full artist discographies (including non official release groups) by default, by appending (all=1). | jesus2099 | |||||
Ame (MusicBrainz) | Adds release buttons for multi-source cover art search. Enhanced search with direct ISRC, cat. no and barcode, and drag-drop log file search and attachment on release pages. Auto select search on page load. | SuperSaltyGamer | |||||
Ame (Apple Music) | Selectable release title, artist, description; fix preview queue not working when logged out; check release storefront availability; link to full resolution release cover; hide upselling modals and banners; extended release info panel; fix CTRL+A in search field; copy authorization token; release quality badges; check track quality; lyrics downloading; search MH Covers | SuperSaltyGamer | |||||
Apple Music Barcodes/ISRCs | Reads barcodes, ISRCs, and other metadata from Apple Music releases. Click the green square in the upper-left corner to display album metadata. | Apple Music | ToadKing | ||||
Artist Credits Helper | Split and fill artist credits, append character voice actor credit, and guess artists from track titles. | y-young | |||||
Auto-Focus + Keyboard-Select | Mouse-less editing - focuses fields in various MusicBrainz edit pages, allows keyboard selection of relationship types as well as some release editor keyboard navigation performance features. | jesus2099 | |||||
Bandcamp Tag Importer | Easily submit tags on Bandcamp pages to MusicBrainz. | Bandcamp | zabe | ||||
Bulk Edit Release Events | Copy and input release events from atisket into MB. | texke | |||||
Colourful rainbow edit headers | Changes the background colour of the edit header, depending on the type of edit. By default: add is green, edit is yellow, remove is pink, merge is purple and all others are blue. If you want to change the colours, they're set at the top of the script. | stars | N/A | ||||
Cool Entity Links | In some pages like edits, blog, forums, chatlogs, tickets, annotations, etc. it will prefix entity links with an icon, shorten and embelish all sorts of MB links (cdtoc, entities, tickets, bugs, edits, etc.). | jesus2099 | |||||
Create entity or fill data from wikipedia / wikidata / VIAF / ISNI | Create entity or fill data from wikipedia / wikidata / VIAF / ISNI. | loujine | |||||
Disable browser autofill on the tags field | Disables browser autofill functionality on the tags input field. | atj | |||||
Disable the tags field genre autocompletion | Disables the tags input field genre autocompletion functionality. | atj | |||||
Elephant Editor | Remember last edit notes and dates. | jesus2099 | |||||
Expand/collapse release groups | See what's inside a release group without having to follow its URL. Adds convenient edit links. | bitmap | |||||
Fast cancel edits | Makes it easier to cancel a large amount of edits on a page. Don't use if you're prone to clicking anything by mistake. | bitmap | |||||
Guess Unicode Punctuation | Replaces ASCII punctuation symbols by their preferred Unicode counterparts via a “Guess punctuation” button. | kellnerd | |||||
Import Bandcamp releases to MusicBrainz Album Link Helper | Add a link to Bandcamp's album canonical URL on pages without /album/, to import the release into MusicBrainz. | Bandcamp | zas | ||||
INLINE STUFF | musicbrainz.org release page: Inline recording names, comments, ISRC, PUID and AcoustID. Highlights duplicates in releases and edits. | jesus2099 | |||||
Magic Tagger Button | Detects whether Picard is running and will auto-enable the tagger buttons if so. | phw | |||||
Make columns sortable | Make table columns sortable. | loujine | |||||
MB Auto Track Lengths from CD TOC | Autoset track lengths from unique CD-TOC | Anakunda | |||||
MB Auto-retry on upload to CAA error | Auto reupload failed cover art images on server errors till all succeed. | Anakunda | |||||
MB Release Collection to CSV | Export MB Release Collections to a CSV file | Volumetrique | N/A | ||||
MB Release Seeding Helper | Give better clues on reusing of existing releases/recordings for new release. | Anakunda | |||||
MERGE HELPOR 2 | Merge helper highlights last clicked, shows info, indicates oldest MBID, manages (remove) entity merge list; merge queue (clear before add) tool; don’t reload page for nothing when nothing is checked. | jesus2099 | |||||
MusicBrainz CTDB Links | Add links to CTDB disc IDs on MusicBrainz CDTOC pages. | CUETools DB | ToadKing | ||||
MusicBrainz Date Helper | Userscript which assists in copy and pasting dates in MusicBrainz. | Levi_OP | |||||
MusicBrainz Entity Images | Display images on MusicBrainz for artists, labels, places, and events. | zabey | |||||
MusicBrainz: Parse Copyright Notice | Parses copyright (and phonographic) notices and automates the process of creating release and recording relationships for these. | Wiki | kellnerd | ||||
MusicBrainz Relationship batch selector | Input track ranges to automatically select them in the relationships editor. | ToadKing | |||||
MusicBrainz Taggregator | Easily submit tags from anywhere to Musicbrainz. | zabe | |||||
MusicBrainz UI enhancements | Various UI enhancements for MusicBrainz. | murdos | |||||
Monstercat - Search in Musicbrainz | Add a MusicBrainz and a Spotify search button to Monstercat's Release Pages | Monstercat | RustyNova | ||||
Move track relationships to the release-level | Allows mass-moving incorrect recording- and work-level relationships to the release-level in the release relationship editor. | bitmap | |||||
Paste multiple external links at once | Paste multiple external links at once into the external link editor. Input is split on whitespace (newlines, tabs, spaces, etc.) and fed into the link editor separately. | ROpdebee | |||||
Plain Text Tracklist | Get a quick copy of the tracklists in plain text (several formats) for quick re-use (in track parser, EAC, foobar2000 or mp3tag for instance). | jesus2099 | |||||
Preferred MusicBrainz Server | Choose your favourite MusicBrainz server (main or beta) and no link will ever send you to the other. | jesus2099 | |||||
REDIRECT WHEN UNIQUE RESULT | Redirect when only 1 result and-or unique 100% scored result. | jesus2099 | |||||
Revive Deleted Editors | Reveal deleted editors’ names and emphasizes your own name to standout in MB pages. | jesus2099 | |||||
Semi-automate adding "remixer" and "remix of" credits | Adds links to the relationship editor that semi-automate adding "remixer" and "remix-of" credits to recordings. | atj | |||||
sanojjonas visualise stuff | Visualise stuff in MusicBrainz: Event/festival timetable, artist member timeline | sanojjonas | N/A | ||||
Shortcuts to external links | Display clickable icons, without opening each entity page, for release-group, release, recording and work external links: e.g. Amazon, Bandcamp, Discogs etc. | murdos | |||||
Show Bandcamp publish date | Shows Bandcamp releases' real "publish date" below the listed date. Also shows "date modified", if different. | Bandcamp | w-biggs | N/A | |||
Show alias count | Show alias number on work/artist pages. | loujine | |||||
Spotify: MusicBrainz Status | Issues in Violentmonkey | Highlights albums, in Spotify, that aren't in MusicBrainz (don't have a URL relationship in MB). | Spotify | RustyNova | |||
SUPER MIND CONTROL Ⅱ X TURBO | MusicBrainz Power-Ups (mbsandbox.org too): RELEASE_CLONER. copy/paste releases / DOUBLE_CLICK_SUBMIT / CONTROL_ENTER_SUBMIT / RELEASE_EDITOR_PROTECTOR. prevent accidental cancel by better tab key navigation / TRACKLIST_TOOLS. search→replace, track length parser, remove recording relationships, set selected works date / LAST_SEEN_EDIT. handy for subscribed entities / COOL_SEARCH_LINKS / COPY_TOC / ROW_HIGHLIGHTER / SPOT_CAA / SPOT_AC / RECORDING_LENGTH_COLUMN / RELEASE_EVENT_COLUMN / WARN_NEW_WINDOW / SERVER_SWITCH / TAG_TOOLS / USER_STATS / MAX_RECENT_ENTITIES / CHECK_ALL_SUBSCRIPTIONS / EASY_DATE. paste full dates in one go / STATIC_MENU / MERGE_USER_MENUS / SLOW_DOWN_RETRY / CENTER_FLAGS / RATINGS_ON_TOP / HIDE_RATINGS / UNLINK_ENTITY_HEADER / MARK_PENDING_EDIT_MEDIUMS. | jesus2099 | |||||
VGMdb Musicbrainz Links | Add MusicBrainz links to VGMdb album pages | VGMdb | ToadKing | ||||
Unicode characters | Ctrl+M on MusicBrainz input text or textarea controls shows context menu for unicode characters. Just click on the menu line to send the character or close. | Smeulf | |||||
Voice Actor Credits | Parses voice actor credits from text and automates the process of creating release relationships for these. Also imports credits from Discogs. | kellnerd | |||||
Youtube Link Canonicalizer | Correct youtube @username artist link relationships to channel IDs. | YouTube | zabey | ||||
Musicbrainz DiscIds Detector | broken? | Generate MusicBrainz DiscIds from online EAC logs, and check existence in MusicBrainz database. | murdos | N/A | |||
Paste-A-Date! | broken | Adds a field after the existing date fields where you can paste a date and it will try to parse it. | nikki | N/A |
Userscripts: Works
Userscripts: Recordings
Userscripts: Voting
Userscripts: Cover art
Name | Status | Info | Site | Author | DL | Src | Bug |
---|---|---|---|---|---|---|---|
1200px CAA | Use 1200px images for the pop‐up/previews, instead of loading huge images (also adds 1200px 'thumbnail' links). | Freso | |||||
Enhanced Cover Art Uploads | Enhance the cover art uploader (integrates Image Max URL). | ROpdebee | |||||
CAA Links (Cover Art Archive Links) | Linkifies cover art edit “Filenames” (as specified in http://musicbrainz.org/edit/42525958). | jesus2099 | |||||
Display CAA image dimensions | Loads and displays the image dimensions of images in the cover art archive. | ROpdebee | |||||
Funkey Illustrated Records | CAA front cover art archive pictures/images (release groups and releases). Big illustrated discography and/or inline. | jesus2099 | |||||
Image Max URL | Finds larger or original versions of images and videos for 7,500+ websites, including a powerful media popup feature. | Various | qsniyg | ||||
Stig's Art Grabr | Grab high resolution album cover-art from various sites. | Various | StigNygaard | ||||
Supercharged Cover Art Edits | Supercharges reviewing cover art edits. Displays release information on CAA edits. Enables image comparisons on removed and added images. | ROpdebee |
Userscripts: AcoustID/AcousticBrainz
Userscripts: Collections
Userscripts: ListenBrainz
Name | Status | Info | Site | Author | DL | Src | Bug |
---|---|---|---|---|---|---|---|
Search unlinked listen in MusicBrainz | Adds MusicBrainz search links for artist and title of unmapped listens. | Rokoucha | N/A |
Writing userscripts
If you want to write your own userscript for MusicBrainz (or other websites), you can learn a lot from existing examples and the documentation of the userscript extensions:
- GreaseSpot wiki (Greasemonkey)
- Violentmonkey guide
- Tampermonkey documentation
You can use Kellnerd's userscript-bundler as a starting point for a semi-automated setup to build userscripts from JavaScript modules.
Further resources
- External Resources wiki page: External Resources
- Some user script repositories:
- greasyfork.org’s MusicBrainz script set (automatically updated)
- openuserJS.org’s musicbrainz group (manually updated, not always up to date)
Stylus themes
Themes change how webpages look, for instance changing colours, or moving buttons and text. Themes can make very small changes, or change a page completely.
To use themes you have to install Stylus or a similar browser extension.
Name | Status | Info | Author | DL | Src | Bug |
---|---|---|---|---|---|---|
Dark Side of MusicBrainz | Dark theme for the MusicBrainz website (including editing interfaces) and wiki. There is also a companion with additional style fixes for some popular userscripts. | kellnerd | ||||
MetaBrainz All Projects Dark | A dark theme for MetaBrainz project sites. | beckfield | N/A | |||
MetaBrainz Discourse Expand Abbreviations | Shows abbreviation/acronym definitions by touch on mobile (or mouse hover if you use it on PC). | jesus2099 | ||||
MusicBrainz Hide ListenBrainz Player | Hide the big sidebar “Play on ListenBrainz” button. | jesus2099 | ||||
MusicBrainz Nord Dark | A dark theme for MusicBrainz, based on the Nord palette. | shard | N/A | N/A | ||
MusicBrainz Sultan Dark | A somewhat lower contrast dark theme for MusicBrainz. | Aszazin | ||||
MusicBrainz Wiki Mobile Narrow Layout Fix | Only for mobile: Fix the Monobook skin half-screen narrow display OTHER-401 bug of MB wiki. | jesus2099 | ||||
MusicBrainz Dark | Updated 2013 | Dark style for MusicBrainz with purple links. | monn43 | N/A | N/A |
Relevant video:
Troubleshooting
A number of popular userscripts for MusicBrainz no longer work on Firefox 57+ and Greasemonkey 4+. See Greasemonkey#GreaseMonkey 4 incompatibility. Use Violentmonkey or Tampermonkey on Firefox instead.