Picard Documentation/Options/File Naming: Difference between revisions
From MusicBrainz Wiki
Jump to navigationJump to search
(some fixes (Imported from MoinMoin)) |
(Redirected page to MusicBrainz Picard) |
||
| (8 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
#REDIRECT [[MusicBrainz Picard]] |
|||
<small>[[Products]] > [[Picard Tagger| Picard]] > [[Picard Documentation]] > [[Picard Documentation/Options|Options]] > File Naming </small> |
|||
''This page describes [[Picard Qt|PicardQt]] version 0.9.0 beta 1.'' |
|||
=File Naming= |
|||
The File Naming pane has three parts: from top to bottom, '''Rename Files''', '''Move Files''', and '''Example'''. |
|||
==Rename Files== |
|||
The '''Rename Files''' checkbox tells Picard whether it should change file and directory names of your audio files when it saves metadata in them, in order to make the file and directory names consistent with the new metadata. Check this box if you want it to do this renaming. Uncheck the box if you want Picard to leave the file and directory names unchanged. |
|||
===File naming format=== |
|||
The "file naming format" consists of an edit box containing a formatting string, and a '''Default''' button. This formatting string tells Picard what the new name of the file and its containing directories should be, in terms of various metadata values. This first edit box applies to tracks from Releases that MusicBrainz lists as a "single artist" release. |
|||
The formatting string is in [[Picard Scripting|Picard's scripting language]]. Names in "%" signs are [[Picard Tag Mapping|Picard's tag names]]. See those articles for further information. |
|||
Note that the use of a "/" in the formatting string means that everything before the string is a directory name, and everything after the last "/" becomes the audio file's track name. It is allowed to have no "/", or one, or multiple, in the formatting string. |
|||
The default value for the formatting string is: '''$if2(%albumartist%,%artist%)/%album%/$num(%tracknumber%,2) %title%''' |
|||
Press the '''Default''' button to replace whatever is presently in the text box by the default value. This is helpful if you get the string messed up and want to start over. |
|||
===Multiple artist file naming format=== |
|||
The "multiple artist file naming format" behaves the same way as the "File naming format" above, except that it applies to tracks from Releases that MusicBrainz lists as a "[[Multiple Artist|multiple artist]]" release. |
|||
The formatting string language and tag names are the same as above. So is the effect of the '''Default''' button. |
|||
The default value for the formatting string is: '''$if2(%albumartist%,%artist%)/%album%/$num(%tracknumber%,2) %artist% - %title%''' |
|||
===Character conversion options=== |
|||
File names and directory names are not allowed by the computer's operating system to have certain characters. Picard can modify the file and directory names it generates from the formatting strings, to honor those restrictions. The check boxes here let you control this. |
|||
* '''Replace Windows-incompatible characters''': check this if you want Picard to replace any characters that Windows restricts with legible equivalents. In most cases it's better to leave this checked. Uncheck it if you are confident that the Windows restrictions won't be an issue, and if the details of your file name strings are important to you. [''Not clear exactly what characters get changed to what. --ed.''] |
|||
<ul><li style="list-style-type:none">Windows-incompatable characters are \/:?*<>| anywhere in the file or directory name, as well as any file or directory name with initial . -- [[Brian Schweitzer|BrianSchweitzer]] 17:35, 09 December 2007 (UTC) |
|||
</ul> |
|||
* '''Replace non-ASCII characters''': check this box if you want Picard to replace any characters that are outside the [http://en.wikipedia.org/wiki/ASCII ASCII] set, i.e. the unaccented letters A-Z, a-z, numbers, and some simple punctuation, with equivalents inside the ASCII set. If you are tagging audio files by artists with names in languages different from your operating system's main language, then it may be helpful to set this checkbox. For instance, if the artist names are in Japanese, but your computer's menus and dialog boxes are in French, it is possible that you won't be able to use Japanese characters in file names. If this is the case, check this option. If all your metadata is in either ASCII characters or in your operating system's main language, it is probably safe to leave this option unchecked. This lets the file names reflect the proper spelling of the artist and release names. [''Not clear exactly what characters get changed to what. --ed.''] |
|||
==Move Files== |
|||
The '''Move Files''' checkbox tells Picard whether it should move your audio files to a new directory when it saves metadata in them. One use for this is to keep your work organised: all untagged files are under directory A, and when Picard tags them it moves them to directory B. When directory A is empty, your tagging work is done. Check this box, and select a destination directory, if you want Picard to move files this way. Uncheck the box if you want Picard to leave the files under the same directory. |
|||
The '''Rename Files''' and '''Move Files''' options are independent. Rename Files refers to file names, and directory names based on artist and release names, under a parent directory. Move Files refers to changing the parent directory. |
|||
===Move tagged files to this directory=== |
|||
This consists of an edit box containing the path name of the destination parent directory, and a '''Browse...''' button. |
|||
Push the Browse... button. A file open dialog box appears. Navigate through your files until the directory you want to be the new parent directory is at the ''top'' of the dialog box, and what you see inside the dialog box is the present ''contents'' of the parent directory. (An easy mistake is stop when you see the directory you want in the contents of the dialog box; this sets the parent directory to be one level higher than you intended.) Click the '''Choose''' button in the lower right to accept this parent directory. Click the '''Cancel''' button to return to the Options dialog with no change. |
|||
In the edit box, look at the path name listed, and be sure it is what you intend. You can also type the path name into the box yourself. |
|||
Examples of possible path names: |
|||
* on Linux, "/home/tanaka/Music/tagged" |
|||
* on Windows, "C:\My Music\tagged" |
|||
===Move additional files=== |
|||
Check the "Move additional files:" checkbox if you want Picard to look for other files in the same directory as the audio files and move them to under the new parent directory. Leave this unchecked if you want Picard to move only the audio files it is tagging, not any others. |
|||
In the edit box, put wildcard patterns which match the other files you want Picard to move. In a wildcard, "*" matches zero or more characters. Other text, like ".jpg", matches those exact characters. Thus "*.jpg" matches "cover.jpg" and "liner.jpg" and "a.jpg" and ".jpg", but not "nomatch.jpg2" Put spaces between wildcard patterns. ''[Not clear what the rest of the wildcard rules are. How to escape blanks? -- ed.''] |
|||
The default value for the wildcard patterns is: '''*.jpg *.png''' . This has the effect of moving any artwork files in the directory. Consider adding *.log if you are generating log files, or *.cue if you are generating [http://en.wikipedia.org/wiki/Cue_sheet_(computing) cue sheets]. |
|||
Check the "Delete empty directories" checkbox if you want Picard to delete any Artist and Release origin directories which are empty after doing the move operation. Leave the box unchecked if you want Picard to leave the directory structure unchanged. Checking this box may be convenient if you are using the move files option to organise your work. An empty directory has no more work for you to do, and deleting the directory makes that clear. |
|||
''Ed. note: not clear which directories searches for files to move. Just the origin parent directory? Just the Release directory with the audio files? The intervening Artist directory? All three?'' |
|||
''Ed. note: Not clear where the files get moved to in the destination directory: directly in the parent directory, or further down in the Artist or Release directory.'' |
|||
''Ed. note: Not clear if the edit box can contain ".." to indicate files pulled from higher directories than source directory.'' |
|||
==Example== |
|||
The bottom section of the Options dialog, labelled '''Example''', gives you a way to check the "File naming format" patterns you specified at the top of the dialog. |
|||
Push the '''Preview''' button. A path name appears under "File name", showing where a particular single-artist audio file would end up if both the "Rename files" and "Move files" options were applied. Similarly, a path name appears under "Multiple artist file name", showing where a particular multiple-artist audio file would end up. |
|||
Previewing the example is purely for your own double-checking; it doesn't affect how Picard behaves. [''That is a guess, not confirmed. --Ed''] |
|||
=Discussion= |
|||
''You are welcome to make changes right in the text above. It is a wiki, after all. However, you can also add points for discussion in this section. Please put your wiki name and the current date after your discussion entry.'' -- [[User:JimDeLaHunt|JimDeLaHunt]] 2007-12-05 |
|||
[[Category:To Be Reviewed]] |
|||
Latest revision as of 22:51, 20 May 2015
Redirect to:
