MusicBrainz Picard/Documentation: Difference between revisions
(s/analyzing/scanning (fingerprinting) (Imported from MoinMoin)) |
(Update this document to be current, even if incomplete (Imported from MoinMoin)) |
||
Line 1: | Line 1: | ||
<small>[[Products]] > [[Picard Tagger| Picard]] > Picard Documentation</small> |
<small>[[Products]] > [[Picard Tagger| Picard]] > Picard Documentation</small> |
||
<ul><li style="list-style-type:none">[[Image:Attention.png]] '''''Status:''' This page needs updating for the latest version of Picard.'' |
|||
</ul> |
|||
=Documentation for Picard= |
=Documentation for Picard= |
||
This page discusses |
This page discusses Picard 0.9.0+, the next generation [[Picard Tagger|PicardTagger]]. |
||
Line 11: | Line 9: | ||
==Quick start for the impatient== |
==Quick start for the impatient== |
||
⚫ | |||
⚫ | |||
We have a quick start guide that shows you [[How To Tag Files With Picard|HowToTagFilesWithPicard]]. |
|||
⚫ | |||
==Basic Picard Documentation== |
==Basic Picard Documentation== |
||
This tagger takes an album approach to tagging, whereas the old tagger required the user to work with one track at a time and check to see if the tagger correctly identified the track. The amount of time spent reviewing the old tagger's suggestions will probably equal the amount of work the user has to do to find the right albums in the new tagger. More details on this thought later -- first let's explain the basic new operations. |
This tagger takes an album approach to tagging, whereas the [[MusicBrainz Tagger| old tagger]] required the user to work with one track at a time and check to see if the tagger correctly identified the track. The amount of time spent reviewing the old tagger's suggestions will probably equal the amount of work the user has to do to find the right albums in the new tagger. More details on this thought later -- first let's explain the basic new operations. |
||
Start with opening individual music files or directories by dragging them into the |
Start with opening individual music files or directories by dragging them into the left-hand pane. The tagger will read the metadata from each of the files and unless they have been tagged before, the files will be deposited into the "Unmatched files" folder. Files that have been tagged before and contain the [[MusicBrainz]] track identifier will be opened up as releases in the right-hand pane. |
||
Once the tagger finishes processing the files, press the |
Once the tagger finishes processing the files, press the "Cluster" button (white square with 'clusters' on them). This will cause the tagger to attempt to group the files into album clusters by examining the metadata read from the files and clustering files that appear to belong to the same album. Files that are not matched into album clusters will remain in the "Unmatched files" folder. In future the tagger will automatically cluster the files when it has finished reading the metadata from the files. |
||
This is where the magic currently ends -- from now on you will need to look up album clusters or individual files by selecting the cluster or file and clicking on the |
This is where the magic currently ends -- from now on you will need to look up album clusters or individual files by selecting the cluster or file and clicking on the "Lookup" button. This will open a web browser window where you can browse/search for the appropriate album using the [[MusicBrainz]] web-site. Once you've found the right album, click on the 'tagger' icon in the album title: [[Image:mblookup-tagger.png]] . Once you click on this link, the tagger pops up and loads that album into the tagger. |
||
Now you can drag tracks from the " |
Now you can drag tracks from the "Unmatched files" folder or from the clusters onto tracks in albums. Dragging a file to an album 'tags' it to that album and you should see an icon in front of the track: |
||
* a green check mark indicates the track is up to date and saved. |
* a green check mark indicates the track is up to date and saved. |
||
* a small rectangle ranging from red to green indicates the quality of the match. red -> bad match, green -> good match |
* a small rectangle ranging from red to green indicates the quality of the match. red -> bad match, green -> good match |
||
Line 39: | Line 41: | ||
==Scanning (fingerprinting) files== |
==Scanning (fingerprinting) files== |
||
Instead of using the above release-oriented and metadata-dependent lookup; Picard can try and tag your files 1-by-1 based on their [[Audio Fingerprint|AudioFingerprint]]. If you select a set of files in the left-hand pane and click "Scan", Picard will calculate an [[Audio Fingerprint|AudioFingerprint]] for your files and query [[MusicBrainz]] to find a [[Track]] that matches the [[PUID]] located from this fingerprint. |
|||
Section needs to be written/expanded including intertwingling of these terms: [[How PUIDs Work|HowPUIDsWork]] and [[PUID]]s. |
|||
To learn about the process by which PUIDs are used by Picard to tag your files, read [[How PUIDs Work|HowPUIDsWork]]. |
|||
==Picard configuration and options== |
==Picard configuration and options== |
||
⚫ | |||
Here are instructions on the Picard [[Picard Documentation/Options| configuration and options]]. |
Here are instructions on the Picard [[Picard Documentation/Options| configuration and options]]. |
||
==File re-naming, scripting and customization== |
|||
⚫ | |||
It is possible to customize the way Picard operates on your audio files in several ways |
|||
Not yet -- but soon! Picard is actively developed: |
|||
* file renaming scripts - rename and reorganise your collection using a subset of the functions in [[Picard Scripting|PicardScripting]] alongside the metadata variables in [[Picard Tags|PicardTags]]. |
|||
* We are enhancing the UI to create an [[Intuitive Picard Interface|IntuitivePicardInterface]] (yes, we know the current one sucks). |
|||
* [[Picard Scripting| scripting]] - to change/customize the way Picard applies the [[MusicBrainz]] metadata to your files. |
|||
* Picard will soon get an automatic tagging algorithm called "Data" which should do large parts of the tagging proces for you. |
|||
* [[Picard Plugins| plugins]] - to encapsulate scripting, download cover art and add other functionality to Picard |
|||
* A [[Tagger Script|TaggerScript]] should allow Picard to tag files much more flexibly with data from [[Advanced Relationships|AdvancedRelationships]] |
|||
⚫ | |||
Probably, yes! - this documentation is unfortunately not complete. Please [http://wiki.musicbrainz.org/PicardDocumentation?action=edit help out]! In any case, Picard is actively developed. See [[Picard Development|PicardDevelopment]] for more information on the development process. |
|||
See [[Picard Development|PicardDevelopment]] for further details. |
|||
==More Information== |
==More Information== |
Revision as of 08:22, 1 August 2008
Products > Picard > Picard Documentation
Documentation for Picard
This page discusses Picard 0.9.0+, the next generation PicardTagger.
Quick start for the impatient
Before you can use it, you have to download Picard. See those instructions, and come back where when you have Picard downloaded and running.
We have a quick start guide that shows you HowToTagFilesWithPicard.
If you've never used Picard before, please read the guide or the remainder of the page for it to make sense to you!
Basic Picard Documentation
This tagger takes an album approach to tagging, whereas the old tagger required the user to work with one track at a time and check to see if the tagger correctly identified the track. The amount of time spent reviewing the old tagger's suggestions will probably equal the amount of work the user has to do to find the right albums in the new tagger. More details on this thought later -- first let's explain the basic new operations.
Start with opening individual music files or directories by dragging them into the left-hand pane. The tagger will read the metadata from each of the files and unless they have been tagged before, the files will be deposited into the "Unmatched files" folder. Files that have been tagged before and contain the MusicBrainz track identifier will be opened up as releases in the right-hand pane.
Once the tagger finishes processing the files, press the "Cluster" button (white square with 'clusters' on them). This will cause the tagger to attempt to group the files into album clusters by examining the metadata read from the files and clustering files that appear to belong to the same album. Files that are not matched into album clusters will remain in the "Unmatched files" folder. In future the tagger will automatically cluster the files when it has finished reading the metadata from the files.
This is where the magic currently ends -- from now on you will need to look up album clusters or individual files by selecting the cluster or file and clicking on the "Lookup" button. This will open a web browser window where you can browse/search for the appropriate album using the MusicBrainz web-site. Once you've found the right album, click on the 'tagger' icon in the album title: . Once you click on this link, the tagger pops up and loads that album into the tagger.
Now you can drag tracks from the "Unmatched files" folder or from the clusters onto tracks in albums. Dragging a file to an album 'tags' it to that album and you should see an icon in front of the track:
- a green check mark indicates the track is up to date and saved.
- a small rectangle ranging from red to green indicates the quality of the match. red -> bad match, green -> good match
- a blue ? indicates an unmatched file.
- a red error triangle means the file has an error. See the status bar in the bottom of the picard window to see the error.
- a red-and-white "No entry" sign means that Picard doesn't have permission to write to that file, so that it can't save any changes (to correct this, look into the permissions on the file system and directory holding the file)
- a musical note icon, or no icon, means that no file is associated with that track
You can also drag whole directories, multiple files or album clusters onto albums and the tagger will attempt to match the dragged files to the album. Any track that doesn't match up well enough, will be added to an "unmatched files" sub-folder specific to that album. You can drag files out of this folder and into the right slots in the album to fix up the files the tagger couldn't get right.
Once you've matched up your tracks to albums you can select a track or an album and click on the save button to save that track/album. Depending on your settings this may move the track to a new directory and/or rename the track according to its metadata. Take a look at the options dialog to fine tune your settings.
Once you've saved a file, or otherwise want to get rid of a track or album, select the track and click on the delete button in the toolbar.
Scanning (fingerprinting) files
Instead of using the above release-oriented and metadata-dependent lookup; Picard can try and tag your files 1-by-1 based on their AudioFingerprint. If you select a set of files in the left-hand pane and click "Scan", Picard will calculate an AudioFingerprint for your files and query MusicBrainz to find a Track that matches the PUID located from this fingerprint.
To learn about the process by which PUIDs are used by Picard to tag your files, read HowPUIDsWork.
Picard configuration and options
Here are instructions on the Picard configuration and options.
File re-naming, scripting and customization
It is possible to customize the way Picard operates on your audio files in several ways
- file renaming scripts - rename and reorganise your collection using a subset of the functions in PicardScripting alongside the metadata variables in PicardTags.
- scripting - to change/customize the way Picard applies the MusicBrainz metadata to your files.
- plugins - to encapsulate scripting, download cover art and add other functionality to Picard
Isn't there more to Picard?
Probably, yes! - this documentation is unfortunately not complete. Please help out! In any case, Picard is actively developed. See PicardDevelopment for more information on the development process.
More Information
You should checkfor a list of all pages that deal with Picard.