Guides/Userscripts
From MusicBrainz Wiki
(Redirected from User scripts)
Jump to navigationJump to searchUserscripts 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.
| 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 | 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 | Import album data from junodownload.com/products to add a new release on MusicBrainz. | Juno Download | murdos |
|
|
| |
| Import Loot releases to MusicBrainz | Import album data from Loot.co.za to add a new release on MusicBrainz. | Loot | murdos |
|
|
| |
| Import Metal Archives releases to MusicBrainz | Import album data from Metal Archives to add a new release on MusicBrainz. | Metal Archives | murdos |
|
|
| |
| 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 | murdos |
|
|
| |
| 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 | murdos |
|
|
| |
| Import VGMdb releases to MusicBrainz | Import album data from VGMdb to add a new release on MusicBrainz. | VGMdb | murdos |
|
|
| |
| 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 |
|
|
| |
| 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 |
|
|
| |
| 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 |
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 | 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 | |
| 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 | 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. | murdos |
|
|
| ||
| 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 |
|
|
| ||
| 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 | Aurelien Mino |
|
|
|
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. | murdos |
|
|
|
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 |
|
|
| ||
| 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. | murdos |
|
|
|
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) | murdos |
|
|
| ||
| 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: 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 |
|
|
| ||
| 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 |
|
|
| |
| Musicbrainz DiscIds Detector | broken? | Generate MusicBrainz DiscIds from online EAC logs, and check existence in MusicBrainz database. | murdos |
|
|
N/A |
Writing userscripts
You can use Kellnerd's userscript-bundler as a starting point for new userscripts: https://github.com/kellnerd/userscript-bundler
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 | Bug |
|---|---|---|---|---|
| MetaBrainz All Projects Dark | A dark theme for MetaBrainz project sites. | beckfield |
|
|
| MusicBrainz Nord Dark | A dark theme for MusicBrainz, based on the Nord palette. | shard |
|
N/A |
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.
