MusicBrainz Picard/Plugins: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(manually redirecting anyone naughtily linking to the wiki instead of /doc/)
 
(108 intermediate revisions by 42 users not shown)
Line 1: Line 1:
#REDIRECT [[MusicBrainz Picard]]
There are many plugins available for Picard. A number of these are written by the Picard developers, however many are written by users and enthusiasts. If you are having issues with a plugin, please check the [http://forums.musicbrainz.org/ forums] for answers and ask any questions.

==Installation==
To install a plugin:
# download .py file(s)
# create a 'plugins' directory (if not existing already) under
## Windows: either <code><nowiki>C:\Program Files\Musicbrainz Picard\plugins</nowiki></code> (for default Picard application folder) or <code><nowiki>%APPDATA%\MusicBrainz\Picard\plugins</nowiki></code>
## *Nix: either Picard application directory/plugins or <code><nowiki>~/.config/MusicBrainz/Picard/plugins</nowiki></code>
## OSX: Follow These Steps:
### Open a Terminal (can be found in: <code><nowiki>Applications/Utilities/Terminal</nowiki></code>)
### type <code><nowiki>mkdir -p $HOME/.config/MusicBrainz/Picard/plugins</nowiki></code> (needs to be done only once)
### type <code><nowiki>open $HOME/.config/MusicBrainz/Picard/plugins</nowiki></code> to display the folder in finder. Now move the plugins there.
## Please note that some plugins need to be placed inside a separate subdirectory specific to the plugin. See the 'Notes' column below to see if this is required for the particular plugin you are installing.
# Move downloaded .py file(s) to 'plugins' directory
# Enable the plugin. Check the box beside the individual plugin in the plugins menu, which can be found at
## Windows/*Nix: Options Menu >> Options... >> Plugins
## OSX: MusicBrainz Picard >> Preferences >> Plugins

==Plugins==

{| border="0"
|-
| '''Name''' || '''Description''' || '''Author''' || '''Compatibility''' || '''Adds Context Menu Item?''' || '''Download''' || '''Known issues/Notes'''
|-
| ''' Disc Numbers''' || Moves ''(disc X)'' from releases titles into separate tags (''discnumber'' and ''discsubtitle''). || [[User:LukasLalinsky|Lukáš Lalinský]] || 0.9a - 0.12 || No || [http://users.musicbrainz.org/~luks/picard-qt/plugins/discnumber.py here] || -
|-
| '''Feat. Artists''' || Removes ''(feat. Artist)'' parts from track titles. || [[User:LukasLalinsky|Lukáš Lalinský]] || 0.9a - 0.12 || No || [http://users.musicbrainz.org/~luks/picard-qt/plugins/featartist.py here] || -
|-
| '''Title Case''' || Converts track and release titles to Title Case (capitalizes first character of every word) || Javier Kohen, [[User:LukasLalinsky|Lukáš Lalinský]] || 0.9a - 0.12 || No || [http://oxygene.sk/lukas/titlecase.py here] || -
|-
| '''Cover Art Downloader''' || Downloads cover art for optional tag embedding and/or saving as a separate image file (using standard Options >> Cover Art Picard settings) || [[User:OliverCharles|Oliver Charles]], [[User:OutsideContext|Philipp Wolfer]] || 0.12 || No || [http://users.musicbrainz.org/~outsidecontext/picard/plugins/coverart.py here] || See [[Ticket:3528|3528]] [[Ticket:5715|5715]]
|-
| '''Last.fm Tags''' || Use Last.fm tags as "genre" || [[User:LukasLalinsky|Lukáš Lalinský]] || 0.9a - 0.12 || No || [http://users.musicbrainz.org/~luks/picard-qt/plugins/lastfm/__init__.py 1] [http://users.musicbrainz.org/~luks/picard-qt/plugins/lastfm/ui_options_lastfm.py 2] || ''(copy both files to directory <code><nowiki>plugins/lastfm/</nowiki></code>)''
|-
| '''Last.fm Plus''' || Use Last.fm tags as "genre/moods/occasions/countries/originalyear" and more. Modified version of above plugin. || [[User:RifRaf|RifRaf]] || 0.9a - 0.11 || No || [http://tiptoes.hobby-site.com/mbz/lastfm/lastfmplus.zip here] || ''(copy both files to directory <code><nowiki>plugins/lastfmplus/</nowiki></code>)'' [http://tiptoes.hobby-site.com/mbz/lastfm/lastfmplus.html Tutorial], [http://forums.musicbrainz.org/viewtopic.php?id=1795 forum thread]
|-
| '''Add Cluster As A Release''' || Adds right click option to an unmatched cluster to allow adding releases to MB based on tags. || [[User:LukasLalinsky|Lukáš Lalinský]] || 0.9a - 0.12 || Yes || [http://users.musicbrainz.org/~luks/picard-qt/plugins/addrelease.py here] || See [[Ticket:2544|2544]], [http://forums.musicbrainz.org/viewtopic.php?pid=5825#p5825 *You cannot add a release to the 'Deleted Artist'.* workaround]
|-
| '''Generate Cuesheet''' || Generates a cuesheet from a release || [[User:LukasLalinsky|Lukáš Lalinský]] || 0.10 - 0.12 || Yes || [http://users.musicbrainz.org/~luks/picard-qt/plugins/cuesheet.py here] || -
|-
| ''' Bonus Disc''' || Moves ''(bonus disc: Bonus Disc Title)'' from album titles to separate tags. (''bonusdisc'' and ''bonusdisctitle'') || [[User:Zout|Jan van Thiel]] || 0.9a - 0.11 || No || [http://dispuutivv.nl/~jan/bonusdisc.py here] || -
|-
| '''Release Type''' || Appends information to EPs and Singles such as " EP" or " (single)" (customisable, see file for details). Useful for separating releases with singles/EPs of the same name. || [[User:chancey|Elliot Chance]] || 0.9a - 0.9.0 || No || [http://sumafi.com/files/release_type.py here] || -
|-
| rowspan="10" | '''Search Plugins''' || rowspan="10" | Launches searches for clusters or releases to external non-MB websites from Picard || rowspan="10" | [[User:BrianFreud| Brian Schweitzer]] || rowspan="10" | 0.9a - 0.10+ || rowspan="10" | Yes || [http://users.musicbrainz.org/~brianfreud/SearchAMG.py All Music Guide] || -
|-
| [http://users.musicbrainz.org/~brianfreud/SearchAmazon3.py Amazon] || Supports: .ca, .com, .de, .fr, .jp, and .co.uk
|-
| [http://users.musicbrainz.org/~brianfreud/SearchCastAlbums3.py CastAlbums.org] || (Musicals)
|-
| [http://users.musicbrainz.org/~brianfreud/SearchDiscogs3.py Discogs] || -
|-
| [http://users.musicbrainz.org/~brianfreud/SearchFilmMusziek3.py FilmMusziek.be] || ("Film Music Search")
|-
| [http://users.musicbrainz.org/~brianfreud/SearchGMR.py Game Music Revolution] || (Game Soundtracks)
|-
| [http://users.musicbrainz.org/~brianfreud/SearchGoogle3.py Google] || -
|-
| [http://users.musicbrainz.org/~brianfreud/SearchLortelArchives3.py The Lortel Archives] || (Off-Broadway Musicals)
|-
| [http://users.musicbrainz.org/~brianfreud/SearchSoundtrackCollector3.py SoundtrackCollector.org] || (Soundtracks)
|-
| [http://users.musicbrainz.org/~brianfreud/SearchSoundtrackINFO3.py SoundtrackINFO] || (Soundtracks)
|-
| '''Change Encoding''' || Converts the tags of individual files or clusters between different character encodings. This is often necessary with files that have only ID3v1 tags in a non-Latin encoding. || [[User:foolip|Philip Jägenstedt]] || 0.9a - 0.12 || Yes || [http://foolip.org/mb/encoding.py here] || You will probably only need to change the ''target'' encoding. If the encoding you're looking for isn't in the list, you can type it in yourself and it will hopefully work.
|-
| '''Original Release Date''' || Set the original release date of a release by using the release events and "earliest release" advanced relationships. || [[User:OutsideContext|Philipp Wolfer]] || 0.12 || No || [http://users.musicbrainz.org/~outsidecontext/picard/plugins/originalreleasedate.py here] ||
|-
| '''Title sort names''' || Guess sortnames for track and album titles and adds as titlesort and albumsort tags. || [[User:Creap|Creap]] || 0.12 || No || [http://github.com/Creap/Picard-Plugins/raw/master/titlesort.py here] || Checks language (English, Spanish, German, French, Swedish and Multiple) and moves articles ("The", "Das", etc) to the end of the track/album title in the sort tags. The title (TIT2 in id3v2) tag is left alone.
|-
| '''Title version''' || Moves song metadata such as "demo", "live" from titlesort to version tag. || [[User:Creap|Creap]] || 0.12 || No || [http://github.com/Creap/Picard-Plugins/raw/master/titleversion.py here] || Searches titles for keywords like ''live'', ''demo'', ''mix'', etc, and moves it from titles to version tags.
|-
| '''$swapprefix function''' || Adds the $swapprefix(text, *prefixes) script function, which moves the specified prefixes to the end of the text. || [[User:OutsideContext|Philipp Wolfer]] || 0.9a - 0.12 || No || [http://users.musicbrainz.org/~outsidecontext/picard/plugins/swapprefix.py here] || See this [http://forums.musicbrainz.org/viewtopic.php?id=2220 forum post] for details.
|-
| '''Lookup PUID''' || Adds the ability to lookup the PUID on MusicBrainz (useful in case there are several tracks linked with the same PUID) || WPME Hofland || 0.9a - 0.12 (tested only with 0.12!) || Yes || [http://www.merijnhofland.info/mb/searchpuid.py here] ||
|}



=== Context Menu Items ===
Note that not all plugins will add options to the "Plugins" section of the right click context menu you get on tracks, files and clusters. Plugins in the above list that do not add a context menu item should work automatically on all new metadata that is loaded into the right-hand pane, once they are enabled in the options.

[[Category:MusicBrainz Picard]][[Category:WikiDocs Page]]

Latest revision as of 21:16, 25 November 2014

Redirect to: