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.

For more editing tools see External Resources.

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.

Userscript Manager Browser Compatibility

	Chrome / Chromium / Vivaldi	Edge	Firefox	Maxthon	Opera	Safari
Greasemonkey	✗	✗	✓	✗	✗	✗
Violentmonkey	✓	✓	✓	✓	✓	✗
Tampermonkey	✓	✓	✓	✗	✓	✓
ScriptCat	✓	✓	✓	✗	✗	✗
FireMonkey	✗	✗	✓	✗	✗	✗
Userscripts Safari	✗	✗	✗	✗	✗	✓

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 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 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 Deezer releases to MusicBrainz		Import album data from Deezer to add a new release on MusicBrainz.	Deezer	atj
Import Encyclopedisque releases to MusicBrainz		Import album data from Encyclopedisque to add a new release on MusicBrainz.	Encyclopedisque	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 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 Naxos releases into MusicBrainz		Import album data from Naxos Music Library to add a new release on MusicBrainz.	Naxos	loujine
Import Qobuz releases to MusicBrainz		Import album data from Qobuz to add a new release on MusicBrainz.	Qobuz	zas
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 VGMdb releases to MusicBrainz		Import album data from VGMdb to add a new release on MusicBrainz.	VGMdb	augustjanse
Import Soundcloud releases to MusicBrainz		Import album data from Soundcloud to add a new release on MusicBrainz.	Soundcloud	garylaski
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 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 THBWiki releases to MusicBrainz		Import album data from THBWiki to add a new release on MusicBrainz.	THBWiki	y-young
Import Netease releases to MusicBrainz		Adds a button to import or find NetEase releases in MusicBrainz	music.163	garylaski
Import videos from YouTube			YouTube	Freso
Import videos from Vimeo			Vimeo	nikki
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		Facebook	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
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
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
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
Musicbrainz UI enhancements		Various UI enhancements for Musicbrainz.		murdos
Show alias count		Show alias number on work/artist pages.		loujine
Make columns sortable		Make table columns sortable.		loujine
Create entity or fill data from wikipedia / wikidata / VIAF / ISNI		Create entity or fill data from wikipedia / wikidata / VIAF / ISNI.		loujine
Elephant Editor	broken	Remember last edit notes and dates.		jesus2099
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
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
Expand/collapse release groups		See what's inside a release group without having to follow its URL. Adds convenient edit links.		bitmap
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
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
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
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
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
INLINE STUFF		musicbrainz.org release page: Inline recording names, comments, ISRC, PUID and AcoustID. Highlights duplicates in releases and edits.		jesus2099
Guess Unicode Punctuation		Replaces ASCII punctuation symbols by their preferred Unicode counterparts via a “Guess punctuation” button.		kellnerd
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
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
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
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
Magic Tagger Button		Detects whether Picard is running and will auto-enable the tagger buttons if so.		phw
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
Artist Credits Helper		Split and fill artist credits, append character voice actor credit, and guess artists from track titles.		y-young
ame		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
MB Release Seeding Helper		Give better clues on reusing of existing releases/recordings for new release		Anakunda

Userscripts: Works

Name	Status	Info	Site	Author	DL	Src	Bug
Show missing works		Show missing works on an artist page.		loujine
Set work attributes		Set work attributes from the composer page.		loujine
Guess related works		Set best-guess related works.		loujine
Bulk copy-paste work codes		Quickly copy-paste work identifiers (ISWC, agency work codes) from CISAC's ISWCNet into a MusicBrainz work.		ROpdebee
Validate Work Codes		Validate work attributes on various MB pages. Highlights invalid (red) or ill-formatted (yellow) work codes.		ROpdebee
Batch-add "performance of" relationships		Batch link recordings to works from the artist Recordings page.		bitmap

Userscripts: Recordings

Name	Status	Info	Site	Author	DL	Src	Bug
Replace recording artist from recording AR		Replace associated recording artist from an Artist or Work page.		loujine
Propagate recording dates		Batch-propagate recording dates.		loujine
Set recording attributes		Set attributes (live, partial) on selected recordings.		loujine
Transform release AR into recording AR		Move performer AR on release to recordings AR.		loujine
Replace recording artist from recording AR (On release pages)		Replace associated recording artist from a Release page.		loujine
Replace recording artist from recording AR (On work pages)		Replace associated recording artist from an Artist or Work page.		loujine
Clone recording relations onto other recordings		MusicBrainz relation editor: Clone recording relations onto other recordings. Can also clone release relationships between releases.		loujine
Mark recordings as video		Mark selected recordings as video		loujine
Mass Merge Recordings		Merges selected or all recordings from release A to release B.		jesus2099
Spot Duplicate Recordings		Spot recordings that are linked multiple times to the same work.		jesus2099
Set recording comments for a release		Batch set recording comments from a Release page.		bitmap
Set performer instrument		Convert to "string" instrument AR on selected recordings.		loujine
Inline Track Artist		Highlights track title, length and artist differences in recording page.		jesus2099
Select All Update Recordings		Add buttons to release editor to select all "Update recordings" checkboxes. Differs from the built-in "Select All" checkboxes in that it doesn't lock the checkboxes to a given state, enabling you to deselect some checkboxes.		ROpdebee
Inline all recording's tracks on releases		Display all tracks and releases on which a recording appears from the release page. Makes it easier to check whether live or DJ-mix recordings are wrongly linked to other tracks.		ROpdebee
Seed the batch recording comments script		Seed the recording comments for the batch recording comments userscripts with live and DJ-mix data. Can save a bunch of keystrokes when setting live or DJ-mix disambiguation comments. DJ-mix comments are derived from the release title. Live comments are derived from "recorded at place", "recorded in area", and "recording of work" advanced relationships.		ROpdebee
Batch-add "performance of" relationships		Batch link recordings to works from the artist Recordings page.		bitmap

Userscripts: Voting

Name	Status	Info	Site	Author	DL	Src	Bug
Power Vote		Adds buttons to check all unvoted edits (Yes/No/Abs/None) at once in the edit search page. You can also collapse/expand (all) edits for clarity. A handy reset votes button is also available + Double click radio to vote single edit + range click with shift to vote a series of edits. Hidden (collapsed) edits will never be voted (even if range click or shift+click force vote).		jesus2099
Blind Votes		Blinds editor and voter details before your votes are cast.		ROpdebee

Userscripts: Cover art

Name	Status	Info	Site	Author	DL	Src	Bug
Display CAA image dimensions		Loads and displays the image dimensions of images in the cover art archive.		ROpdebee
Enhanced Cover Art Uploads		Enhance the cover art uploader (integrates Image Max URL)		ROpdebee
Supercharged Cover Art Edits		Supercharges reviewing cover art edits. Displays release information on CAA edits. Enables image comparisons on removed and added images.		ROpdebee
CAA Links (Cover Art Archive Links)		Linkifies cover art edit “Filenames” (as specified in http://musicbrainz.org/edit/42525958).		jesus2099
Funkey Illustrated Records		CAA front cover art archive pictures/images (release groups and releases). Big illustrated discography and/or inline		jesus2099
1200px CAA		Use 1200px images for the pop‐up/previews, instead of loading huge images (also adds 1200px 'thumbnail' links)		Freso
Stig's Art Grabr		Grab high resolution album cover-art from various sites	Various	StigNygaard
Image Max URL		Finds larger or original versions of images and videos for 7,500+ websites, including a powerful media popup feature	Various	qsniyg

Userscripts: AcoustID/AcousticBrainz

Name	Status	Info	Site	Author	DL	Src	Bug
Show acoustID and AcousticBrainz link		Show acoustids on a Work page.		loujine
Show statistics from AcousticBrainz				loujine
Compare AcoustIDs easier		Displays AcoustID fingerprints in more places at MusicBrainz.		otringal
AcousticBrainz links		Display AcousticBrainz links in release pages.		jesus2099			N/A

Userscripts: Collections

Name	Status	Info	Site	Author	DL	Src	Bug
Hyper Moulinette		Mass PUT or DELETE releases in a collection from an edit search or an other collection.		jesus2099
Collection Highlighter		Highlights releases, release-groups, etc. that you have in your collections (anyone’s collection can be loaded) everywhere.		jesus2099
Batch Add to Collection		Batch add entities to MusicBrainz collection and copy MBIDs from entity pages, search result or existing collections.		y-young
Print All Pages		Print your complete collections to make your shopping lists or check lists.		jesus2099

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

Userscripts: Other

Name	Status	Info	Site	Author	DL	Src	Bug
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
REDIRECT WHEN UNIQUE RESULT		Redirect when only 1 result and-or unique 100% scored result		jesus2099
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
Revive Deleted Editors		Reveal deleted editors’ names and emphasizes your own name to standout in MB pages.		jesus2099
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
ALL RELEASE GROUPS		It will always display full artist discographies (including non official release groups) by default.		jesus2099
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
Add a-tisket button to Deezer		Adds a button to Deezer interface to load the current release into a-tisket.	Deezer	atj
Add a link to MusicBrainz to import ISRCs		Adds an "import ISRCs" link on MusicBrainz releases which have a Spotify URL.		atj
Musicbrainz DiscIds Detector	broken?	Generate MusicBrainz DiscIds from online EAC logs, and check existence in MusicBrainz database.		murdos			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	Info	Author	DL	Src	Bug
MetaBrainz All Projects Dark	A dark theme for MetaBrainz project sites.	beckfield		N/A
MusicBrainz Dark	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		N/A
MusicBrainz Nord Dark	A dark theme for MusicBrainz, based on the Nord palette.	shard		N/A	N/A
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 Hide ListenBrainz Player	Hide the big sidebar “Play on ListenBrainz” button	jesus2099
MetaBrainz Discourse Expand Abbreviations	Shows abbreviation/acronym definitions by touch on mobile (or mouse hover if you use it on PC)	jesus2099

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.