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 (proprietary)	✓	✓	✓	✗	✓	✓

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 Amazon releases to MusicBrainz		Import album data from Amazon to add a new release on MusicBrainz.	Amazon	Goram
	broken			dufferzafar
Import Bandcamp releases to MusicBrainz		Add a button on Bandcamp's album pages to open MusicBrainz release editor with pre-filled data for the selected release.	Bandcamp	murdos
Import Beatport releases to MusicBrainz		One-click importing of releases from beatport.com/release pages into MusicBrainz.	Beatport	VxJasonxV
Import Discogs releases to MusicBrainz		Add a button to import Discogs releases to MusicBrainz and add links to matching MusicBrainz entities for various Discogs entities (artist,release,master,label).	Discogs	murdos
Import Encyclopedisque releases to MusicBrainz		Easily import Encyclopedisque releases into MusicBrainz.	Encyclopedisque	murdos
Import events from Facebook	broken		Facebook	opatel99			N/A
Import Free Music Archive releases to MusicBrainz		Add a button to import https://freemusicarchive.org/ releases to MusicBrainz via API.	Free Music Archive	murdos
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		One-click importing of releases from junodownload.com/products pages into MusicBrainz.	Juno Download	murdos
Import Loot releases to MusicBrainz		Add a button to import Loot.co.za releases to MusicBrainz	Loot	murdos
Import Metal Archives releases into MusicBrainz		Add a button on Metal Archives release pages allowing to open MusicBrainz release editor with pre-filled data for the selected release.	Metal Archives	murdos
Import Naxos releases into MusicBrainz		Add a button to import Naxos Music Library releases to MusicBrainz	Naxos	loujine
Import Qobuz releases to MusicBrainz		Add a button on Qobuz's album pages to open MusicBrainz release editor with pre-filled data for the selected release.	Qobuz	murdos
Import T-Series releases to MusicBrainz		Import album data from T-Series's official website to add a new release on MusicBrainz.	T-Series	dufferzafar
Import Takealot releases to MusicBrainz		Add a button to import Takealot releases to MusicBrainz.	Takealot	murdos
Import VGMdb releases to MusicBrainz		One-click importing of releases from vgmdb.net into MusicBrainz.	VGMdb	murdos
Import from Music Forest		Import releases from Music Forest into MusicBrainz.	minc.or.jp	y-young
Import from THBWiki		Import releases from THBWiki into MusicBrainz.	THBWiki	y-young
Copy Tracklist from OTOTOY		Add a button on OTOTOY album pages to copy the tracklist.	OTOTOY	redbluescreen
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

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/, for one to import the release into MusicBrainz.	Bandcamp	murdos
Musicbrainz UI enhancements		Various UI enhancements for Musicbrainz.		murdos
Show discid count		Show discid number on main release pages.		loujine
Show alias count		Show alias number on work/artist pages.		loujine
Make columns sortable		Make table columns sortable.		loujine
Create artist from wikipedia data		Fill artist info from wikidata.		loujine
Elephant Editor		Remember last edit notes and dates.		jesus2099
Paste-A-Date!		This script 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		This makes it easier to cancel a large amount of edits on a page. Don't use this if you're prone to clicking pretty much anything by mistake.		bitmap
Expand/collapse release groups		See what's inside a release group without having to follow its URL. Also adds convenient edit links for it.		murdos
Auto-Focus + Keyboard-Select		MOUSE-LESS EDITING! Cleverly focuses fields in various musicbrainz edit pages and 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
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

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

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		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

Userscripts: Voting

Name	Status	Info	Site	Author	DL	Src	Bug
Power Vote		Adds some 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!		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 everywhere possible without cluttering the pages		jesus2099
Stig's Art Grabr		Grabbing big high resolution album cover-art from various sites	Various	StigNygaard
Image Max URL		Finds larger or original versions of images and videos for 7500+ 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

Userscripts: Other

Name	Status	Info	Site	Author	DL	Src	Bug
Colourful rainbow edit headers		This script 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
Musicbrainz DiscIds Detector		Generate MusicBrainz DiscIds from online EAC logs, and check existence in MusicBrainz database.		murdos

Further resources

• External Resources wiki page: External_Resources#User_scripts_.2F_GreaseMonkey_.2F_User_javascripts_.2F_UserJS
• Some user script repositories:
  • greasyfork.org’s MusicBrainz script set (automatically updated)
  • openuserJS.org’s musicbrainz group (manually updated, not always up to date)

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.