Difference between revisions of "Guides/Userscripts"

From MusicBrainz Wiki
(Introduction: Add link to "how to install userscripts" DDG search.)
 
(19 intermediate revisions by 9 users not shown)
Line 1: Line 1:
==Introduction==
+
Userscripts run in the web browser and make on-the-fly local changes to specific web pages. They generally change MusicBrainz pages to facilitate editing.
Userscripts are [[wikipedia:Greasemonkey|Greasemonkey]] scripts that run in the web browser, making on-the-fly local changes to specific web pages. In this context, they generally augment MusicBrainz pages and/or facilitate editing. You will need to [https://duckduckgo.com/?q=how+to+install+userscripts install the scripts] to your browser before they will work.
+
 
 +
{{note}} 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.
 +
 
 +
== Userscript manager ==
 +
To run userscripts, you need to install userscripts and an in-browser userscript manager to run them. Although Chrome/Chromium can run userscripts without installing a userscript manager extension, many userscripts will not work properly. It is recommended that you install a userscript manager.
 +
 
 +
{| class="wikitable" align="center" style="text-align:center;"
 +
|+ Userscript Manager Browser Compatibility
 +
! !! Chrome/<br/>Chromium !! Firefox !! Opera !! Safari
 +
|-
 +
! scope="row" | [https://www.greasespot.net/ Greasemonkey]
 +
| ✗
 +
| [https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/ ✓]
 +
| ✗
 +
| ?
 +
|-
 +
! scope="row" | [https://violentmonkey.github.io/ Violentmonkey]
 +
| [https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag ✓]
 +
| [https://addons.mozilla.org/en-US/firefox/addon/violentmonkey/ ✓]
 +
| ✓
 +
| ?
 +
|-
 +
! scope="row" | [https://www.tampermonkey.net/ Tampermonkey]<br/>(proprietary)
 +
| [https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo ✓]
 +
| [https://addons.mozilla.org/en-US/firefox/addon/tampermonkey/ ✓]
 +
| ✓
 +
| [https://www.tampermonkey.net/?browser=safari ✓]
 +
|}
  
 
==Critical==
 
==Critical==
 
Could not edit MB without these:
 
Could not edit MB without these:
; [http://userscripts.org/scripts/show/81127 mb. INLINE STUFF]: musicbrainz.org release page: Inline recording names, comments, ISRC, PUID and AcoustID. Highlights duplicates in releases and edits.
+
; [https://community.metabrainz.org/t/320907 mb. INLINE STUFF]: musicbrainz.org release page: Inline recording names, comments, ISRC and AcoustID. Displays CAA count and add link if none. Highlights duplicates in releases and edits.
  
 
==Very useful==
 
==Very useful==
 
These make MB much easier to edit
 
These make MB much easier to edit
; [http://userscripts.org/scripts/show/57765 mb. POWER VOTE 1.0]: 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).
+
; [https://github.com/jesus2099/konami-command/blob/master/mb_POWER-VOTE.user.js mb. 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).
; mb. FUNKEY ILLUSTRATED RECORDS 1.0: musicbrainz.org: CAA front cover art archive pictures/images (release groups and releases) Big illustrated discography and/or inline everywhere possible without cluttering the pages
+
; [https://community.metabrainz.org/t/180558/9 mb. FUNKEY ILLUSTRATED RECORDS]: musicbrainz.org: CAA front cover art archive pictures/images (release groups and releases) Big illustrated discography and/or inline everywhere possible without cluttering the pages
 
; mb. TAGGER LINKS NOW 2012.1106.2230: musicbrainz.org: Quickly show or update "TAGGER" links with desired port
 
; mb. TAGGER LINKS NOW 2012.1106.2230: musicbrainz.org: Quickly show or update "TAGGER" links with desired port
 
; MusicBrainz - Colourful edits 1.0: A script to add colour to the edit headers in the edit search results.
 
; MusicBrainz - Colourful edits 1.0: A script to add colour to the edit headers in the edit search results.
; mb. MASS MERGE RECORDINGS: Merges selected or all recordings from tracklist/release A to tracklist/release B in *.musicbrainz.org
+
; [https://community.metabrainz.org/t/203168 mb. MASS MERGE RECORDINGS]: Merges selected or all recordings from tracklist/release A to tracklist/release B in *.musicbrainz.org
; [http://userscripts.org/scripts/show/121217 MusicBrainz: 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.
+
; [https://gist.github.com/JesseWeinstein/368bddf748f4faf44b5775addf7f3db0 MusicBrainz: 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.
  
 
==Handy to have==
 
==Handy to have==
Line 22: Line 49:
  
 
==Occasionally helpful==
 
==Occasionally helpful==
; Extra MusicBrainz/AcoustID integration 1.0: Display additional AcoustID data on MusicBrainz ''mostly icons on tracks which have acoustIDs. Would be better if it did this anywhere a recording appeared, and maybe indicated how many acoustIDs there were.
+
; Extra MusicBrainz/AcoustID integration 1.0: Display additional [[AcoustID]] data on MusicBrainz ''mostly icons on tracks which have AcoustIDs. Would be better if it did this anywhere a recording appeared, and maybe indicated how many AcoustIDs there were.''
; MusicBrainz Fast cancel edits: ''Makes canceling edits much less painful, no need to go to a new page and enter a comment for each one.''
+
; [https://github.com/murdos/musicbrainz-userscripts#fast-cancel-edits MusicBrainz Fast cancel edits]: ''Makes canceling edits much less painful, no need to go to a new page and enter a comment for each one.''
  
 
==Importers==
 
==Importers==
Line 37: Line 64:
 
; CD1D : [https://github.com/murdos/musicbrainz-userscripts#cd1d_importer Import CD1D releases to MusicBrainz]
 
; CD1D : [https://github.com/murdos/musicbrainz-userscripts#cd1d_importer Import CD1D releases to MusicBrainz]
 
; CD Baby : [https://github.com/murdos/musicbrainz-userscripts#cdbaby_importer Import CD Baby releases to MusicBrainz]
 
; CD Baby : [https://github.com/murdos/musicbrainz-userscripts#cdbaby_importer Import CD Baby releases to MusicBrainz]
 +
; DG/Decca :  [https://bitbucket.org/loujine/musicbrainz-scripts/raw/default/mbz-dgdecca_importer.user.js  Import DG / Decca releases to MusicBrainz]
 
; Discogs : [https://github.com/murdos/musicbrainz-userscripts#discogs_importer Import Discogs releases to MusicBrainz]
 
; Discogs : [https://github.com/murdos/musicbrainz-userscripts#discogs_importer Import Discogs releases to MusicBrainz]
 
; Encyclopedisque : [https://github.com/murdos/musicbrainz-userscripts#encyclopedisque_importer Import Encyclopedisque releases to MusicBrainz]
 
; Encyclopedisque : [https://github.com/murdos/musicbrainz-userscripts#encyclopedisque_importer Import Encyclopedisque releases to MusicBrainz]
; iTunes : [https://bitbucket.org/96187/userscripts/src/master/itunes-importer/ MusicBrainz: Import from iTunes]
+
; Facebook : [https://gist.github.com/opatel99/3537237628abce4da2a3 MusicBrainz: Import events from Facebook]
 +
; iTunes : MusicBrainz: Import from iTunes [https://bitbucket.org/96187/userscripts/src/master/itunes-importer/ original version] / [https://github.com/dufferzafar/Userscripts/blob/master/MB-Import-From-iTunes.user.js updated version]
 
; Juno Download : [https://github.com/murdos/musicbrainz-userscripts#juno_download_importer Import Juno Download releases to MusicBrainz]
 
; Juno Download : [https://github.com/murdos/musicbrainz-userscripts#juno_download_importer Import Juno Download releases to MusicBrainz]
 
; Last.fm : [https://github.com/murdos/musicbrainz-userscripts#lastfm_importer Import Last.fm releases to MusicBrainz]
 
; Last.fm : [https://github.com/murdos/musicbrainz-userscripts#lastfm_importer Import Last.fm releases to MusicBrainz]
 
; Loot : [https://github.com/murdos/musicbrainz-userscripts#loot_importer Import Loot.co.za releases to MusicBrainz]
 
; Loot : [https://github.com/murdos/musicbrainz-userscripts#loot_importer Import Loot.co.za releases to MusicBrainz]
 
; Metal Archives : [https://github.com/murdos/musicbrainz-userscripts#metalarchives_importer Import Metal Archives releases to MusicBrainz]
 
; Metal Archives : [https://github.com/murdos/musicbrainz-userscripts#metalarchives_importer Import Metal Archives releases to MusicBrainz]
 +
; Naxos : [https://bitbucket.org/loujine/musicbrainz-scripts/raw/default/mbz-naxos_library_importer.user.js Import Naxos Music Library releases to MusicBrainz]
 
; Qobuz : [https://github.com/murdos/musicbrainz-userscripts#qobuz_importer Import Qobuz releases to MusicBrainz]
 
; Qobuz : [https://github.com/murdos/musicbrainz-userscripts#qobuz_importer Import Qobuz releases to MusicBrainz]
 
; TakeAlot : [https://github.com/murdos/musicbrainz-userscripts#takealot_importer Import Takealot releases to MusicBrainz]
 
; TakeAlot : [https://github.com/murdos/musicbrainz-userscripts#takealot_importer Import Takealot releases to MusicBrainz]
Line 50: Line 80:
  
 
==Further Reading==
 
==Further Reading==
* [http://www.greasespot.net/ Greasemonkey]
+
* [[External_Resources#User_scripts_.2F_GreaseMonkey_.2F_User_javascripts_.2F_UserJS]]
* [http://tampermonkey.net/ Tampermonkey]
 
* [[External_Resources]]
 

Latest revision as of 08:21, 20 May 2020

Userscripts run in the web browser and make on-the-fly local changes to specific web pages. They generally change MusicBrainz pages to facilitate editing.

Note Note: 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.

Userscript manager

To run userscripts, you need to install userscripts and an in-browser userscript manager to run them. Although Chrome/Chromium can run userscripts without installing a userscript manager extension, many userscripts will not work properly. It is recommended that you install a userscript manager.

Userscript Manager Browser Compatibility
Chrome/
Chromium
Firefox Opera Safari
Greasemonkey ?
Violentmonkey ?
Tampermonkey
(proprietary)

Critical

Could not edit MB without these:

mb. INLINE STUFF
musicbrainz.org release page: Inline recording names, comments, ISRC and AcoustID. Displays CAA count and add link if none. Highlights duplicates in releases and edits.

Very useful

These make MB much easier to edit

mb. 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).
mb. FUNKEY ILLUSTRATED RECORDS
musicbrainz.org: CAA front cover art archive pictures/images (release groups and releases) Big illustrated discography and/or inline everywhere possible without cluttering the pages
mb. TAGGER LINKS NOW 2012.1106.2230
musicbrainz.org: Quickly show or update "TAGGER" links with desired port
MusicBrainz - Colourful edits 1.0
A script to add colour to the edit headers in the edit search results.
mb. MASS MERGE RECORDINGS
Merges selected or all recordings from tracklist/release A to tracklist/release B in *.musicbrainz.org
MusicBrainz: 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.

Handy to have

MusicBrainz - Batch-add composer/lyricist/librettist/arranger/orchestrator/publisher/part-of relationships 1.0
Create various relationships between an artist and the selected works or "part of" relationships between a main work and selected works from an artist's works list. Based on bitmap's 'Batch-add "performance of" relationships' userscript.
MusicBrainz Relate recordings to works from a release
the predecessor to the relationship editor, just does the works side of it. Has nicer date editing than the rel. editor.
MusicBrainz - Link work to recordings 1.0
MusicBrainz : Batch linking a work to recordings


Occasionally helpful

Extra MusicBrainz/AcoustID integration 1.0
Display additional AcoustID data on MusicBrainz mostly icons on tracks which have AcoustIDs. Would be better if it did this anywhere a recording appeared, and maybe indicated how many AcoustIDs there were.
MusicBrainz Fast cancel edits
Makes canceling edits much less painful, no need to go to a new page and enter a comment for each one.

Importers

These are useful for importing data from various sites semi-automatically into MusicBrainz.

Note: The importers generally function by placing a button of some sort on pages of the site they're made to import from. Clicking that button should open up MusicBrainz.
Amazon
Import releases from Amazon
Bandcamp
Import Bandcamp releases to MusicBrainz
Import Bandcamp releases to MusicBrainz Album Link Helper
Beatport
Import Beatport releases to MusicBrainz
Import Beatport Pro releases to MusicBrainz
CD1D 
Import CD1D releases to MusicBrainz
CD Baby 
Import CD Baby releases to MusicBrainz
DG/Decca 
Import DG / Decca releases to MusicBrainz
Discogs 
Import Discogs releases to MusicBrainz
Encyclopedisque 
Import Encyclopedisque releases to MusicBrainz
Facebook 
MusicBrainz: Import events from Facebook
iTunes 
MusicBrainz: Import from iTunes original version / updated version
Juno Download 
Import Juno Download releases to MusicBrainz
Last.fm 
Import Last.fm releases to MusicBrainz
Loot 
Import Loot.co.za releases to MusicBrainz
Metal Archives 
Import Metal Archives releases to MusicBrainz
Naxos 
Import Naxos Music Library releases to MusicBrainz
Qobuz 
Import Qobuz releases to MusicBrainz
TakeAlot 
Import Takealot releases to MusicBrainz
Vimeo 
MusicBrainz: Import videos from Vimeo
YouTube 
MusicBrainz: Import videos from YouTube

Further Reading