diff options
| author |  Alex Bennee <alex@bennee.com> | 2010-07-14 15:57:06 +0100 |
|---|---|---|
| committer | Alex Bennee <alex@bennee.com> | 2010-07-14 15:57:06 +0100 |
| commit | ba15707b292d827bdce732e7713b26fae3f75c74 (patch) | |
| tree | 8159d5daa4588ade1e71b9cb8541d6438c6b80c6 /doc | |
EasyTag 2.1.1
Diffstat (limited to 'doc')
72 files changed, 5617 insertions, 0 deletions
diff --git a/doc/EasyTAG_Documentation.html b/doc/EasyTAG_Documentation.html new file mode 100755 index 0000000..300421b --- /dev/null +++ b/doc/EasyTAG_Documentation.html @@ -0,0 +1,612 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+ <title>Documentation for EasyTAG</title>
+ <style>
+ <!--
+ body {
+ font-family: Arial, Helvetica, sans-serif;
+ margin: 10;
+ padding: 0;
+ color: #000000;
+ background-color: #FDFDE7;
+ font-size: 1em;
+ }
+ p {
+ text-align: justify;
+ text-indent: 2em;
+ }
+ #contents {
+ font-size: 1.5em;
+ color: blue;
+ }
+
+ h1 {
+ text-align: center;
+ border-top: 1px solid #CCCCCC;
+ border-bottom: 1px solid #CCCCCC;
+ border-left: 1px solid #CCCCCC;
+ border-right: 1px solid #CCCCCC;
+ color: blue;
+ }
+ h2 {
+ font-size: 2em;
+ text-decoration: underline;
+ text-indent: 0pt;
+ margin-top: 1em;
+ color: blue;
+ }
+ h3, h4 {
+ text-decoration: underline;
+ margin-top: 1em;
+ color: blue;
+ }
+ li {
+ list-style-type: circle;
+ text-indent: 2em;
+ }
+ .example-text {
+ font-family: "Courier New", Courier, mono;
+ }
+ .question-text {
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-style: italic;
+ padding-top: 1em;
+ color: #666666;
+ }
+ table {
+ border: 1px solid #666666;
+ margin: 0px;
+ padding: 0px;
+ }
+ th {
+ background-color: #CCCCCC;
+ border: 1px solid;
+ }
+
+ -->
+ </style>
+</head>
+<body>
+<h1>EasyTAG</h1>
+ <p id="contents">Contents:</p>
+ <ul>
+ <li><a href="#ch_1">1. Presentation and steps:</a></li>
+ <ul>
+ <li><a href="#ch_1_1">1.1. Description (based on the last version
+ 1.99.9 for GTK2):</a></li>
+ <li><a href="#ch_1_2">1.2. Basics steps of tagging/correcting tags:</a></li>
+ <ul>
+ <li><a href="#ch_1_2_1">1.2.1. Manually:</a></li>
+ <li><a href="#vh_1_2_2">1.2.2. Automatically with “Fill Tag” scanner:</a></li>
+ <li><a href="#ch_1_2_3">1.2.3. Automatically with CDDB:</a></li>
+ <li><a href="#ch_1_2_4">1.2.4. Correct tags fields with “Process Fields”
+ scanner:</a></li>
+ <li><a href="#ch_1_2_5">1.2.5. Automatic corrections:</a></li>
+ </ul>
+ <li><a href="#ch_1_3">1.3. Basics steps of renaming files and directories:</a></li>
+ <ul>
+ <li><a href="#ch_1_3_1">1.3.1. Manually:</a></li>
+ <li><a href="#ch_1_3_2">1.3.2. Automatically with scanner:</a></li>
+ <li><a href="#ch_1_3_3">1.3.3. Automatically with CDDB:</a></li>
+ <li><a href="#ch_1_3_4">1.3.4. Automatically from a TXT file:</a></li>
+ </ul>
+ </ul>
+ <li><a href="#ch_2">2. Tips:</a></li>
+</ul>
+<p><br /></p>
+<h2><a name="ch_1" id="ch_1"></a>1. Presentation and steps:</h2>
+<h3><a name="ch_1_1" id="ch_1"></a>1.1. Description (based on the last version
+ 1.99.9 for GTK2):</h3>
+<p> EasyTAG is a utility for viewing and editing tags for MP3, MP2,
+FLAC, Ogg Vorbis, MusePack and Monkey's Audio files, and based on a
+simple and nice GTK+ interface making tagging easier.</p>
+<p> With the tree browser, select quickly the directory to search for
+supported files (with or without including sub-directories). All files
+found are displayed in a main with a variable background colour to
+show, in one glance, the files in the same directory.</p>
+<p> A second useful view mode, organizes the files by artist and by
+album to have a quick look to all the artists of your collection, and
+all albums for each artist.</p>
+<p> The interface displays basic file informations taken from the file
+header, like bitrate or duration. With the interface, you can as well
+edit common tag fields as : title, artist, album, year, track number,
+genre and comment which were available into ID3v1.1 and ID3v2.3 tag.
+But you can also edit specials ID3v2.3 fields like : disc album,
+composer, original artist/performer, copyright, URL, encoder name and
+attached pictures.</p>
+<p> Three differents scanners allow you to tag automatically from the
+filename, rename the file and directory from the tag, and process
+fields (for example to change the case). The first two scanners use a
+preview to avoid any mistakes and help you when using or creating yours
+own patterns.</p>
+<p> If necessary you can use one of the both CDDB modes to fill yours
+tags with FreeDB servers. First, the automatic way tries to identify
+the selected files with the correct CDDB album. Else, a manual search
+lets you to search any word in the CDDB database to identify yourself
+the right album.</p>
+<p> Also, you can load the content of a simple TXT file (containing
+filenames) to set name of each file.</p>
+<p> Mass tagging is available with the scanners, but also with buttons
+to apply a field to all other selected files (small button on the right
+of each field).</p>
+<p> To prevent mistakes, the undo and redo functions assist the user to
+recover the last changes.</p>
+<p> The files collection can be export to a play list for Winamp or
+XMMS.</p>
+<p> With the search window, look for the requested files.</p>
+<p> After the various operations over the files, those who were changed
+and need to be saved are displayed in red in the list of files.<br>
+</p>
+<br>
+<p>The program depends on the following libraries:</p>
+<ul>
+ <li> GTK 2.4,</li>
+ <li> id3lib to handle MP3 files,</li>
+ <li> libogg,</li>
+ <li> libvorbis for Ogg Vorbis files,</li>
+ <li> libFLAC (with libogg and libvorbis) for FLAC Vorbis files,</li>
+ <li> mpeg4ip for MP4 files.</li>
+</ul>
+<h3><a name="ch_1_2" id="ch_1"></a>1.2. Basics steps of tagging/correcting tags:</h3>
+<p> EasyTAG offers three different “main” ways to tag or rename yours
+files: manually, automatically with the scanner or automatically with
+CDDB. Below is a description of each one.<br>
+But note that for better tagging (when tags are empty for example), the
+program prefers files classed by albums, than all the files in a same
+directory.<br>
+Also, it is important to know that the program works only with the
+selected files in the list. So when saving, using the scanner, using
+the “small buttons” and so on, only the selected files are affected,
+except when typing manually in one field. </p>
+<h4><a name="ch_1_2_1" id="ch_1"></a>1.2.1. Manually:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> files mixed</li>
+ <li> not much files</li>
+ <li> little changes to do,</li>
+ <li> adding pictures to the MP3 tag</li>
+</ul>
+<p> If you have only some albums to tag, this mode is very easy to use.
+Indeed, you have to type directly and manually the strings into each
+field.<br>
+Of course, when working by albums, some values as the album name, the
+year and the genre are the same for all files. So for fastest tagging,
+use the “small buttons” on the right of each field, to set this value
+to all others selected files in one click.<br>
+The genre can be selected from the list (list of ID3 genres), but you
+can also type your own one.<br>
+The year field, offers also a little improvement, because you need to
+type only the last numbers. The other part will be filled automatically
+according the current century and decade. For example, typing only ‘4’
+will display ‘2004’, and ‘94’ will display ‘1994’.<br>
+To number tracks quickly with the format xx/xx, use the first “small
+button” with a sharp to renumber automatically the file according its
+position in the list (so the order of files is important). Then the
+second “small button” set automatically the number of files.<br>
+For an efficient handling, to pass from one field to the next one, just
+press the enter key. The tab key gives focus to the “small button”
+corresponding to the field. The keys PageUp and PageDown permit to jump
+respectively to the previous and next file.<br>
+To attach a picture to the file, just select the image file (JPG or
+PNG) with the “+” button (in the picture tab), or Drag&Drop
+directly the picture file in the zone. </p>
+<h4><a name="ch_1_2_2" id="ch_1"></a>1.2.2. Automatically with “Fill Tag”
+ scanner:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> files sorted by albums</li>
+ <li> filenames or parent directory contain tag information (artist,
+album, title, …)</li>
+ <li> empty or not correct tags</li>
+</ul>
+<p> The “Fill Tag” scanner uses a pattern to associate words in the
+filename and directories with the tag entries. By this way, the tag
+fields can be completed automatically by pressing the “green” button in
+the scanner window or the toolbar. If the tag is partially completed,
+use the option “Overwrite fields when scanning tag” in the “Scanner”
+tab of the “Preferences” window, to replace all fields by the new
+values.<br>
+<br>
+Each code correspond to a field, following theses rules :</p>
+<p>
+<table>
+ <tbody>
+ <tr>
+ <th>
+ <div align="center">Strings associated with code:</div>
+ </th>
+ <th>Will fill the field:</th>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%a</div>
+ </td>
+ <td>Artist</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%b</div>
+ </td>
+ <td>Album</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%c</div>
+ </td>
+ <td>Comment</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%p</div>
+ </td>
+ <td>Composer</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%r</div>
+ </td>
+ <td>Copyright</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%e</div>
+ </td>
+ <td>Encoded by</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%g</div>
+ </td>
+ <td>Genre</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%i</div>
+ </td>
+ <td>None! (used to ignore a string)</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%l</div>
+ </td>
+ <td>Number of tracks</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%o</div>
+ </td>
+ <td>Original artist</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%n</div>
+ </td>
+ <td>Track</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%t</div>
+ </td>
+ <td>Title</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%u</div>
+ </td>
+ <td>URL</td>
+ </tr>
+ <tr>
+ <td>
+ <div align="center">%y</div>
+ </td>
+ <td>Year</td>
+ </tr>
+ </tbody>
+</table>
+<p></p>
+<p><br>
+<br>
+Note : to avoid mistakes, it is recommended to use a code only one time
+in the pattern.
+Of course, like when tagging manually, only the selected files are
+processed by the scanner.<br>
+You can use the defined patterns in the list, or write yours own
+patterns to correspond to the format of yours file names and
+directories.<br>
+To avoid mistakes when selecting the right pattern, or writing it, a
+preview shows immediately the results before to apply the pattern.<br>
+If you need some help with the different codes, press the “Help” button
+(the lifebuoy) to display the legend of each code.<br>
+Also, if you want to save yours own patterns, edit or sort then, by
+pressing the “Mask” button an little editor will be shown on the
+scanner window.<br>
+<br>
+Below an example of use of patterns :
+</p>
+<blockquote>
+ <p> a) the following filename :</p>
+ <p class="example-text"> “/mnt/MP3/EVANESCENCE – Fallen (2003) –
+Rock/01. Going Under.mp3”</p>
+ <p> b) with the pattern :</p>
+ <p class="example-text"> “%a - %b (%y) - %g/%n. %t”</p>
+ <p> c) you will fill the tag with theses strings :</p>
+ <ul>
+ <li> Artist (%a) => EVANESCENCE</li>
+ <li> Album (%b) => Fallen</li>
+ <li> Year (%y) => 2003</li>
+ <li> Genre (%g) => Rock</li>
+ <li> Track (%n) => 01</li>
+ <li> Title (%t) => Going Under</li>
+ </ul>
+</blockquote>
+<h4><a name="ch_1_2_3" id="ch_1"></a>1.2.3. Automatically with CDDB:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> files sorted by album</li>
+ <li> file audio data must correspond to the original CD (to use the
+Automatic Search)</li>
+ <li> album found in CD database</li>
+</ul>
+<p> To use tagging with the CD database, two modes are available.
+First, privilege the automatic search, but if it fails to identify the
+album, try with the manual search.</p>
+<p> Automatic Search</p>
+<p> This mode generates the CddbID from the audio files to request the
+database. So select all files of the album (and only them) in the right
+order (same order of the CD) and press the “Search” button.<br>
+All the corresponding albums found in the CD database are listed below.
+Select a line to display the tracks of this album on the right.<br>
+Finally, to fill the tag, select the interesting lines in the last list
+and press the “Apply” button.</p>
+<p> Manual Search</p>
+<p> If none album was found with the previous method, your last chance
+is to try a search using words (words supposed to by in the artist
+name, album name or track name). This search returns the same results
+of the search service on the freedb.org site. And may return lot of
+lines…<br>
+While browsing the albums list, those which have been already displayed
+are shown in red. Press the “red line button” to keep only these lines
+and remove all other.<br>
+When the right album was identified, follow the same method as the
+“automatic search” to select and apply the album to yours files. </p>
+<h4><a name="ch_1_2_4" id="ch_1"></a>1.2.4. Correct tags fields with “Process
+ Fields” scanner:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> filename or tag fields filled</li>
+ <li> want to correct the case</li>
+ <li> want to change some characters</li>
+</ul>
+<p> This feature is interesting to normalize quickly yours filenames or
+tags. For example to fix the case or convert some characters (filename
+to lower case and words separated with spaces).<br>
+On the top of the window, select the push-down buttons corresponding to
+each field to process. And then, press again the “green” button to run
+the scanner on the selected fields. </p>
+<h4><a name="ch_1_2_5" id="ch_1"></a>1.2.5. Automatic corrections:</h4>
+<p> Sometimes when loading files, you will note that some files are displayed to
+red. This will be due to useless spaces which are automatically stripped in the
+fields.<br>
+So it displays the file in red to let you to save the file. Note that you can't
+disable this feature). </p>
+<h3><a name="ch_1_3" id="ch_1"></a>1.3. Basics steps of renaming files and directories:
+</h3>
+<h4><a name="ch_1_3_1" id="ch_1"></a>1.3.1. Manually:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> little changes to do… </li>
+</ul>
+<p>To rename the filenames one by one (as only the selected file can be
+changed) enter the new file name, in the field of the ‘File’ frame in
+the right top of the main window.<br>
+The last name remains in the file list up to saving the file. But the
+new name is displayed in the file field.<br>
+The invalid characters typed (for windows partitions like: ‘/’, ’+’,
+and so on) will be automatically replaced, except if you disable the
+option “Replace illegal characters in filename (for Windows and
+CD-Rom)” in the “Misc” tab of the preferences window.<br>
+</p>
+<p>To rename the directory directly in the browser, use the popup menu
+to open the ‘Rename Directory’ window and to edit the new name for the
+directory. The change takes effect immediately and you can’t undo it.<br>
+The version 1.99.9 adds the ability to rename the directory from tag
+with a pattern.<br>
+</p>
+<p>Note : Unlike the scanner, when renaming manually the directory, the
+files aren’t moved. As the directory is renamed all files (even files
+not supported in EasyTAG like jpeg) stay in the directory. </p>
+<h4><a name="ch_1_3_2" id="ch_1"></a>1.3.2. Automatically with scanner:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> tags filled</li>
+</ul>
+<p> With the scanner mode “Rename File and Directory”, you can easily
+fix names of lot of files and move them into new directories. As the
+new file names will be based on the tag values, it is important to have
+correct tags.<br>
+Like in the “Fill Tag” scanner, it uses the same codes to build the
+filename structure from the tag entries, following theses rules:</p>
+<p>
+<table>
+ <tbody>
+ <tr>
+ <th>
+ <div align="center">To use the field:</div>
+ </th>
+ <th>
+ <div align="center">Use the code:</div>
+ </th>
+ </tr>
+ <tr>
+ <td>Artist</td>
+ <td>
+ <div align="center">%a</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Album</td>
+ <td>
+ <div align="center">%b</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Comment</td>
+ <td>
+ <div align="center">%c</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Composer</td>
+ <td>
+ <div align="center">%p</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Copyright</td>
+ <td>
+ <div align="center">%r</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Encoded by</td>
+ <td>
+ <div align="center">%e</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Genre</td>
+ <td>
+ <div align="center">%g</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Number of tracks</td>
+ <td>
+ <div align="center">%l</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Original artist</td>
+ <td>
+ <div align="center">%o</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Track</td>
+ <td>
+ <div align="center">%n</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Title</td>
+ <td>
+ <div align="center">%t</div>
+ </td>
+ </tr>
+ <tr>
+ <td>URL</td>
+ <td>
+ <div align="center">%u</div>
+ </td>
+ </tr>
+ <tr>
+ <td>Year</td>
+ <td>
+ <div align="center">%y</div>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<p></p>
+<p>Note : a code can be used several times Of course, like when
+renaming manually, only the selected files are processed by the
+scanner. The new files name are only visible in the ‘File’ frame up to
+saving the files.<br>
+This scanner also offers the ability to move the files in new or
+existing directories, using an absolute or relative path.</p>
+<p>Relative path:</p>
+<p>By using a relative path, the files will be moved into a
+subdirectory of the current directory.<br>
+For example,<br>
+- the file “/mp3/evanescence/01. Going Under.mp3”<br>
+- with the pattern “%a - %b/%n - %t”<br>
+- will be moved to “/mp3/evanescence/EVANESCENCE – Fallen/01 - Going
+Under.mp3”<br>
+- if tag contains the values %a = EVANESCENCE, %b = Fallen, %n = 01 and
+%t = Going Under</p>
+<p> Absolute path:</p>
+<p> By using an absolute path, the files can be moved in any directory.
+The current path of the file can be added to the pattern by pressing
+the icon on the left of the field (a directory with a green ‘+’). With
+this feature, it is easier to change the current path of the file.<br>
+For example:<br>
+- the file “/mp3/evanescence/01. Going Under.mp3”<br>
+- with the pattern “/mp3/%a - %b/%n - %t”<br>
+- will be moved to “/mp3/EVANESCENCE – Fallen/01 - Going Under.mp3”<br>
+- if tag contains the values %a = EVANESCENCE, %b = Fallen, %n = 01and
+%t = Going Under</p>
+<p> Note: Unlike when renaming manually the directory, the scanner
+moves the files to the new destination. So it is important to know that
+the files not recognized by EasyTAG will not be moved to the new
+directory and will stay in the current location. The files are moved
+when only when saving files, so you can use undo if needed. </p>
+<h4><a name="ch_1_3_3" id="ch_1"></a>1.3.3. Automatically with CDDB:</h4>
+<p> Like for the tag fields, you can use the CDDB results to apply the
+new name to the file. But by this way you can rename only the file
+name, and not the path. So you can use the second method. Activate the
+‘Rename file’ scanner which will be ran after applying the results. </p>
+<h4><a name="ch_1_3_4" id="ch_1"></a>1.3.4. Automatically from a TXT file:</h4>
+<p> Some conditions to use this mode:</p>
+<ul>
+ <li> to have a text file with track names</li>
+ <li> files sorted by album</li>
+</ul>
+<p> With this feature, you can rename files, but not the directories. A
+simple text file containing the list of track names will be loaded to
+associate each line with a file.</p>
+<h2> <a name="ch_2" id="ch_1"></a>2. Tips:</h2>
+<p class="question-text">How to see in one glance all tags of each file?</p>
+<p> Open the search window and run it without typing any parameter
+(field “Search :” empty). As result you will display content of all
+files.</p>
+<p class="question-text">How to play files?</p>
+<p> You can play directly the selected files or those placed in a
+directory by using an external application like XMMS. Over the selected
+files on the files list, or a directory in the tree, use the popup menu
+an press “Run Audio Player”. But default, as set in the preference
+window, the command ran is “xmms –p” to play only this files. But if
+you want to enqueue files, type the command “xmms –e” when using the
+popup menu entries “Open file(s) with …” or “Browse directory with…”</p>
+<p class="question-text">Files can be organized by artist and album?</p>
+<p>The “Artist + Album” view is for you. To activate it press the
+pushbutton in the toolbar with “a head + a disc”. This mode allows to
+browser easier the albums of an artist. It is also a good way to
+identify files with a wrong tag.</p>
+<p class="question-text">How to run the program directly from a
+directory?</p>
+<p>For example to run EasyTAG loading files from the current directory,
+use the command “easytag . &”. In the same way, to load an other
+directory, use the command line: “easytag /file-audio-dir”.</p>
+<p class="question-text">Tags and filenames changed, but how to save
+only tags?</p>
+<p>After renaming the files or correcting the tags you may want to save
+only tag data. When saving a file it will ask you confirmation before
+to save the tag and then to rename the file.<br>
+To do the same with several files at one time, answer like this to the
+confirmation dialog boxes:<br>
+- Confirmation to tag write: Check “Do the same for all files” and
+press “Yes”<br>
+- Confirmation to rename file: Check “Do the same for all files” and
+press “No”</p>
+<p class="question-text">How to see if a field haven’t been filled?</p>
+<p>Two ways are available:<br>
+- You can sort the list of files using the corresponding criteria.
+Empty fields appear on the top of the list. (Example: “sort by
+ascending artist name”).<br>
+- Use the search window to display all files and identify the “empty”
+cell. </p>
+<p> </p>
+</body>
+</html>
diff --git a/doc/EasyTAG_Documentation_fr.html b/doc/EasyTAG_Documentation_fr.html new file mode 100755 index 0000000..4c13669 --- /dev/null +++ b/doc/EasyTAG_Documentation_fr.html @@ -0,0 +1,448 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <title>Documentation du logiciel EasyTAG</title>
+ <style>
+ body {
+ font-family: Arial, Helvetica, sans-serif;
+ margin: 10;
+ padding: 0;
+ background-color: #FDFDE7;
+ font-size: 1em;
+ }
+ p {
+ text-align: justify;
+ text-indent: 2em;
+ }
+
+ .sans-retrait {
+ text-align: justify;
+ text-indent: 0em;
+ }
+ .txt_autre {
+ font-family: "Arial", sans-serif;
+ }
+
+ #tab_matiere {
+ font-size: 1.5em;
+ color: blue;
+ }
+
+ .souligne {
+ text-decoration: underline;
+ }
+
+ h1 {
+ text-align: center;
+ border-top: 1px solid #CCCCCC;
+ border-bottom: 1px solid #CCCCCC;
+ border-left: 1px solid #CCCCCC;
+ border-right: 1px solid #CCCCCC;
+ color: blue;
+ }
+ h2 {
+ font-size: 1.5em;
+ text-decoration: underline;
+ text-indent: 0pt;
+ margin-top: 1em;
+ color: blue;
+ }
+ h3, h4 {
+ text-decoration: underline;
+ margin-top: 1em;
+ color: blue;
+ }
+ li {
+ margin-left: 2em;
+ list-style-type: circle;
+ text-indent: 0em;
+ }
+
+ .example-text {
+ font-family: "Courier New", Courier, mono;
+ }
+
+ .question-text {
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-style: italic;
+ padding-top: 1em;
+ color: #666666;
+ }
+ table {
+ border: 1px solid #666666;
+ margin: 0px;
+ padding: 0px;
+ }
+ th {
+ background-color: #CCCCCC;
+ border: 1px solid;
+ }
+
+ </style>
+</head>
+<body>
+ <h1>EasyTAG</h1>
+ <p id="tab_matiere">Table des matières.</p>
+ <ul>
+ <li><a href="#ch_1">1. Présentation générale</a></li>
+ <ul>
+ <li><a href="#ch_1_1">1.1. Vue d'ensemble des fonctionnalités du logiciel.</a></li>
+ <li><a href="#ch_1_2">1.2. Editer/corriger les tags.</a></li>
+ <ul>
+ <li><a href="#ch_1_2_1">1.2.1. Mode manuel.</a></li>
+ <li><a href="#ch_1_2_2">1.2.2. Mode automatique via le scanner "Compléter le(s) Tag(s)".</a></li>
+ <li><a href="#ch_1_2_3">1.2.3. Mode automatique via la base de données CDDB.</a></li>
+ <li><a href="#ch_1_2_4">1.2.4. Correction des tags via le scanner "Traiter les Champs".</a></li>
+ </ul>
+ <li><a href="#ch_1_3">1.3. Renommer les fichiers/les répertoires.</a></li>
+ <ul>
+ <li><a href="#ch_1_3_1">1.3.1. Mode manuel.</a></li>
+ <li><a href="#ch_1_3_2">1.3.2. Mode automatique via le scanner.</a></li>
+ <li><a href="#ch_1_3_3">1.3.3. Mode automatique via la base de données CDDB.</a></li>
+ <li><a href="#ch_1_3_4">1.3.4. Mode automatique via la lecture d'un fichier texte.</a></li>
+ </ul>
+ </ul>
+ <li><a href="#ch_2">2. Astuces.</a></li>
+ </ul>
+ <p><br/><br/></p>
+
+ <h2><a name="ch_1" id="ch_1">1. Présentation générale.</a></h2>
+ <h3><a name="ch_1_1" id="ch_1_1">1.1. Vue d'ensemble des fonctionnalités du logiciel (version 1.99.9 développée avec GTK2).</a></h3>
+ <p>EasyTAG est un utilitaire permettant l'édition et la modification des tags des fichiers audio de type MP3, MP2, FLAC, Ogg Vorbis, MusePack et Monkey. Il s'appuie sur une interface, simple et intuitive, développée en GTK+. Cette interface est organisée autour de trois fenêtres.</p>
+ <p>Une première fenêtre, nommée Sélecteur, permet de choisir rapidement le répertoire particulier contenant les fichiers audio que vous voulez traiter (une option permet d'étendre cette recherche aux sous répertoires). EasyTAG dispose de deux modes de visualisation du contenu du répertoire (et/ou sous répertoires) :
+ <ul>
+ <li>Un premier mode de type arborescence qui permet de naviguer dans les différents répertoires du support de stockage et de sélectionner rapidement un répertoire particulier. L'ensemble des fichiers trouvés dans ce répertoire sont alors affichés sous forme d'une liste. Dans cette liste, seule une alternance de couleur permet de distinguer les fichiers appartenant à des artistes/albums différents.</li>
+ <li>Le deuxième mode, complémentaire du précédent, affiche le contenu du répertoire sélectionné sous la forme d'une arborescence de type artistes/albums qui permet d'accéder rapidement à un artiste donné et aux fichiers audio d'un album particulier de ce dernier.</li>
+ </ul>
+ <p>Une deuxième fenêtre, nommée Fichier, affiche certaines informations de base contenues dans l'en-tête du fichier audio comme, par exemple, le bitrate ou la durée du morceau.</p>
+ <p>La troisième fenêtre, nommée Tag, permet d'afficher et de modifier le contenu des tags disponibles dans les normes ID3v1.1 et ID3v2.3 comme : titre, artiste, album, année, numéro de piste, genre et commentaire. Mais vous pouvez avoir aussi accès à certains tags particuliers disponibles dans la norme ID3v2.3 comme : album, compositeur, premier artiste/interprète, copyright, URL, type d'encodeur et images.</p>
+
+ <p>EasyTAG offre la possibilité de traitement automatique des tags des fichiers par l'utilisation de scanners. Trois scanners sont disponibles qui permettent :
+ <ul>
+ <li>soit de renseigner automatiquement les différents tags à partir des informations contenues dans le nom du fichier,</li>
+ <li>soit de renommer automatiquement les fichiers et le répertoire les contenant à partir des informations contenues dans leurs tags,</li>
+ <li>soit d'effectuer différentes opérations de mise en forme sur les différents tags et noms de fichiers (par exemple, changer la casse).</li>
+ </ul>
+
+ <p class="sans-retrait">Dans le cas des deux premiers scanners, les opérations sont effectuées sur la base d'un masque (voir <a href="#ch_1_2_2">paragraphe 1.2.2</a>). Une pré-visualisation de l'effet d'un masque particulier est disponible ce qui :</p>
+ <ul>
+ <li>permet d'éviter toute erreur de traitement,</li>
+ <li>constitue une aide précieuse pour réaliser votre propre modèle de masque et ainsi adapter au mieux l'outil à vos propres besoins.</li>
+ </ul>
+ <p> EasyTAG offre aussi la possibilité de traitement automatique via une connexion internet. En effet, vous pouvez, en interrogeant la base de données CDDB disponible sur les serveurs FreeDB, rechercher le bon album correspondant aux fichiers sélectionnés et renseigner alors directement les différents tags de vos fichiers.<br/>Deux modes d'interrogation sont possibles : un mode automatique et un mode manuel. Dans le mode automatique, le programme essaie de trouver automatiquement, dans la base de données CDDB, le bon album correspondant aux fichiers sélectionnés. Dans le mode manuel, vous effectuez vous même la recherche dans la base de données CDDB sur la base de mots clé.</p>
+
+ <p> EasyTAG offre enfin la possibilité de renommer chaque fichier grâce à la lecture d'un simple fichier texte contenant la liste exhaustive des noms des fichiers sélectionnés.</p>
+
+ <p> EasyTAG vous permet aussi de modifier simultanément les tags de plusieurs fichiers. Pour cela, il faut, après avoir sélectionné un ensemble de fichiers, soit utiliser un scanner (voir <a href="#ch_1_2_2">paragraphe 1.2.2</a>), soit cliquer sur le petit bouton rond situé à droite de chaque tag pour appliquer la modification à l'ensemble des fichiers.</p>
+ <p> Pour bien contrôler les opérations réalisées sur les fichiers et éviter toute modification involontaire, le programme dispose de deux touches : une touche "Annuler Modif. des fichier(s)" qui permet de revenir à l'état existant avant les modifications envisagées sur les fichiers et une touche "Refaire les modifications des fichiers" qui permet de réaliser l'opération inverse de la précédente.</p>
+
+ <p> Par ailleurs, le programme dispose des fonctionnalités suivantes :</p>
+ <ul>
+ <li>création d'une playlist de différents fichiers pour les logiciels Winamp ou XMMS,</li>
+ <li>possibilité de rechercher dans votre collection les fichiers par mots clé (sur le nom du fichier, le titre ...).</li>
+ </ul>
+
+ <p> Au final, les fichiers ayant subi des modifications (et qui, par conséquent, doivent être sauvegardés) sont clairement identifiables car ils apparaissent en rouge dans la liste des fichiers affichés.<br/></p>
+
+ <p>Pour fonctionner, EasyTAG doit disposer des librairies suivantes :</p>
+ <ul>
+ <li>GTK 2.4,</li>
+ <li>id3lib pour les fichiers MP3,</li>
+ <li>libogg,</li>
+ <li>libvorbis pour les fichiers Ogg Vorbis,</li>
+ <li>libFLAC (en complément de libogg and libvorbis) pour les fichiers FLAC Vorbis,</li>
+ <li>mpeg4ip pour les fichiers MP4.</li>
+ </ul>
+
+ <h3><a name="ch_1_2" id="ch_1_2">1.2. Editer/corriger les tags.</a></h3>
+ <p>Nous avons vu que EasyTAG offre trois différents modes de traitement pour renommer ou bien encore pour modifier les tags de vos fichiers : un mode manuel, un mode automatique utilisant un scanner et un mode automatique utilisant une base de données CDDB. Dans la suite, nous allons décrire la mise en oeuvre de chacun d'entre eux.</p>
+ <p>Avant toute chose, il est bon de noter que le traitement des tags sera grandement facilité si les fichiers sont regroupés par album plutôt que d'être tous stockés dans un même répertoire.</p>
+ <p>De plus, il est important de garder à l'esprit que chaque traitement ne s'applique que sur les fichiers sélectionnés dans la liste. De même, la procédure de sauvegarde ne s'applique aussi que sur ces fichiers.</p>
+
+ <h4><a name="ch_1_2_1" id="ch_1_2_1">1.2.1. Mode manuel.</a></h4>
+ <p>Ce mode peut être utilisé dans les conditions suivantes :</p>
+ <ul>
+ <li>les fichiers sont mélangés et non pas classés album par album,</li>
+ <li>les fichiers ne sont pas trop nombreux,</li>
+ <li>le nombre de traitements à effectuer est faible,</li>
+ <li>vous voulez ajouter des images aux tags MP3 des fichiers.</li>
+ </ul>
+ <p>Si vous n'avez à modifier les tags que de quelques albums, ce mode répond bien à votre besoin puisqu'il suffit alors de taper dans chaque tag que vous voulez renseigner la valeur correspondante.</p>
+ <p>Bien évidemment, lorsque vous travaillez sur des albums entiers, certains paramètres comme le nom de l'album, l'année et le genre sont communs à tous les fichiers. Dans ce cas, il est conseillé d'utiliser le petit bouton rond situé à droite de chaque tag. En effet, en cliquant sur ce bouton, on affecte, pour un tag donné, la même valeur à l'ensemble des fichiers sélectionnés.</p>
+ <p>Le genre peut être choisi dans une liste prédéfinie (liste des genres ID3), mais vous pouvez très bien définir un genre qui vous est personnel.</p>
+ <p>La saisie de la valeur du tag année a été simplifiée au maximum. En effet, vous pouvez seulement saisir les deux derniers digits (dizaines et unités) de l'année et EasyTAG completera alors les digits manquants. Par exemple :</p>
+ <ul>
+ <li>si vous entrez "4", EasyTAG affichera "2004",</li>
+ <li>si vous entrez "94", EasyTAG affichera "1994".</li>
+ </ul>
+
+ <p>La numérotation des différentes pistes au format "numéro de piste/nombre total de pistes" peut se faire rapidement en utilisant le petit bouton situé à gauche du mot Piste et le petit bouton situé à gauche du tag "Nombre de pistes". Le premier bouton permet d'affecter au tag Piste une valeur correpondant à la position du fichier considéré dans la liste des fichiers présents dans le répertoire (l'ordre des fichiers est donc essentiel). Le deuxième petit bouton permet d'affecter au tag "Nombre de pistes" une valeur correspondant au nombre de fichiers présents dans le répertoire.
+ <p>La connaissance de certaines touches permettent d'être plus efficace. Ainsi, la touche "Entrée" permet de se déplacer rapidement d'un tag au suivant. De même, pour un tag particulier, la touche Tab permet d'activer directement le petit bouton rond situé à droite de celui-ci (valeur du tag donnée à l'ensemble des fichiers sélectionnés). Enfin, les touches PageUp et PageDown permettent respectivement de passer au fichier précédent ou au fichier suivant.</p>
+
+ <p>Enfin, il est possible d'attacher une image (couverture de l'album, par exemple) à un fichier mp3. Pour cela, il suffit de sélectionner le fichier image (JPG ou PNG) avec le bouton “+” présent dans le menu "Images". On peut aussi effectuer un «Drag and Drop» du fichier image directement dans la zone "Images" du menu du même nom.</p>
+
+ <h4><a name="ch_1_2_2" id="ch_1_2_2">1.2.2. Mode automatique via le scanner "Compléter le(s) Tag(s)".</a></h4>
+ <p>Ce mode peut être utilisé dans les conditions suivantes :</p>
+ <ul>
+ <li>les fichiers sont classés par album,</li>
+ <li>les noms des fichiers ou le répertoire de ces fichiers contiennent les informations pertinentes (artiste, album, titre, …),</li>
+ <li>les tags sont vides ou bien encore partiellement renseignés.</li>
+ </ul>
+ <p> Le scanner "Compléter le(s) Tag(s)" utilise un modèle de masque pour associer les différents mots constituant le nom du fichier ou le répertoire avec les différents tags correspondants. De cette façon, il est alors possible de renseigner automatiquement les tags en cliquant sur le bouton "vert" de la barre des tâches de la fenêtre Scanner. Si les tags sont déjà partiellement renseignés, vous pouvez remplacer tous les anciens tags par les nouveaux tags à la condition d'avoir coché la case "Ecraser les champs lors d'un Scan du tag" de l'onglet Scanner du menu Préférences.</p>
+ <p class="sans-retrait"><br/>Le tableau suivant présente, pour le modèle de masque du scanner, la correspondance entre code et tag :</p>
+ <div align="center"><table>
+ <tbody>
+ <tr>
+ <th><div align="center">Cette valeur de code :</div></th>
+ <th>va renseigner le tag :</th></tr>
+ <tr>
+ <td><div align="center">%a</div></td>
+ <td>Artiste</td></tr>
+ <tr>
+ <td><div align="center">%b</div></td>
+ <td>Album</td></tr>
+ <tr>
+ <td><div align="center">%c</div></td>
+ <td>Commentaire</td></tr>
+ <tr>
+ <td><div align="center">%p</div></td>
+ <td>Compositeur</td></tr>
+ <tr>
+ <td><div align="center">%r</div></td>
+ <td>Copyright</td></tr>
+ <tr>
+ <td><div align="center">%e</div></td>
+ <td>Encodeur</td></tr>
+ <tr>
+ <td><div align="center">%g</div></td>
+ <td>Genre</td></tr>
+ <tr>
+ <td><div align="center">%i</div></td>
+ <td>Rien! (utilisé pour ignorer un mot particulier)</td></tr>
+ <tr>
+ <td><div align="center">%l</div></td>
+ <td>Nombre de pistes</td></tr>
+ <tr>
+ <td><div align="center">%o</div></td>
+ <td>Artiste Orig.</td></tr>
+ <tr>
+ <td><div align="center">%n</div></td>
+ <td>Piste</td></tr>
+ <tr>
+ <td><div align="center">%t</div></td>
+ <td>Titre</td></tr>
+ <tr>
+ <td><div align="center">%u</div></td>
+ <td>URL</td></tr>
+ <tr>
+ <td><div align="center">%y</div></td>
+ <td>Année</td></tr>
+ </tbody>
+ </table>
+ </div>
+ <p class="sans-retrait"><br/><br/>Note : Pour éviter toute erreur, il est recommandé de n'utiliser un code particulier qu'une seule fois dans un modèle de masque. Bien évidemment, comme dans le cas de l'édition/modification manuelle des tags, seuls les fichiers sélectionnés seront modifiés par le scanner.</p>
+ <p>Dans EasyTAG, vous disposez d'une liste de modèles de masque pré-définis mais vous pouvez aussi créer votre propre modèle de masque pour correspondre au mieux au format des noms et des répertoires de vos fichiers audio. Pour éviter toute erreur lors de la définition du modèle de masque, EasyTAG intègre une fonction de pré-visualisation qui vous permet de vous rendre immédiatement compte du résultat du masque avant de l'appliquer effectivement sur les fichiers.</p>
+ <p>Si vous avez besoin d'aide quant à la signication des différents codes, vous pouvez presser le bouton "?" qui ouvre la fenêtre Légende décrivant toutes les correspondances possibles (code/tag). De plus, pour créer votre propre modèle de masque, le modifier ou le sauvegarder, vous avez à votre disposition l'outil "Editeur de masque" accessible en cliquant sur le bouton "masque" de la barre des tâches.</p>
+
+ <p class="sans-retrait"><br/>Voici un exemple d'utilisation d'un modèle de masque :</p>
+ <blockquote>
+ <p>a) si le fichier audio se nomme : </p>
+ <p class="example-text">“/mnt/MP3/EVANESCENCE – Fallen (2003) –Rock/01. Going Under.mp3”</p>
+ <p>b) avec ce masque particulier : <span class="example-text">“%a - %b (%y) - %g/%n. %t”</span></p>
+ <p>c) les tags vont être renseignés avec les valeurs suivantes :</p>
+ <ul>
+ <li>Artiste (%a) => EVANESCENCE</li>
+ <li>Album (%b) => Fallen</li>
+ <li>Année (%y) => 2003</li>
+ <li>Genre (%g) => Rock</li>
+ <li>Piste (%n) => 01</li>
+ <li>Titre (%t) => Going Under</li>
+ </ul>
+ </blockquote>
+
+ <h4><a name="ch_1_2_3" id="ch_1_2_3">1.2.3. Mode automatique via la base de données CDDB.</a></h4>
+ <p>Ce mode peut être utilisé dans les conditions suivantes :</p>
+ <ul>
+ <li>les fichiers sont classés par album,</li>
+ <li>les données du fichier audio doivent correspondre à celles du CD d'origine (condition nécessaire pour utiliser la recherche automatique),</li>
+ <li>l'album doit être répertorié dans la base de données CDDB.</li>
+ </ul>
+ <p>Pour renseigner les tags via la base de données, deux modes de recherche sont disponibles (un mode automatique et un mode manuel). Une bonne stratégie est d'utiliser, dans un premier temps, le mode automatique. Si ce dernier s'avère incapable d'identifier correctement l'album, vous pouvez vous rabattre sur le mode manuel et utiliser alors des mots clé pour guider la recherche.</p>
+
+ <p class="souligne">Recherche automatique.</p>
+ <p>La recherche se fait par l'envoi à la base de données CDDB d'un paramètre nommé CddbID identifiant normalement le CD audio. Ce paramètre est calculé par EasyTAG à partir des caractéristiques des différentes plages du CD audio (durée totale du CD, nombre de plages, durée de chaque plage). De ce fait, il est nécessaire de sélectionner tous les fichiers de l'album (et seulement ceux-ci) et il est aussi nécessaire que ces derniers soient classés exactement comme dans le CD d'origine. Pour lancer l'interrogation de la base de données, cliquez sur le bouton "Rechercher".</p>
+ <p>La liste des différents albums possibles trouvés dans la base de données (le cddbid n'étant pas unique) apparait alors. Sélectionnez une des lignes de cette liste pour visualiser à droite les différentes pistes de cet album.</p>
+ <p>Finalement, Il suffit alors de cliquer sur le bouton "Appliquer" pour renseigner les différents tags. Si aucune piste de l'album n'est sélectionnée, les tags de l'ensemble des pistes seront modifiés. Par contre, si une piste est sélectionnée, seuls les tags de cette piste seront modifiés.</p>
+
+ <p class="souligne">Recherche manuelle.</p>
+ <p>Si aucun album n'a pu être identifié par la recherche automatique, vous pouvez toujours essayer une recherche manuelle en utilisant des mots clé (ces mots doivent être présents dans le nom de l'artiste, le nom de l'album ou bien encore dans le nom de la piste). La liste de résultats obtenue dans ce mode est identique à celle obtenue via l'outil de recherche du site freedb.org. Cette recherche peut s'avérer peu sélective et conduire à une liste de taille importante.</p>
+ <p>Dans la liste d'albums obtenue, tous les albums déjà consultés sont affichés en rouge. Cliquez sur le bouton caractérisé par des lignes rouges pour ne conserver que ces lignes et éliminer toutes les autres de la liste. Dès que vous avez réussi à identifier le bon album, il suffit alors, pour renseigner les tags de vos fichiers, de procéder exactement comme dans le mode automatique.</p>
+
+ <h4><a name="ch_1_2_4" id="ch_1_2_4">1.2.4. Correction des tags via le scanner "Traiter les Champs".</a></h4>
+ <p>Ce mode peut être utilisé dans les conditions suivantes :</p>
+ <ul>
+ <li>les noms des fichiers ou les différents tags sont déjà renseignés,</li>
+ <li>vous voulez corriger la casse,</li>
+ <li>vous voulez éliminer certains caractères de certains tags.</li>
+ </ul>
+ <p>Cette fonctionnalité est très utile lorsque vous voulez rapidement uniformiser les noms des fichiers ou bien encore les tags. Par exemple, il est très facile de modifier la casse (passage du titre en minuscules …) ou bien encore de remplacer certains caractères par d'autres (mots du nom de fichier séparés par des blancs et non plus par des %20 …).</p>
+ <p>Dans le haut de la fenêtre scanner, sélectionnez les boutons des tags sur lesquels vous souhaitez effectuer le traitement (ces boutons passent alors en grisé) puis, cliquez sur le bouton "vert" pour appliquer alors les modifications sur les différents fichiers et tags sélectionnés.</p>
+
+ <h3><a name="ch_1_3" id="ch_1_3">1.3. Renommer les fichiers/les répertoires. </a></h3>
+ <p>EasyTAG offre différents modes pour renommer les fichiers et/ou les répertoires : un mode manuel, un mode automatique via le scanner, un mode automatique via la base de données CDDB et enfin un mode basé sur la lecture d'un fichier texte. Dans la suite, nous allons décrire la mise en oeuvre de chacun d'entre eux.</p>
+
+ <h4><a name="ch_1_3_1" id="ch_1_3_1">1.3.1. Mode manuel.</a></h4>
+ <p>Ce mode peut être utilisé si vous avez peu de modifications à réaliser (sinon, cela s'avererait vite fastidieux)</p>
+
+ <p>Pour renommer manuellement un fichier, il suffit de sélectionner ce dernier dans la liste puis de modifier son nom dans la fenêtre Fichier située en haut, à droite de la fenêtre principale. Toutefois, ce nouveau nom de fichier ne sera effectif qu'après avoir sauvegardé le fichier. Les caractères illégaux (comme, pour les partitions Windows : ‘/’, ’+’ …) seront automatiquement remplacés à moins que vous n'ayez décoché l'option "Remplacer les caractères illégaux des noms de fichiers (pour Windows et les CD-Rom)" de l'onglet "Paramètres du nom des fichiers" du menu "Préférences".</p>
+ <p>Pour renommer manuellement un répertoire, il vous suffit de cliquer sur l'entrée "Renommer le répertoire ..." du menu Sélecteur puis de saisir alors le nouveau nom du répertoire. Le fait de cliquer sur "Appliquer" rend cette modification immédiate et définitive.</p>
+
+ <p>Note : Contrairement au mode automatique via le scanner (voir <a href="#ch_1_3_2">paragraphe 1.3.2</a>), lorsque le répertoire est renommé manuellement, les différents fichiers restent physiquement dans celui-ci. Il contient donc tous les fichiers présents dans l'ancien répertoire (y compris les fichiers qui ne sont pas supportés par EasyTAG tels que les fichiers jpeg).</p>
+
+ <h4><a name="ch_1_3_2" id="ch_1_3_2">1.3.2. Mode automatique via le scanner.</a></h4>
+ <p>A partir de la version 1.99.9, EasyTAG permet de renommer un répertoire à partir des tags des fichiers grâce à l'utilisation d'un modèle de masque. Pour utiliser ce mode, les tags doivent être préalablement renseignés.</p>
+
+ <p>Dans le mode "Renommer le(s) Fichier(s) et Répertoire(s)" du scanner, vous pouvez très facilement modifier les noms des fichiers et les déplacer dans un nouveau répertoire. Comme les nouveaux noms des fichiers sont basés sur les valeurs des tags, il est impératif que ceux-ci soient correctement renseignés.</p>
+ <p>Pour construire le nouveau nom de fichier à partir des valeurs de certains tags, EasyTAG utilise un modèle de masque similaire à celui utilisé dans le mode scanner "Compléter le(s) Tag(s)" (voir <a href="#ch_1_2_2">paragraphe 1.2.2</a>). La correspondance entre code et tag est donnée dans le tableau suivant :</p>
+
+ <div align="center">
+ <table>
+ <tbody>
+ <tr>
+ <th><div align="center">Ce tag correspond :</div></th>
+ <th><div align="center">Ã ce code :</div></th>
+ </tr>
+ <tr>
+ <td>Artiste</td>
+ <td><div align="center">%a</div></td>
+ </tr>
+ <tr>
+ <td>Album</td>
+ <td><div align="center">%b</div></td>
+ </tr>
+ <tr>
+ <td>Commentaire</td>
+ <td><div align="center">%c</div></td>
+ </tr>
+ <tr>
+ <td>Compositeur</td>
+ <td><div align="center">%p</div></td>
+ </tr>
+ <tr>
+ <td>Copyright</td>
+ <td><div align="center">%r</div></td>
+ </tr>
+ <tr>
+ <td>Encodeur</td>
+ <td><div align="center">%e</div></td>
+ </tr>
+ <tr>
+ <td>Genre</td>
+ <td><div align="center">%g</div></td>
+ </tr>
+ <tr>
+ <td>Nombre de pistes</td>
+ <td><div align="center">%l</div></td>
+ </tr>
+ <tr>
+ <td>Artiste Orig.</td>
+ <td><div align="center">%o</div></td>
+ </tr>
+ <tr>
+ <td>Piste</td>
+ <td><div align="center">%n</div></td>
+ </tr>
+ <tr>
+ <td>Titre</td>
+ <td><div align="center">%t</div></td>
+ </tr>
+ <tr>
+ <td>URL</td>
+ <td><div align="center">%u</div></td>
+ </tr>
+ <tr>
+ <td>Année</td>
+ <td><div align="center">%y</div></td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+
+ <p class="sans-retrait">Note : Un même code peut être utilisé plusieurs fois. Bien évidemment, comme dans le mode manuel, seuls seront modifiés les fichiers que vous aurez préalablement sélectionnés. De plus, les nouveaux noms de fichiers visibles dans la fenêtre "Fichier" ne seront pris en compte qu'après avoir effectuer la sauvegarde de ces fichiers.</p>
+ <p>Ce mode scanner offre aussi la possibilité de déplacer simultanément les fichiers dans un répertoire existant ou dans un nouveau répertoire. Ce déplacement peut prendre en compte soit un chemin absolu, soit un chemin relatif.</p>
+ <p class="souligne">Utilisation d'un chemin relatif :</p>
+ <p>Dans ce cas, les fichiers vont être déplacés dans un sous-répertoire du répertoire courant (ce sous-répertoire étant crée s'il n'existe pas).</p>
+ <p>Par exemple :</p>
+ <ul>
+ <li>le fichier mp3 : “/mp3/evanescence/01. Going Under.mp3”,</li>
+ <li>possédant les tags : artiste = EVANESCENCE, album = Fallen, piste = 01 et titre = Going Under,</li>
+ <li>avec le masque : “%a - %b/%n - %t”</li>
+ <li>sera déplacé dans le répertoire : “/mp3/evanescence/EVANESCENCE – Fallen/01 - Going Under.mp3”.</li>
+ </ul>
+
+ <p class="souligne">Utilisation d'un chemin absolu :</li>
+ <p>L'utilisation d'un chemin absolu permet de déplacer les fichiers dans n'importe quel répertoire. Dans la fenêtre Scanner, il suffit d'ajouter le chemin du répertoire de destination au début du modèle de masque (le chemin du répertoire courant peut être ajouté en cliquant sur le répertoire marqué par une croix verte situé immédiatement à gauche du masque). De cette façon, il est très facile de modifier le répertoire courant des fichiers.</p>
+
+ <p>Par exemple :</p>
+ <ul>
+ <li>le fichier mp3 : “/mp3/evanescence/01. Going Under.mp3”,</li>
+ <li>possédant les tags : artiste = EVANESCENCE, album = Fallen, piste = 01 et titre = Going Under,</li>
+ <li>avec le masque : “/mp3/%a - %b/%n - %t”</li>
+ <li>sera renommé et déplacé dans le répertoire : “/mp3/EVANESCENCE – Fallen/01 - Going Under.mp3”.</li>
+ </ul>
+
+ <p class="sans-retrait"> Note: Contrairement au mode manuel, les fichiers sont physiquement déplacés vers leur nouveau répertoire. Les fichiers qui ne sont pas supportés par EasyTAG tels que les fichiers jpeg ne seront pas eux déplacés et resteront donc dans le répertoire d'origine.<br/>Enfin, le déplacement effectif des fichiers n'intervient que lorsque vous les sauvegardez. De ce fait, tant que vous n'avez pas effectuer la sauvegarde, vous pouvez toujours, en cas d'erreur, revenir en arrière en utilisant la touche "Annuler Modif. des fichier(s)".</p>
+
+ <h4><a name="ch_1_3_3" id="ch_1_3_3">1.3.3. Mode automatique via la base de données CDDB.</a></h4>
+ <p>Dans le <a href="#ch_1_2_3">paragraphe 1.2.3</a>, nous avons vu comment rechercher, dans la base de données CDDB, l'album CD audio correspondant à un ensemble de fichiers. Ce résultat permet non seulement de renseigner les différents tags mais aussi les noms des fichiers. Par contre, il ne permet pas de mettre directement à jour le nom du répertoire. Pour arriver à ce résultat, il faut alors procéder en deux étapes :</p>
+ <ul>
+ <li>étape 1 : renseigner les noms des fichiers par la méthode décrite au <a href="#ch_1_2_3">paragraphe 1.2.3</a>,</li>
+ <li>étape 2 : modifier le nom du répertoire par la méthode décrite au <a href="#ch_1_3_2">paragraphe 1.3.2.</a></li>
+ </ul>
+
+ <h4><a name="ch_1_3_4" id="ch_1_3_4">1.3.4. Mode automatique via la lecture d'un fichier texte.</a></h4>
+ <p>Ce mode peut être utilisé dans les conditions suivantes :</p>
+ <ul>
+ <li>il faut disposer d'un fichier texte contenant la liste des noms des fichiers,</li>
+ <li>les fichiers doivent être triés par album et ordonnés comme dans le fichier texte.</li>
+ </ul>
+ <p>Dans ce cas, vous pouvez renommer les différents fichiers mais pas le répertoire. Le traitement consiste alors à renommer le premier fichier avec la valeur de la première ligne du fichier texte. On procède alors de proche en proche jusqu'à la dernière ligne du fichier texte.</p>
+
+ <h2><a name="ch_2" id="ch_2">2. Astuces.</a></h2>
+ <p class="question-text">Comment voir en une fois tous les tags de chaque fichier ?</p>
+ <p>Il suffit d'ouvrir la fenêtre "Rechercher un fichier" et d'effectuer la recherche en laissant le champ "Rechercher" vide. L'ensemble des tags des différents fichiers seront alors affichés.</p>
+
+ <p class="question-text">Comment faire pour écouter les fichiers audio ?</p>
+ <p>Vous pouvez écouter directement les fichiers sélectionnés ou bien tous les fichiers d'un répertoire particulier en faisant appel à une application externe (XMMS …).
+ Après avoir sélectionné un ensemble de fichiers ou bien un répertoire, cliquez sur l'entrée "Lancer Lecteur Audio" du menu "Divers" pour lancer alors le lecteur audio. Par défaut, le lecteur utilisé est XMMS lancé par l'intermédiaire de la commande "xmms -p" (voir l'onglet "Divers" du menu "Préférences"). Si vous désirez ajouter d'autres fichiers à la playlist courante, il faut alors cliquer sur l'entrée :
+ <ul>
+ <li>"Ouvrir le(s) Fichier(s) avec ..." du menu "Fichier",</li>
+ <li>"Parcourir le Répertoire avec ..." du menu "Sélecteur".</li>
+ </ul>
+ et taper la commande "xmms -e" dans la boite qui s'affiche alors.</p>
+
+ <p class="question-text">Les fichiers peuvent-ils être organisés par artiste et album ?</p>
+ <p>Le mode de visualisation "Artiste + Album" est fait pour vous. Pour activer ce mode, il suffit de cliquer sur le bouton caractérisé par "une tête et un disque" présent dans la barre des tâches. Ce mode permet de naviguer très rapidement dans les albums d'un artiste donné. Ce mode permet aussi de localiser très vite les fichiers possédant des mauvais tags.</p>
+
+ <p class="question-text">Comment spécifier le répertoire au lancement du programme ?</p>
+ <p>Par exemple, pour lancer EasyTAG avec préchargement des fichiers présents dans le répertoire courant, il suffit de lancer le programme avec la commande <span class="txt_autre">"easytag . &"</span>. Par ailleurs, pour spécifier un répertoire donné (par exemple, /file-audio-dir), il faut utiliser la commande : “easytag /file-audio-dir”.</p>
+
+ <p class="question-text">A la suite d'une modification des tags et des noms des fichiers, comment ne sauvegarder que les modifications effectuées sur les tags ?</p>
+ <p>Le processus de sauvegarde d'un fichier fait appel à deux écrans de confirmation distincts : le premier concernant les tags du fichier, le deuxième le nom du fichier. Si, à la suite d'une modification des tags et des noms des fichiers, vous ne voulez que sauvegarder les modifications effectuées sur les tags, il suffit alors de :
+ <ul>
+ <li>répondre "OUI" dans l'écran de confirmation d'écriture des tags du fichier,</li>
+ <li>répondre "NON" dans l'écran de confirmation d'écriture du nom du fichier.</li>
+ </ul>
+ <p>Pour effectuer en une passe la même chose sur l'ensemble des fichiers sélectionnés, il suffit alors, avant de confirmer ou non la sauvegarde, de cocher la case "Répéter la même action pour les autres fichiers".<p>
+
+ <p class="question-text">Comment savoir si un tag n'est pas renseigné (champ vide) ?</p>
+ <p>Pour le savoir, deux façons de procéder sont possibles :</p>
+ <ul>
+ <li>Vous pouvez effectuer un tri sur la liste des fichiers avec le critère adapté au tag qui vous intéresse (Par exemple, "Classer par ordre croissant des artistes"). Les fichiers ne possédant aucune valeur du tag considéré sont affichés dans le haut de la liste.</li>
+ <li>Vous pouvez utiliser la fenêtre spécifique de "Rechercher Fichiers" pour afficher tous les fichiers et identifier alors toutes les cellules vides du tag qui vous intéresse.</li>
+ </ul>
+ <p> </p>
+</body>
+</html>
+
diff --git a/doc/easytag.1.in b/doc/easytag.1.in new file mode 100755 index 0000000..fc9dcf2 --- /dev/null +++ b/doc/easytag.1.in @@ -0,0 +1,63 @@ +.TH EasyTAG 1 +.SH NAME +EasyTAG @VERSION@ \- Tag editor for MP3 and Ogg Vorbis files +.SH SYNOPSIS +.na +.nh +.B easytag +.RI [options] +.br +.B easytag +.RI [directory] + +.SH DESCRIPTION +.B EasyTAG +is an utility for viewing and editing tags for MP3, MP2, FLAC, Ogg Vorbis, +MP4/AAC, MusePack and Monkey's Audio files. Its simple and nice GTK2 interface +makes tagging easier under GNU/Linux. + +.SH OPTIONS +.TP +.B \-\-help +Display a short help +.TP +.B \-\-version +Display version information +.TP +.B [directory] +Choose the directory to open at startup. It can be either +an absolute path or a relative path. + +.SH AVAILABILITY +.PP +EasyTAG is licensed under the +GNU Public License(GPL). A copy of that license should +have come with the package in the file COPYING. You are +encouraged to distribute copies of the Samba suite, but +please obey the terms of this license. +.PP +The latest version of EasyTAG can be +obtained via the project's webpage +<URL: \fIhttp://easytag.sourceforge.net/\fR> + +.SH FILES +.PP +EasyTAG will create a directory named .easytag in your home +directory where it stores its configuration file and history files. +.br +\fI@prefix@/bin/easytag\fR: \fBEasyTAG\fR's location. +.br +\fI~/.easytag/easytagrc\fR: \fBEasyTAG\fR's configuration file. +.br + +.SH VERSION +.PP +This man page is done for the version @VERSION@ of EasyTAG. + +.SH AUTHOR +.PP +The author of this software is Jerome COUDERC. +.PP +You can mail him about EasyTAG at <\fIeasytag@gmail.com\fR> +.PP +This man page was originally written by Pauliuc George <\fIpauliuc@gmx.net\fR> diff --git a/doc/id3/easy.html b/doc/id3/easy.html new file mode 100755 index 0000000..d6bce99 --- /dev/null +++ b/doc/id3/easy.html @@ -0,0 +1,52 @@ +<HTML><head><title>ID3v2 made easy</title>
+<style type="text/css">
+td.h1 {font: 43px Arial, Helvetica}
+td.h2 {font: 27px Arial, Helvetica}
+div.h5 {font: 14px Arial, Helvetica}
+td.t {font: 14px Arial, Helvetica}
+a {color: #DD6600; text-decoration: none}
+b {font-weight: bold}
+</style>
+<META name="description" content="Information about a new ID3 format, ID3v2.">
+<META name="keywords" content="ID3v2, ID3, MP3">
+</head>
+<body bgcolor=white text=black><center>
+
+<table border=0><tr><td class=h1> ID3v2 made easy </td></tr><tr><td bgcolor="#FF7700"><img src="fillpx.gif" width=1 height=1 alt=""></td></tr></table>
+
+<br>
+
+<table border=0 width="90%"><tr><td class=h2>What is ID3v2?</td></tr></table>
+
+<table border=0 width="80%"><tr valign=top><td class=t>
+<p>ID3v2 is a new tagging system that lets you put enriching and relevant information about your audio files within them. In more down to earth terms, ID3v2 is a chunk of data prepended to the binary audio data. Each ID3v2 tag holds one or more smaller chunks of information, called frames. These frames can contain any kind of information and data you could think of such as title, album, performer, website, lyrics, equalizer presets, pictures etc. The block scheme to the right is an example of how the layout of a typical ID3v2 tagged audio file may look like.</p>
+<p>One of the design goals were that the ID3v2 should be very flexible and expandable. It is very easy to add new functions to the ID3v2 tag, because, just like in HTML, all parsers will ignore any information they don't recognize. Since each frame can be 16MB and the entire tag can be 256MB you'll probably never again be in the same situation as when you tried to write a useful comment in the old ID3 being limited to 30 characters.</p>
+<p>Speaking of characters, the ID3v2 supports Unicode so even if you use the Bopomofo character set you'll be able to write in your native language. You can also include in which language you're writing so that one file might contain e.g. the same lyrics but in different languages.</p>
+<p>Even though the tag supports a lot of byte consuming capabilities like inline pictures and even the possibility to include any other file, ID3v2 still tries to use the bytes as efficient as possibly. If you convert an ID3v1 tag to an ID3v2 tag it is even likely that the new tag will be smaller. If you convert an ID3v1 tag where all fields are full (that is, all 30 characters are used in every field) to an ID3v2 tag it will be 56 bytes bigger. This is the worst case scenario for ID3v1 to ID3v2 conversion.</p>
+<p>Since it's so easy to implement new functionality into ID3v2, one can hope that we'll see a lot of creative uses for ID3v2 in the future. E.g. there is a built-in system for rating the music and counting how often you listen to a file, just to mention some brainstorm results that are included. This feature can be used to build playlists that play your favourite songs more often than others.</p>
+</td><td align=center class=t> <br><img src="id3v2_blocks.gif" width=229 height=354 alt="Internal layout of an ID3v2 tagged file."><br><i>Example of the internal layout<br>of an ID3v2 tagged file.</i></td></tr></table>
+
+<br>
+
+<table border=0 width="90%"><tr><td class=h2>Some main features</td></tr></table>
+
+<table border=0 width="80%"><tr><td class=t><ul>
+ <li>The ID3v2 tag is a container format, just like IFF or PNG files, allowing new frames (chunks) as evolution proceeds.</li>
+ <li>Residing in the beginning of the audio file makes it suitable for streaming.</li>
+ <li>Has an 'unsynchronization scheme' to prevent ID3v2-incompatible players to attempt to play the tag.</li>
+ <li>Maximum tag size is 256 megabytes and maximum frame size is 16 megabytes.</li>
+ <li>Byte conservative and with the capability to compress data it keeps the files small.</li>
+ <li>The tag supports Unicode.</li>
+ <li>Isn't entirely focused on musical audio, but also other types of audio.</li>
+ <li>Has several new text fields such as composer, conductor, media type, BPM, copyright message, etc. and the possibility to design your own as you see fit.</li>
+ <li>Can contain lyrics as well as music-synced lyrics (karaoke) in almost any language.</li>
+ <li>Is able to contain volume, balance, equalizer and reverb settings.</li>
+ <li>Could be linked to CD-databases such as <a href="http://www.cddb.com">CDDB</a>.</li>
+ <li>Is able to contain images and just about any file you want to include.</li>
+ <li>Supports enciphered information, linked information and weblinks.</li>
+ <li>and more... (a complete list of all frames and their functions can be found <a href="frames.html"><b>here</b></a>)</li>
+</ul></td></tr></table>
+
+<br>
+
+</center></body></html>
diff --git a/doc/id3/id3v2.3.0.html b/doc/id3/id3v2.3.0.html new file mode 100755 index 0000000..2aee39d --- /dev/null +++ b/doc/id3/id3v2.3.0.html @@ -0,0 +1,2257 @@ +<html><head><title>ID3v2 - Informal standard</title>
+<style type="text/css">
+body {font: 16px times}
+h1 {font: 34px times}
+h3 {font: 20px times; margin-left: 5%}
+div.h5 {font: 16px times; font-weight: bold; margin-left: 8%}
+div.t {margin-left: 10%; margin-right: 10%}
+p.t {margin-left: 10%; margin-right: 10%}
+p.ind {margin-left: 15%; margin-right: 15%}
+pre {font: 16px times}
+pre {margin-left: 40px}
+a {font: 15px arial, helvetica; color: #CC5500; text-decoration: none}
+</style>
+<META name="description" content="ID3v2 informal standard.">
+<META name="keywords" content="ID3v2">
+</head><body bgcolor=white text=black>
+
+<a name="top"> </a>
+
+<br>
+<p><table border=0 width=100%><tr><td>Informal standard<br>Document: id3v2.3.0.html</td><td align=right>
+M. Nilsson<br>3rd February 1999</td></tr></table></p>
+
+<h1 align=center>ID3 tag version 2.3.0</h1>
+
+<a name="status"> </a>
+<h3>Status of this document</h3>
+<p class=t>
+This document is an informal standard and replaces the <a href="#ID3v2">ID3v2.2.0</a>
+standard. The informal standard is released so that
+implementors could have a set standard before a formal standard is
+set. The formal standard will use another version or revision number
+if not identical to what is described in this document. The contents
+in this document may change for clarifications but never for added or
+altered functionallity.
+</p><p class=t>
+Distribution of this document is unlimited.
+</p>
+
+<a name="abstract"> </a>
+<h3>Abstract</h3>
+<p class=t>
+This document describes the <a href="#ID3v2">ID3v2.3.0</a>, which is a more developed
+version of the ID3v2 informal standard (version 2.2.0),
+evolved from the ID3 tagging system. The ID3v2 offers a flexible way
+of storing information about an audio file within itself to determine
+its origin and contents. The information may be technical
+information, such as equalisation curves, as well as related meta
+information, such as title, performer, copyright etc.
+</p>
+
+<a name="sec1"> </a>
+<h3>1.Table of contents</h3>
+
+<p><center><table border=0 width="80%"><tr><td>
+<dl>
+<dt>2. <a href="#sec2">Conventions in this document</a></dt>
+<dt>3. <a href="#sec3">ID3v2 overview</a>
+ <dd> 3.1. <a href="#sec3.1">ID3v2 header</a></dd>
+ <dd> 3.2. <a href="#sec3.2">ID3v2 extended header</a></dd>
+ <dd> 3.3. <a href="#sec3.3">ID3v2 frames overview</a></dd>
+ <dl><dd> 3.3.1. <a href="#sec3.3.1">Frame header flags</a></dd>
+ <dd> 3.3.2. <a href="#sec3.3.2">Default flags</a></dd></dl></dt>
+<dt>4. <a href="#sec4">Declared ID3v2 frames</a>
+ <dd> 4.1. <a href="#sec4.1">Unique file identifier</a></dd>
+ <dd> 4.2. <a href="#sec4.2">Text information frames</a>
+ <dl><dd> 4.2.1. <a href="#sec4.2.1">Text information frames - details</a></dd>
+ <dd> 4.2.2. <a href="#sec4.2.2">User defined text information frame</a></dd></dl></dd>
+ <dd> 4.3. <a href="#sec4.3">URL link frames</a>
+ <dl><dd>4.3.1. <a href="#sec4.3.1">URL link frames - details</a></dd>
+ <dd>4.3.2. <a href="#sec4.3.2">User defined URL link frame</a></dd></dl></dd>
+ <dd> 4.4. <a href="#sec4.4">Involved people list</a></dd>
+ <dd> 4.5. <a href="#sec4.5">Music CD Identifier</a></dd>
+ <dd> 4.6. <a href="#sec4.6">Event timing codes</a></dd>
+ <dd> 4.7. <a href="#sec4.7">MPEG location lookup table</a></dd>
+ <dd> 4.8. <a href="#sec4.8">Synced tempo codes</a></dd>
+ <dd> 4.9. <a href="#sec4.9">Unsychronised lyrics/text transcription</a></dd>
+ <dd> 4.10. <a href="#sec4.10">Synchronised lyrics/text</a></dd>
+ <dd> 4.11. <a href="#sec4.11">Comments</a></dd>
+ <dd> 4.12. <a href="#sec4.12">Relative volume adjustment</a></dd>
+ <dd> 4.13. <a href="#sec4.13">Equalisation</a></dd>
+ <dd> 4.14. <a href="#sec4.14">Reverb</a></dd>
+ <dd> 4.15. <a href="#sec4.15">Attached picture</a></dd>
+ <dd> 4.16. <a href="#sec4.16">General encapsulated object</a></dd>
+ <dd> 4.17. <a href="#sec4.17">Play counter</a></dd>
+ <dd> 4.18. <a href="#sec4.18">Popularimeter</a></dd>
+ <dd> 4.19. <a href="#sec4.19">Recommended buffer size</a></dd>
+ <dd> 4.20. <a href="#sec4.20">Audio encryption</a></dd>
+ <dd> 4.21. <a href="#sec4.21">Linked information</a></dd>
+ <dd> 4.22. <a href="#sec4.22">Position synchronisation frame</a></dd>
+ <dd> 4.23. <a href="#sec4.23">Terms of use</a></dd>
+ <dd> 4.24. <a href="#sec4.24">Ownership frame</a></dd>
+ <dd> 4.25. <a href="#sec4.25">Commercial frame</a></dd>
+ <dd> 4.26. <a href="#sec4.26">Encryption method registration</a></dd>
+ <dd> 4.27. <a href="#sec4.27">Group identification registration</a></dd>
+ <dd> 4.28. <a href="#sec4.28">Private frame</a></dd></dt>
+<dt>5. <a href="#sec5">The 'unsynchronisation scheme'</a></dt>
+<dt>6. <a href="#sec6">Copyright</a></dt>
+<dt>7. <a href="#sec7">References</a></dt>
+<dt>8. <a href="#sec8">Appendix</a>
+ <dd> A. <a href="#secA">Appendix A - Genre List from ID3v1</a></dd></dt>
+<dt>9. <a href="#sec9">Author's Address</a></dt>
+</dl>
+</td></tr></table></center></p>
+
+<a name="sec2"> </a>
+<h3>2.Conventions in this document</h3>
+<p class=t>
+In the examples, text within "" is a text string exactly as it
+appears in a file. Numbers preceded with $ are hexadecimal and
+numbers preceded with % are binary. $xx is used to indicate a byte
+with unknown content. %x is used to indicate a bit with unknown
+content. The most significant bit (MSB) of a byte is called 'bit 7'
+and the least significant bit (LSB) is called 'bit 0'.
+</p><p class=t>
+A tag is the whole tag described in this document. A frame is a block
+of information in the tag. The tag consists of a header, frames and
+optional padding. A field is a piece of information; one value, a
+string etc. A numeric string is a string that consists of the
+characters 0-9 only.
+</p>
+
+<a name="sec3"> </a>
+<h3>3.ID3v2 overview</h3>
+<p class=t>
+The two biggest design goals were to be able to implement ID3v2
+without disturbing old software too much and that ID3v2 should be
+as flexible and expandable as possible.
+</p><p class=t>
+The first criterion is met by the simple fact that the <a href="#MPEG">MPEG</a>
+decoding software uses a syncsignal, embedded in the audiostream, to
+'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
+syncsignal, no software will attempt to play the tag. If, for any
+reason, coincidence make a syncsignal appear within the tag it will
+be taken care of by the 'unsynchronisation scheme' described in
+<a href="#sec5">section 5</a>.
+</p><p class=t>
+The second criterion has made a more noticeable impact on the design
+of the ID3v2 tag. It is constructed as a container for several
+information blocks, called frames, whose format need not be known to
+the software that encounters them. At the start of every frame there
+is an identifier that explains the frames' format and content, and a
+size descriptor that allows software to skip unknown frames.
+</p><p class=t>
+If a total revision of the ID3v2 tag should be needed, there is a
+version number and a size descriptor in the ID3v2 header.
+</p><p class=t>
+The ID3 tag described in this document is mainly targeted at files
+encoded with <a href="#MPEG">MPEG</a>-1/2 layer I, <a href="#MPEG">MPEG</a>-1/2 layer II, <a href="#MPEG">MPEG</a>-1/2 layer III
+and MPEG-2.5, but may work with other types of encoded audio.
+</p><p class=t>
+The bitorder in ID3v2 is most significant bit first (MSB). The
+byteorder in multibyte numbers is most significant byte first (e.g.
+$12345678 would be encoded $12 34 56 78).
+</p><p class=t>
+It is permitted to include padding after all the final frame (at the
+end of the ID3 tag), making the size of all the frames together
+smaller than the size given in the head of the tag. A possible
+purpose of this padding is to allow for adding a few additional
+frames or enlarge existing frames within the tag without having to
+rewrite the entire file. The value of the padding bytes must be $00.
+</p>
+
+<a name="sec3.1"> </a>
+<h3>3.1.ID3v2 header</h3>
+<p class=t>
+The ID3v2 tag header, which should be the first information in the
+file, is 10 bytes as follows:
+</p>
+<p><center><table border=0 width="70%">
+<tr><td nowrap>ID3v2/file identifier</td><td rowspan=4> </td><td width="100%">"ID3"</td></tr>
+<tr><td>ID3v2 version</td><td>$03 00</td></tr>
+<tr><td>ID3v2 flags</td><td>%abc00000</td></tr>
+<tr><td>ID3v2 size</td><td>4 * %0xxxxxxx</td></tr>
+</table></center></p>
+<p class=t>
+The first three bytes of the tag are always "ID3" to indicate that
+this is an ID3v2 tag, directly followed by the two version bytes. The
+first byte of ID3v2 version is it's major version, while the second
+byte is its revision number. In this case this is ID3v2.3.0. All
+revisions are backwards compatible while major versions are not. If
+software with ID3v2.2.0 and below support should encounter version
+three or higher it should simply ignore the whole tag. Version and
+revision will never be $FF.
+</p><p class=t>
+The version is followed by one the ID3v2 flags field, of which
+currently only three flags are used.
+</p>
+<p class=t>
+a - Unsynchronisation
+</p><p class=ind>
+Bit 7 in the 'ID3v2 flags' indicates whether or not unsynchronisation is used (see <a href="#sec5">section 5</a> for details); a set bit indicates usage.</p>
+<p class=t>
+b - Extended header
+</p><p class=ind>
+ The second bit (bit 6) indicates whether or not the header is
+ followed by an extended header. The extended header is described in
+ <a href="#sec3.2">section 3.2</a>.
+</p>
+<p class=t>
+c - Experimental indicator
+</p><p class=ind>
+ The third bit (bit 5) should be used as an 'experimental
+ indicator'. This flag should always be set when the tag is in an
+ experimental stage.
+</p><p class=t>
+All the other flags should be cleared. If one of these undefined
+flags are set that might mean that the tag is not readable for a
+parser that does not know the flags function.
+</p><p class=t>
+The ID3v2 tag size is encoded with four bytes where the most
+significant bit (bit 7) is set to zero in every byte, making a total
+of 28 bits. The zeroed bits are ignored, so a 257 bytes long tag is
+represented as $00 00 02 01.
+</p><p class=t>
+The ID3v2 tag size is the size of the complete tag after
+unsychronisation, including padding, excluding the header but not
+excluding the extended header (total tag size - 10). Only 28 bits
+(representing up to 256MB) are used in the size description to avoid
+the introducuction of 'false syncsignals'.
+</p><p class=t>
+An ID3v2 tag can be detected with the following pattern:<br>
+ $49 44 33 yy yy xx zz zz zz zz<br>
+Where yy is less than $FF, xx is the 'flags' byte and zz is less than
+$80.
+</p>
+
+<a name="sec3.2"> </a>
+<h3>3.2.ID3v2 extended header</h3>
+<p class=t>
+The extended header contains information that is not vital to the
+correct parsing of the tag information, hence the extended header is
+optional.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td nowrap> Extended header size</td><td rowspan=3> </td><td width=100%>$xx xx xx xx</td></tr>
+<tr><td>Extended Flags</td><td>$xx xx</td></tr>
+<tr><td>Size of padding</td><td>$xx xx xx xx</tr>
+</table></center></p>
+<p class=t>
+Where the 'Extended header size', currently 6 or 10 bytes, excludes
+itself. The 'Size of padding' is simply the total tag size excluding
+the frames and the headers, in other words the padding. The extended
+header is considered separate from the header proper, and as such is
+subject to unsynchronisation.
+</p><p class=t>
+The extended flags are a secondary flag set which describes further
+attributes of the tag. These attributes are currently defined as
+follows
+</p><p class=ind>
+ %x0000000 00000000
+</p>
+<p class=t>
+x - CRC data present
+</p><p class=ind>
+ If this flag is set four bytes of CRC-32 data is appended to the
+ extended header. The CRC should be calculated before
+ unsynchronisation on the data between the extended header and the
+ padding, i.e. the frames and only the frames.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td nowrap> Total frame CRC</td><td> </td><td>$xx xx xx xx</td></tr>
+</table></center></p>
+
+
+<a name="sec3.3"> </a>
+<h3>3.3.ID3v2 frame overview</h3>
+<p class=t>
+As the tag consists of a tag header and a tag body with one or more
+frames, all the frames consists of a frame header followed by one or
+more fields containing the actual information. The layout of the
+frame header:
+</p>
+<p><center><table border=0 width="70%">
+<tr><td nowrap> Frame ID</td><td rowspan=3> </td><td width="100%">$xx xx xx xx (four characters)</td></tr>
+<tr><td>Size</td><td>$xx xx xx xx</td></tr>
+<tr><td>Flags</td><td>$xx xx</td></tr>
+</table></center></p>
+<p class=t>
+The frame ID made out of the characters capital A-Z and 0-9.
+Identifiers beginning with "X", "Y" and "Z" are for experimental use
+and free for everyone to use, without the need to set the
+experimental bit in the tag header. Have in mind that someone else
+might have used the same identifier as you. All other identifiers are
+either used or reserved for future use.
+</p><p class=t>
+The frame ID is followed by a size descriptor, making a total header
+size of ten bytes in every frame. The size is calculated as frame
+size excluding frame header (frame size - 10).
+</p><p class=t>
+In the frame header the size descriptor is followed by two flags
+bytes. These flags are described in <a href="#sec3.3.1">section 3.3.1.</a>
+</p><p class=t>
+There is no fixed order of the frames' appearance in the tag,
+although it is desired that the frames are arranged in order of
+significance concerning the recognition of the file. An example of
+such order: <a href="#sec4.1">UFID</a>, <a href="#TIT2">TIT2</a>, <a href="#sec4.5">MCDI</a>, <a href="#TRCK">TRCK</a> ...
+</p><p class=t>
+A tag must contain at least one frame. A frame must be at least 1
+byte big, excluding the header.
+</p><p class=t>
+If nothing else is said a string is represented as
+<a href="#ISO-8859-1">ISO-8859-1</a> characters in the range $20 - $FF. Such strings are
+represented as <text string>, or <full text string> if newlines are
+allowed, in the frame descriptions. All <a href="#UNICODE">Unicode</a> strings use
+16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). Unicode strings
+must begin with the Unicode BOM ($FF FE or $FE FF) to identify the
+byte order.
+</p><p class=t>
+All numeric strings and <a href="#URL">URLs</a> are always encoded as <a href="#ISO-8859-1">ISO-8859-1</a>.
+Terminated strings are terminated with $00 if encoded with <a href="#ISO-8859-1">ISO-8859-1</a>
+and $00 00 if encoded as unicode. If nothing else is said newline
+character is forbidden. In <a href="#ISO-8859-1">ISO-8859-1</a> a new line is represented, when
+allowed, with $0A only. Frames that allow different types of text
+encoding have a text encoding description byte directly after the
+frame size. If <a href="#ISO-8859-1">ISO-8859-1</a> is used this byte should be $00, if Unicode
+is used it should be $01. Strings dependent on encoding is
+represented as <text string according to encoding>, or <full text
+string according to encoding> if newlines are allowed. Any empty
+<a href="#UNICODE">Unicode</a> strings which are NULL-terminated may have the Unicode BOM
+followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
+</p><p class=t>
+The three byte language field is used to describe the language of the
+frame's content, according to <a href="#ISO-639-2">ISO-639-2</a>.
+</p><p class=t>
+All <a href="#URL">URLs</a> may be relative, e.g. "picture.png", "../doc.txt".
+</p><p class=t>
+If a frame is longer than it should be, e.g. having more fields than
+specified in this document, that indicates that additions to the
+frame have been made in a later version of the ID3v2 standard. This
+is reflected by the revision number in the header of the tag.
+</p>
+
+<a name="sec3.3.1"> </a>
+<h3>3.3.1.Frame header flags</h3>
+<p class=t>
+In the frame header the size descriptor is followed by two flags
+bytes. All unused flags must be cleared. The first byte is for
+'status messages' and the second byte is for encoding purposes. If an
+unknown flag is set in the first byte the frame may not be changed
+without the bit cleared. If an unknown flag is set in the second byte
+it is likely to not be readable. The flags field is defined as
+follows.
+</p><p class=ind>
+ %abc00000 %ijk00000
+</p>
+<p class=t>
+a - Tag alter preservation
+</p><p class=ind>
+ This flag tells the software what to do with this frame if it is
+ unknown and the tag is altered in any way. This applies to all
+ kinds of alterations, including adding more padding and reordering
+ the frames.</p>
+<p><center><table border=0 width="70%">
+<tr><td>0 </td><td>Frame should be preserved.</td></tr>
+<tr><td>1</td><td>Frame should be discarded.</td></tr>
+</table></center>
+</p>
+<p class=t>
+b - File alter preservation
+</p><p class=ind>
+ This flag tells the software what to do with this frame if it is
+ unknown and the file, excluding the tag, is altered. This does not
+ apply when the audio is completely replaced with other audio data.</p>
+<p><center><table border=0 width="70%">
+<tr><td>0 </td><td>Frame should be preserved.</td></tr>
+<tr><td>1</td><td>Frame should be discarded.</td></tr>
+</table></center>
+</p>
+<p class=t>
+c - Read only
+</p><p class=ind>
+This flag, if set, tells the software that the contents of this
+frame is intended to be read only. Changing the contents might
+break something, e.g. a signature. If the contents are changed,
+without knowledge in why the frame was flagged read only and
+without taking the proper means to compensate, e.g. recalculating
+the signature, the bit should be cleared.
+</p>
+<p class=t>
+i - Compression
+</p>
+<p class=ind>This flag indicates whether or not the frame is compressed.</p>
+<p><center><table border=0 width="70%">
+<tr><td>0 </td><td>Frame is not compressed.</td></tr>
+<tr><td>1</td><td>Frame is compressed using <a href="#ZLIB">zlib</a> with 4 bytes for 'decompressed size' appended to the frame header.</td></tr>
+</table></center>
+</p>
+<p class=t>
+j - Encryption
+</p><p class=ind>
+This flag indicates wether or not the frame is enrypted. If set
+one byte indicating with which method it was encrypted will be
+appended to the frame header. See <a href="#sec4.26">section 4.26.</a> for more
+information about encryption method registration.
+</p><p><center><table border=0 width="70%">
+<tr><td>0 </td><td>Frame is not encrypted.</td></tr>
+<tr><td>1</td><td>Frame is encrypted.</td></tr>
+</table></center>
+</p>
+<p class=t>
+k - Grouping identity
+</p><p class=ind>
+This flag indicates whether or not this frame belongs in a group
+with other frames. If set a group identifier byte is added to the
+frame header. Every frame with the same group identifier belongs
+to the same group.
+</p><p><center><table border=0 width="70%">
+<tr><td>0 </td><td>Frame does not contain group information</td></tr>
+<tr><td>1</td><td>Frame contains group information</td></tr>
+</table></center>
+</p>
+<p class=t>
+Some flags indicates that the frame header is extended with
+additional information. This information will be added to the frame
+header in the same order as the flags indicating the additions. I.e.
+the four bytes of decompressed size will preceed the encryption
+method byte. These additions to the frame header, while not included
+in the frame header size but are included in the 'frame size' field,
+are not subject to encryption or compression.
+</p>
+
+<a name="sec3.3.2"> </a>
+<h3>3.3.2.Default flags</h3>
+<p class=t>
+The default settings for the frames described in this document can be
+divided into the following classes. The flags may be set differently
+if found more suitable by the software.
+</p><p class=t>
+ 1. Discarded if tag is altered, discarded if file is altered.
+</p><p class=ind>
+ None.
+</p><p class=t>
+ 2. Discarded if tag is altered, preserved if file is altered.
+</p><p class=ind>
+ None.
+</p><p class=t>
+ 3. Preserved if tag is altered, discarded if file is altered.
+</p><p class=ind>
+ <a href="#sec4.21>AENC</a>, <a href="#sec4.6">ETCO</a>, <a href="#sec4.13">EQUA</a>, <a href="#sec4.7">MLLT</a>, <a href="#sec4.22">POSS</a>, <a href="#4.10">SYLT</a>, <a href="#sec4.8">SYTC</a>, <a href="#4.12">RVAD</a>, <a href="#TENC">TENC</a>, <a href="#TLEN">TLEN</a>, <a href="#TSIZ">TSIZ</a>
+</p><p class=t>
+ 4. Preserved if tag is altered, preserved if file is altered.
+</p><p class=ind>
+ The rest of the frames.
+</p>
+
+<a name="sec4"> </a>
+<h3>4.Declared ID3v2 frames</h3>
+</p><p class=t>
+The following frames are declared in this draft.
+</p><p><center><table border=0 width="70%">
+<tr><td>4.20</td><td>AENC</td><td width="100%"><a href="#sec4.20"> Audio encryption</a></td></tr>
+<tr><td>4.15</td><td>APIC</td><td><a href="#sec4.15">Attached picture</a></td></tr>
+
+<tr><td>4.11</td><td>COMM</td><td><a href="#sec4.11">Comments</a></td></tr>
+<tr><td>4.25</td><td>COMR</td><td><a href="#sec4.25">Commercial frame</a></td></tr>
+
+<tr><td>4.26</td><td>ENCR</td><td><a href="#sec4.26">Encryption method registration</a></td></tr>
+<tr><td>4.13</td><td>EQUA</td><td><a href="#sec4.13">Equalization</a></td></tr>
+<tr><td>4.6 </td><td>ETCO</td><td><a href="#sec4.6">Event timing codes</a></td></tr>
+
+<tr><td>4.16</td><td>GEOB</td><td><a href="#sec4.16">General encapsulated object</a></td></tr>
+<tr><td>4.27</td><td>GRID</td><td><a href="#sec4.27">Group identification registration</a></td></tr>
+
+<tr><td>4.4 </td><td>IPLS</td><td><a href="#sec4.4">Involved people list</a></td></tr>
+
+<tr><td>4.21</td><td>LINK</td><td><a href="#sec4.21">Linked information</a></td></tr>
+
+<tr><td>4.5 </td><td>MCDI</td><td><a href="#sec4.5">Music CD identifier</a></td></tr>
+<tr><td>4.7 </td><td>MLLT</td><td><a href="#sec4.7">MPEG location lookup table</a></td></tr>
+
+<tr><td>4.24</td><td>OWNE</td><td><a href="#sec4.24">Ownership frame</a></td></tr>
+
+<tr><td>4.28</td><td>PRIV</td><td><a href="#sec4.28">Private frame</a></td></tr>
+<tr><td>4.17</td><td>PCNT</td><td><a href="#sec4.17">Play counter</a></td></tr>
+<tr><td>4.18</td><td>POPM</td><td><a href="#sec4.18">Popularimeter</a></td></tr>
+<tr><td>4.22</td><td>POSS</td><td><a href="#sec4.22">Position synchronisation frame</a></td></tr>
+
+<tr><td>4.19</td><td>RBUF</td><td><a href="#sec4.19">Recommended buffer size</a></td></tr>
+<tr><td>4.12</td><td>RVAD</td><td><a href="#sec4.12">Relative volume adjustment</a></td></tr>
+<tr><td>4.14</td><td>RVRB</td><td><a href="#sec4.14">Reverb</a></td></tr>
+
+<tr><td>4.10</td><td>SYLT</td><td><a href="#sec4.10">Synchronized lyric/text</a></td></tr>
+<tr><td>4.8 </td><td>SYTC</td><td><a href="#sec4.8">Synchronized tempo codes</a></td></tr>
+
+<tr><td>4.2.1</td><td>TALB</td><td><a href="#TALB">Album/Movie/Show title</a></td></tr>
+<tr><td>4.2.1</td><td>TBPM</td><td><a href="#TBPM">BPM (beats per minute)</a></td></tr>
+<tr><td>4.2.1</td><td>TCOM</td><td><a href="#TCOM">Composer</a></td></tr>
+<tr><td>4.2.1</td><td>TCON</td><td><a href="#TCON">Content type</a></td></tr>
+<tr><td>4.2.1</td><td>TCOP</td><td><a href="#TCOP">Copyright message</a></td></tr>
+<tr><td>4.2.1</td><td>TDAT</td><td><a href="#TDAT">Date</a></td></tr>
+<tr><td>4.2.1</td><td>TDLY</td><td><a href="#TDLY">Playlist delay</a></td></tr>
+<tr><td>4.2.1</td><td>TENC</td><td><a href="#TENC">Encoded by</a></td></tr>
+<tr><td>4.2.1</td><td>TEXT</td><td><a href="#TEXT">Lyricist/Text writer</a></td></tr>
+<tr><td>4.2.1</td><td>TFLT</td><td><a href="#TFLT">File type</a></td></tr>
+<tr><td>4.2.1</td><td>TIME</td><td><a href="#TIME">Time</a></td></tr>
+<tr><td>4.2.1</td><td>TIT1</td><td><a href="#TIT1">Content group description</a></td></tr>
+<tr><td>4.2.1</td><td>TIT2</td><td><a href="#TIT2">Title/songname/content description</a></td></tr>
+<tr><td>4.2.1</td><td>TIT3</td><td><a href="#TIT3">Subtitle/Description refinement</a></td></tr>
+<tr><td>4.2.1</td><td>TKEY</td><td><a href="#TKEY">Initial key</a></td></tr>
+<tr><td>4.2.1</td><td>TLAN</td><td><a href="#TLAN">Language(s)</a></td></tr>
+<tr><td>4.2.1</td><td>TLEN</td><td><a href="#TLEN">Length</a></td></tr>
+<tr><td>4.2.1</td><td>TMED</td><td><a href="#TMED">Media type</a></td></tr>
+<tr><td>4.2.1</td><td>TOAL</td><td><a href="#TOAL">Original album/movie/show title</a></td></tr>
+<tr><td>4.2.1</td><td>TOFN</td><td><a href="#TOFN">Original filename</a></td></tr>
+<tr><td>4.2.1</td><td>TOLY</td><td><a href="#TOLY">Original lyricist(s)/text writer(s)</a></td></tr>
+<tr><td>4.2.1</td><td>TOPE</td><td><a href="#TOPE">Original artist(s)/performer(s)</a></td></tr>
+<tr><td>4.2.1</td><td>TORY</td><td><a href="#TORY">Original release year</a></td></tr>
+<tr><td>4.2.1</td><td>TOWN</td><td><a href="#TOWN">File owner/licensee</a></td></tr>
+<tr><td>4.2.1</td><td>TPE1</td><td><a href="#TPE1">Lead performer(s)/Soloist(s)</a></td></tr>
+<tr><td>4.2.1</td><td>TPE2</td><td><a href="#TPE2">Band/orchestra/accompaniment</a></td></tr>
+<tr><td>4.2.1</td><td>TPE3</td><td><a href="#TPE3">Conductor/performer refinement</a></td></tr>
+<tr><td>4.2.1</td><td>TPE4</td><td><a href="#TPE4">Interpreted, remixed, or otherwise modified by</a></td></tr>
+<tr><td>4.2.1</td><td>TPOS</td><td><a href="#TPOS">Part of a set</a></td></tr>
+<tr><td>4.2.1</td><td>TPUB</td><td><a href="#TPUB">Publisher</a></td></tr>
+<tr><td>4.2.1</td><td>TRCK</td><td><a href="#TRCK">Track number/Position in set</a></td></tr>
+<tr><td>4.2.1</td><td>TRDA</td><td><a href="#TRDA">Recording dates</a></td></tr>
+<tr><td>4.2.1</td><td>TRSN</td><td><a href="#TRSN">Internet radio station name</a></td></tr>
+<tr><td>4.2.1</td><td>TRSO</td><td><a href="#TRSO">Internet radio station owner</a></td></tr>
+<tr><td>4.2.1</td><td>TSIZ</td><td><a href="#TSIZ">Size</a></td></tr>
+<tr><td>4.2.1</td><td>TSRC</td><td><a href="#TSRC">ISRC (international standard recording code)</a></td></tr>
+<tr><td>4.2.1</td><td>TSSE</td><td><a href="#TSSE">Software/Hardware and settings used for encoding</a></td></tr>
+<tr><td>4.2.1</td><td>TYER</td><td><a href="#TYER">Year</a></td></tr>
+<tr><td>4.2.2</td><td>TXXX</td><td><a href="#TXXX">User defined text information frame</a></td></tr>
+
+<tr><td>4.1 </td><td>UFID</td><td><a href="#sec4.1">Unique file identifier</td></tr>
+<tr><td>4.23</td><td>USER</td><td><a href="#sec4.23">Terms of use</td></tr>
+<tr><td>4.9 </td><td>USLT</td><td><a href="#sec4.9">Unsychronized lyric/text transcription</td></tr>
+
+<tr><td>4.3.1</td><td>WCOM</td><td><a href="#WCOM">Commercial information</a></td></tr>
+<tr><td>4.3.1</td><td>WCOP</td><td><a href="#WCOP">Copyright/Legal information</a></td></tr>
+<tr><td>4.3.1</td><td>WOAF</td><td><a href="#WOAF">Official audio file webpage</a></td></tr>
+<tr><td>4.3.1</td><td>WOAR</td><td><a href="#WOAR">Official artist/performer webpage</a></td></tr>
+<tr><td>4.3.1</td><td>WOAS</td><td><a href="#WOAS">Official audio source webpage</a></td></tr>
+<tr><td>4.3.1</td><td>WORS</td><td><a href="#WORS">Official internet radio station homepage</a></td></tr>
+<tr><td>4.3.1</td><td>WPAY</td><td><a href="#WPAY">Payment</a></td></tr>
+<tr><td>4.3.1</td><td>WPUB</td><td><a href="#WPUB">Publishers official webpage</a></td></tr>
+<tr><td>4.3.2</td><td>WXXX</td><td><a href="#WXXX">User defined URL link frame</a></td></tr>
+</table></center>
+</p>
+
+<a name="sec4.1"> </a>
+<h3>4.1.Unique file identifier</h3>
+<p class=t>
+This frame's purpose is to be able to identify the audio file in a
+database that may contain more information relevant to the content.
+Since standardisation of such a database is beyond this document, all
+frames begin with a null-terminated string with a <a href="#URL">URL</a>
+containing an email address, or a link to a location where an email
+address can be found, that belongs to the organisation responsible
+for this specific database implementation. Questions regarding the
+database should be sent to the indicated email address. The <a href="#URL">URL</a>
+should not be used for the actual database queries. The string
+"http://www.id3.org/dummy/ufid.html" should be used for tests.
+Software that isn't told otherwise may safely remove such frames. The
+'Owner identifier' must be non-empty (more than just a termination).
+The 'Owner identifier' is then followed by the actual identifier,
+which may be up to 64 bytes. There may be more than one "UFID" frame
+in a tag, but only one with the same 'Owner identifier'.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Unique file identifier', ID: "UFID"></td></tr>
+<tr><td>Owner identifier</td><td width="80%"><text string> $00</td></tr>
+<tr><td>Identifier</td><td><up to 64 bytes binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.2"> </a>
+<h3>4.2.Text information frames</h3>
+<p class=t>
+The text information frames are the most important frames, containing
+information like artist, album and more. There may only be one text
+information frame of its kind in an tag. If the textstring is
+followed by a termination ($00 (00)) all the following information
+should be ignored and not be displayed. All text frame identifiers
+begin with "T". Only text frame identifiers begin with "T", with the
+exception of the "<a href="#sec4.2.2">TXXX</a>" frame. All the text information frames have
+the following format:
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Text information frame', ID: "T000" - "TZZZ", excluding "TXXX" described in 4.2.2.></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>Information </td><td><text string according to encoding></td></tr>
+</table></center></p>
+
+<a name="sec4.2.1"> </a>
+<h3>4.2.1.Text information frames - details</h3>
+<p>
+<a name="TALB"> </a>
+<div class=h5>TALB</div>
+<div class=t>
+The 'Album/Movie/Show title' frame is intended for the title of the
+recording(/source of sound) which the audio in the file is taken
+from.
+</div>
+</p>
+
+<p>
+<a name="TBPM"> </a>
+<div class=h5>TBPM</div>
+<div class=t>The 'BPM' frame contains the number of beats per minute in the
+mainpart of the audio. The BPM is an integer and represented as a
+numerical string.</div>
+</p>
+
+<p>
+<a name="TCOM"> </a>
+<div class=h5>TCOM</div>
+<div class=t>The 'Composer(s)' frame is intended for the name of the composer(s).
+They are seperated with the "/" character.</div>
+</p>
+
+<p>
+<a name="TCON"> </a>
+<div class=h5>TCON</div>
+<div class=t>The 'Content type', which previously was
+stored as a one byte numeric value only, is now a numeric string. You
+may use one or several of the types as ID3v1.1 did or, since the
+category list would be impossible to maintain with accurate and up to
+date categories, define your own.
+</div></p>
+<p><div class=t>
+References to the ID3v1 genres can be made by, as first byte, enter
+"(" followed by a number from the genres list (<a href="#secA">appendix A</a>) and
+ended with a ")" character. This is optionally followed by a
+refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
+made in the same frame, e.g. "(51)(39)". If the refinement should
+begin with a "(" character it should be replaced with "((", e.g. "((I
+can figure out any genre)" or "(55)((I think...)". The following new
+content types is defined in ID3v2 and is implemented in the same way
+as the numerig content types, e.g. "(RX)".</div>
+</p>
+<p><center><table border=0 width="70%">
+<tr><td>RX</td><td width="100%">Remix</td></tr>
+<tr><td>CR</td><td>Cover</td></tr>
+</table></center>
+</p>
+
+<p>
+<a name="TCOP"> </a>
+<div class=h5>TCOP</div>
+<div class=t>The 'Copyright message' frame, which must begin with a year and a
+space character (making five characters), is intended for the
+copyright holder of the original sound, not the audio file itself.
+The absence of this frame means only that the copyright information
+is unavailable or has been removed, and must not be interpreted to
+mean that the sound is public domain. Every time this field is
+displayed the field must be preceded with "Copyright © ".</div>
+</p>
+
+<p>
+<a name="TDAT"> </a>
+<div class=h5>TDAT</div>
+<div class=t>The 'Date' frame is a numeric string in the DDMM format containing
+the date for the recording. This field is always four characters
+long.</div>
+</p>
+
+<p>
+<a name="TDLY"> </a>
+<div class=h5>TDLY</div>
+<div class=t>The 'Playlist delay' defines the numbers of milliseconds of silence
+between every song in a playlist. The player should use the "ETC"
+frame, if present, to skip initial silence and silence at the end of
+the audio to match the 'Playlist delay' time. The time is represented
+as a numeric string.</div>
+</p>
+
+<p>
+<a name="TENC"> </a>
+<div class=h5>TENC</div>
+<div class=t>The 'Encoded by' frame contains the name of the person or
+organisation that encoded the audio file. This field may contain a
+copyright message, if the audio file also is copyrighted by the
+encoder.</div>
+</p>
+
+<p>
+<a name="TEXT"> </a>
+<div class=h5>TEXT</div>
+<div class=t>The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
+of the text or lyrics in the recording. They are seperated with the
+"/" character.</div>
+</p>
+
+<p>
+<a name="TFLT"> </a>
+<div class=h5>TFLT</div>
+<div class=t>The 'File type' frame indicates which type of audio this tag defines.
+The following type and refinements are defined:
+</div></p>
+<p><center><table border=0 width="70%">
+<tr><td>MPG</td><td rowspan=8> </td><td width="100%">MPEG Audio</td></tr>
+<tr><td align=right>/1</td><td>MPEG 1/2 layer I</td></tr>
+<tr><td align=right>/2</td><td>MPEG 1/2 layer II</td></tr>
+<tr><td align=right>/3</td><td>MPEG 1/2 layer III</td></tr>
+<tr><td align=right>/2.5</td><td>MPEG 2.5</td></tr>
+<tr><td align=right> /AAC</td><td>Advanced audio compression</td></tr>
+<tr><td>VQF</td><td>Transform-domain Weighted Interleave Vector Quantization</td></tr>
+<tr><td>PCM</td><td>Pulse Code Modulated audio</td></tr>
+</table></center></p>
+<p><div class=t>
+but other types may be used, not for these types though. This is used
+in a similar way to the predefined types in the "TMED" frame, but
+without parentheses. If this frame is not present audio type is
+assumed to be "MPG".</div>
+</p>
+
+<p>
+<a name="TIME"> </a>
+<div class=h5>TIME</div>
+<div class=t>The 'Time' frame is a numeric string in the HHMM format containing
+the time for the recording. This field is always four characters
+long.</div>
+</p>
+
+<p>
+<a name="TIT1"> </a>
+<div class=h5>TIT1</div>
+<div class=t>The 'Content group description' frame is used if the sound belongs to
+a larger category of sounds/music. For example, classical music is
+often sorted in different musical sections (e.g. "Piano Concerto",
+"Weather - Hurricane").</div>
+</p>
+
+<p>
+<a name="TIT2"> </a>
+<div class=h5>TIT2</div>
+<div class=t>The 'Title/Songname/Content description' frame is the actual name of
+the piece (e.g. "Adagio", "Hurricane Donna").</div>
+</p>
+
+<p>
+<a name="TIT3"> </a>
+<div class=h5>TIT3</div>
+<div class=t>The 'Subtitle/Description refinement' frame is used for information
+directly related to the contents title (e.g. "Op. 16" or "Performed
+live at Wembley").</div>
+</p>
+
+<p>
+<a name="TKEY"> </a>
+<div class=h5>TKEY</div>
+<div class=t>The 'Initial key' frame contains the musical key in which the sound
+starts. It is represented as a string with a maximum length of three
+characters. The ground keys are represented with "A","B","C","D","E",
+"F" and "G" and halfkeys represented with "b" and "#". Minor is
+represented as "m". Example "Cbm". Off key is represented with an "o"
+only.</div>
+</p>
+
+<p>
+<a name="TLAN"> </a>
+<div class=h5>TLAN</div>
+<div class=t>The 'Language(s)' frame should contain the languages of the text or
+lyrics spoken or sung in the audio. The language is represented with
+three characters according to <a href="#ISO-639-2">ISO-639-2</a>. If more than one language is
+used in the text their language codes should follow according to
+their usage.</div>
+</p>
+
+<p>
+<a name="TLEN"> </a>
+<div class=h5>TLEN</div>
+<div class=t>The 'Length' frame contains the length of the audiofile in
+milliseconds, represented as a numeric string.</div>
+</p>
+
+<p>
+<a name="TMED"> </a>
+<div class=h5>TMED</div>
+<div class=t>The 'Media type' frame describes from which media the sound
+originated. This may be a text string or a reference to the
+predefined media types found in the list below. References are made
+within "(" and ")" and are optionally followed by a text refinement,
+e.g. "(MC) with four channels". If a text refinement should begin
+with a "(" character it should be replaced with "((" in the same way
+as in the "TCO" frame. Predefined refinements is appended after the
+media type, e.g. "(CD/A)" or "(VID/PAL/VHS)".</div>
+</p>
+<p><center><table border=0 width="70%">
+<tr><td>DIG</td><td rowspan=67> </td><td width="100%">Other digital media</td></tr>
+<tr valign=top><td align=right>/A<br> </td><td>Analog transfer from media</td></tr>
+
+<tr><td>ANA</td><td>Other analog media</td></tr>
+<tr><td align=right>/WAC</td><td>Wax cylinder</td></tr>
+<tr valign=top><td align=right>/8CA<br> </td><td>8-track tape cassette</td></tr>
+
+<tr><td>CD</td><td>CD</td></tr>
+<tr><td align=right>/A</td><td>Analog transfer from media</td></tr>
+<tr><td align=right>/DD</td><td>DDD</td></tr>
+<tr><td align=right>/AD</td><td>ADD</td></tr>
+<tr valign=top><td align=right>/AA<br> </td><td>AAD</td></tr>
+
+<tr><td>LD</td><td>Laserdisc</td></tr>
+<tr valign=top><td align=right>/A<br> </td><td>Analog transfer from media</td></tr>
+
+<tr><td>TT</td><td>Turntable records</td></tr>
+<tr><td align=right>/33</td><td>33.33 rpm</td></tr>
+<tr><td align=right>/45</td><td>45 rpm</td></tr>
+<tr><td align=right>/71</td><td>71.29 rpm</td></tr>
+<tr><td align=right>/76</td><td>76.59 rpm</td></tr>
+<tr><td align=right>/78</td><td>78.26 rpm</td></tr>
+<tr valign=top><td align=right>/80<br> </td><td>80 rpm</td></tr>
+
+<tr><td>MD</td><td>MiniDisc</td></tr>
+<tr valign=top><td align=right>/A<br> </td><td>Analog transfer from media</td></tr>
+
+<tr><td>DAT</td><td>DAT</td></tr>
+<tr><td align=right>/A</td><td>Analog transfer from media</td></tr>
+<tr><td align=right>/1</td><td>standard, 48 kHz/16 bits, linear</td></tr>
+<tr><td align=right>/2</td><td>mode 2, 32 kHz/16 bits, linear</td></tr>
+<tr><td align=right>/3</td><td>mode 3, 32 kHz/12 bits, nonlinear, low speed</td></tr>
+<tr><td align=right>/4</td><td>mode 4, 32 kHz/12 bits, 4 channels</td></tr>
+<tr><td align=right>/5</td><td>mode 5, 44.1 kHz/16 bits, linear</td></tr>
+<tr valign=top><td align=right>/6<br> </td><td>mode 6, 44.1 kHz/16 bits, 'wide track' play</td></tr>
+
+<tr><td>DCC</td><td>DCC</td></tr>
+<tr valign=top><td align=right>/A<br> </td><td>Analog transfer from media</td></tr>
+
+<tr><td>DVD</td><td>DVD</td></tr>
+<tr valign=top><td align=right>/A<br> </td><td>Analog transfer from media</td></tr>
+
+<tr><td>TV</td><td>Television</td></tr>
+<tr><td align=right>/PAL</td><td>PAL</td></tr>
+<tr><td align=right>/NTSC</td><td>NTSC</td></tr>
+<tr valign=top><td align=right> /SECAM<br> </td><td>SECAM</td></tr>
+
+<tr><td>VID</td><td>Video</td></tr>
+<tr><td align=right>/PAL</td><td>PAL</td></tr>
+<tr><td align=right>/NTSC</td><td>NTSC</td></tr>
+<tr><td align=right>/SECAM</td><td>SECAM</td></tr>
+<tr><td align=right>/VHS</td><td>VHS</td></tr>
+<tr><td align=right>/SVHS</td><td>S-VHS</td></tr>
+<tr valign=top><td align=right>/BETA<br> </td><td>BETAMAX</td></tr>
+
+<tr><td>RAD</td><td>Radio</td></tr>
+<tr><td align=right>/FM</td><td>FM</td></tr>
+<tr><td align=right>/AM</td><td>AM</td></tr>
+<tr><td align=right>/LW</td><td>LW</td></tr>
+<tr valign=top><td align=right>/MW<br> </td><td>MW</td></tr>
+
+<tr><td>TEL</td><td>Telephone</td></tr>
+<tr valign=top><td align=right>/I<br> </td><td>ISDN</td></tr>
+
+<tr><td>MC</td><td>MC (normal cassette)</td></tr>
+<tr><td align=right>/4</td><td>4.75 cm/s (normal speed for a two sided cassette)</td></tr>
+<tr><td align=right>/9</td><td>9.5 cm/s</td></tr>
+<tr><td align=right>/I</td><td>Type I cassette (ferric/normal)</td></tr>
+<tr><td align=right>/II</td><td>Type II cassette (chrome)</td></tr>
+<tr><td align=right>/III</td><td>Type III cassette (ferric chrome)</td></tr>
+<tr valign=top><td align=right>/IV<br> </td><td>Type IV cassette (metal)</td></tr>
+
+<tr><td>REE</td><td>Reel</td></tr>
+<tr><td align=right>/9</td><td>9.5 cm/s</td></tr>
+<tr><td align=right>/19</td><td>19 cm/s</td></tr>
+<tr><td align=right>/38</td><td>38 cm/s</td></tr>
+<tr><td align=right>/76</td><td>76 cm/s</td></tr>
+<tr><td align=right>/I</td><td>Type I cassette (ferric/normal)</td></tr>
+<tr><td align=right>/II</td><td>Type II cassette (chrome)</td></tr>
+<tr><td align=right>/III</td><td>Type III cassette (ferric chrome)</td></tr>
+<tr><td align=right>/IV<br> </td><td>Type IV cassette (metal)</td></tr>
+</table></center>
+</p>
+
+<p>
+<a name="TOAL"> </a>
+<div class=h5>TOAL</div>
+<div class=t>The 'Original album/movie/show title' frame is intended for the title
+of the original recording (or source of sound), if for example the
+music in the file should be a cover of a previously released song.
+</p></div>
+
+<p>
+<a name="TOFN"> </a>
+<div class=h5>TOFN</div>
+<div class=t>The 'Original filename' frame contains the preferred filename for the
+file, since some media doesn't allow the desired length of the
+filename. The filename is case sensitive and includes its suffix.</div>
+</p>
+
+<p>
+<a name="TOLY"> </a>
+<div class=h5>TOLY</div>
+<div class=t>The 'Original lyricist(s)/text writer(s)' frame is intended for the
+text writer(s) of the original recording, if for example the music in
+the file should be a cover of a previously released song. The text
+writers are seperated with the "/" character.</div>
+</p>
+
+<p>
+<a name="TOPE"> </a>
+<div class=h5>TOPE</div>
+<div class=t>The 'Original artist(s)/performer(s)' frame is intended for the
+performer(s) of the original recording, if for example the music in
+the file should be a cover of a previously released song. The
+performers are seperated with the "/" character.</div>
+</p>
+
+<p>
+<a name="TORY"> </a>
+<div class=h5>TORY</div>
+<div class=t>The 'Original release year' frame is intended for the year when the
+original recording, if for example the music in the file should be a
+cover of a previously released song, was released. The field is
+formatted as in the "TYER" frame.</div>
+</p>
+
+<p>
+<a name="TOWN"> </a>
+<div class=h5>TOWN</div>
+<div class=t>The 'File owner/licensee' frame contains the name of the owner or
+licensee of the file and it's contents.</div>
+</p>
+
+<p>
+<a name="TPE1"> </a>
+<div class=h5>TPE1</div>
+<div class=t>The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is
+used for the main artist(s). They are seperated with the "/"
+character.</div>
+</p>
+
+<p>
+<a name="TPE2"> </a>
+<div class=h5>TPE2</div>
+<div class=t>The 'Band/Orchestra/Accompaniment' frame is used for additional
+information about the performers in the recording.</div>
+</p>
+
+<p>
+<a name="TPE3"> </a>
+<div class=h5>TPE3</div>
+<div class=t>The 'Conductor' frame is used for the name of the conductor.</div>
+</p>
+
+<p>
+<a name="TPE4"> </a>
+<div class=h5>TPE4</div>
+<div class=t>The 'Interpreted, remixed, or otherwise modified by' frame contains
+more information about the people behind a remix and similar
+interpretations of another existing piece.</div>
+</p>
+
+<p>
+<a name="TPOS"> </a>
+<div class=h5>TPOS</div>
+<div class=t>The 'Part of a set' frame is a numeric string that describes which
+part of a set the audio came from. This frame is used if the source
+described in the "<a href="#TALB">TALB</a>" frame is divided into several mediums, e.g. a
+double CD. The value may be extended with a "/" character and a
+numeric string containing the total number of parts in the set. E.g.
+"1/2".</div>
+</p>
+
+<p>
+<a name="TPUB"> </a>
+<div class=h5>TPUB</div>
+<div class=t>The 'Publisher' frame simply contains the name of the label or
+publisher.</div>
+</p>
+
+<p>
+<a name="TRCK"> </a>
+<div class=h5>TRCK</div>
+<div class=t>The 'Track number/Position in set' frame is a numeric string
+containing the order number of the audio-file on its original
+recording. This may be extended with a "/" character and a numeric
+string containing the total numer of tracks/elements on the original
+recording. E.g. "4/9".</div>
+</p>
+
+<p>
+<a name="TRDA"> </a>
+<div class=h5>TRDA</div>
+<div class=t>The 'Recording dates' frame is a intended to be used as complement to
+the "<a href="#TYER">TYER</a>", "<a href="#TDAT">TDAT</a>" and "<a href="#TIME">TIME</a>" frames. E.g. "4th-7th June, 12th June"
+in combination with the "<a href="#TYER">TYER</a>" frame.</div>
+</p>
+
+<p>
+<a name="TRSN"> </a>
+<div class=h5>TRSN</div>
+<div class=t>The 'Internet radio station name' frame contains the name of the
+internet radio station from which the audio is streamed.</div>
+</p>
+
+<p>
+<a name="TRSO"> </a>
+<div class=h5>TRSO</div>
+<div class=t>The 'Internet radio station owner' frame contains the name of the
+owner of the internet radio station from which the audio is
+streamed.</div>
+</p>
+
+<p>
+<a name="TSIZ"> </a>
+<div class=h5>TSIZ</div>
+<div class=t>The 'Size' frame contains the size of the audiofile in bytes,
+excluding the ID3v2 tag, represented as a numeric string.</div>
+</p>
+
+<p>
+<a name="TSRC"> </a>
+<div class=h5>TSRC</div>
+<div class=t>The 'ISRC' frame should contain the International Standard Recording
+Code (<a href="#ISRC">ISRC</a>) (12 characters).</div>
+</p>
+
+<p>
+<a name="TSSE"> </a>
+<div class=h5>TSSE</div>
+<div class=t>The 'Software/Hardware and settings used for encoding' frame
+includes the used audio encoder and its settings when the file was
+encoded. Hardware refers to hardware encoders, not the computer on
+which a program was run.</div>
+</p>
+
+<p>
+<a name="TYER"> </a>
+<div class=h5>TYER</div>
+<div class=t>The 'Year' frame is a numeric string with a year of the recording.
+This frames is always four characters long (until the year 10000).</div>
+</p>
+
+<h3>4.2.2.User defined text information frame</h3>
+<p class=t>
+<div class=t>This frame is intended for one-string text information concerning the
+audiofile in a similar way to the other "T"-frames. The frame body
+consists of a description of the string, represented as a terminated
+string, followed by the actual string. There may be more than one
+"TXXX" frame in each tag, but only one with the same description.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'User defined text information frame', ID: "TXXX">
+<tr><td>Text encoding</td><td>$xx</td></tr>
+<tr><td>Description</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Value</td><td><text string according to encoding></td></tr>
+</table></center></p>
+
+<a name="sec4.3"> </a>
+<h3>4.3.URL link frames</h3>
+<p class=t>
+With these frames dynamic data such as webpages with touring
+information, price information or plain ordinary news can be added to
+the tag. There may only be one <a href="#URL">URL</a> link frame of its kind in an
+tag, except when stated otherwise in the frame description. If the
+textstring is followed by a termination ($00 (00)) all the following
+information should be ignored and not be displayed. All <a href="#URL">URL</a> link
+frame identifiers begins with "W". Only <a href="#URL">URL</a> link frame identifiers
+begins with "W". All <a href="#URL">URL</a> link frames have the following format:
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'URL link frame', ID: "W000" - "WZZZ", excluding "WXXX" described in 4.3.2.></td></tr>
+<tr><td>URL</td><td width="80%"><text string></td></tr>
+</table></center></p>
+
+<a name="sec4.3.1"> </a>
+<h3>4.3.1.URL link frames - details</h3>
+<p>
+<a name="WCOM"> </a>
+<div class=h5>WCOM</div>
+<div class=t>The 'Commercial information' frame is a <a href="#URL">URL</a> pointing at a webpage
+with information such as where the album can be bought. There may be
+more than one "WCOM" frame in a tag, but not with the same content.</div>
+</p>
+
+<p>
+<a name="WCOP"> </a>
+<div class=h5>WCOP</div>
+<div class=t>The 'Copyright/Legal information' frame is a <a href="#URL">URL</a> pointing at a
+webpage where the terms of use and ownership of the file is
+described.</div>
+</p>
+
+<p>
+<a name="WOAF"> </a>
+<div class=h5>WOAF</div>
+<div class=t>The 'Official audio file webpage' frame is a <a href="#URL">URL</a> pointing at a file
+specific webpage.</div>
+</p>
+
+<p>
+<a name="WOAR"> </a>
+<div class=h5>WOAR</div>
+<div class=t>The 'Official artist/performer webpage' frame is a <a href="#URL">URL</a> pointing at
+the artists official webpage. There may be more than one "WOAR" frame
+in a tag if the audio contains more than one performer, but not with
+the same content.</div>
+</p>
+
+<p>
+<a name="WOAS"> </a>
+<div class=h5>WOAS</div>
+<div class=t>The 'Official audio source webpage' frame is a <a href="#URL">URL</a> pointing at the
+official webpage for the source of the audio file, e.g. a movie.</div>
+</p>
+
+<p>
+<a name="WORS"> </a>
+<div class=h5>WORS</div>
+<div class=t>The 'Official internet radio station homepage' contains a <a href="#URL">URL</a>
+pointing at the homepage of the internet radio station.</div>
+</p>
+
+<p>
+<a name="WPAY"> </a>
+<div class=h5>WPAY</div>
+<div class=t>The 'Payment' frame is a <a href="#URL">URL</a> pointing at a webpage that will handle
+the process of paying for this file.</div>
+</p>
+
+<p>
+<a name="WPUB"> </a>
+<div class=h5>WPUB</div>
+<div class=t>The 'Publishers official webpage' frame is a <a href="#URL">URL</a> pointing at the
+official wepage for the publisher.</div>
+</p>
+
+<a name="sec4.3.2"> </a>
+<h3>4.3.2.User defined URL link frame</h3>
+<p class=t>
+This frame is intended for <a href="#URL">URL</a> links concerning the audiofile
+in a similar way to the other "W"-frames. The frame body consists
+of a description of the string, represented as a terminated string,
+followed by the actual <a href="#URL">URL</a>. The <a href="#URL">URL</a> is always encoded with <a href="#ISO-8859-1">ISO-8859-1</a>. There may be more than one "WXXX" frame in each tag,
+but only one with the same description.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'User defined URL link frame', ID: "WXXX"></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>Description </td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>URL </td><td><text string></td></tr>
+</table></center></p>
+
+<a name="sec4.4"> </a>
+<h3>4.4.Involved people list</h3>
+<p class=t>
+Since there might be a lot of people contributing to an audio file in
+various ways, such as musicians and technicians, the 'Text
+information frames' are often insufficient to list everyone involved
+in a project. The 'Involved people list' is a frame containing the
+names of those involved, and how they were involved. The body simply
+contains a terminated string with the involvement directly followed
+by a terminated string with the involvee followed by a new
+involvement and so on. There may only be one "IPLS" frame in each
+tag.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Involved people list', ID: "IPLS"></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>People list strings</td><td><text strings according to encoding></td></tr>
+</table></center></p>
+
+<a name="sec4.5"> </a>
+<h3>4.5.Music CD identifier</h3>
+<p class=t>
+This frame is intended for music that comes from a CD, so that the CD
+can be identified in databases such as the <a href="#CDDB">CDDB</a>. The frame
+consists of a binary dump of the Table Of Contents, TOC, from the CD,
+which is a header of 4 bytes and then 8 bytes/track on the CD plus 8
+bytes for the 'lead out' making a maximum of 804 bytes. The offset to
+the beginning of every track on the CD should be described with a
+four bytes absolute CD-frame address per track, and not with absolute
+time. This frame requires a present and valid "<a href="#TRCK">TRCK</a>" frame, even if
+the CD's only got one track. There may only be one "MCDI" frame in
+each tag.
+</p>
+<p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Music CD identifier', ID: "MCDI"></td></tr>
+<tr><td>CD TOC</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.6"> </a>
+<h3>4.6.Event timing codes</h3>
+<p class=t>
+This frame allows synchronisation with key events in a song or sound.
+The header is:
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Event timing codes', ID: "ETCO"></td></tr>
+<tr><td>Time stamp format</td><td width="80%">$xx</td></tr>
+</table></center>
+</p><p class=t>
+Where time stamp format is:
+</p><p class=ind>
+ $01 Absolute time, 32 bit sized, using <a href="#MPEG">MPEG</a> frames as unit<br>
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
+</p><p class=t>
+Abolute time means that every stamp contains the time from the
+beginning of the file.
+</p><p class=t>
+Followed by a list of key events in the following format:
+</p><p><center><table border=0 width="70%">
+<tr><td>Type of event</td><td width="80%">$xx</td></tr>
+<tr><td>Time stamp</td><td>$xx (xx ...)</td></tr>
+</table></center>
+</p><p class=t>
+The 'Time stamp' is set to zero if directly at the beginning of the
+sound or after the previous event. All events should be sorted in
+chronological order. The type of event is as follows:
+</p><p><center><table border=0 width="70%">
+<tr><td>$00</td><td width="80%">padding (has no meaning)</td></tr>
+<tr><td>$01</td><td>end of initial silence</td></tr>
+<tr><td>$02</td><td>intro start</td></tr>
+<tr><td>$03</td><td>mainpart start</td></tr>
+<tr><td>$04</td><td>outro start</td></tr>
+<tr><td>$05</td><td>outro end</td></tr>
+<tr><td>$06</td><td>verse start</td></tr>
+<tr><td>$07</td><td>refrain start</td></tr>
+<tr><td>$08</td><td>interlude start</td></tr>
+<tr><td>$09</td><td>theme start</td></tr>
+<tr><td>$0A</td><td>variation start</td></tr>
+<tr><td>$0B</td><td>key change</td></tr>
+<tr><td>$0C</td><td>time change</td></tr>
+<tr><td>$0D</td><td>momentary unwanted noise (Snap, Crackle & Pop)</td></tr>
+<tr><td>$0E</td><td>sustained noise</td></tr>
+<tr><td>$0F</td><td>sustained noise end</td></tr>
+<tr><td>$10</td><td>intro end</td></tr>
+<tr><td>$11</td><td>mainpart end</td></tr>
+<tr><td>$12</td><td>verse end</td></tr>
+<tr><td>$13</td><td>refrain end</td></tr>
+<tr><td>$14</td><td>theme end</td></tr>
+
+<tr><td>$15-$DF</td><td>reserved for future use</td></tr>
+
+<tr><td>$E0-$EF</td><td>not predefined sync 0-F</td></tr>
+
+<tr><td>$F0-$FC</td><td>reserved for future use</td></tr>
+
+<tr><td>$FD</td><td>audio end (start of silence)</td></tr>
+<tr><td>$FE</td><td>audio file ends</td></tr>
+<tr><td>$FF</td><td>one more byte of events follows (all the following bytes with the value $FF have the same function)</td></tr>
+</table></center>
+</p><p class=t>
+Terminating the start events such as "intro start" is not required.
+The 'Not predefined sync's ($E0-EF) are for user events. You might
+want to synchronise your music to something, like setting of an
+explosion on-stage, turning on your screensaver etc.
+</p>
+<p class=t>There may only be one "ETCO" frame in each tag.</p>
+
+<a name="sec4.7"> </a>
+<h3>4.7.MPEG location lookup table</h3>
+<p class=t>
+To increase performance and accuracy of jumps within a <a href="#MPEG">MPEG</a>
+audio file, frames with timecodes in different locations in the file
+might be useful. The ID3v2 frame includes references that the
+software can use to calculate positions in the file. After the frame
+header is a descriptor of how much the 'frame counter' should
+increase for every reference. If this value is two then the first
+reference points out the second frame, the 2nd reference the 4th
+frame, the 3rd reference the 6th frame etc. In a similar way the
+'bytes between reference' and 'milliseconds between reference' points
+out bytes and milliseconds respectively.
+</p><p class=t>
+Each reference consists of two parts; a certain number of bits, as
+defined in 'bits for bytes deviation', that describes the difference
+between what is said in 'bytes between reference' and the reality and
+a certain number of bits, as defined in 'bits for milliseconds
+deviation', that describes the difference between what is said in
+'milliseconds between reference' and the reality. The number of bits
+in every reference, i.e. 'bits for bytes deviation'+'bits for
+milliseconds deviation', must be a multiple of four. There may only
+be one "MLLT" frame in each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Location lookup table', ID: "MLLT"></td></tr>
+<tr><td nowrap>MPEG frames between reference</td><td width="80%">$xx xx</td></tr>
+<tr><td>Bytes between reference</td><td>$xx xx xx</td></tr>
+<tr><td>Milliseconds between reference</td><td>$xx xx xx</td></tr>
+<tr><td>Bits for bytes deviation</td><td>$xx</td></tr>
+<tr><td>Bits for milliseconds dev.</td><td>$xx</td></tr>
+</table></center>
+</p><p class=t>
+Then for every reference the following data is included;
+</p><p><center><table border=0 width="70%">
+<tr><td>Deviation in bytes</td><td width="80%">%xxx....</td></tr>
+<tr><td>Deviation in milliseconds</td><td>%xxx....</td></tr>
+</table></center>
+</p>
+
+<a name="sec4.8"> </a>
+<h3>4.8.Synchronised tempo codes</h3>
+<p class=t>
+For a more accurate description of the tempo of a musical piece this
+frame might be used. After the header follows one byte describing
+which time stamp format should be used. Then follows one or more
+tempo codes. Each tempo code consists of one tempo part and one time
+part. The tempo is in BPM described with one or two bytes. If the
+first byte has the value $FF, one more byte follows, which is added
+to the first giving a range from 2 - 510 BPM, since $00 and $01 is
+reserved. $00 is used to describe a beat-free time period, which is
+not the same as a music-free time period. $01 is used to indicate one
+single beat-stroke followed by a beat-free period.
+</p><p class=t>
+The tempo descriptor is followed by a time stamp. Every time the
+tempo in the music changes, a tempo descriptor may indicate this for
+the player. All tempo descriptors should be sorted in chronological
+order. The first beat-stroke in a time-period is at the same time as
+the beat description occurs. There may only be one "SYTC" frame in
+each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Synchronised tempo codes', ID: "SYTC"></td></tr>
+<tr><td>Time stamp format</td><td width="80%">$xx</td></tr>
+<tr><td>Tempo data </td><td><binary data></td></tr>
+</table></center>
+</p><p class=t>
+Where time stamp format is:
+</p><p class=ind>
+ $01 Absolute time, 32 bit sized, using <a href="#MPEG">MPEG</a> frames as unit<br>
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
+</p><p class=t>
+Abolute time means that every stamp contains the time from the
+beginning of the file.
+</p>
+
+<a name="sec4.9"> </a>
+<h3>4.9.Unsychronised lyrics/text transcription</h3>
+<p class=t>
+This frame contains the lyrics of the song or a text transcription of
+other vocal activities. The head includes an encoding descriptor and
+a content descriptor. The body consists of the actual text. The
+'Content descriptor' is a terminated string. If no descriptor is
+entered, 'Content descriptor' is $00 (00) only. Newline characters
+are allowed in the text. There may be more than one 'Unsynchronised
+lyrics/text transcription' frame in each tag, but only one with the
+same language and content descriptor.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Unsynchronised lyrics/text transcription', ID: "USLT"></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>Language</td><td>$xx xx xx</td></tr>
+<tr><td>Content descriptor</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Lyrics/text</td><td><full text string according to encoding></td></tr>
+</table></center>
+</p>
+
+<a name="sec4.10"> </a>
+<h3>4.10.Synchronised lyrics/text</h3>
+<p class=t>
+This is another way of incorporating the words, said or sung lyrics,
+in the audio file as text, this time, however, in sync with the
+audio. It might also be used to describing events e.g. occurring on a
+stage or on the screen in sync with the audio. The header includes a
+content descriptor, represented with as terminated textstring. If no
+descriptor is entered, 'Content descriptor' is $00 (00) only.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Synchronised lyrics/text', ID: "SYLT"></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>Language</td><td>$xx xx xx</td></tr>
+<tr><td>Time stamp format</td><td>$xx</td></tr>
+<tr><td>Content type</td><td>$xx</td></tr>
+<tr><td>Content descriptor</td><td><text string according to encoding> $00 (00)</td></tr>
+</table></center>
+</p>
+<p><center><table border=0 width="70%">
+<tr><td rowspan=2 valign=top>Encoding:</td><td>$00</td><td><a href="#ISO-8859-1">ISO-8859-1</a> character set is used => $00
+ is sync identifier.</td></tr>
+<tr><td>$01</td><td><a href="#UNICODE">Unicode</a> character set is used => $00 00 is
+ sync identifier.</td></tr>
+</table></center></p>
+
+<p><center><table border=0 width="70%">
+<tr><td rowspan=7 valign=top>Content type:</td><td>$00</td><td width="80%">is other</td></tr>
+<tr><td>$01</td><td>is lyrics</td></tr>
+<tr><td>$02</td><td>is text transcription</td></tr>
+<tr><td>$03</td><td>is movement/part name (e.g. "Adagio")</td></tr>
+<tr><td>$04</td><td>is events (e.g. "Don Quijote enters the stage")</td></tr>
+<tr><td>$05</td><td>is chord (e.g. "Bb F Fsus")</td></tr>
+<tr><td>$06</td><td>is trivia/'pop up' information</td></tr>
+</table></center></p>
+<p class=t>
+Time stamp format is:
+</p><p class=ind>
+ $01 Absolute time, 32 bit sized, using <a href="#MPEG">MPEG</a> frames as unit<br>
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
+</p>
+<p class=t>
+Abolute time means that every stamp contains the time from the
+beginning of the file.
+</p><p class=t>
+The text that follows the frame header differs from that of the
+unsynchronised lyrics/text transcription in one major way. Each
+syllable (or whatever size of text is considered to be convenient by
+the encoder) is a null terminated string followed by a time stamp
+denoting where in the sound file it belongs. Each sync thus has the
+following structure:
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2>Terminated text to be synced (typically a syllable)</td></tr>
+<tr><td nowrap>Sync identifier (terminator to above string)</td><td width="80%">$00 (00)</td></tr>
+<tr><td>Time stamp</td><td>$xx (xx ...)</td></tr>
+</table></center>
+<p class=t>
+The 'time stamp' is set to zero or the whole sync is omitted if
+located directly at the beginning of the sound. All time stamps
+should be sorted in chronological order. The sync can be considered
+as a validator of the subsequent string.
+</p><p class=t>
+Newline ($0A) characters are allowed in all "SYLT" frames and should
+be used after every entry (name, event etc.) in a frame with the
+content type $03 - $04.
+</p><p class=t>
+A few considerations regarding whitespace characters: Whitespace
+separating words should mark the beginning of a new word, thus
+occurring in front of the first syllable of a new word. This is also
+valid for new line characters. A syllable followed by a comma should
+not be broken apart with a sync (both the syllable and the comma
+should be before the sync).</p>
+<p class=t>An example: The "USLT" passage</p>
+<p class=ind>"Strangers in the night" $0A "Exchanging glances"</p>
+<p class=t>would be "SYLT" encoded as:</p>
+<p class=ind>
+ "Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
+ " night" $00 xx xx 0A "Ex" $00 xx xx "chang" $00 xx xx "ing" $00 xx
+ xx "glan" $00 xx xx "ces" $00 xx xx
+</p>
+<p class=t>There may be more than one "SYLT" frame in each tag, but only one
+with the same language and content descriptor.</p>
+
+<a name="sec4.11"> </a>
+<h3>4.11.Comments</h3>
+<p class=t>
+This frame is indended for any kind of full text information that
+does not fit in any other frame. It consists of a frame header
+followed by encoding, language and content descriptors and is ended
+with the actual comment as a text string. Newline characters are
+allowed in the comment text string. There may be more than one
+comment frame in each tag, but only one with the same language and
+content descriptor.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Comment', ID: "COMM"></td></tr>
+<tr><td>Text encoding</td><td width="80%">$xx</td></tr>
+<tr><td>Language </td><td>$xx xx xx</td></tr>
+<tr><td>Short content descrip.</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>The actual text </td><td><full text string according to encoding></td></tr>
+</table></center>
+</p>
+
+<a name="sec4.12"> </a>
+<h3>4.12.Relative volume adjustment</h3>
+<p class=t>
+This is a more subjective function than the previous ones. It allows
+the user to say how much he wants to increase/decrease the volume on
+each channel while the file is played. The purpose is to be able to
+align all files to a reference volume, so that you don't have to
+change the volume constantly. This frame may also be used to balance
+adjust the audio. If the volume peak levels are known then this could
+be described with the 'Peak volume right' and 'Peak volume left'
+field. If Peakvolume is not known these fields could be left zeroed
+or, if no other data follows, be completely omitted. There may only
+be one "RVAD" frame in each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Relative volume adjustment', ID: "RVAD"></td></tr>
+<tr><td>Increment/decrement</td><td width="80%">%00xxxxxx</td></tr>
+<tr><td>Bits used for volume descr.</td><td>$xx</td></tr>
+<tr><td>Relative volume change, right</td><td>$xx xx (xx ...)</td></tr>
+<tr><td>Relative volume change, left</td><td>$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume right</td><td>$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume left</td><td>$xx xx (xx ...)</td></tr>
+</table></center></p>
+<p class=t>
+In the increment/decrement field bit 0 is used to indicate the right
+channel and bit 1 is used to indicate the left channel. 1 is
+increment and 0 is decrement.
+</p><p class=t>
+The 'bits used for volume description' field is normally $10 (16
+bits) for <a href="#MPEG">MPEG</a> 2 layer I, II and III and MPEG 2.5. This value
+may not be $00. The volume is always represented with whole bytes,
+padded in the beginning (highest bits) when 'bits used for volume
+description' is not a multiple of eight.
+</p><p class=t>
+This datablock is then optionally followed by a volume definition for
+the left and right back channels. If this information is appended to
+the frame the first two channels will be treated as front channels.
+In the increment/decrement field bit 2 is used to indicate the right
+back channel and bit 3 for the left back channel.
+</p><p><center><table border=0 width="70%">
+<tr><td nowrap>Relative volume change, right back</td><td width="80%">$xx xx (xx ...)</td></tr>
+<tr><td>Relative volume change, left back</td><td>$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume right back</td><td>$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume left back</td><td>$xx xx (xx ...)</td></tr>
+</table></center></p>
+<p class=t>
+If the center channel adjustment is present the following is appended
+to the existing frame, after the left and right back channels. The
+center channel is represented by bit 4 in the increase/decrease
+field.
+</p><p><center><table border=0 width="70%">
+<tr><td nowrap>Relative volume change, center</td><td width="80%">$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume center</td><td>$xx xx (xx ...)</td></tr>
+</table></center></p>
+<p class=t>
+If the bass channel adjustment is present the following is appended
+to the existing frame, after the center channel. The bass channel is
+represented by bit 5 in the increase/decrease field.
+</p><p><center><table border=0 width="70%">
+<tr><td nowrap>Relative volume change, bass</td><td width="80%">$xx xx (xx ...)</td></tr>
+<tr><td>Peak volume bass</td><td>$xx xx (xx ...)</td></tr>
+</table></center></p>
+
+<a name="sec4.13"> </a>
+<h3>4.13.Equalisation</h3>
+<p class=t>
+This is another subjective, alignment frame. It allows the user to
+predefine an equalisation curve within the audio file. There may only
+be one "EQUA" frame in each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header of 'Equalisation', ID: "EQUA"></td></tr>
+<tr><td>Adjustment bits</td><td width="80%">$xx</td></tr>
+</table></center></p>
+<p class=t>
+The 'adjustment bits' field defines the number of bits used for
+representation of the adjustment. This is normally $10 (16 bits) for
+<a href="#MPEG">MPEG</a> 2 layer I, II and III and MPEG 2.5. This value may not be
+$00.
+</p><p class=t>
+This is followed by 2 bytes + ('adjustment bits' rounded up to the
+nearest byte) for every equalisation band in the following format,
+giving a frequency range of 0 - 32767Hz:
+</p><p><center><table border=0 width="70%">
+<tr><td>Increment/decrement</td><td width="80%">%x (MSB of the Frequency)</td></tr>
+<tr><td>Frequency </td><td>(lower 15 bits)</td></tr>
+<tr><td>Adjustment</td><td>$xx (xx ...)</td></tr>
+</Table></center></p>
+<p class=t>
+The increment/decrement bit is 1 for increment and 0 for decrement.
+The equalisation bands should be ordered increasingly with reference
+to frequency. All frequencies don't have to be declared. The
+equalisation curve in the reading software should be interpolated
+between the values in this frame. Three equal adjustments for three
+subsequent frequencies. A frequency should only be described once in
+the frame.
+</p>
+
+<a name="sec4.14"> </a>
+<h3>4.14.Reverb</h3>
+<p class=t>
+Yet another subjective one. You may here adjust echoes of different
+kinds. Reverb left/right is the delay between every bounce in ms.
+Reverb bounces left/right is the number of bounces that should be
+made. $FF equals an infinite number of bounces. Feedback is the
+amount of volume that should be returned to the next echo bounce. $00
+is 0%, $FF is 100%. If this value were $7F, there would be 50% volume
+reduction on the first bounce, 50% of that on the second and so on.
+Left to left means the sound from the left bounce to be played in the
+left speaker, while left to right means sound from the left bounce to
+be played in the right speaker.
+</p><p class=t>
+'Premix left to right' is the amount of left sound to be mixed in the
+right before any reverb is applied, where $00 id 0% and $FF is 100%.
+'Premix right to left' does the same thing, but right to left.
+Setting both premix to $FF would result in a mono output (if the
+reverb is applied symmetric). There may only be one "RVRB" frame in
+each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Reverb', ID: "RVRB"></td></tr>
+<tr><td>Reverb left (ms) </td><td>$xx xx</td></tr>
+<tr><td>Reverb right (ms) </td><td>$xx xx</td></tr>
+<tr><td>Reverb bounces, left </td><td>$xx</td></tr>
+<tr><td>Reverb bounces, right</td><td>$xx</td></tr>
+<tr><td>Reverb feedback, left to left </td><td>$xx</td></tr>
+<tr><td>Reverb feedback, left to right</td><td>$xx</td></tr>
+<tr><td>Reverb feedback, right to right </td><td>$xx</td></tr>
+<tr><td>Reverb feedback, right to left</td><td>$xx</td></tr>
+<tr><td>Premix left to right </td><td>$xx</td></tr>
+<tr><td>Premix right to left </td><td>$xx</td></tr>
+</table></center></p>
+
+<a name="sec4.15"> </a>
+<h3>4.15.Attached picture</h3>
+<p class=t>
+This frame contains a picture directly related to the audio file.
+Image format is the <a href="#MIME">MIME</a> type and subtype for the image. In
+the event that the <a href="#MIME">MIME</a> media type name is omitted, "image/" will be
+implied. The "<a href="#PNG">image/png</a>" or "<a href="#JFIF">image/jpeg</a>" picture format
+should be used when interoperability is wanted. Description is a
+short description of the picture, represented as a terminated
+textstring. The description has a maximum length of 64 characters,
+but may be empty. There may be several pictures attached to one file,
+each in their individual "APIC" frame, but only one with the same
+content descriptor. There may only be one picture with the picture
+type declared as picture type $01 and $02 respectively. There is the
+possibility to put only a link to the image file by using the '<a href="#MIME">MIME</a>
+type' "-->" and having a complete <a href="#URL">URL</a> instead of picture data.
+The use of linked files should however be used sparingly since there
+is the risk of separation of files.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Attached picture', ID: "APIC"></td></tr>
+<tr><td>Text encoding</td><td>$xx</td></tr>
+<tr><td>MIME type </td><td><text string> $00</td></tr>
+<tr><td>Picture type </td><td>$xx</td></tr>
+<tr><td>Description </td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Picture data </td><td><binary data></td></tr>
+</table>
+</center></p>
+<p><center><table border=0 width="70%">
+<tr><td rowspan=21 valign=top>Picture type:</td><td>$00</td><td>Other</td></tr>
+<tr><td>$01</td><td>32x32 pixels 'file icon' (PNG only)</td></tr>
+<tr><td>$02</td><td>Other file icon</td></tr>
+<tr><td>$03</td><td>Cover (front)</td></tr>
+<tr><td>$04</td><td>Cover (back)</td></tr>
+<tr><td>$05</td><td>Leaflet page</td></tr>
+<tr><td>$06</td><td>Media (e.g. lable side of CD)</td></tr>
+<tr><td>$07</td><td>Lead artist/lead performer/soloist</td></tr>
+<tr><td>$08</td><td>Artist/performer</td></tr>
+<tr><td>$09</td><td>Conductor</td></tr>
+<tr><td>$0A</td><td>Band/Orchestra</td></tr>
+<tr><td>$0B</td><td>Composer</td></tr>
+<tr><td>$0C</td><td>Lyricist/text writer</td></tr>
+<tr><td>$0D</td><td>Recording Location</td></tr>
+<tr><td>$0E</td><td>During recording</td></tr>
+<tr><td>$0F</td><td>During performance</td></tr>
+<tr><td>$10</td><td>Movie/video screen capture</td></tr>
+<tr><td>$11</td><td>A bright coloured fish</td></tr>
+<tr><td>$12</td><td>Illustration</td></tr>
+<tr><td>$13</td><td>Band/artist logotype</td></tr>
+<tr><td>$14</td><td>Publisher/Studio logotype</td></tr>
+</table></center></p>
+
+<a name="sec4.16"> </a>
+<h3>4.16.General encapsulated object</h3>
+<p class=t>
+In this frame any type of file can be encapsulated. After the header,
+'Frame size' and 'Encoding' follows '<a href="#MIME">MIME</a> type' represented as
+as a terminated string encoded with <a href="#ISO-8859-1">ISO-8859-1</a>. The
+filename is case sensitive and is encoded as 'Encoding'. Then follows
+a content description as terminated string, encoded as 'Encoding'.
+The last thing in the frame is the actual object. The first two
+strings may be omitted, leaving only their terminations. There may be more than one "GEOB"
+frame in each tag, but only one with the same content descriptor.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'General encapsulated object', ID: "GEOB"></td></tr>
+<tr><td>Text encoding </td><td>$xx</td></tr>
+<tr><td>MIME type </td><td><text string> $00</td></tr>
+<tr><td>Filename</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Content description </td><td><text string according to encóding> $00 (00)</td></tr>
+<tr><td>Encapsulated object </td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.17"> </a>
+<h3>4.17.Play counter</h3>
+<p class=t>
+This is simply a counter of the number of times a file has been
+played. The value is increased by one every time the file begins to
+play. There may only be one "PCNT" frame in each tag. When the
+counter reaches all one's, one byte is inserted in front of the
+counter thus making the counter eight bits bigger. The counter must
+be at least 32-bits long to begin with.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Play counter', ID: "PCNT"></td></tr>
+<tr><td>Counter </td><td>$xx xx xx xx (xx ...)</td></tr>
+</table></center></p>
+
+
+<a name="sec4.18"> </a>
+<h3>4.18.Popularimeter</h3>
+<p class=t>
+The purpose of this frame is to specify how good an audio file is.
+Many interesting applications could be found to this frame such as a
+playlist that features better audiofiles more often than others or it
+could be used to profile a person's taste and find other 'good' files
+by comparing people's profiles. The frame is very simple. It contains
+the email address to the user, one rating byte and a four byte play
+counter, intended to be increased with one for every time the file is
+played. The email is a terminated string. The rating is 1-255 where
+1 is worst and 255 is best. 0 is unknown. If no personal counter is
+wanted it may be omitted. When the counter reaches all one's, one
+byte is inserted in front of the counter thus making the counter
+eight bits bigger in the same away as the play counter ("PCNT").
+There may be more than one "POPM" frame in each tag, but only one
+with the same email address.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Popularimeter', ID: "POPM"></td></tr>
+<tr><td>Email to user</td><td><text string> $00</td></tr>
+<tr><td>Rating </td><td>$xx</td></tr>
+<tr><td>Counter</td><td>$xx xx xx xx (xx ...)</td></tr>
+</table></center></p>
+
+<a name="sec4.19"> </a>
+<h3>4.19.Recommended buffer size</h3>
+<p class=t>
+Sometimes the server from which a audio file is streamed is aware of
+transmission or coding problems resulting in interruptions in the
+audio stream. In these cases, the size of the buffer can be
+recommended by the server using this frame. If the 'embedded info
+flag' is true (1) then this indicates that an ID3 tag with the
+maximum size described in 'Buffer size' may occur in the audiostream.
+In such case the tag should reside between two <a href="#MPEG">MPEG</a> frames, if
+the audio is <a href="#MPEG">MPEG</a> encoded. If the position of the next tag is known,
+'offset to next tag' may be used. The offset is calculated from the
+end of tag in which this frame resides to the first byte of the
+header in the next. This field may be omitted. Embedded tags are
+generally not recommended since this could render unpredictable
+behaviour from present software/hardware.
+</p><p class=t>
+For applications like streaming audio it might be an idea to embed
+tags into the audio stream though. If the clients connects to
+individual connections like HTTP and there is a possibility to begin
+every transmission with a tag, then this tag should include a
+'recommended buffer size' frame. If the client is connected to a
+arbitrary point in the stream, such as radio or multicast, then the
+'recommended buffer size' frame should be included in every tag.
+Every tag that is picked up after the initial/first tag is to be
+considered as an update of the previous one. E.g. if there is a
+"<a href="#TIT2">TIT2</a>" frame in the first received tag and one in the second tag,
+then the first should be 'replaced' with the second.
+</p><p class=t>
+The 'Buffer size' should be kept to a minimum. There may only be one
+"RBUF" frame in each tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Recommended buffer size', ID: "RBUF"></td></tr>
+<tr><td>Buffer size</td><td>$xx xx xx</td></tr>
+<tr><td>Embedded info flag</td><td>%0000000x</td></tr>
+<tr><td>Offset to next tag</td><td>$xx xx xx xx</td></tr>
+</table></center></p>
+
+<a name="sec4.20"> </a>
+<h3>4.20.Audio encryption</h3>
+<p class=t>
+This frame indicates if the actual audio stream is encrypted, and by
+whom. Since standardisation of such encrypion scheme is beyond this
+document, all "AENC" frames begin with a terminated string with a
+URL containing an email address, or a link to a location where an
+email address can be found, that belongs to the organisation
+responsible for this specific encrypted audio file. Questions
+regarding the encrypted audio should be sent to the email address
+specified. If a $00 is found directly after the 'Frame size' and the
+audiofile indeed is encrypted, the whole file may be considered
+useless.
+</p><p class=t>
+After the 'Owner identifier', a pointer to an unencrypted part of the
+audio can be specified. The 'Preview start' and 'Preview length' is
+described in frames. If no part is unencrypted, these fields should
+be left zeroed. After the 'preview length' field follows optionally a
+datablock required for decryption of the audio. There may be more
+than one "AENC" frames in a tag, but only one with the same 'Owner
+identifier'.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Audio encryption', ID: "AENC"></td></tr>
+<tr><td>Owner identifier</td><td><text string> $00</td></tr>
+<tr><td>Preview start</td><td>$xx xx</td></tr>
+<tr><td>Preview length</td><td>$xx xx</td></tr>
+<tr><td>Encryption info</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.21"> </a>
+<h3>4.21.Linked information</h3>
+<p class=t>
+To keep space waste as low as possible this frame may be used to link
+information from another ID3v2 tag that might reside in another audio
+file or alone in a binary file. It is recommended that this method is
+only used when the files are stored on a CD-ROM or other
+circumstances when the risk of file seperation is low. The frame
+contains a frame identifier, which is the frame that should be linked
+into this tag, a <a href="#URL">URL</a> field, where a reference to the file where
+the frame is given, and additional ID data, if needed. Data should be
+retrieved from the first tag found in the file to which this link
+points. There may be more than one "LINK" frame in a tag, but only
+one with the same contents. A linked frame is to be considered as
+part of the tag and has the same restrictions as if it was a physical
+part of the tag (i.e. only one "RVRB" frame allowed, whether it's
+linked or not).
+</p><p><center><table border=0 width="70%">
+<tr><td><Header for 'Linked information', ID: "LINK"></td></tr>
+<tr><td>Frame identifier</td><td>$xx xx xx</td></tr>
+<tr><td>URL</td><td><text string> $00</td></tr>
+<tr><td>ID and additional data</td><td><text string(s)></td></tr>
+</table></center></p>
+<p class=t>
+Frames that may be linked and need no additional data are "IPLS",
+"MCID", "ETCO", "MLLT", "SYTC", "RVAD", "EQUA", "RVRB", "RBUF", the
+text information frames and the URL link frames.
+</p><p class=t>
+The "TXXX", "APIC", "GEOB" and "AENC" frames may be linked with
+the content descriptor as additional ID data.
+</p><p class=t>
+The "COMM", "SYLT" and "USLT" frames may be linked with three bytes
+of language descriptor directly followed by a content descriptor as
+additional ID data.
+</p>
+
+<a name="sec4.22"> </a>
+<h3>4.22.Position synchronisation frame</h3>
+<p class=t>
+This frame delivers information to the listener of how far into the
+audio stream he picked up; in effect, it states the time offset of
+the first frame in the stream. The frame layout is:
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Head for 'Position synchronisation', ID: "POSS"></td></tr>
+<tr><td>Time stamp format</td><td>$xx</td></tr>
+<tr><td>Position</td><td>$xx (xx ...)</td></tr>
+</table></center></p>
+<p class=t>
+Where time stamp format is:
+</p><p class=ind>
+$01 Absolute time, 32 bit sized, using <a href="#MPEG">MPEG</a> frames as unit<br>
+$02 Absolute time, 32 bit sized, using milliseconds as unit
+</p><p class=t>
+and position is where in the audio the listener starts to receive,
+i.e. the beginning of the next frame. If this frame is used in the
+beginning of a file the value is always 0. There may only be one
+"POSS" frame in each tag.
+</p>
+
+<a name="sec4.23"> </a>
+<h3>4.23.Terms of use frame</h3>
+<p class=t>
+This frame contains a brief description of the terms of use and
+ownership of the file. More detailed information concerning the legal
+terms might be available through the "WCOP" frame. Newlines are
+allowed in the text. There may only be one "USER" frame in a tag.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Terms of use frame', ID: "USER"></td></tr>
+<tr><td>Text encoding</td><td>$xx</td></tr>
+<tr><td>Language</td><td>$xx xx xx</td></tr>
+<tr><td>The actual text</td><td><text string according to encoding></td></tr>
+</table></center></p>
+
+<a name="sec4.24"> </a>
+<h3>4.24.Ownership frame</h3>
+<p class=t>
+The ownership frame might be used as a reminder of a made transaction
+or, if signed, as proof. Note that the "USER" and "TOWN" frames are
+good to use in conjunction with this one. The frame begins, after the
+frame ID, size and encoding fields, with a 'price payed' field. The
+first three characters of this field contains the currency used for
+the transaction, encoded according to <a href="#ISO-4217">ISO-4217</a> alphabetic
+currency code. Concatenated to this is the actual price payed, as a
+numerical string using "." as the decimal separator. Next is an 8
+character date string (YYYYMMDD) followed by a string with the name
+of the seller as the last field in the frame. There may only be one
+"OWNE" frame in a tag.
+</p><p><center><table border=0 width="70%">
+<tr><td><Header for 'Ownership frame', ID: "OWNE"></td></tr>
+<tr><td>Text encoding</td><td>$xx</td></tr>
+<tr><td>Price payed</td><td><text string> $00</td></tr>
+<tr><td>Date of purch.</td><td><text string></td></tr>
+<tr><td>Seller</td><td><text string according to encoding></td></tr>
+</table></center></p>
+
+<a name="sec4.25"> </a>
+<h3>4.25.Commercial frame</h3>
+<p class=t>
+This frame enables several competing offers in the same tag by
+bundling all needed information. That makes this frame rather complex
+but it's an easier solution than if one tries to achieve the same
+result with several frames. The frame begins, after the frame ID,
+size and encoding fields, with a price string field. A price is
+constructed by one three character currency code, encoded according
+to <a href="#ISO-4217">ISO-4217</a> alphabetic currency code, followed by a
+numerical value where "." is used as decimal seperator. In the price
+string several prices may be concatenated, seperated by a "/"
+character, but there may only be one currency of each type.
+</p><p class=t>
+The price string is followed by an 8 character date string in the
+format YYYYMMDD, describing for how long the price is valid. After
+that is a contact <a href="#URL">URL</a>, with which the user can contact the seller,
+followed by a one byte 'received as' field. It describes how the
+audio is delivered when bought according to the following list:
+</p><p><center><table border=0 width="70%">
+<tr><td>$00</td><td>Other</td></tr>
+<tr><td>$01</td><td>Standard CD album with other songs</td></tr>
+<tr><td>$02</td><td>Compressed audio on CD</td></tr>
+<tr><td>$03</td><td>File over the Internet</td></tr>
+<tr><td>$04</td><td>Stream over the Internet</td></tr>
+<tr><td>$05</td><td>As note sheets</td></tr>
+<tr><td>$06</td><td>As note sheets in a book with other sheets</td></tr>
+<tr><td>$07</td><td>Music on other media</td></tr>
+<tr><td>$08</td><td>Non-musical merchandise</td></tr>
+</table></center></p>
+<p class=t>
+Next follows a terminated string with the name of the seller followed
+by a terminated string with a short description of the product. The
+last thing is the ability to include a company logotype. The first of
+them is the 'Picture MIME type' field containing information about
+which picture format is used. In the event that the <a href="#MIME">MIME</a> media type
+name is omitted, "image/" will be implied. Currently only "<a href="#PNG">image/png</a>"
+and "<a href="#JFIF">image/jpeg</a>" are allowed. This format string is followed by the
+binary picture data. This two last fields may be omitted if no
+picture is to attach.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2> <Header for 'Commercial frame', ID: "COMR"></td></tr>
+<tr><td>Text encoding</td><td>$xx</td></tr>
+<tr><td>Price string</td><td><text string> $00</td></tr>
+<tr><td>Valid until</td><td><text string></td></tr>
+<tr><td>Contact URL</td><td><text string> $00</td></tr>
+<tr><td>Received as</td><td>$xx</td></tr>
+<tr><td>Name of seller</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Description</td><td><text string according to encoding> $00 (00)</td></tr>
+<tr><td>Picture MIME type</td><td><string> $00</td></tr>
+<tr><td>Seller logo</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.26"> </a>
+<h3>4.26.Encryption method registration</h3>
+<p class=t>
+To identify with which method a frame has been encrypted the
+encryption method must be registered in the tag with this frame. The
+'Owner identifier' is a null-terminated string with a <a href="#URL">URL</a>
+containing an email address, or a link to a location where an email
+address can be found, that belongs to the organisation responsible
+for this specific encryption method. Questions regarding the
+encryption method should be sent to the indicated email address. The
+'Method symbol' contains a value that is associated with this method
+throughout the whole tag. Values below $80 are reserved. The 'Method
+symbol' may optionally be followed by encryption specific data. There
+may be several "ENCR" frames in a tag but only one containing the
+same symbol and only one containing the same owner identifier. The
+method must be used somewhere in the tag. See <a href="#sec3.3.1">section 3.3.1</a>, flag j
+for more information.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Encryption method registration', ID: "ENCR"></td></tr>
+<tr><td>Owner identifier</td><td width="80%"><text string> $00</td></tr>
+<tr><td>Method symbol</td><td>$xx</td></tr>
+<tr><td>Encryption data</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.27"> </a>
+<h3>4.27.Group identification registration</h3>
+<p class=t>
+This frame enables grouping of otherwise unrelated frames. This can
+be used when some frames are to be signed. To identify which frames
+belongs to a set of frames a group identifier must be registered in
+the tag with this frame. The 'Owner identifier' is a null-terminated
+string with a <a href="#URL">URL</a> containing an email address, or a link to a
+location where an email address can be found, that belongs to the
+organisation responsible for this grouping. Questions regarding the
+grouping should be sent to the indicated email address. The 'Group
+symbol' contains a value that associates the frame with this group
+throughout the whole tag. Values below $80 are reserved. The 'Group
+symbol' may optionally be followed by some group specific data, e.g.
+a digital signature. There may be several "GRID" frames in a tag but
+only one containing the same symbol and only one containing the same
+owner identifier. The group symbol must be used somewhere in the tag.
+See <a href="#sec3.3.1">section 3.3.1</a>, flag j for more information.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Group ID registration', ID: "GRID"></td></tr>
+<tr><td>Owner identifier</td><td><text string> $00</td></tr>
+<tr><td>Group symbol</td><td width="80%">$xx</td></tr>
+<tr><td>Group dependent data</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec4.28"> </a>
+<h3>4.28.Private frame</h3>
+<p class=t>
+This frame is used to contain information from a software producer
+that its program uses and does not fit into the other frames. The
+frame consists of an 'Owner identifier' string and the binary data.
+The 'Owner identifier' is a null-terminated string with a <a href="#URL">URL</a>
+containing an email address, or a link to a location where an email
+address can be found, that belongs to the organisation responsible
+for the frame. Questions regarding the frame should be sent to the
+indicated email address. The tag may contain more than one "PRIV"
+frame but only with different contents. It is recommended to keep the
+number of "PRIV" frames as low as possible.
+</p><p><center><table border=0 width="70%">
+<tr><td colspan=2><Header for 'Private frame', ID: "PRIV"></td></tr>
+<tr><td>Owner identifier</td><td width="80%"><text string> $00</td></tr>
+<tr><td>The private data</td><td><binary data></td></tr>
+</table></center></p>
+
+<a name="sec5"> </a>
+<h3>5.The 'unsynchronisation scheme'</h3>
+<p class=t>
+The only purpose of the 'unsynchronisation scheme' is to make the
+ID3v2 tag as compatible as possible with existing software. There is
+no use in 'unsynchronising' tags if the file is only to be processed
+by new software. Unsynchronisation may only be made with MPEG 2 layer
+I, II and III and MPEG 2.5 files.
+</p><p class=t>
+Whenever a false synchronisation is found within the tag, one zeroed
+byte is inserted after the first false synchronisation byte. The
+format of a correct sync that should be altered by ID3 encoders is as
+follows:
+</p><p class=ind>
+%11111111 111xxxxx
+</p><p class=t>
+And should be replaced with:
+</p><p class=ind>
+%11111111 00000000 111xxxxx
+</p><p class=t>
+This has the side effect that all $FF 00 combinations have to be
+altered, so they won't be affected by the decoding process. Therefore
+all the $FF 00 combinations have to be replaced with the $FF 00 00
+combination during the unsynchronisation.
+</p><p class=t>
+To indicate usage of the unsynchronisation, the first bit in 'ID3
+flags' should be set. This bit should only be set if the tag
+contains a, now corrected, false synchronisation. The bit should
+only be clear if the tag does not contain any false synchronisations.
+</p><p class=t>
+Do bear in mind, that if a compression scheme is used by the encoder,
+the unsynchronisation scheme should be applied *afterwards*. When
+decoding a compressed, 'unsynchronised' file, the 'unsynchronisation
+scheme' should be parsed first, decompression afterwards.
+</p><p class=t>
+If the last byte in the tag is $FF, and there is a need to eliminate
+false synchronisations in the tag, at least one byte of padding
+should be added.
+</p>
+
+<a name="sec6"> </a>
+<h3>6.Copyright</h3>
+<p class=t>
+Copyright © Martin Nilsson 1998. All Rights Reserved.
+</p><p class=t>
+This document and translations of it may be copied and furnished to
+others, and derivative works that comment on or otherwise explain it
+or assist in its implementation may be prepared, copied, published
+and distributed, in whole or in part, without restriction of any
+kind, provided that a reference to this document is included on all
+such copies and derivative works. However, this document itself may
+not be modified in any way and reissued as the original document.
+</p><p class=t>
+The limited permissions granted above are perpetual and will not be revoked.
+</p><p class=t>
+This document and the information contained herein is provided on an
+"AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
+THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
+WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+</p>
+
+
+<a name="sec7"> </a>
+<h3>7.References</h3>
+
+<a name="CDDB"> </a>
+<p class=t>[CDDB] Compact Disc Data Base</p>
+<p class=ind><url:<a href="http://www.cddb.com">http://www.cddb.com</a>></p>
+
+<a name="ID3v2"> </a>
+<p class=t>[ID3v2] Martin Nilsson, "ID3v2 informal standard".</p>
+<p class=ind><url:<a href="http://www.id3.org/id3v2-00.txt">http://www.id3.org/id3v2-00.txt</a>></p>
+
+<a name="ISO-639-2"> </a>
+<p class=t>[ISO-639-2] ISO/FDIS 639-2.<br>
+Codes for the representation of names of languages, Part 2: Alpha-3 code. Technical committee / subcommittee: TC 37 / SC 2</p>
+
+<a name="ISO-4217"> </a>
+<p class=t>[ISO-4217] ISO 4217:1995.<br>
+Codes for the representation of currencies and funds. Technical committee / subcommittee: TC 68</p>
+
+<a name="ISO-8859-1"> </a>
+<p class=t>[ISO-8859-1] ISO/IEC DIS 8859-1.<br>
+8-bit single-byte coded graphic character sets, Part 1: Latin alphabet No. 1. Technical committee / subcommittee: JTC 1 / SC 2</p>
+
+<a name="ISRC"> </a>
+<p class=t>[ISRC] ISO 3901:1986<br>
+International Standard Recording Code (ISRC). Technical committee / subcommittee: TC 46 / SC 9</p>
+
+<a name="JFIF"> </a>
+<p class=t>[JFIF] JPEG File Interchange Format, version 1.02</p>
+<p class=ind><url:<a href="http://www.w3.org/Graphics/JPEG/jfif.txt">http://www.w3.org/Graphics/JPEG/jfif.txt</a>></p>
+
+<a name="MIME"> </a>
+<p class=t>[MIME] Freed, N. and N. Borenstein, "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", RFC 2045, November 1996.</p>
+<p class=ind><url:<a href="ftp://ftp.isi.edu/in-notes/rfc2045.txt">ftp://ftp.isi.edu/in-notes/rfc2045.txt</a>></p>
+
+<a name="MPEG"> </a>
+<p class=t>[MPEG] ISO/IEC 11172-3:1993.<br>
+Coding of moving pictures and associated audio for digital storage media at up to about 1,5 Mbit/s, Part 3: Audio. Technical committee / subcommittee: JTC 1 / SC 29<br>
+ and<br>
+ISO/IEC 13818-3:1995<br>
+Generic coding of moving pictures and associated audio information, Part 3: Audio. Technical committee / subcommittee: JTC 1 / SC 29<br>
+ and<br>
+ISO/IEC DIS 13818-3<br>
+Generic coding of moving pictures and associated audio information, Part 3: Audio (Revision of ISO/IEC 13818-3:1995)</p>
+
+<a name="PNG"> </a>
+<p class=t>[PNG] Portable Network Graphics, version 1.0</p>
+<p class=ind><url:<a href="http://www.w3.org/TR/REC-png-multi.html">http://www.w3.org/TR/REC-png-multi.html</a>></p>
+
+<a name="UNICODE"> </a>
+<p class=t>[UNICODE] ISO/IEC 10646-1:1993.<br>
+Universal Multiple-Octet Coded Character Set (UCS), Part 1: Architecture and Basic Multilingual Plane. Technical committee / subcommittee: JTC 1 / SC 2</p>
+<p class=ind><url:<a href="http://www.unicode.org">http://www.unicode.org</a>></p>
+
+<a name="URL"> </a>
+<p class=t>[URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource Locators (URL).", RFC 1738, December 1994.</p>
+<p class=ind><url:<a href="ftp://ftp.isi.edu/in-notes/rfc1738.txt">ftp://ftp.isi.edu/in-notes/rfc1738.txt</a>></p>
+
+<a name="ZLIB"> </a>
+<p class=t>[ZLIB] P. Deutsch, Aladdin Enterprises & J-L. Gailly, "ZLIB Compressed Data Format Specification version 3.3", RFC 1950, May 1996.</p>
+<p class=ind><url:<a href="ftp://ftp.isi.edu/in-notes/rfc1950.txt">ftp://ftp.isi.edu/in-notes/rfc1950.txt</a>></p>
+
+
+<a name="sec8"> </a>
+<h3>8.Appendix</h3>
+
+<a name="secA"> </a>
+<h3>A.Appendix A - Genre List from ID3v1</h3>
+<center><table border=0 width="70%"><tr valign=top><td>
+The following genres is defined in ID3v1
+<pre>
+ 0.Blues
+ 1.Classic Rock
+ 2.Country
+ 3.Dance
+ 4.Disco
+ 5.Funk
+ 6.Grunge
+ 7.Hip-Hop
+ 8.Jazz
+ 9.Metal
+ 10.New Age
+ 11.Oldies
+ 12.Other
+ 13.Pop
+ 14.R&B
+ 15.Rap
+ 16.Reggae
+ 17.Rock
+ 18.Techno
+ 19.Industrial
+ 20.Alternative
+ 21.Ska
+ 22.Death Metal
+ 23.Pranks
+ 24.Soundtrack
+ 25.Euro-Techno
+ 26.Ambient
+ 27.Trip-Hop
+ 28.Vocal
+ 29.Jazz+Funk
+ 30.Fusion
+ 31.Trance
+ 32.Classical
+ 33.Instrumental
+ 34.Acid
+ 35.House
+ 36.Game
+ 37.Sound Clip
+ 38.Gospel
+ 39.Noise
+ 40.AlternRock
+ 41.Bass
+ 42.Soul
+ 43.Punk
+ 44.Space
+ 45.Meditative
+ 46.Instrumental Pop
+ 47.Instrumental Rock
+ 48.Ethnic
+ 49.Gothic
+ 50.Darkwave
+ 51.Techno-Industrial
+ 52.Electronic
+ 53.Pop-Folk
+ 54.Eurodance
+ 55.Dream
+ 56.Southern Rock
+ 57.Comedy
+ 58.Cult
+ 59.Gangsta
+ 60.Top 40
+ 61.Christian Rap
+ 62.Pop/Funk
+ 63.Jungle
+ 64.Native American
+ 65.Cabaret
+ 66.New Wave
+ 67.Psychadelic
+ 68.Rave
+ 69.Showtunes
+ 70.Trailer
+ 71.Lo-Fi
+ 72.Tribal
+ 73.Acid Punk
+ 74.Acid Jazz
+ 75.Polka
+ 76.Retro
+ 77.Musical
+ 78.Rock & Roll
+ 79.Hard Rock
+</pre>
+</td><td>
+The following genres are Winamp extensions
+<pre>
+ 80.Folk
+ 81.Folk-Rock
+ 82.National Folk
+ 83.Swing
+ 84.Fast Fusion
+ 85.Bebob
+ 86.Latin
+ 87.Revival
+ 88.Celtic
+ 89.Bluegrass
+ 90.Avantgarde
+ 91.Gothic Rock
+ 92.Progressive Rock
+ 93.Psychedelic Rock
+ 94.Symphonic Rock
+ 95.Slow Rock
+ 96.Big Band
+ 97.Chorus
+ 98.Easy Listening
+ 99.Acoustic
+100.Humour
+101.Speech
+102.Chanson
+103.Opera
+104.Chamber Music
+105.Sonata
+106.Symphony
+107.Booty Bass
+108.Primus
+109.Porn Groove
+110.Satire
+111.Slow Jam
+112.Club
+113.Tango
+114.Samba
+115.Folklore
+116.Ballad
+117.Power Ballad
+118.Rhythmic Soul
+119.Freestyle
+120.Duet
+121.Punk Rock
+122.Drum Solo
+123.A capella
+124.Euro-House
+125.Dance Hall
+</pre></td></tr></table></center>
+
+<a name="sec9"> </a>
+<h3>9.Author's Address</h3>
+<p class=t>
+Written by
+</p><p class=ind>
+Martin Nilsson<br>
+Rydsvägen 246 C. 30<br>
+S-584 34 Linköping<br>
+Sweden<br>
+</p><p class=ind>
+Email: <a href="mailto:nilsson@id3.org">nilsson@id3.org</a>
+</p>
+
+<p class=t>
+Edited by
+</p><p class=ind>
+Dirk Mahoney<br>
+57 Pechey Street<br>
+Chermside Q<br>
+Australia 4032<br>
+</p><p class=ind>
+Email: <a href="mailto:dirk@id3.org">dirk@id3.org</a>
+</p>
+<p class=ind>
+Johan Sundström<br>
+Alsättersgatan 5 A. 34<br>
+S-584 35 Linköping<br>
+Sweden<br>
+</p><p class=ind>
+Email: <a href="mailto:johan@id3.org">johan@id3.org</a>
+</p>
+
+</body></html>
\ No newline at end of file diff --git a/doc/id3/id3v2_blocks.gif b/doc/id3/id3v2_blocks.gif Binary files differnew file mode 100755 index 0000000..153027e --- /dev/null +++ b/doc/id3/id3v2_blocks.gif diff --git a/doc/id3/mpeghdr-19991222.htm b/doc/id3/mpeghdr-19991222.htm new file mode 100755 index 0000000..b690c98 --- /dev/null +++ b/doc/id3/mpeghdr-19991222.htm @@ -0,0 +1,769 @@ +<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
+<META NAME="AUTHOR" CONTENT="Predrag Supurovic, broker@dv.co.yu">
+<META NAME="KEYWORDS" CONTENT="mpeg, mp3, header, coding, programming,
+structure, frame, audio, music, file, format, layer I, layer II, layer III, layer 1, layer 2, layer 3, ISO/IEC 11172-3, ISO/IEC 13818-3">
+<META NAME="GENERATOR" CONTENT="handmade">
+<TITLE>MPEG AUDIO FRAME HEADER</TITLE>
+</HEAD>
+
+<BODY BGCOLOR="#FFFFFF">
+
+<P>This is a brief and informal document targeted to those who want to deal
+with the MPEG format. If you are one of them, you probably already know what
+is MPEG audio. If not, jump to <A
+HREF="http://www.mp3.com/">http://www.mp3.com/</A> or <A
+HREF="http://www.layer3.org/">http://www.layer3.org/</A> where you will find
+more details and also more links. This document does not cover compression and
+decompression algorithm.
+
+<P>NOTE: You cannot just search the Internet and find the MPEG audio specs. It
+is copyrighted and you will have to pay quite a bit to get the Paper. That's why
+I made this. Information I got is gathered from the Internet, and mostly originate
+from program sources I found available for free. Despite my intention to always
+specify the information sources, I am not able to do it this time. Sorry, I did
+not maintain the list. :-(
+<P><B>These are not a decoding specs, it just informs you how to read the </B><A
+HREF="#MPEG HEADER"><B>MPEG headers</B></A><B> and the </B> <A HREF="#MPEGTAG"
+TARGET=""><B>MPEG TAG</B></A><B>. MPEG Version 1, 2 and 2.5 and Layer I, II
+and III are supported, the MP3 TAG (ID3v1 and ID3v1.1) also.</B>. Those of you
+who use Delphi may find <A
+HREF="http://www.dv.co.yu/mpgscript/mpgtools.htm">MPGTools Delphi unit (freeware source)</A>
+useful, it is where I implemented this stuff.
+
+<P>I do not claim information presented in this document is accurate. At first
+I just gathered it from different sources. It was not an easy task but I needed
+it. Later, I received lots of comments as feedback when I published this document.
+I think this last release is highly accurate due to comments and corrections I
+received.
+<P>This document is last updated on December 22, 1999.
+<P ALIGN="center"><FONT SIZE="5"><B>MPEG Audio Compression Basics</B></FONT>
+
+<P>This is one of many methods to compress audio in digital form trying to consume
+as little space as possible but keep audio quality as good as possible. MPEG compression
+showed up as one of the best achievements in this area.
+<P>This is a lossy compression, which means, you will certainly loose some audio
+information when you use this compression methods. But, this lost can hardly be
+noticed because the compression method tries to control it. By using several quite
+complicate and demanding mathematical algorithms it will only loose those parts
+of sound that are hard to be heard even in the original form. This leaves more
+space for information that is important. This way you can compress audio up to
+12 times (you may choose compression ratio) which is really significant. Due to
+its quality MPEG audio became very popular.
+<P>MPEG standards MPEG-1, MPEG-2 and MPEG-4 are known but this document covers
+first two of them. There is an unofficial MPEG-2.5 which is rarely used. It is
+also covered.
+<P><B>MPEG-1 audio</B> (described in ISO/IEC 11172-3) describes three Layers of audio coding with the following properties:
+<LI>one or two audio channels
+<LI>sample rate 32kHz, 44.1kHz or 48kHz.
+<LI>bit rates from 32kbps up to 448kbps<BR>
+Each layer has its merits.
+
+<P><B>MPEG-2 audio</B> (described in ISO/IEC 13818-3) has two extensions to MPEG-1, usually referred as MPEG-2/LSF and MPEG-2/Multichannel.
+<P>MPEG-2/LSF has the following properties:
+<LI>one or two audio channels
+<LI>sample rates half those of MPEG-1
+<LI>bit rates from 8 kbps up to 256kbps.
+
+<P>MPEG-2/Multichannel has the following properties:
+<LI>up to 5 full range audio channels and an LFE-channel (Low Frequency
+Enhancement <> subwoofer!)
+<LI>sample rates the same as those of MPEG-1
+<LI>highest possible bitrate goes up to about 1Mbps for 5.1
+
+
+<P ALIGN="center"><A NAME="MPEG HEADER"></A><FONT SIZE="5"><B>MPEG Audio Frame
+Header</B></FONT>
+
+<P>An MPEG audio file is built up from smaller parts called frames. Generally,
+frames are independent items. Each frame has its own header and audio informations.
+There is no file header. Therefore, you can cut any part of MPEG file and play
+it correctly (this should be done on frame boundaries but most applications will
+handle incorrect headers). For Layer III, this is not 100% correct. Due to internal
+data organization in MPEG version 1 Layer III files, frames are often dependent
+of each other and they cannot be cut off just like that.
+<P>When you want to read info about an MPEG file, it is usually enough to find
+the first frame, read its header and assume that the other frames are the same
+This may not be always the case. Variable bitrate MPEG files may use so called
+bitrate switching, which means that bitrate changes according to the content of
+each frame. This way lower bitrates may be used in frames where it will not reduce
+sound quality. This allows making better compression while keeping high quality
+of sound.
+<P>The frame header is constituted by the very first four bytes (32bits) in a
+frame. The first eleven bits (or first twelve bits, see below about frame sync)
+of a frame header are always set and they are called "frame sync". Therefore,
+you can search through the file for the first occurence of frame sync (meaning
+that you have to find a byte with a value of 255, and followed by a byte with
+its three (or four) most significant bits set). Then you read the whole header
+and check if the values are correct. You will see in the following table the exact
+meaning of each bit in the header, and which values may be checked for validity.
+Each value that is specified as reserved, invalid, bad, or not allowed should
+indicate an invalid header. Remember, this is not enough, frame sync can be easily
+(and very frequently) found in any binary file. Also it is likely that MPEG file
+contains garbage on it's beginning which also may contain false sync. Thus, you
+have to check two or more frames in a row to assure you are really dealing with
+MPEG audio file.
+<P>Frames may have a CRC check. The CRC is 16 bits long
+and, if it exists, it follows the frame header. After the CRC comes the audio
+data. You may calculate the length of the frame and use it if you need to read
+other headers too or just want to calculate the CRC of the frame, to compare
+it with the one you read from the file. This is actually a very good method to
+check the MPEG header validity.
+
+<P>Here is "graphical" presentation of the header content. Characters
+from A to M are used to indicate different fields. In the table, you can see
+details about the content of each field.
+<P ALIGN="center">
+<B><TT><FONT SIZE="5">
+AAAAAAAA AAABBCCD EEEEFFGH IIJJKLMM
+</FONT>
+</TT></B>
+
+<P><CENTER>
+
+<TABLE BORDER="0" CELLSPACING=7>
+<TR VALIGN=TOP BGCOLOR="#E2E2E2">
+<TD>Sign</TD><TD>Length<BR>(bits)</TD><TD>Position<BR>(bits)</TD><TD>Description</TD>
+</TR>
+
+<TR VALIGN=TOP>
+<TD>A</TD><TD>11</TD><TD>(31-21)</TD><TD>Frame sync (all bits set)</TD>
+</TR>
+
+<TR VALIGN=TOP>
+<TD>B</TD><TD>2</TD><TD>(20,19)</TD><TD>MPEG Audio version ID<BR>
+00 - MPEG Version 2.5<BR>01 - reserved<BR>10 - MPEG Version 2 (ISO/IEC 13818-3)<BR>11 - MPEG Version 1 (ISO/IEC 11172-3)
+<P>Note: MPEG Version 2.5 is not official standard. Bit No 20 in frame header
+is used to indicate version 2.5. Applications that do not support this MPEG version
+expect this bit always to be set, meaning that frame sync (A) is twelve bits long,
+not eleve as stated here. Accordingly, B is one bit long (represents only bit
+No 19). I recommend using methodology presented here, since this allows you to
+distinguish all three versions and keep full compatibility.
+</TD>
+</TR>
+
+<TR VALIGN=TOP><TD>C</TD><TD>2</TD><TD>(18,17)</TD>
+<TD>Layer description<BR>
+00 - reserved<BR>
+01 - Layer III<BR>
+10 - Layer II<BR>
+11 - Layer I</TD>
+</TR>
+
+<TR VALIGN=TOP>
+<TD>D</TD><TD>1</TD><TD>(16)</TD>
+<TD>Protection bit<BR>
+0 - Protected by CRC (16bit crc follows header)<BR>
+1 - Not protected</TD>
+</TR>
+<TR VALIGN=TOP><TD>E</TD><TD>4</TD><TD>(15,12)</TD><TD>Bitrate index<BR>
+<TABLE BORDER="1" CELLSPACING="0" CELLPADING="0">
+<TR><TD>bits</TD><TD>V1,L1</TD><TD>V1,L2</TD><TD>V1,L3</TD><TD>V2,L1</TD><TD>V2, L2 & L3</TD></TR>
+<TR><TD>0000</TD><TD>free</TD><TD>free</TD><TD>free</TD><TD>free</TD><TD>free</TD></TR>
+<TR><TD>0001</TD><TD>32</TD><TD>32</TD><TD>32</TD><TD>32</TD><TD>8</TD></TR>
+<TR><TD>0010</TD><TD>64</TD><TD>48</TD><TD>40</TD><TD>48</TD><TD>16</TD></TR>
+<TR><TD>0011</TD><TD>96</TD><TD>56</TD><TD>48</TD><TD>56</TD><TD>24</TD></TR>
+<TR><TD>0100</TD><TD>128</TD><TD>64</TD><TD>56</TD><TD>64</TD><TD>32</TD></TR>
+<TR><TD>0101</TD><TD>160</TD><TD>80</TD><TD>64</TD><TD>80</TD><TD>40</TD></TR>
+<TR><TD>0110</TD><TD>192</TD><TD>96</TD><TD>80</TD><TD>96</TD><TD>48</TD></TR>
+<TR><TD>0111</TD><TD>224</TD><TD>112</TD><TD>96</TD><TD>112</TD><TD>56</TD></TR>
+<TR><TD>1000</TD><TD>256</TD><TD>128</TD><TD>112</TD><TD>128</TD><TD>64</TD></TR>
+<TR><TD>1001</TD><TD>288</TD><TD>160</TD><TD>128</TD><TD>144</TD><TD>80</TD></TR>
+<TR><TD>1010</TD><TD>320</TD><TD>192</TD><TD>160</TD><TD>160</TD><TD>96</TD></TR>
+<TR><TD>1011</TD><TD>352</TD><TD>224</TD><TD>192</TD><TD>176</TD><TD>112</TD></TR>
+<TR><TD>1100</TD><TD>384</TD><TD>256</TD><TD>224</TD><TD>192</TD><TD>128</TD></TR>
+<TR><TD>1101</TD><TD>416</TD><TD>320</TD><TD>256</TD><TD>224</TD><TD>144</TD></TR>
+<TR><TD>1110</TD><TD>448</TD><TD>384</TD><TD>320</TD><TD>256</TD><TD>160</TD></TR>
+<TR><TD>1111</TD><TD>bad</TD><TD>bad</TD><TD>bad</TD><TD>bad</TD><TD>bad</TD></TR>
+</TABLE>
+<P>
+NOTES: All values are in kbps<BR>
+V1 - MPEG Version 1<BR>
+V2 - MPEG Version 2 and Version 2.5<BR>
+L1 - Layer I<BR>
+L2 - Layer II<BR>
+L3 - Layer III<BR>
+"free" means free format. If the correct fixed bitrate (such files cannot
+use variable bitrate) is different than those presented in upper table it must
+be determined by the application. This may be implemented only for internal purposes
+since third party applications have no means to find out correct bitrate. Howewer,
+this is not impossible to do but demands lot's of efforts.<BR>
+"bad" means that this is not an allowed value
+
+<P>MPEG files may have variable bitrate (VBR). This means that bitrate in the file may change. I have learned about two used methods:
+<LI>bitrate switching. Each frame may be created with different bitrate. It may be used in all layers. Layer III decoders must support this method. Layer I & II decoders may support it.
+<LI>bit reservoir. Bitrate may be borrowed (within limits) from previous frames
+in order to provide more bits to demanding parts of the input signal. This causes,
+however, that the frames are no longer independent, which means you should not
+cut this files. This is supported only in Layer III.
+<P>More about VBR you may find on <A HREF="http://www.xingtech.com/">Xing Tech
+site</A>
+<P>For Layer II there are some combinations of bitrate and mode which are not
+allowed. Here is a list of allowed combinations.
+<TABLE BORDER=1 CELLSPACING=0>
+<TR>
+<TD>bitrate</TD>
+<TD>allowed modes</TD>
+</TR>
+<TR>
+<TD>free</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>32</TD>
+<TD>single channel</TD>
+</TR>
+<TR>
+<TD>48</TD>
+<TD>single channel</TD>
+</TR>
+<TR>
+<TD>56</TD>
+<TD>single channel</TD>
+</TR>
+<TR>
+<TD>64</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>80</TD>
+<TD>single channel</TD>
+</TR>
+<TR>
+<TD>96</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>112</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>128</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>160</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>192</TD>
+<TD>all</TD>
+</TR>
+<TR>
+<TD>224</TD>
+<TD>stereo, intensity stereo, dual channel</TD>
+</TR>
+<TR>
+<TD>256</TD>
+<TD>stereo, intensity stereo, dual channel</TD>
+</TR>
+<TR>
+<TD>320</TD>
+<TD>stereo, intensity stereo, dual channel</TD>
+</TR>
+<TR>
+<TD>384</TD>
+<TD>stereo, intensity stereo, dual channel</TD>
+</TR>
+</TABLE>
+</TD></TR>
+<TR VALIGN=TOP>
+<TD>F</TD><TD>2</TD><TD>(11,10)</TD>
+<TD>Sampling rate frequency index (values are in Hz)
+<TABLE BORDER="1" CELLSPACING="0" CELLPADING="0">
+<TR><TD>bits</TD><TD>MPEG1</TD><TD>MPEG2</TD><TD>MPEG2.5</TD></TR>
+<TR><TD>00</TD><TD>44100</TD><TD>22050</TD><TD>11025</TD></TR>
+<TR><TD>01</TD><TD>48000</TD><TD>24000</TD><TD>12000</TD></TR>
+<TR><TD>10</TD><TD>32000</TD><TD>16000</TD><TD>8000</TD></TR>
+<TR><TD>11</TD><TD>reserv.</TD><TD>reserv.</TD><TD>reserv.</TD></TR>
+</TABLE>
+</TD></TR>
+
+<TR VALIGN=TOP>
+<TD>G</TD><TD>1</TD><TD>(9)</TD>
+<TD>Padding bit<BR>
+0 - frame is not padded<BR>
+1 - frame is padded with one extra slot<BR>
+
+Padding is used to fit the bit rates exactly. For an example: 128k 44.1kHz layer II uses a lot of 418 bytes and some of 417 bytes long frames to get the exact 128k bitrate. For Layer I slot is 32 bits long, for Layer II and Layer III slot is 8 bits long.
+
+
+
+<P><B>How to calculate frame length</B>
+
+<P>First, let's distinguish two terms frame size and frame length. Frame size
+is the number of samples contained in a frame. It is constant and always 384 samples
+for Layer I and 1152 samples for Layer II and Layer III. Frame length is length
+of a frame when compressed. It is calculated in slots. One slot is 4 bytes long
+for Layer I, and one byte long for Layer II and Layer III. When you are reading
+MPEG file you must calculate this to be able to find each consecutive frame. Remember,
+frame length may change from frame to frame due to padding or bitrate switching.
+<P>Read the BitRate, SampleRate and Padding of the frame header.
+<P>For Layer I files us this formula:
+<P ALIGN=CENTER>FrameLengthInBytes = (12 * BitRate / SampleRate + Padding) * 4
+<P ALIGN=LEFT>For Layer II & III files use this formula:
+<P ALIGN=CENTER>FrameLengthInBytes = 144 * BitRate / SampleRate + Padding
+<P>Example:<BR>
+Layer III, BitRate=128000, SampleRate=441000, Padding=0<BR>
+ ==> FrameSize=417 bytes
+</TD></TR>
+
+<TR VALIGN=TOP><TD>H</TD><TD>1</TD><TD>(8)</TD>
+<TD>Private bit. It may be freely used for specific needs of an application, i.e. if it has to trigger some application specific events.</TD>
+</TR>
+
+<TR VALIGN=TOP><TD>I</TD><TD>2</TD><TD>(7,6)</TD>
+<TD>Channel Mode<BR>
+00 - Stereo<BR>
+01 - Joint stereo (Stereo)<BR>
+10 - Dual channel (Stereo)<BR>
+11 - Single channel (Mono)</TD>
+</TR>
+
+<TR VALIGN=TOP><TD>J</TD><TD>2</TD><TD>(5,4)</TD>
+<TD>Mode extension (Only if Joint stereo)
+<P>Mode extension is used to join informations that are of no use for stereo effect, thus reducing needed resources. These bits are dynamically determined by an encoder in Joint stereo mode.
+
+<P>Complete frequency range of MPEG file is divided in subbands There are 32 subbands. For Layer I & II these two bits determine frequency range (bands) where intensity stereo is applied. For Layer III these two bits determine which type of joint stereo
+
+is used (intensity stereo or m/s stereo). Frequency range is determined within decompression algorythm.
+
+<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="0">
+<TR><TD ALIGN=CENTER>Layer I and II</TD><TD ALIGN=CENTER>Layer III</TD></TR>
+<TR VALIGN=TOP><TD>
+<TABLE BORDER="1" CELLSPACING="0" CELLPADING="0">
+<TR><TD>value</TD><TD>Layer I & II</TD></TR>
+<TR><TD>00</TD><TD>bands 4 to 31</TD></TR>
+<TR><TD>01</TD><TD>bands 8 to 31</TD></TR>
+<TR><TD>10</TD><TD>bands 12 to 31</TD></TR>
+<TR><TD>11</TD><TD>bands 16 to 31</TD></TR></TABLE>
+</TD>
+
+<TD>
+<TABLE BORDER="1" CELLSPACING="0" CELLPADING="0" WIDTH="212">
+<TR ALIGN=CENTER><TD>Intensity stereo</TD><TD>MS stereo</TD></TR>
+<TR ALIGN=CENTER><TD>off</TD><TD>off</TD></TR>
+<TR ALIGN=CENTER><TD>on</TD><TD>off</TD></TR>
+<TR ALIGN=CENTER><TD>off</TD><TD>on</TD></TR>
+<TR ALIGN=CENTER><TD>on</TD><TD>on</TD></TR></TABLE>
+</TD></TR></TABLE>
+</TD></TR>
+
+<TR VALIGN=TOP><TD>K</TD><TD>1</TD><TD>(3)</TD>
+<TD>Copyright<BR>
+0 - Audio is not copyrighted<BR>
+1 - Audio is copyrighted</TD>
+</TR>
+
+<TR VALIGN=TOP><TD>L</TD><TD>1</TD><TD>(2)</TD>
+<TD>Original<BR>
+0 - Copy of original media<BR>
+1 - Original media</TD>
+</TR>
+
+<TR VALIGN=TOP>
+<TD>M</TD><TD>2</TD><TD>(1,0)</TD>
+<TD>Emphasis<BR>
+00 - none<BR>
+01 - 50/15 ms<BR>
+10 - reserved<BR>
+11 - CCIT J.17</TD>
+</TR></TABLE>
+<P> </P></CENTER>
+
+<P ALIGN="center"><A NAME="MPEGTAG"></A><FONT SIZE="5"><B>MPEG Audio Tag ID3v1</B></FONT>
+<P>The TAG is used to describe the MPEG Audio file. It contains information
+about artist, title, album, publishing year and genre. There is some extra
+space for comments. It is exactly 128 bytes long and is located at very end of
+the audio data. You can get it by reading the last 128 bytes of the MPEG audio
+file.
+
+<P ALIGN="center"><FONT SIZE="5"><B><TT>
+AAABBBBB BBBBBBBB BBBBBBBB BBBBBBBB<BR>
+BCCCCCCC CCCCCCCC CCCCCCCC CCCCCCCD<BR>
+DDDDDDDD DDDDDDDD DDDDDDDD DDDDDEEE<BR>
+EFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFG<BR>
+</TT></B></FONT>
+
+<CENTER>
+
+<TABLE BORDER="0" WIDTH="500">
+<TR VALIGN=TOP BGCOLOR=#E2E2E2>
+<TD>Sign</TD><TD>Length<BR>(bytes)</TD><TD>Position<BR>
+(bytes)</TD><TD>Description</TD></TR>
+<TR VALIGN=TOP><TD>A</TD><TD>3</TD><TD>(0-2)</TD>
+<TD>Tag identification. Must contain 'TAG' if tag exists and is
+correct.</TD>
+</TR>
+<TR><TD>B</TD><TD>30</TD><TD>(3-32)</TD><TD>Title</TD></TR>
+<TR><TD>C</TD><TD>30</TD><TD>(33-62)</TD><TD>Artist</TD></TR>
+<TR><TD>D</TD><TD>30</TD><TD>(63-92)</TD><TD>Album</TD></TR>
+<TR><TD>E</TD><TD>4</TD><TD>(93-96)</TD><TD>Year</TD></TR>
+<TR><TD>F</TD><TD>30</TD><TD>(97-126)</TD><TD>Comment</TD></TR>
+<TR><TD>G</TD><TD>1</TD><TD>(127)</TD><TD>Genre</TD></TR></TABLE>
+</CENTER>
+
+<P>The specification asks for all fields to be padded with null character
+(ASCII 0). However, not all applications respect this (an example is WinAmp
+which pads fields with <space>, ASCII 32).
+
+<P>There is a small change proposed in <B>ID3v1.1</B> structure. The last byte
+of the Comment field may be used to specify the track number of a song in an
+album. It should contain a null character (ASCII 0) if the information is
+unknown.
+
+<P>Genre is a numeric field which may have one of the following values:
+
+<CENTER>
+<TABLE BORDER="0" WIDTH="90%">
+<TR>
+<TD WIDTH="1%">0</TD>
+<TD WIDTH="20%">'Blues'</TD>
+<TD WIDTH="1%">20</TD>
+<TD WIDTH="20%">'Alternative'</TD>
+<TD WIDTH="1%">40</TD>
+<TD WIDTH="20%">'AlternRock'</TD>
+<TD WIDTH="1%">60</TD>
+<TD WIDTH="20%">'Top 40'</TD>
+</TR>
+<TR>
+<TD>1</TD>
+<TD>'Classic Rock'</TD>
+<TD>21</TD>
+<TD>'Ska'</TD>
+<TD>41</TD>
+<TD>'Bass'</TD>
+<TD>61</TD>
+<TD>'Christian Rap'</TD>
+</TR>
+<TR>
+<TD>2</TD>
+<TD>'Country'</TD>
+<TD>22</TD>
+<TD>'Death Metal'</TD>
+<TD>42</TD>
+<TD>'Soul'</TD>
+<TD>62</TD>
+<TD>'Pop/Funk'</TD>
+</TR>
+<TR>
+<TD>3</TD>
+<TD>'Dance'</TD>
+<TD>23</TD>
+<TD>'Pranks'</TD>
+<TD>43</TD>
+<TD>'Punk'</TD>
+<TD>63</TD>
+<TD>'Jungle'</TD>
+</TR>
+<TR>
+<TD>4</TD>
+<TD>'Disco'</TD>
+<TD>24</TD>
+<TD>'Soundtrack'</TD>
+<TD>44</TD>
+<TD>'Space'</TD>
+<TD>64</TD>
+<TD>'Native American'</TD>
+</TR>
+<TR>
+<TD>5</TD>
+<TD>'Funk'</TD>
+<TD>25</TD>
+<TD>'Euro-Techno'</TD>
+<TD>45</TD>
+<TD>'Meditative'</TD>
+<TD>65</TD>
+<TD>'Cabaret'</TD>
+</TR>
+<TR>
+<TD>6</TD>
+<TD>'Grunge'</TD>
+<TD>26</TD>
+<TD>'Ambient'</TD>
+<TD>46</TD>
+<TD>'Instrumental Pop'</TD>
+<TD>66</TD>
+<TD>'New Wave'</TD>
+</TR>
+<TR>
+<TD>7</TD>
+<TD>'Hip-Hop'</TD>
+<TD>27</TD>
+<TD>'Trip-Hop'</TD>
+<TD>47</TD>
+<TD>'Instrumental Rock'</TD>
+<TD>67</TD>
+<TD>'Psychadelic'</TD>
+</TR>
+<TR>
+<TD>8</TD>
+<TD>'Jazz'</TD>
+<TD>28</TD>
+<TD>'Vocal'</TD>
+<TD>48</TD>
+<TD>'Ethnic'</TD>
+<TD>68</TD>
+<TD>'Rave'</TD>
+</TR>
+<TR>
+<TD>9</TD>
+<TD>'Metal'</TD>
+<TD>29</TD>
+<TD>'Jazz+Funk'</TD>
+<TD>49</TD>
+<TD>'Gothic'</TD>
+<TD>69</TD>
+<TD>'Showtunes'</TD>
+</TR>
+<TR>
+<TD>10</TD>
+<TD>'New Age'</TD>
+<TD>30</TD>
+<TD>'Fusion'</TD>
+<TD>50</TD>
+<TD>'Darkwave'</TD>
+<TD>70</TD>
+<TD>'Trailer'</TD>
+</TR>
+<TR>
+<TD>11</TD>
+<TD>'Oldies'</TD>
+<TD>31</TD>
+<TD>'Trance'</TD>
+<TD>51</TD>
+<TD>'Techno-Industrial'</TD>
+<TD>71</TD>
+<TD>'Lo-Fi'</TD>
+</TR>
+<TR>
+<TD>12</TD>
+<TD>'Other'</TD>
+<TD>32</TD>
+<TD>'Classical'</TD>
+<TD>52</TD>
+<TD>'Electronic'</TD>
+<TD>72</TD>
+<TD>'Tribal'</TD>
+</TR>
+<TR>
+<TD>13</TD>
+<TD>'Pop'</TD>
+<TD>33</TD>
+<TD>'Instrumental'</TD>
+<TD>53</TD>
+<TD>'Pop-Folk'</TD>
+<TD>73</TD>
+<TD>'Acid Punk'</TD>
+</TR>
+<TR>
+<TD>14</TD>
+<TD>'R&B'</TD>
+<TD>34</TD>
+<TD>'Acid'</TD>
+<TD>54</TD>
+<TD>'Eurodance'</TD>
+<TD>74</TD>
+<TD>'Acid Jazz'</TD>
+</TR>
+<TR>
+<TD>15</TD>
+<TD>'Rap'</TD>
+<TD>35</TD>
+<TD>'House'</TD>
+<TD>55</TD>
+<TD>'Dream'</TD>
+<TD>75</TD>
+<TD>'Polka'</TD>
+</TR>
+<TR>
+<TD>16</TD>
+<TD>'Reggae'</TD>
+<TD>36</TD>
+<TD>'Game'</TD>
+<TD>56</TD>
+<TD>'Southern Rock'</TD>
+<TD>76</TD>
+<TD>'Retro'</TD>
+</TR>
+<TR>
+<TD>17</TD>
+<TD>'Rock'</TD>
+<TD>37</TD>
+<TD>'Sound Clip'</TD>
+<TD>57</TD>
+<TD>'Comedy'</TD>
+<TD>77</TD>
+<TD>'Musical'</TD>
+</TR>
+<TR>
+<TD>18</TD>
+<TD>'Techno'</TD>
+<TD>38</TD>
+<TD>'Gospel'</TD>
+<TD>58</TD>
+<TD>'Cult'</TD>
+<TD>78</TD>
+<TD>'Rock & Roll'</TD>
+</TR>
+<TR>
+<TD>19</TD>
+<TD>'Industrial'</TD>
+<TD>39</TD>
+<TD>'Noise'</TD>
+<TD>59</TD>
+<TD>'Gangsta'</TD>
+<TD>79</TD>
+<TD>'Hard Rock'</TD>
+</TR>
+</TABLE>
+<DIV ALIGN="LEFT"><BR>
+WinAmp expanded this table with next codes: </DIV>
+<TABLE BORDER="0" WIDTH="90%">
+<TR>
+<TD WIDTH="1%">80</TD>
+<TD WIDTH="20%">'Folk'</TD>
+<TD>92</TD>
+<TD>'Progressive Rock'</TD>
+<TD>104</TD>
+<TD>'Chamber Music'</TD>
+<TD>116</TD>
+<TD>'Ballad'</TD>
+</TR>
+<TR>
+<TD>81</TD>
+<TD>'Folk-Rock'</TD>
+<TD WIDTH="1%">93</TD>
+<TD WIDTH="20%">'Psychedelic Rock'</TD>
+<TD>105</TD>
+<TD>'Sonata'</TD>
+<TD>117</TD>
+<TD>'Poweer Ballad'</TD>
+</TR>
+<TR>
+<TD>82</TD>
+<TD>'National Folk'</TD>
+<TD>94</TD>
+<TD>'Symphonic Rock'</TD>
+<TD WIDTH="1%">106</TD>
+<TD WIDTH="20%">'Symphony'</TD>
+<TD>118</TD>
+<TD>'Rhytmic Soul'</TD>
+</TR>
+<TR>
+<TD>83</TD>
+<TD>'Swing'</TD>
+<TD>95</TD>
+<TD>'Slow Rock'</TD>
+<TD>107</TD>
+<TD>'Booty Brass'</TD>
+<TD WIDTH="1%">119</TD>
+<TD WIDTH="20%">'Freestyle'</TD>
+</TR>
+<TR>
+<TD>84</TD>
+<TD>'Fast Fusion'</TD>
+<TD>96</TD>
+<TD>'Big Band'</TD>
+<TD>108</TD>
+<TD>'Primus'</TD>
+<TD>120</TD>
+<TD>'Duet'</TD>
+</TR>
+<TR>
+<TD>85</TD>
+<TD>'Bebob'</TD>
+<TD>97</TD>
+<TD>'Chorus'</TD>
+<TD>109</TD>
+<TD>'Porn Groove'</TD>
+<TD>121</TD>
+<TD>'Punk Rock'</TD>
+</TR>
+<TR>
+<TD>86</TD>
+<TD>'Latin'</TD>
+<TD>98</TD>
+<TD>'Easy Listening'</TD>
+<TD>110</TD>
+<TD>'Satire'</TD>
+<TD>122</TD>
+<TD>'Drum Solo'</TD>
+</TR>
+<TR>
+<TD>87</TD>
+<TD>'Revival'</TD>
+<TD>99</TD>
+<TD>'Acoustic'</TD>
+<TD>111</TD>
+<TD>'Slow Jam'</TD>
+<TD>123</TD>
+<TD>'A Capela'</TD>
+</TR>
+<TR>
+<TD>88</TD>
+<TD>'Celtic'</TD>
+<TD>100</TD>
+<TD>'Humour'</TD>
+<TD>112</TD>
+<TD>'Club'</TD>
+<TD>124</TD>
+<TD>'Euro-House'</TD>
+</TR>
+<TR>
+<TD>89</TD>
+<TD>'Bluegrass'</TD>
+<TD>101</TD>
+<TD>'Speech'</TD>
+<TD>113</TD>
+<TD>'Tango'</TD>
+<TD>125</TD>
+<TD>'Dance Hall'</TD>
+</TR>
+<TR>
+<TD>90</TD>
+<TD>'Avantgarde'</TD>
+<TD>102</TD>
+<TD>'Chanson'</TD>
+<TD>114</TD>
+<TD>'Samba'</TD>
+<TD> </TD>
+<TD> </TD>
+</TR>
+<TR>
+<TD>91</TD>
+<TD>'Gothic Rock'</TD>
+<TD>103</TD>
+<TD>'Opera'</TD>
+<TD>115</TD>
+<TD>'Folklore'</TD>
+<TD> </TD>
+<TD> </TD>
+</TR>
+<TR>
+<TD COLSPAN=8>Any other value should be considered as 'Unknown'
+</TABLE>
+<P> </P></CENTER>
+
+<P ALIGN="center"><A NAME="MPEG TAG"></A><FONT SIZE="5"><B>MPEG Audio Tag ID3v2</B></FONT>
+<P>This is new proposed TAG format which is different than ID3v1 and ID3v1.1.
+Complete tech specs for it may be found at <A
+HREF="http://www.id3.org/">http://www.id3.org/</A>.
+<P><CENTER>
+<HR>
+<P><FONT SIZE="-1"> Created on September 1998. by <A HREF="http://www.dv.co.yu/broker/">Predrag
+Supurovic</A>.<BR>
+Thanks to <A HREF="http://www.jps.net/kyunghi/">Jean</A> for debugging and polishing
+of this document, <A HREF="http://members.tripod.com/~videoripper/home.htm">Peter
+Luijer</A>, Guwani, Rob Leslie and Franc Zijderveld<BR>
+for valuable comments and corrections.</FONT></P>
+<P>© 1998, 1999 Copyright by DataVoyage</P>
+<P><FONT SIZE="-1">This document may be changed. Check <A
+HREF="http://www.dv.co.yu/mpgscript/mpeghdr.htm">http://www.dv.co.yu/mpgscript/mpeghdr.htm</A>
+for updates.<BR>
+You may use it freely. Distribution is allowed only in unaltered form. If you
+can help me make it more accurate, please do. </FONT></P>
+<P> </P>
+</CENTER>
+</BODY></HTML>
diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr1.html b/doc/users_guide_french/USERS-GUIDE-11_fr1.html new file mode 100755 index 0000000..960b6a6 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr1.html @@ -0,0 +1,63 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr1.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 1 - Introduction * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG</title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 1 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="#ch_1">1 - Introduction.</a></li> + <li><a href="USERS-GUIDE-11_fr2.html">2 - Description de l'interface.</a></li> + <li><a href="USERS-GUIDE-11_fr3.html">3 - Recherche rapide dans votre collection de fichiers audio.</a></li> + <li><a href="USERS-GUIDE-11_fr4.html">4 - Editer/corriger les tags.</a></li> + <li><a href="USERS-GUIDE-11_fr5.html">5 - Renommer les fichiers/les répertoires.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html">6 - Autres fonctions.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- INTRODUCTION =========================================================================--> + + <h2><a name="ch_1" id="ch_1">1 - Introduction.</a></h2> + <p>EasyTAG est un utilitaire permettant l'édition et la modification des tags des fichiers audio. Ses caractéristiques principales sont les suivantes :</p> + <ul class="liste1"> + <li>EasyTAG prend en charge les fichiers audio de type MP3, MP2 (tag ID3 incluant les images), FLAC (tag FLAC Vorbis), Ogg Vorbis (tag Ogg Vorbis), MP4/AAC (tag MP4/AAC), MusePack et Monkey (tag APE).</li> + <li>EasyTAG permet l'édition/la modification d'un grand nombre de champs d'information (métadonnées) des différents tags : titre, artiste, album, numéro d'album, année, numéro de piste, nombre total de pistes, genre, commentaire, compositeur, premier artiste/interprète, copyright, URL, type d'encodeur et, pour les fichiers MP3 et FLAC, le champ images.</li> + <li>EasyTAG possède une interface, développée en GTK+, simple et intuitive.</li> + <li>EasyTAG permet une navigation très facile dans l'ensemble de votre collection de fichiers audio grâce à : + <ul class="liste2"> + <li>deux modes de visualisation de votre collection : un mode de type arborescence des répertoires ou un mode de type arborescence artistes/albums,</li> + <li>une possibilité de rechercher, dans votre collection, les fichiers par mots clé (nom du fichier, titre).</li> + </ul> + </li> + <li>EasyTAG permet une modification manuelle ou automatique (traitement via un scanner, via une base de données CDDB) des différents champs d'information du tag des différents fichiers audio.</li> + <li>EasyTAG permet non seulement de modifier manuellement ou automatiquement le nom des fichiers et des répertoires contenant ces fichiers mais aussi de déplacer automatiquement les fichiers renommés dans un répertoire particulier.</li> + <li>EasyTAG permet enfin de créer une liste de lecture de fichiers audio pour les logiciels Winamp ou XMMS ou de lancer, depuis l'interface, l'écoute des fichiers audio.</li> + </ul> + <p>Le présent guide va vous permettre de maitriser l'interface et les différentes fonctionnalités de cet utilitaire.</p> + +<!-- FIN INTRODUCTION =====================================================================--> + + <p class="img_c"><br/><a href="#haut_page">RETOUR A LA TABLE DES MATIERES.</a></p> +</body> +</html> + diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr2.html b/doc/users_guide_french/USERS-GUIDE-11_fr2.html new file mode 100755 index 0000000..ad7cad4 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr2.html @@ -0,0 +1,274 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr2.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 2 - Description de l'interface. * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> + +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG - chapitre 2 - Description de l'interface.</title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> + +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 2 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="USERS-GUIDE-11_fr1.html">1 - Introduction.</a></li> + <li><a href="#ch_2">2 - Description de l'interface.</a> + <ul class="TM2"> + <li><a href="#ch_2_1">2.1 - Barre de menus.</a> + <ul class="TM3"> + <li><a href="#ch_2_1_1">2.1.1 - Menu «Fichier».</a></li> + <li><a href="#ch_2_1_2">2.1.2 - Menu «Sélecteur».</a></li> + <li><a href="#ch_2_1_3">2.1.3 - Menu «Scanner».</a></li> + <li><a href="#ch_2_1_4">2.1.4 - Menu «Divers».</a></li> + <li><a href="#ch_2_1_5">2.1.5 - Menu «Paramètres».</a></li> + </ul> + </li> + <li><a href="#ch_2_2">2.2 - Barre de fonctions.</a></li> + <li><a href="#ch_2_3">2.3 - Fenêtre «Sélecteur».</a> + <ul class="TM3"> + <li><a href="#ch_2_3_1">2.3.1 - Mode arborescence des répertoires.</a></li> + <li><a href="#ch_2_3_2">2.3.2 - Mode arborescence artistes/albums.</a></li> + </ul> + </li> + <li><a href="#ch_2_4">2.4 - Fenêtre «Fichier».</a></li> + <li><a href="#ch_2_5">2.5 - Fenêtre «Tag».</a></li> + <li><a href="#ch_2_6">2.6 - Menus contextuels.</a></li> + </ul> + </li> + <li><a href="USERS-GUIDE-11_fr3.html">3 - Recherche rapide dans votre collection de fichiers audio.</a></li> + <li><a href="USERS-GUIDE-11_fr4.html">4 - Editer/corriger les tags.</a></li> + <li><a href="USERS-GUIDE-11_fr5.html">5 - Renommer les fichiers/les répertoires.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html">6 - Autres fonctions.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- DESCRIPTION DE L'INTERFACE =============================================================--> + + <h2><a name="ch_2" id="ch_2">2 - Description de l'interface.</a></h2> + <p>La figure ci-après présente une vue d'ensemble de l'interface. Celle-ci est organisée autour de trois fenêtres (Sélecteur, Fichier, Tag), fenêtres affichées avec une bordure rouge sur la figure. Au dessus de ces fenêtres, on trouve un ensemble de menus (Fichier, Sélecteur, Scanner, Divers, Paramètres, Aide) et une barre de boutons permettant un accès rapide à certaines fonctions. De plus, dans certaines zones, en cliquant sur le bouton droit de la souris, il est possible de faire apparaitre des menus contextuels permettant aussi un accès rapide à certaines fonctions.</p> + <div class="img_c"> + <img src="images/interface.png" alt="interface"/> + </div> + <p>Dans la suite de ce chapitre, nous allons détailler ces différents menus et fenêtres.</p> + +<!-- Barre de menus --> + <h3><a name="ch_2_1" id="ch_2_1">2.1 - Barre de menus.</a></h3> + <p>La barre de menus est formée de six menus : menu «Fichier», «Sélecteur», «Scanner», «Divers», «Paramètres» et menu «Aide».</p> + <h4><a name="ch_2_1_1" id="ch_2_1_1">2.1.1 - Menu «Fichier».</a></h4> + <p>Ce menu (voir figure ci-contre) regroupe de nombreuses fonctions de manipulation des fichiers. Discutons plus particulièrement les fonctions suivantes :</p> + <ul class="liste1"> + <li> + <img class="droite" src="images/menu_fic.png" alt="menu Fichier"/> + <span class="entree">Classer liste par tag</span> : Ce sous-menu déroulant (présenté, en partie, sur la figure ci-après) permet d'effectuer un classement de la liste des fichiers présents dans un répertoire sur la base des champs d'information du tag (piste, titre, artiste, …). Voir le <a href="USERS-GUIDE-11_fr3.html#ch_3_1">paragraphe 3.1</a> pour plus de détails. + </li> + <li><span class="entree">Classer liste par propriétés</span> : Ce sous-menu déroulant (présenté, en partie, sur la figure ci-après) permet d'effectuer un classement de la liste des fichiers présents dans un répertoire sur la base de caractéristiques du fichier (nom de fichier, date de création, type de fichier, …). Voir le <a href="USERS-GUIDE-11_fr3.html#ch_3_1">paragraphe 3.1</a> pour plus de détails.</li> + <li><span class="entree">Ouvrir le(s) Fichier(s) avec …</span> : Cette entrée permet la mise en oeuvre d'une application externe (par exemple, lecteur de fichiers audio Xmms) sur une sélection de fichiers. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + <li><span class="entree">Premier Fichier</span> : Déplacement au premier fichier de la liste de la fenêtre «Sélecteur».</li> + <li><span class="entree">Fichier Précédent</span> : Déplacement au fichier précédent de la liste de la fenêtre «Sélecteur»</li> + <li><span class="entree">Fichier Suivant</span> : Déplacement au fichier suivant de la liste de la fenêtre «Sélecteur»</li> + <li><span class="entree">Dernier Fichier</span> : Déplacement au dernier fichier de la liste de la fenêtre «Sélecteur»</li> + <li><span class="entree">Scanner le(s) Fichier(s)</span> : Lance la fenêtre «Scanner». Voir le <a href="#ch_2_1_3">paragraphe 2.1.3</a> pour plus de détails.</li> + <li><span class="entree">Annuler Modifs des Fichiers</span> : Annule les modifications effectuées sur l'ensemble des fichiers sélectionnés.</li> + <li><span class="entree">Refaire Modifs des Fichiers</span> : Effectue, sur l'ensemble des fichiers sélectionnés, l'opération inverse de l'entrée précédente.</li> + <li><span class="entree">Sauver le(s) Fichier(s)</span> : Sauvegarde des fichiers sélectionnés ayant subi des modifications (fichiers indiqués en rouge dans la fenêtre «Sélecteur»).</li> + <li><span class="entree">Forcer la Sauvegarde de(s) Fichier(s)</span> : Force la sauvegarde de tous les fichiers sélectionnés, y compris ceux n'ayant pas subi de modifications (fonction utile lors de l'utilisation de certaines options avancées du logiciel).</li> + <li><span class="entree">Annuler les Derniers Changements</span> : Annule les modifications du dernier fichier modifié même si ce fichier n'est pas sélectionné.</li> + <li><span class="entree">Refaire les Derniers Changements</span> : Effectue, sur le dernier fichier modifié, l'opération inverse de l'entrée précédente.</li> + </ul> + <hr class="fin_img"/> + + <h4><a name="ch_2_1_2" id="ch_2_1_2">2.1.2 - Menu «Sélecteur».</a></h4> + <p>Ce menu (voir figure ci-contre) regroupe de nombreuses fonctions de manipulation des répertoires. Discutons plus particulièrement les fonctions suivantes :</p> + <ul class="liste1"> + <li> + <img class="droite" src="images/menu_sel.png" alt="image menu Sélecteur"/> + <span class="entree">Arborescence/Vue par Artiste-Album</span> : Cette entrée permet de basculer entre le mode arborescence répertoires et le mode arborescence artistes/albums. Voir le <a href="#ch_2_3">paragraphe 2.3</a> pour plus de détails. + </li> + <li><span class="entree">Parcourir le Répertoire avec …</span> : Cette entrée permet la mise en oeuvre d'une application externe (par exemple, lecteur de fichiers audio Xmms) sur un répertoire particulier. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + <li><span class="entree">Refermer l'Arbre</span> : Ferme l'arborescence des répertoires et retourne à l'affichage des répertoires racines.</li> + <li><span class="entree">Rafraîchir l'Arbre</span> : Dans le cas de changement dans l'arborescence des fichiers (création de répertoires, déplacements/suppression de fichiers, …), lance l'acquisition de la nouvelle arborescence.</li> + </ul> + <hr class="fin_img"/> + + <h4><a name="ch_2_1_3" id="ch_2_1_3">2.1.3 - Menu «Scanner».</a></h4> + <p>Ce menu (voir figure ci-contre) permet d'ouvrir l'un des trois scanners disponibles :</p> + <ul class="liste1"> + <li> + <img class="droite" src="images/menu_scan.png" alt="image menu Scanner"/> + <span class="entree">Compléter le(s) Tag(s) …</span> : Lancement du scanner qui permet la modification automatique des champs d'information des tags des fichiers présents dans un répertoire particulier. Voir le <a href="USERS-GUIDE-11_fr4.html#ch_4_2">paragraphe 4.2</a> pour plus de détails. + </li> + <li><span class="entree">Renommer le(s) Fichier(s) et Répertoire(s) …</span> : Lancement du scanner qui permet de renommer automatiquement les fichiers et les répertoires. Voir le <a href="USERS-GUIDE-11_fr5.html#ch_5_2">paragraphe 5.2</a> pour plus de détails.</li> + <li><span class="entree">Traiter le(s) Champs …</span> : Lancement du scanner qui permet d'effectuer un traitement automatique d'uniformisation (traitement de la casse …) des noms et des tags des fichiers présents dans un répertoire particulier. Voir le <a href="USERS-GUIDE-11_fr4.html#ch_4_4">paragraphe 4.4</a> pour plus de détails.</li> + </ul> + + <hr class="fin_img"/> + + <h4><a name="ch_2_1_4" id="ch_2_1_4">2.1.4 - Menu «Divers».</a></h4> + <p>Ce menu (voir figure ci-contre) regroupe, comme son nom l'indique, des fonctions très diverses :</p> + <ul class="liste1"> + <li> + <img class="droite" src="images/menu_div.png" alt="image menu Divers"/> + <span class="entree">Rechercher le(s) Fichier(s) …</span> : Lance une recherche manuelle par mot clé sur l'ensemble des fichiers présents dans un répertoire particulier. Voir le <a href="USERS-GUIDE-11_fr3.html#ch_3_2">paragraphe 3.2</a> pour plus de détails. + </li> + <li><span class="entree">Recherche CDDB …</span> : Lance la modification automatique des tags des fichiers d'un album via la base de données cddb. Voir le <a href="USERS-GUIDE-11_fr4.html#ch_4_3">paragraphe 4.3</a> pour plus de détails.</li> + <li><span class="entree">Charger les Noms des fichiers à partir d'un TXT …</span> : Modification des noms d'un ensemble de fichiers à partir d'un fichier texte. Voir le <a href="USERS-GUIDE-11_fr5.html#ch_5_1_4">paragraphe 5.1.4</a> pour plus de détails.</li> + <li><span class="entree">Ecrire Liste de Lecture …</span> : Création d'une liste de lecture de fichiers audio pour les logiciels Winamp ou XMMS. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_1">paragraphe 6.1</a> pour plus de détails.</li> + <li><span class="entree">Lancer Lecteur Audio</span> : Lancement du lecteur audio spécifié par défaut. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + </ul> + + <hr class="fin_img"/> + + <h4><a name="ch_2_1_5" id="ch_2_1_5">2.1.5 - Menu «Paramètres».</a></h4> + <p>Ce menu contient le sous-menu «Préférences …» qui permet d'effectuer un certain nombre de réglages par défaut du logiciel EasyTAG. Cette fenêtre dispose de huit onglets de réglages différents (Sélecteur, Divers, Paramètres du nom des fichiers, Paramètres des Tags, Paramètres des Tags ID3, Scanner, Base de données CD, Confirmation). Il n'est pas possible de décrire dans le cadre de ce guide l'ensemble des différentes options de réglage du logiciel (se référer alors à chaque bulle d'aide associée à chaque option). La figure suivante présente, par exemple, les possibilités de réglages disponibles dans l'onglet «Divers». En particulier, vous pouvez voir, en bas de cette fenêtre, la zone dans laquelle vous pouvez définir le logiciel de lecture de fichiers audio par défaut (Xmms ou autre).</p> + <div class="img_c"><img src="images/menu_pref.png" alt="image menu Paramètres"/></div> + +<!-- Barre de boutons --> + <h3><a name="ch_2_2" id="ch_2_2">2.2 - Barre de boutons.</a></h3> + <div class="img_c"> + <img src="images/fen_boutons.png" alt="image barre de boutons"/> + </div> + <p>La barre de boutons, présentée ci-dessus, incorpore 14 boutons de fonctions :</p> + <ul class="liste1"> + <li>bouton 1 : déplacement au premier fichier de la liste de la fenêtre «Sélecteur»,</li> + <li>bouton 2 : déplacement au fichier précédent de la liste de la fenêtre «Sélecteur»,</li> + <li>bouton 3 : déplacement au fichier suivant de la liste de la fenêtre «Sélecteur»,</li> + <li>bouton 4 : déplacement au dernier fichier de la liste de la fenêtre «Sélecteur»,</li> + <li>bouton 5 : lancement de la fenêtre «Scanner» (voir le <a href="#ch_2_1_3">paragraphe 2.1.3</a> pour plus de détails),</li> + <li>bouton 6 : effacer le tag du(des) fichier(s) sélectionné(s),</li> + <li>bouton 7 : annuler les modifications du(des) fichier(s) sélectionné(s),</li> + <li>bouton 8 : refaire les modifications du(des) fichier(s) sélectionné(s),</li> + <li>bouton 9 : lancer la sauvegarde du(des) fichier(s) sélectionné(s),</li> + <li>bouton 10 : bascule entre le mode arborescence répertoires et le mode arborescence artistes/albums (voir le <a href="#ch_2_3">paragraphe 2.3</a> pour plus de détails),</li> + <li>bouton 11 : sélectionner tous les fichiers de la liste,</li> + <li>bouton 12 : inverser la sélection des fichiers de la liste,</li> + <li>bouton 13 : arrêt de l'action en cours,</li> + <li>bouton 14 : quitter EasyTAG.</li> + </ul> + +<!-- Fenêtre Sélecteur --> + <h3><a name="ch_2_3" id="ch_2_3">2.3 - Fenêtre «Sélecteur».</a></h3> + <p>La fenêtre «Sélecteur» permet de choisir rapidement le répertoire de travail et les fichiers audio dont vous souhaitez éditer/modifier les tags. EasyTAG dispose, pour cela, de deux modes de visualisation du contenu d'un répertoire : mode arborescence des répertoires ou mode arborescence artistes/albums. Le basculement entre ces deux modes peut se faire en cliquant sur le bouton <img src="images/bouton_arbo.png" alt="bouton tête+disque"/> de la barre de boutons (voir le <a href="#ch_2_2">paragraphe 2.2</a>).</p> + <p>Cette fenêtre est divisée en trois zones (zones 1, 2, 3 : voir les figures suivantes). Nous allons maintenant discuter les deux formes que peut prendre cette fenêtre suivant le mode de visualisation choisi.</p> + + <h4><a name="ch_2_3_1" id="ch_2_3_1">2.3.1 - Mode arborescence des répertoires.</a></h4> + <ul class="liste1"> + <li> + <img class="droite"src="images/fen_sel1.png" alt="image mode arborescence des répertoires"/> + zone 1 : Cette zone permet d'afficher initialement le répertoire de travail par défaut puis, tout au long de l'édition des fichiers, le répertoire de travail courant. Elle permet aussi de spécifier directement un certain répertoire de travail, soit en : + <ul class="liste2"> + <li>entrant manuellement le chemin de ce répertoire,</li> + <li>choisissant un répertoire dans la liste déroulante des anciens répertoires déjà consultés.</li> + </ul> + </li> + <li>zone 2 : La zone 2 présente l'arborescence des différents répertoires du support de stockage. Il est alors possible de naviguer dans cette arborescence pour sélectionner très rapidement un répertoire particulier.</li> + <li>zone 3 : La zone 3 affiche alors la liste de l'ensemble des fichiers audio contenus dans ce répertoire et ses sous répertoires (option de l'onglet «Préférences» du menu «Divers») et dont l'extension est reconnue par le programme. <br/>Le nombre de fichiers de cette liste peut être relativement important. De ce fait, pour s'y retrouver, une alternance de couleur (blanc/bleu) permet de distinguer les fichiers appartenant à des répertoires différents.</li> + </ul> + + <hr class="fin_img"/> + <h4><a name="ch_2_3_2" id="ch_2_3_2">2.3.2 - Mode arborescence artistes/albums.</a></h4> + <p>Ce mode de visualisation est totalement complémentaire du précédent.</p> + <div><img class="droite"src="images/fen_sel2.png" alt="image mode arborescence artistes-albums"/></div> + <ul class="liste1"> + <li>zone 1 : Cette zone, identique à celle du mode précédent, permet d'afficher/spécifier le répertoire de travail.</li> + <li>zone 2 : La zone 2 présente le contenu du répertoire sélectionné sous la forme d'une arborescence de type artistes/albums. <br/>Les artistes correspondant aux fichiers du répertoire courant sont listés dans la partie haute de cette zone. <br/>Pour l'artiste sélectionné, les différents albums correspondant aux fichiers présents dans le répertoire courant sont listés dans la partie basse de cette zone.</li> + <li>zone 3 : La zone 3 affiche les différents fichiers audio de l'artiste et de l'album sélectionné.<br/>Nous voyons que ce nombre de fichiers est, par nature, limité.</li> + </ul> + <hr class="fin_img"/> + <div><img class="droite"src="images/fen_sel3.png" alt="image modification fichiers"/></div> + <p>Dans la zone 3 de chacun de ces deux modes, les fichiers ayant subi des modifications soit de nom de fichier soit de tag et qui, par conséquent, doivent être sauvegardés sont clairement identifiables car ils apparaissent en rouge dans la liste des fichiers affichés (voir figure ci-contre pour le mode arborescence de répertoires). <br /> Astuce : double-cliquez sur un fichier pour sélectionner tous les fichiers d'un même dossier. Triple-cliquez pour sélectionner tous les fichiers de la liste.</p> + <hr class="fin_img"/> + +<!-- Fenêtre Fichier --> + <h3><a name="ch_2_4" id="ch_2_4">2.4 - Fenêtre «Fichier».</a></h3> + <p>La fenêtre «Fichier» est présentée, ci-contre, pour deux types de fichiers audio (Ogg et mp3).</p> + <p>En plus, d'une zone de saisie/affichage du nom de fichier, cette fenêtre montre certaines caractéristiques du fichier et certaines informations de base contenues dans l'en-tête du fichier audio comme :</p> + <div><img class="droite" src="images/fen_fich.png" alt="image fenêtre Fichier"/></div> + <ul class="liste1"> + <li>le type d'encodage (par exemple MPEG1, layer III),</li> + <li>le débit,</li> + <li>la fréquence d'échantillonnage du fichier audio,</li> + <li>la taille en Mo du fichier audio,</li> + <li>la durée du morceau correspondant exprimée en (heure:minutes:secondes).</li> + </ul> + <p>De plus, dans cette fenêtre, sont indiquées entre parenthèses :</p> + <ul class="liste1"> + <li>la taille totale en Mo/Go de l'ensemble des fichiers du répertoire sélectionné,</li> + <li>la durée totale des morceaux présents dans le répertoire, exprimée en (heure:minutes:secondes).</li> + </ul> + <hr class="fin_img"/> + +<!-- Fenêtre Tag --> + <h3><a name="ch_2_5" id="ch_2_5">2.5 - Fenêtre «Tag».</a></h3> + <p>La fenêtre Tag sert à afficher l'ensemble des différents champs d'information du tag du fichier sélectionné. Elle se caractérise par la présence de deux onglets, onglet «Général» et onglet «Images» :</p> + + <ul class="liste1"> + <li><img class="droite" src="images/fen_tag_gen.png" alt="image fenêtre Tag"/> + <span class="entree">Onglet «Général»</span> : Cet onglet est présenté ci-contre pour un fichier audio de type mp3 (tag ID3) mais sa structure est la même quelque soit le type de fichier (tag ID3, tag Ogg Vorbis, tag Flac Vorbis …).<br/>Les différents champs d'information du tag sont presque tous clairement identifiables. + <ul class="liste2"> + <li>La zone de saisie (#) située à droite de la zone "Album" correspond au champ "numéro de disque".</li> + <li>La zone de saisie située à droite du / correspond au champ "nombre total de pistes".</li> + </ul> + <br/>Dans cette fenêtre, on remarque la présence de deux types de boutons : + <ul class="liste2"> + <li>Le bouton <img src="images/fen_tag_bout1.png" alt="bouton"/> situé à droite de tous les champs d'information sert à généraliser la modification du champ à tous les fichiers sélectionnés dans la fenêtre "Sélecteur" (voir le <a href="USERS-GUIDE-11_fr4.html#ch_4_1">paragraphe 4.1</a> pour plus de détails).<br/><br/></li> + <li>Les boutons <img src="images/fen_tag_bout2.png"alt="bouton"/> servent à modifier manuellement les champs "numéro de piste" et "nombre total de pistes". Leur utilisation est décrite au <a href="USERS-GUIDE-11_fr4.html#ch_4_1">paragraphe 4.1</a>.</li> + </ul> + <hr class="fin_img"/> + </li> + <li><img class="droite" src="images/fen_tag_img.png" alt="image fenêtre Tag Images"/> + <span class="entree">Onglet «Images»</span> : L'utilisation de cet onglet est spécifique au fichier Mp3 et au fichier Flac (option à activer dans l'onglet «Paramètres des tags ID3» du menu «Préférences»). En effet, dans le tag ID3, il est possible d'incorporer des images. Pour d'autres tags (Ogg Vorbis par exemple), cet onglet est présent mais n'est pas fonctionnel.<br/>La manière de procéder pour incorporer des images au tag est décrite au <a href="USERS-GUIDE-11_fr4.html#ch_4_1">paragraphe 4.1</a>. + <hr class="fin_img"/> + </li> + </ul> + +<!-- Menus contextuels --> + <h3><a name="ch_2_6" id="ch_2_6">2.6 - Menus contextuels.</a></h3> + <p>Dans EasyTAG, on dispose de trois menus contextuels : menus accessibles en cliquant sur le bouton droit de la souris.</p> + + <div><img class="droite" src="images/menu_context1.png" alt="image menu contectuel"/></div> + <p>Le premier menu, présenté ci-contre, est accessible lorsque le pointeur de souris est situé dans la zone 2 de la fenêtre «Sélecteur» (voir le <a href="#ch_2_3">paragraphe 2.3</a>). Ce menu regroupe les différentes fonctions de manipulation des répertoires et est quasiment identique au menu «Sélecteur» (voir le <a href="#ch_2_1_2">paragraphe 2.1.2</a>). Dans cette liste, deux entrées doivent être commentées :</p> + <ul class="liste1"> + <li><span class="entree">Lancer Lecteur Audio</span> : Lancement du lecteur audio spécifié par défaut. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + <li><span class="entree">Parcourir le Répertoire avec …</span> : Cette entrée permet la mise en oeuvre d'une application externe (par exemple, lecteur de fichiers audio Xmms) sur un répertoire particulier. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + </ul> + <hr class="fin_img"/> + + <div><img class="droite" src="images/menu_context2.png" alt="image menu contectuel"/></div> + <p>Le deuxième menu, présenté ci-contre, est accessible lorsque le pointeur de souris est situé dans la zone 3 de la fenêtre «Sélecteur» (voir le <a href="#ch_2_3">paragraphe 2.3</a>). Ce menu regroupe les différentes fonctions de traitement des fichiers et reprend un certain nombre d'entrées du menu «Fichier» (voir le <a href="#ch_2_1_1">paragraphe 2.1.1</a>) et certaines entrées du menu «Divers» (voir le <a href="#ch_2_1_4">paragraphe 2.1.4</a>). Dans cette liste, deux entrées doivent être commentées :</p> + <ul class="liste1"> + <li><span class="entree">Lancer Lecteur Audio</span> : Lancement du lecteur audio spécifié par défaut. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + <li><span class="entree">Ouvrir le(s) Fichier(s) avec …</span> : Cette entrée permet la mise en oeuvre d'une application externe (par exemple, lecteur de fichiers audio Xmms) sur une sélection de fichiers. Voir le <a href="USERS-GUIDE-11_fr6.html#ch_6_2">paragraphe 6.2</a> pour plus de détails.</li> + </ul> + <hr class="fin_img"/> + + <div><img class="droite" src="images/menu_context3.png" alt="image menu contectuel"/></div> + <p>Le troisième menu, présenté ci-contre, est accessible lorsque le pointeur de souris est situé dans la zone de saisie de la fenêtre «Fichier» ou dans les zones de saisie de la fenêtre «Tag». Les différentes entrées sont identiques à celles du sous-menu «Traiter les champs» du menu «Scanner» (voir <a href="USERS-GUIDE-11_fr3.html#ch_3_4">paragraphe 3.4</a>). Les différentes entrées permettent de réaliser des modifications sur le nom et sur les champs d'information des fichiers telles que :</p> + <ul class="liste1"> + <li>conversion minuscules/majuscules.</li> + <li>remplacement d'un caractère par un autre …</li> + </ul> + <hr class="fin_img"/> + +<!-- FIN DESCRIPTION DE L'INTERFACE =========================================================--> + + <p class="img_c"><br/><a href="#haut_page">- RETOUR A LA TABLE DES MATIERES -</a></p> +</body> +</html> + diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr3.html b/doc/users_guide_french/USERS-GUIDE-11_fr3.html new file mode 100755 index 0000000..929d8b3 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr3.html @@ -0,0 +1,94 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr3.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 3 - Recherche rapide dans votre collection de fichiers audio. * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> + +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG - chapitre 3 - Recherche rapide dans votre collection de fichiers audio.</title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> + +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 3 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="USERS-GUIDE-11_fr1.html">1 - Introduction.</a></li> + <li><a href="USERS-GUIDE-11_fr2.html">2 - Description de l'interface.</a></li> + <li> + <a href="#ch_3">3 - Recherche rapide dans votre collection de fichiers audio.</a> + <ul class="TM2"> + <li><a href="#ch_3_1">3.1 - Classement par critère de la liste des fichiers.</a></li> + <li><a href="#ch_3_2">3.2 - Recherche manuelle par mot clé.</a></li> + </ul> + </li> + <li><a href="USERS-GUIDE-11_fr4.html">4 - Editer/corriger les tags.</a></li> + <li><a href="USERS-GUIDE-11_fr5.html">5 - Renommer les fichiers/les répertoires.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html">6 - Autres fonctions.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- RECHERCHE RAPIDE DANS UNE COLLECTION DE FICHIERS AUDIO =================================--> + + <h2><a name="ch_3" id="ch_3">3 - Recherche rapide dans votre collection de fichiers audio.</a></h2> + <p>Une collection de fichiers audio peut contenir un grand nombre de fichiers. L'étape avant tout traitement consiste alors à identifier rapidement les fichiers audio que l'on veut éditer/modifier. Pour cela, EasyTAG dispose de plusieurs outils que nous allons discuter dans ce chapitre.</p> + +<!-- Menus contextuels --> + <h3><a name="ch_3_1" id="ch_3_1">3.1 - Classement par critère de la liste des fichiers.</a></h3> + <p>EasyTAG permet de classer la liste des fichiers audio présents dans un répertoire particulier suivant certains critères :</p> + <ul class="liste1"> + <li><img class="droite" src="images/sousmenu_fic1.png" alt="image classement par champs d'information"/> + <span class="entree">Champs d'information du tag du fichier</span> : Le classement peut être réalisé par ordre croissant/décroissant de piste, de titre, d'artiste, d'album, d'année, de genre, de commentaire, de compositeur, d'artiste original, de copyright, d'URL ou de nom d'encodeur, + <hr class="fin_img"/> + </li> + <li><img class="droite" src="images/sousmenu_fic2.png"alt="image classement par caractéristiques fichier"/> + <span class="entree">Caractéristiques du fichier lui-même</span> : Le classement peut être réalisé par ordre croissant/décroissant de nom de fichier, de date de création, de type de fichier, de taille de fichier, de durée, de débit ou de fréquence. + <hr class="fin_img"/> + </li> + </ul> + <p>Ces deux fonctions <span class="entree">Classer liste par tag</span> et <span class="entree">Classer liste par propriétés</span> sont accessibles depuis le menu «Fichier» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1">paragraphe 2.1</a>) ou depuis un menu contextuel (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <p>L'intérêt de ces différents classements est de modifier, en fonction de vos besoins, l'exploration de votre collection de fichiers audio. Par exemple :</p> + <ul class="liste1"> + <li>Pour trouver rapidement les morceaux les plus récents, il suffit de classer la liste par ordre décroissant des années. Les fichiers correspondant aux morceaux les plus récents s'afficheront alors tout en haut de la liste.</li> + <li>Pour identifier facilement les fichiers dont le champ année n'est pas renseigné, il suffit de classer la liste par ordre croissant des années. En effet, ces fichiers apparaîtront alors en premier dans la liste.</li> + <li>Pour différencier les fichiers mp3, ogg ou encore flac, il suffit d'effectuer un classement de la liste par type de fichiers.</li> + </ul> + <p class="sans-retrait">De nombreuses autres utilisations de ces classements sont possibles. A vous de choisir le type de classement qui correspond le mieux à votre besoin.</p> + +<!-- Menus contextuels --> + <h3><a name="ch_3_2" id="ch_3_2">3.2 - Recherche manuelle par mot clé.</a></h3> + <p>Dans EasyTAG, vous pouvez aussi effectuer une recherche par mot clé sur la liste des fichiers audio présents dans un répertoire particulier. La fenêtre de recherche par mot clé est accessible en cliquant sur l'entrée <span class="entree">Rechercher le(s) fichier(s) …</span> du menu «Divers» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1">paragraphe 2.1</a>) ou du menu contextuel consacré au traitement des fichiers (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <p>La fenêtre «Rechercher un fichier» de base est présentée sur la figure suivante. On voit qu'elle permet d'afficher en une fois toutes les informations pertinentes des fichiers : le nom de fichier et quasiment la totalité des champs d'information du tag (titre, artiste, album, numéro de disque, année, piste, genre, commentaire, compositeur, artiste original, copyright, URL, nom d'encodeur).</p> + <div class="img_c"><img src="images/menu_recherche.png" alt="image fenêtre -Rechercher un fichier-"/></div> + <p>Cette recherche peut être utilisée de la manière suivante :</p> + <ul class="liste1"> + <li><span class="entree">Visualisation globale</span> : Il est possible de visualiser en une fois le nom et l'ensemble des champs d'information du tag de tous les fichiers présents dans un répertoire (voir figure suivante). Pour cela, il suffit de lancer la recherche en laissant le champ "Rechercher" vide.<br/>Si le nombre de fichiers trouvés n'est pas trop important, vous pouvez, par défilement, visualiser l'ensemble de ces fichiers et sélectionner ceux sur lesquels effectuer un traitement ultérieur. De plus, dans cette liste, vous pouvez facilement identifier tous les fichiers dont un champ d'information particulier du tag (par exemple, champ année) n'est pas renseigné (cellule vide). + <div class="img_c"><img src="images/menu_recherche2.png" alt="image fenêtre -Rechercher un fichier- visualisation globale"/></div> + </li> + <li><span class="entree">Visualisation partielle</span> : Si le nombre de fichiers présents dans le répertoire est important, il peut être utile de limiter l'affichage aux fichiers répondant à certains critères (par exemple, recherche d'un artiste particulier). Pour cela, il suffit de lancer la recherche en entrant un mot clé dans la zone de saisie ou bien encore en choisissant ce mot clé dans la liste déroulante des mots clé déja utilisés. Un exemple de cette recherche est présenté sur la figure suivante.<br/> + Pour faciliter la sélection des fichiers, tous les champs d'information qui contiennent la chaîne de caractères recherchée sont affichés en rouge. + <div class="img_c"><img src="images/menu_recherche1.png" alt="image fenêtre -Rechercher un fichier- visualisation partielle"/></div> + </li> + </ul> + +<!-- FIN RECHERCHE RAPIDE DANS UNE COLLECTION DE FICHIERS AUDIO =============================--> + + <p class="img_c"><br/><a href="#haut_page">- RETOUR A LA TABLE DES MATIERES -</a></p> +</body> +</html> + diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr4.html b/doc/users_guide_french/USERS-GUIDE-11_fr4.html new file mode 100755 index 0000000..8b7298c --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr4.html @@ -0,0 +1,205 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr4.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 4 - Editer/corriger les tags. * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> + +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG - chapitre 4 - Editer/corriger les tags.</title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> + +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 4 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="USERS-GUIDE-11_fr1.html">1 - Introduction.</a></li> + <li><a href="USERS-GUIDE-11_fr2.html">2 - Description de l'interface.</a></li> + <li><a href="USERS-GUIDE-11_fr3.html">3 - Recherche rapide dans votre collection de fichiers audio.</a></li> + <li><a href="#ch_4">4 - Editer/corriger les tags.</a> + <ul class="TM2"> + <li> + <a href="#ch_4_1">4.1 - Mode manuel.</a> + <ul class="TM3"> + <li><a href="#ch_4_1_1">4.1.1 - Travail sur un fichier.</a></li> + <li><a href="#ch_4_1_2">4.1.2 - Travail sur un ensemble de fichiers.</a></li> + </ul> + </li> + <li><a href="#ch_4_2">4.2 - Mode automatique via le scanner "Compléter le(s) Tag(s)".</a></li> + <li> + <a href="#ch_4_3">4.3 - Mode automatique via la base de données CDDB.</a> + <ul class="TM3"> + <li><a href="#ch_4_3_1">4.3.1 - Recherche automatique.</a></li> + <li><a href="#ch_4_3_2">4.3.2 - Recherche manuelle.</a></li> + </ul> + </li> + <li><a href="#ch_4_4">4.4 - Correction des champs d'information du tag via le scanner "Traiter les Champs".</a></li> + </ul> + </li> + <li><a href="USERS-GUIDE-11_fr5.html">5 - Renommer les fichiers/les répertoires.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html">6 - Autres fonctions.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- EDITER/CORRIGER LES TAGS =============================================================--> + + <h2><a name="ch_4" id="ch_4">4 - Editer/corriger les tags.</a></h2> + <p>EasyTAG offre trois modes différents pour modifier les champs d'information du tag de vos fichiers : un mode manuel, un mode automatique via un scanner et un mode automatique via la recherche dans une base de données CDDB. Dans la suite de ce chapitre, nous allons décrire la mise en oeuvre de chacun d'entre eux.</p> + <p>Avant toute chose, il est bon de noter que le traitement du tag des fichiers sera grandement facilité si ces fichiers sont regroupés par album plutôt que d'être tous stockés dans un même répertoire.</p> + <p>De plus, il est important de garder à l'esprit que chaque traitement ne s'applique que sur les fichiers sélectionnés dans la liste de la fenêtre «Sélecteur». De même, la procédure de sauvegarde ne s'applique aussi que sur ces fichiers.</p> + +<!-- Mode manuel --> + <h3><a name="ch_4_1" id="ch_4_1">4.1 - Mode manuel.</a></h3> + <p>Ce mode est utile lorsque vous n'avez à renseigner/modifier les champs d'information du tag que d'un nombre limité de fichiers.<br/>Si vous voulez traiter l'ensemble des fichiers d'un même album, il peut être préférable, dans un premier temps, d'utiliser le mode de modification via la base de données CDDB (voir <a href="#ch_4_3">paragraphe 4.3</a>).<br/>De même, si les noms des fichiers ou le répertoire de ces fichiers contiennent un certain nombre d'informations pertinentes (artiste, album, année …), il peut être judicieux d'utiliser le mode de modification automatique via le scanner «Compléter le(s) Tag(s)» (voir <a href="#ch_4_2">paragraphe 4.2</a>).</p> + <p>Dans le mode manuel, il est possible de travailler sur un fichier ou de travailler simultanément sur un ensemble de fichiers.</p> + <h4><a name="ch_4_1_1" id="ch_4_1_1">4.1.1 - Travail sur un fichier.</a></h4> + + <div><img class="droite" src="images/fen_tag_gen.png" alt="image Tag ID3 - onglet général"/></div> + <p>Pour renseigner un champ d'information du tag du fichier, il suffit alors de taper la valeur souhaitée dans la zone de saisie correspondante (voir figure ci-contre). Concernant certains champs, les points suivants doivent être notés :</p> + <ul class="liste1"> + <li><span class="entree">Numéro de piste</span> : Le numéro de piste peut être saisi ou être choisi dans une liste déroulante (01 à 30).</li> + <li><span class="entree">Genre</span> : Le genre peut être choisi dans une liste prédéfinie (liste des genres ID3, de "Acid" à "Tribal") ou bien correspondre à une valeur qui vous est personnelle ("Chanson française", par exemple).</li> + <li><span class="entree">Année</span> : La saisie de la valeur de ce champ a été simplifiée au maximum. En effet, seule la saisie des deux derniers digits (dizaines et unités) de l'année est nécessaire. EasyTAG complete alors intelligemment les digits manquants (millénaires et siècles). Ainsi, la saisie "04" sera complétée en "2004" et la saisie "94" sera complétée en "1994".</li> + </ul> + <hr class="fin_img"/> + + <div><img class="droite" src="images/fen_tag_img.png" alt="image Tag ID3 - onglet images"/></div> + <p>Par ailleurs, pour les fichiers Mp3 et pour les fichiers Flac , il est possible d'incorporer au tag un certain nombre d'images (jpg ou png). Pour cela, on peut procéder de deux manières :</p> + <ul class="liste1"> + <li>Utiliser une procédure de type "Glisser/Déposer" dans la zone Images,</li> + <li>Cliquer sur le bouton <img src="images/bouton_img1.png" alt="bouton"/> et sélectionner dans l'arborescence l'image souhaitée.</li> + </ul> + <p>Le bouton <img src="images/bouton_img3.png"alt="bouton"/> permet soit d'effacer toutes les images (comportement par défaut) soit de limiter cet effacement aux seules images sélectionnées.</p> + <p>Une fois le choix d'images effectué, il est possible de compléter l'information du champ «Images» en affectant à chaque image un type particulier (couverture "face avant", dépliant intérieur, artiste, …). Pour cela, il suffit de cliquer sur le bouton <img src="images/bouton_img2.png" alt="bouton"/> et d'effectuer un choix parmi la liste des types proposés.</p> + <hr class="fin_img"/> + + <h4><a name="ch_4_1_2" id="ch_4_1_2">4.1.2 - Travail sur un ensemble de fichiers.</a></h4> + <div><img class="droite" src="images/fen_tag_gen.png" alt="image Tag ID3 - onglet général"/></div> + <p>Bien évidemment, lorsque vous travaillez sur l'ensemble des fichiers d'un album particulier, certains paramètres comme le nom de l'album, l'année et le genre sont communs à tous ces fichiers.<br/>De plus, on peut vouloir renseigner un ensemble de fichiers avec un paramètre particulier (fichiers de même genre, par exemple).</p> + <p>Dans ce cas, il est possible d'utiliser le bouton <img src="images/fen_tag_bout1.png" alt="bouton"/> situé à droite de chaque champ. En effet, pour un champ d'information du tag donné (année par exemple), cliquer sur ce bouton revient à affecter la même valeur du champ à l'ensemble des tags des fichiers sélectionnés.</p> + <p>Par ailleurs, si les fichiers présents dans un répertoire correspondent à l'ensemble des fichiers d'un album, la numérotation des différentes pistes au format "numéro de piste/nombre total de pistes" peut se faire rapidement en utilisant le bouton <img src="images/fen_tag_bout2.png" alt="bouton"/> situé à gauche du champ «numéro de piste» et le bouton <img src="images/fen_tag_bout2.png" alt="bouton"/> situé à gauche du champ «nombre total de pistes».<br/>Le premier bouton permet d'affecter au champ "numéro de piste" une valeur correspondant à la position du fichier dans la liste des fichiers présents dans le répertoire (l'ordre des fichiers est donc essentiel).<br/>Le deuxième bouton permet d'affecter au champ "nombre de pistes" une valeur correspondant au nombre de fichiers présents dans le répertoire.</p> + + <p>Enfin, dans le mode manuel, l'utilisation de certaines touches permettent de traiter les champs de façon plus efficace :</p> + <ul class="liste1"> + <li>La touche Entrée permet de se déplacer rapidement d'un champ à l'autre.</li> + <li>La touche Tab permet, pour un champ particulier, d'activer directement le petit bouton rond situé à droite de celui-ci (valeur du champ donnée à l'ensemble des fichiers sélectionnés).</li> + <li>Les touches PageUp et PageDown permettent respectivement de passer au fichier précédent ou au fichier suivant de la liste.</li> + </ul> + <hr class="fin_img"/> + +<!-- Mode automatique via le scanner "Compléter le(s) Tag(s)" --> + <h3><a name="ch_4_2" id="ch_4_2">4.2 - Mode automatique via le scanner "Compléter le(s) Tag(s)".</a></h3> + <p>Si les noms des fichiers ou le répertoire de ces fichiers contiennent un certain nombre d'informations pertinentes (artiste, album, année, titre, …), il est possible d'effectuer la modification automatique de certains champs d'information des tags via le scanner «Compléter le(s) Tag(s)». Pour cela, EasyTAG se base sur un modèle de masque qui permet d'extraire les différentes informations contenues dans le nom du fichier et/ou du répertoire et de renseigner alors les différents champs d'information du tag correspondants.<br/>Ce scanner est accessible depuis le menu «Fichier» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_1">paragraphe 2.1.1</a>), le menu «Scanner» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_3">paragraphe 2.1.3</a>) ou depuis un menu contextuel (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <p>La fenêtre «Scanner de Tag et de Nom de Fichier» est présentée sur la figure ci-contre. Sur cette figure, apparaissent les boutons de contôle suivants :</p> + <div><img class="droite" src="images/fen_scan1.png" alt="image fenêtre -Compléter le(s) Tag(s)-"/></div> + <ul class="liste1"> + <li>bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> : Après la saisie d'un masque, cliquer sur ce bouton lance le traitement automatique des champs d'information du tag de l'ensemble des fichiers audio sélectionnés.</li> + <li>bouton <img src="images/bouton_scan3.png" alt="bouton point d'interrogation"/> : Ouvre/Ferme la fenêtre «Légende» (voir figure ci-contre) qui rappelle la correspondance entre code du masque et champ d'information du tag.</li> + <li>bouton <img src="images/bouton_scan2.png" alt="bouton masque"/> : Ouvre/Ferme la fenêtre «Editeur de Masque» (voir figure ci-contre) qui permet de choisir ou de créer le masque adapté à votre besoin. Elle permet, bien sûr, de sauvegarder ce nouveau masque pour tout traitement ultérieur du même type.</li> + </ul> + <p>La réussite de ce traitement est totalement conditionnée au choix du masque adapté aux données (nom du fichier et/ou nom du répertoire). Dans EasyTAG, de base, vous disposez d'une importante liste de modèles de masque (voir figure ci-contre). On voit qu'un masque est construit à partir d'un certain nombre de codes (%a, %b, %t, …) dont la signification est précisée dans la fenêtre «Légende».<br/>Pour vous guider dans le choix du masque, EasyTAG affiche immédiatement, en dessous de la zone de saisie du masque de la fenêtre «Compléter Tag», les informations extraites du nom du fichier et/ou du nom du répertoire.</p> + <hr class="fin_img"/> + + <p>Vous pouvez aussi créer votre propre modèle de masque pour correspondre au mieux au format du nom de vos fichiers audio et/ou du nom du répertoire les contenant. Pour mieux comprendre comment utiliser les codes, prenons deux exemples.</p> + <div class="droite"> + <table> + <tr><th>Code</th><th>Champ du tag</th><th>Valeur extraite</th></tr> + <tr><td>%a</td><td>Artiste </td><td>Luke </td></tr> + <tr><td>%y</td><td> Année </td><td>2004 </td></tr> + <tr><td>%b</td><td> Album </td><td>La tête en arrière </td></tr> + <tr><td>%n</td><td> Piste </td><td>01 </td></tr> + <tr><td>%t</td><td> Titre </td><td>Comme un homme </td></tr> + </table> + </div> + <p>Si le fichier dont on veut renseigner le tag et le masque choisi sont les suivants :</p> + <ul class="liste1"> + <li><span class="entree">fichier</span> : <span class="entree">01 - Comme un homme.ogg</span> situé dans le répertoire <span class="entree">/media/musiques/Luke/2004 - La tête en arrière/</span>.</li> + <li><span class="entree">masque</span> : "<span class="entree">%a/%y - %b/%n - %t</span>".</li> + </ul> + <p class="sans-retrait">Les informations extraites alors par l'application de ce masque sont données dans le tableau ci-contre.</p> + <hr class="fin_img"/> + + <p>Dans la liste des codes de la fenêtre «Légende», on voit qu'il existe un code "%i" qui ne correspond à aucun champ d'information du tag. Ce code permet d'extraire une information et de ne pas l'affecter à un champ particulier.</p> + <div class="droite"> + <table> + <tr><th>Code</th><th>Champ du tag</th><th>Valeur extraite</th></tr> + <tr><td>%a</td><td>Artiste </td><td>Luke </td></tr> + <tr><td>%i</td><td>Aucun </td><td>disc </td></tr> + <tr><td>%b</td><td>Album </td><td>La tête en arrière </td></tr> + <tr><td>%y</td><td>Année </td><td>2004 </td></tr> + <tr><td>%n</td><td>Piste </td><td>01 </td></tr> + <tr><td>%t</td><td>Titre </td><td>Comme un homme </td></tr> + </table> + </div> + + <p>Si le fichier dont on veut renseigner le tag et le masque choisi sont les suivants :</p> + <ul class="liste1"> + <li><span class="entree">fichier</span> : <span class="entree">01 - Comme un homme.ogg</span> situé dans le répertoire <span class="entree">/media/musiques/Luke/disc - La tête en arrière(2004)/</span>.</li> + <li><span class="entree">masque</span> : "<span class="entree">%a/%i - %b(%y)/%n - %t</span>".</li> + </ul> + <p class="sans-retrait">Les informations extraites alors par l'application de ce masque sont données dans le tableau ci-contre.</p> + <hr class="fin_img"/> + + <p>Une fois le choix du masque effectué, cliquer sur le bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> permet de lancer alors le traitement automatique sur l'ensemble des fichiers selectionnés. Si les champs d'information du tag des fichiers sont déjà partiellement renseignés, vous pouvez remplacer toutes les anciennes valeurs des champs par les nouvelles valeurs extraites à la condition d'avoir coché la case <span class="entree">Ecraser les champs lors d'un Scan du tag</span> de l'onglet «Scanner» du menu «Préférences».</p> + +<!-- Mode automatique via la base de données CDDB --> + <h3><a name="ch_4_3" id="ch_4_3">4.3 - Mode automatique via la base de données CDDB.</a></h3> + <p>Si les fichiers sélectionnés constituent l'ensemble des fichiers d'un même album, il est alors possible d'utiliser le mode de traitement automatique via la base de données CDDB. En effet, sur internet, cette base de données répertorie les différentes informations d'un très grand nombre d'albums CD publiés. Il suffit alors de retouver l'album correspondant à vos fichiers pour pouvoir renseigner automatiquement l'ensemble des champs d'information du tag de ces fichiers. Deux modes d'interrogation de la base de données sont disponibles (un mode automatique et un mode manuel). Une bonne stratégie est d'utiliser, dans un premier temps, le mode automatique. Si ce dernier s'avère incapable d'identifier correctement l'album, vous pouvez vous rabattre sur le mode manuel et utiliser alors des mots clé pour guider la recherche.</p> + + <h4><a name="ch_4_3_1" id="ch_4_3_1">4.3.1 - Recherche automatique.</a></h4> + <p>La recherche se fait par l'envoi à la base de données CDDB d'un paramètre nommé CddbID identifiant normalement le CD audio. Ce paramètre est calculé par EasyTAG à partir des caractéristiques des différentes plages du CD audio (durée totale du CD, nombre de plages, durée de chaque plage). De ce fait, il est nécessaire de sélectionner tous les fichiers de l'album (et seulement ceux-ci) et il est aussi nécessaire que ces derniers soient classés exactement comme dans le CD d'origine.</p> + <p>Une fois cette sélection effectuée, vous pouvez lancer l'interrogation de la base de données. La fenêtre correspondant au mode automatique est présentée sur la figure ci-contre. Pour lancer l'interrogation, cliquez sur le bouton «Rechercher».</p> + <div class="img_c"><img src="images/fen_cddb1.png" alt="image fenêtre Recherche automatique"/></div> + <p>La liste des différents albums possibles trouvés dans la base de données (le cddbid n'étant pas unique) apparait alors dans la fenêtre «Résultats». Sélectionnez une des lignes de cette liste pour visualiser à droite les différentes pistes de cet album. Les albums déja consultés sont affichés en rouge.</p> + <p>Une fois le bon album identifié, vous pouvez alors renseigner les champs d'information du tag des fichiers de cet album. Pour cela, il faut dans un premier temps, choisir quels champs mettre à jour. Il est possible de mettre à jour tous les champs ou seulement quelques uns choisis dans la liste (nom de fichier, titre, artiste …). Puis, dans un deuxième temps, cliquer sur le bouton «Appliquer» lance le traitement. Si aucune piste de la fenêtre «Résultats» n'est sélectionnée, les champs d'information de l'ensemble des pistes seront modifiés. Par contre, si une piste particulière est sélectionnée, seuls les champs d'information du tag de cette piste seront mis à jour.</p> + + <h4><a name="ch_4_3_2" id="ch_4_3_2">4.3.2 - Recherche manuelle.</a></h4> + <p>Si aucun album n'a pu être identifié par la recherche automatique (fichiers audio du CD imcomplets …), vous pouvez toujours essayer une recherche manuelle en utilisant des mots clé (ces mots doivent être présents dans le nom de l'artiste, le nom de l'album ou bien encore dans le nom de la piste). La fenêtre correspondant à ce mode est présentée sur la figure suivante.</p> + <div class="img_c"><img src="images/fen_cddb2.png" alt="image fenêtre Recherche manuelle"/></div> + <p>Pour effectuer la recherche, il faut entrer les "bons" mots clé dans la zone «Mots» puis cliquer sur le bouton «Rechercher». La liste des albums trouvés s'affiche alors dans la fenêtre «Résultats ». La liste de résultats obtenue dans ce mode est identique à celle obtenue via l'outil de recherche du site freedb.org.</p> + <p>A ce stade, il faut noter que cette recherche peut s'avérer peu sélective et conduire à une liste d'albums trouvés de taille importante. Cette liste peut être réduite, soit :</p> + <ul class="liste1"> + <li>En effectuant une recherche dans la liste des résultats. Pour cela, il faut entrer un mot clé dans la zone de saisie «Rechercher» de la fenêtre «Résultats».</li> + <li>En faisant défiler la liste des albums et en pré-sélectionnant un certain nombre d'albums candidats. Ces albums sont affichés en rouge. Il suffit alors de cliquer sur le bouton <img src="images/bouton_scan6.png" alt="bouton liste rouge"/> pour ne conserver que les albums pré-sélectionnés.</li> + </ul> + <p>Dès que vous avez réussi à identifier le bon album, il suffit alors, pour renseigner les champs d'information du tag de vos fichiers, de procéder exactement comme dans le mode automatique.</p> + +<!-- Correction des tags via le scanner "Traiter les Champs" --> + <h3><a name="ch_4_4" id="ch_4_4">4.4 - Correction des champs d'information du tag via le scanner "Traiter les Champs".</a></h3> + <p>Ce scanner ne doit être utilisé que si les noms des fichiers ou les différents champs d'information du tag des fichiers ont déjà été renseignés dans un premier temps. Il permet de rapidement uniformiser toutes ces chaînes de caractères en choisissant une mise en forme particulière.<br/>Ce scanner est accessible depuis le menu «Fichier» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_1">paragraphe 2.1.1</a>), le menu «Scanner» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_3">paragraphe 2.1.3</a>) ou depuis un menu contextuel (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <div><img class="droite" src="images/fen_scan3.png" alt="image fenêtre -Traiter les Champs-"/></div> + <p>La fenêtre «Scanner de Tag et de Nom de Fichier» est présentée sur la figure ci-contre. Dans un premier temps, vous devez choisir sur quels champs effectuer le traitement. Cette sélection se fait, dans le haut de la fenêtre «Traiter Champs», en cliquant sur les différents boutons correspondant aux différents champs. Les boutons des champs sélectionnés passent alors en grisé. Pour être complet, précisons la signification des deux boutons suivants :</p> + <ul class="liste1"> + <li>bouton <img src="images/bouton_scan5.png" alt="bouton triangle"/> : Inverser la sélection des différents champs.</li> + <li>bouton <img src="images/bouton_scan4.png" alt="bouton carre"/> : Sélectionner/Désélectionner tous les champs.</li> + </ul> + <p>Une fois la sélection effectuée, il est possible de réaliser les traitements :</p> + <ul class="liste1"> + <li>Remplacement de certains caractères (par exemple, élimination des caractères %20 du nom de fichier …).</li> + <li>Modification de la casse (transformation minuscule/majuscule).</li> + <li>Suppression de certains caractères en trop.</li> + </ul> + + <p> Enfin, Cliquez sur le bouton <img src="images/bouton_scan1.png" alt="bouton porte"/>, lance les traitements de l'ensemble des différents champs des fichiers sélectionnés.</p> + <hr class="fin_img"/> + +<!-- FIN EDITER/CORRIGER LES TAGS =========================================================--> + + <p class="img_c"><br/><a href="#haut_page">- RETOUR A LA TABLE DES MATIERES -</a></p> +</body> +</html> diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr5.html b/doc/users_guide_french/USERS-GUIDE-11_fr5.html new file mode 100755 index 0000000..5b95a34 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr5.html @@ -0,0 +1,171 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr5.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 5 - Renommer les fichiers/les répertoires. * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> + +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG - chapitre 5 - Renommer les fichiers/les répertoires.</title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> + +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 5 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="USERS-GUIDE-11_fr1.html">1 - Introduction.</a></li> + <li><a href="USERS-GUIDE-11_fr2.html">2 - Description de l'interface.</a></li> + <li><a href="USERS-GUIDE-11_fr3.html">3 - Recherche rapide dans votre collection de fichiers audio.</a></li> + <li><a href="USERS-GUIDE-11_fr4.html">4 - Editer/corriger les tags.</a></li> + <li> + <a href="#ch_5">5 - Renommer les fichiers/les répertoires.</a> + <ul class="TM2"> + <li> + <a href="#ch_5_1">5.1 - Renommer les fichiers.</a> + <ul class="TM3"> + <li><a href="#ch_5_1_1">5.1.1 - Mode manuel.</a></li> + <li><a href="#ch_5_1_2">5.1.2 - Mode automatique via le scanner.</a></li> + <li><a href="#ch_5_1_3">5.1.3 - Mode automatique via la base de données CDDB.</a></li> + <li><a href="#ch_5_1_4">5.1.4 - Mode automatique via la lecture d'un fichier texte.</a></li> + </ul> + </li> + <li><a href="#ch_5_2">5.2 - Renommer les répertoires.</a></li> + <li><a href="#ch_5_3">5.3 - Renommer et déplacer les fichiers dans un répertoire.</a></li> + </ul> + </li> + <li><a href="USERS-GUIDE-11_fr6.html">6 - Autres fonctions.</a></li> + <li><a href="USERS-GUIDE-11_fr6.html#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- RENOMMER FICHIERS/REPERTOIRES =========================================================--> + + <h2><a name="ch_5" id="ch_5">5 - Renommer les fichiers/les répertoires.</a></h2> + <p>EasyTAG offre différents modes pour renommer les fichiers : un mode manuel, un mode automatique via le scanner, un mode automatique via la base de données CDDB et enfin un mode basé sur la lecture d'un fichier texte. Il offre la possibilité de renommer les répertoires contenant les fichiers audio. EasyTAG permet aussi, via le scanner, de renommer et de déplacer automatiquement les fichiers dans un nouveau répertoire. Dans la suite, nous allons décrire la mise en oeuvre de chacun d'entre eux.</p> + <h3><a name="ch_5_1" id="ch_5_1">5.1 Renommer les fichiers.</a></h3> + <h4><a name="ch_5_1_1" id="ch_5_1_1">5.1.1 - Mode manuel.</a></h4> + <p>Ce mode peut être utilisé si vous avez peu de modifications à réaliser (sinon, cela s'avérerait vite fastidieux)</p> + <div><img class="droite" src="images/fen_fich.png" alt="image fenêtre Fichier"/></div> + <p>Pour renommer manuellement un fichier, il suffit tout simplement de sélectionner ce dernier dans la liste de la fenêtre «Sélecteur» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_3">paragraphe 2.3</a>) puis de modifier son nom dans la zone de saisie de la fenêtre «Fichier» (voir figure). Toutefois, ce nouveau nom de fichier ne sera effectif qu'après avoir sauvegardé le fichier.<br/>Note : Les caractères illégaux (pour les partitions Windows : ‘/’, ’+’ …) seront automatiquement remplacés à moins que vous n'ayez décoché l'option <span class="entree">Remplacer les caractères illégaux des noms de fichiers (pour Windows et les CD-Rom)</span> de l'onglet «Paramètres du nom des fichiers» du menu «Préférences».</p> + <hr class="fin_img"/> + + <h4><a name="ch_5_1_2" id="ch_5_1_2">5.1.2 - Mode automatique via le scanner.</a></h4> + <p>EasyTAG permet de renommer automatiquement les fichiers à partir des champs d'information du tag. Ce traitement est disponible via le scanner «Renommer le(s) Fichier(s) et Répertoire(s)», accessible depuis le menu «Fichier» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_1">paragraphe 2.1.1</a>), le menu «Scanner» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_3">paragraphe 2.1.3</a>) ou depuis un menu contextuel (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <p>La fenêtre du scanner «Renommer le(s) Fichier(s) et Répertoire(s)» est présentée sur la figure ci-contre. Sur cette figure, apparaissent les boutons de contrôle suivants :</p> + <div><img class="droite" src="images/fen_scan2.png" alt="image fenêtre scanner -Renommer le(s) Fichier(s) et Répertoire(s)-"/></div> + <ul class="liste1"> + <li>bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> : Après la saisie d'un masque, cliquer sur ce bouton lance le traitement automatique des noms de fichiers et répertoire de l'ensemble des fichiers audio sélectionnés.</li> + <li>bouton <img src="images/bouton_scan3.png" alt="bouton point d'interrogation"/> : Ouvre/Ferme la fenêtre «Légende» (voir figure ci-contre) qui rappelle la correspondance entre code du masque et champ d'information du tag.</li> + <li>bouton <img src="images/bouton_scan2.png" alt="bouton masque"/> : Ouvre/Ferme la fenêtre «Editeur de Masque» (voir figure ci-contre) qui permet de choisir ou de créer le masque adapté à votre besoin. Elle permet, bien sûr, de sauvegarder ce nouveau masque pour tout traitement ultérieur du même type.</li> + <li>bouton <img src="images/bouton_scan7.png" alt="bouton répertoire +"/> : Ajoute au début du masque le chemin du répertoire courant (l'intérêt de ce bouton est discuté dans le <a href="#ch_5_3">paragraphe 5.3</a>).</li> + </ul> + <p> Le nouveau nom des fichiers étant construit sur la base d'un modèle de masque, la première étape de ce traitement consiste à bien définir ce masque.<br/>Nous voyons, sur la figure ci-contre, qu'un masque est construit à partir d'un certain nombre de codes (%a, %b, %t, …) dont la signification est précisée dans la fenêtre «Légende». Dans EasyTAG, vous disposez d'une importante liste de modèle de masque (voir fenêtre ci-contre) mais vous pouvez aussi créer et ajouter à cette liste un masque particulier grâce à la fenêtre «Editeur de masque»<br/>Pour vous guider dans le choix du masque, EasyTAG affiche immédiatement, en dessous de la zone de saisie du masque de la fenêtre «Renommer le Fichier et le Répertoire», le nouveau nom du fichier.</p> + <hr class="fin_img"/> + + <p>Pour mieux comprendre comment utiliser les masques, prenons l'exemple du fichier <span class="entree">01.La_tête_en_arrière_(2004) Comme_un_homme.mp3</span> situé dans le répertoire <span class="entree">/media/musiques/</span>. De plus, supposons que les champs d'information du tag de ce fichier sont correctement renseignés et qu'ils prennent les valeurs données dans le tableau ci-contre.</p> + <div class="droite"> + <table> + <tr><th>Code</th><th>Champ du tag</th><th>Valeur extraite</th></tr> + <tr><td>%a</td><td>Artiste </td><td>Luke </td></tr> + <tr><td>%y</td><td>Année </td><td>2004 </td></tr> + <tr><td>%b</td><td>Album </td><td>La tête en arrière </td></tr> + <tr><td>%n</td><td>Piste </td><td>01 </td></tr> + <tr><td>%t</td><td>Titre </td><td>Comme un homme </td></tr> + </table> + </div> + <p>Sans indication d'un chemin de répertoire en début de masque, le fichier est renommé et reste dans le répertoire courant. Ainsi avec le masque "<span class="entree">%n - %t</span>", le fichier :</p> + <ul class="liste1"> + <li>est renommé : <span class="entree">01 - Comme un homme.mp3</span>,</li> + <li>reste dans le répertoire : <span class="entree">/media/musiques/</span>.</li> + </ul> + <hr class="fin_img"/> + <p>Une fois le choix du masque effectué, cliquer sur le bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> permet de lancer alors le traitement automatique de modification du nom des fichiers sur l'ensemble des fichiers selectionnés. Cependant, ces changements de nom ne seront effectifs qu'après avoir sauvegardé ces fichiers.</p> + <p class="sans-retrait">Note : Si un chemin est précisé en début de masque, il est alors possible de renommer et de déplacer automatiquement les fichiers dans un répertoire particulier (voir le <a href="#ch_5_3">paragraphe 5.3</a> pour plus de détails).</p> + + <h4><a name="ch_5_1_3" id="ch_5_1_3">5.1.3 - Mode automatique via la base de données CDDB.</a></h4> + <p>Dans le <a href="USERS-GUIDE-11_fr4.html#ch_4_3_1">paragraphe 4.3.1</a>, nous avons vu qu'il était très souvent possible, grâce à la base de données CDDB, d'identifier l'album CD audio correspondant à un ensemble de fichiers. Ce résultat permet non seulement de renseigner automatiquement les différents champs d'information du tag des fichiers mais aussi de renseigner automatiquement les noms des fichiers (voir figure ci-dessous).</p> + <div class="img_c"><img src="images/fen_cddb1.png" alt="image fenêtre Recherche CDDB"/></div> + + <h4><a name="ch_5_1_4" id="ch_5_1_4">5.1.4 - Mode automatique via la lecture d'un fichier texte.</a></h4> + <p>Si les méthodes automatiques ont échoué, il reste toujours possible de mettre à jour les noms des fichiers grâce à la lecture d'un fichier texte. Ce fichier texte doit contenir la liste des noms des fichiers à traiter (dans un ordre identique à celui des fichiers sélectionnés).</p> + <p>Avant tout traitement, il faut récupérer ou créer le fichier texte des noms de fichiers audio. Dans le cas du traitement d'un album particulier, il est, par exemple, très facile de récupérer sur internet la liste des noms des pistes d'un CD. Cette méthode permet d'éviter de rentrer à la main les différents noms des pistes et, par la même, les possibles fautes de frappe.</p> + <div><img class="droite" src="images/fen_fic_txt.png" alt="image fenêtre -Charger les noms des fichiers à partir d'un fichier TXT-"/></div> + <p>Ce traitement est accessible depuis l'entrée <span class="entree">Charger les Noms des fichiers à partir d'un TXT …</span> du menu «Divers» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_4">paragraphe 2.1.4</a>). La fenêtre correspondante est présentée sur la figure ci-contre.</p> + <p>Au départ, il faut entrer le nom du fichier texte et cliquer sur le bouton "Charger" pour lire les données de ce fichier.<br/>Ces données sont alors affichées dans la zone gauche de la fenêtre.<br/>Les noms des fichiers à renseigner sont, par contre, affichés dans la zone droite de la fenêtre.</p> + <p>Pour finir, il suffit alors de cliquer sur le bouton "Appliquer" pour renseigner les noms des fichiers avec les valeurs lues dans le fichier texte. Toutefois, le changement de nom ne sera effectif qu'après la sauvegarde de ces fichiers.</p> + <hr class="fin_img"/> + + <h3><a name="ch_5_2" id="ch_5_2">5.2 Renommer les répertoires.</a></h3> + <div><img class="droite" src="images/fen_rech1.png" alt="image fenêtre - Renommer le répertoire-"/></div> + <p>Pour renommer manuellement un répertoire, il vous suffit de cliquer sur l'entrée <span class="entree">Renommer le répertoire ...</span> du menu «Sélecteur» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_2">paragraphe 2.1.2</a>) puis d'entrer le nouveau nom du répertoire dans la zone de saisie (voir figure ci-contre). Le fait de cliquer sur le bouton «Appliquer» rend cette modification immédiate et définitive.</p> + <p>Vous pouvez aussi renommer le nom du répertoire en utilisant un modèle de masque. Pour cela, il suffit de cocher la case <span class="entree">Utiliser le masque</span> et de saisir un masque particulier ou de choisir un masque dans la liste de masques disponibles. La définition des codes utilisés par le masque est donnée dans le <a href="#ch_5_1_2">paragraphe 5.1.2</a>. Le nom du répertoire construit à partir de ce masque est présenté sous la zone de saisie du masque. Si le nom vous convient, il vous suffit alors de cliquer sur le bouton "Appliquer" pour effectuer la modification.</p> + <hr class="fin_img"/> + + <p class="sans-retrait">Note : Contrairement au mode automatique via le scanner (voir le <a href="#ch_5_3">paragraphe 5.3</a>), lorsque le répertoire est renommé manuellement, les différents fichiers restent physiquement dans celui-ci. Le nouveau répertoire contient donc tous les fichiers présents dans l'ancien répertoire (y compris les fichiers non supportés par EasyTAG tels que les fichiers jpeg).</p> + + <h3><a name="ch_5_3" id="ch_5_3">5.3 - Renommer et déplacer les fichiers dans un répertoire.</a></h3> + <p>EasyTAG permet, à partir des différents champs d'information du tag, de renommer et de déplacer automatiquement les fichiers dans un répertoire particulier. Ce traitement est disponible via le scanner «Renommer le(s) Fichier(s) et Répertoire(s)», accessible depuis le menu «Fichier» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_1">paragraphe 2.1.1</a>), le menu «Scanner» (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_1_3">paragraphe 2.1.3</a>) ou depuis un menu contextuel (voir <a href="USERS-GUIDE-11_fr2.html#ch_2_6">paragraphe 2.6</a>).</p> + <p>La fenêtre du scanner «Renommer le(s) Fichier(s) et Répertoire(s)» est présentée sur la figure ci-contre. Sur cette figure, apparaissent les boutons de contrôle suivants :</p> + <div><img class="droite" src="images/fen_scan4.png" alt="image fenêtre -Renommer le(s) Fichier(s) et Répertoire(s)-"/></div> + <ul class="liste1"> + <li>bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> : Après la saisie d'un masque, cliquer sur ce bouton lance le traitement automatique des noms de fichiers et répertoire de l'ensemble des fichiers audio sélectionnés.</li> + <li>bouton <img src="images/bouton_scan3.png" alt="bouton point d'interrogation"/> : Ouvre/Ferme la fenêtre «Légende» (voir figure ci-contre) qui rappelle la correspondance entre code du masque et champ d'information du tag.</li> + <li>bouton <img src="images/bouton_scan2.png" alt="bouton masque"/> : Ouvre/Ferme la fenêtre «Editeur de Masque» (voir figure ci-contre) qui permet de choisir ou de créer le masque adapté à votre besoin. Elle permet, bien sûr, de sauvegarder ce nouveau masque pour tout traitement ultérieur du même type.</li> + <li>bouton <img src="images/bouton_scan7.png" alt="bouton répertoire +"/> : Ajoute au début du masque le chemin du répertoire courant.</li> + </ul> + <p>Dans le <a href="#ch_5_1_2">paragraphe 5.1.2</a>, nous avons vu comment renommer automatiquement les fichiers via le scanner sur la base d'un modèle de masque.<br/>Avec ce même scanner, en précisant en début de masque un chemin de répertoire, il est alors possible non seulement de renommer les fichiers mais aussi de les déplacer automatiquement dans un répertoire particulier.</p> + <p>La définition du masque constitue la première étape de ce traitement. Pour cela, vous disposez d'une liste de modèles de masque (voir figure ci-contre) mais vous pouvez aussi créer et ajouter à la liste un masque particulier grâce à la fenêtre «Editeur de masque».</p> + <p>Pour vous guider dans le choix du masque, EasyTAG affiche, en dessous de la zone de saisie du masque de la fenêtre «Renommer le Fichier et le Répertoire», le nouveau nom du fichier sous la forme "/arborescence du répertoire/nom du fichier".</p> + <hr class="fin_img"/> + + <p>Suivant le chemin précisé en début de masque, vous pouvez soit déplacer les fichiers dans un sous répertoire du répertoire courant soit déplacer les fichiers dans un répertoire particulier. Dans le suite de ce paragraphe, nous allons décrire ces deux traitements en prenant l'exemple du fichier <span class="entree">01.La_tête_en_arrière_(2004) Comme_un_homme.mp3</span> situé dans le répertoire <span class="entree">/media/musiques/</span>. De plus, nous supposerons que les champs d'information du tag de ce fichier prennent les valeurs données dans le tableau ci-contre.</p> + <div class="droite"> + <table> + <tr><th>Code</th><th>Champ du tag</th><th>Valeur extraite</th></tr> + <tr><td>%a</td><td>Artiste </td><td>Luke </td></tr> + <tr><td>%y</td><td>Année </td><td>2004 </td></tr> + <tr><td>%b</td><td>Album </td><td>La tête en arrière </td></tr> + <tr><td>%n</td><td>Piste </td><td>01 </td></tr> + <tr><td>%t</td><td>Titre </td><td>Comme un homme </td></tr> + </table> + </div> + <ul class="liste1"> + <li><span class="entree">Déplacer le fichier dans un sous-répertoire</span> : Pour renommer le fichier et le déplacer dans un sous-répertoire du répertoire courant, il suffit d'indiquer un chemin relatif en début de masque.<br/>Ainsi, avec le masque "<span class="entree">%a/%y - %b/%n - %t</span>", le fichier est : + <ul class="liste2"> + <li>renommé : <span class="entree">01 - Comme un homme.mp3</span>,</li> + <li>déplacé dans le répertoire : <span class="entree">/media/musiques/Luke/2004 - La tête en arrière/</span>.</li> + </ul> + <p>Si ce sous-répertoire n'existe pas, il est bien évidemment crée.</p> + </li> + <li><span class="entree">Déplacer le fichier dans un répertoire particulier</span> : Pour renommer le fichier et le déplacer dans un répertoire particulier, il suffit d'utiliser un chemin absolu en début de masque. Pour vous simplifier la saisie du chemin, il est possible, en cliquant sur le bouton <img src="images/bouton_scan7.png" alt="bouton répertoire +"/> d'ajouter le chemin courant en début de masque.<br/>Ainsi, avec le masque "<span class="entree">/media/Rock/%a/%y - %b/%n - %t</span>", le fichier est : + <ul class="liste2"> + <li>renommé : <span class="entree">01 - Comme un homme.mp3</span>,</li> + <li>déplacé dans le répertoire : <span class="entree">/media/Rock/Luke/2004 - La tête en arrière/</span>.</li> + </ul> + <p>Si ce répertoire n'existe pas, il est bien évidemment crée.</p> + </li> + </ul> + <p>Une fois le choix du masque effectué, cliquer sur le bouton <img src="images/bouton_scan1.png" alt="bouton porte"/> permet de lancer alors le traitement automatique de modification du nom et de déplacement des fichiers sur l'ensemble des fichiers selectionnés. Cependant, ces changements ne seront effectifs qu'après avoir sauvegardé ces fichiers.</p> + + <p class="sans-retrait"> Note : Contrairement au mode manuel, les fichiers sont physiquement déplacés vers leur nouveau répertoire. De ce fait, les fichiers qui ne sont pas supportés par EasyTAG tels que les fichiers jpeg ne seront pas eux déplacés et resteront donc dans le répertoire d'origine.</p> + +<!-- FIN RENOMMER FICHIERS/REPERTOIRES =====================================================--> + + <p class="img_c"><br/><a href="#haut_page">- RETOUR A LA TABLE DES MATIERES -</a></p> +</body> +</html> + diff --git a/doc/users_guide_french/USERS-GUIDE-11_fr6.html b/doc/users_guide_french/USERS-GUIDE-11_fr6.html new file mode 100755 index 0000000..7ad21b1 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE-11_fr6.html @@ -0,0 +1,103 @@ +<!-- ************************************************************************************ + * USERS-GUIDE-11_fr6.html * + * auteur Emmanuel Brun < manub91[at]gmail.com > * + * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict * + * test Firefox + IE6 * + * * + * Guide de l'utilisateur de EasyTAG (version 1.99.11) * + * chapitre 6 - Autres fonctions. * + * chapitre 7 - Pré-requis. * + * * + ************************************************************************************ --> + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html lang="fr"> + +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <title>Guide de l'utilisateur du logiciel EasyTAG - chapitre 6 et 7 </title> + <link rel="stylesheet" type="text/css" href="USERS-GUIDE.css" /> +</head> + +<body> + <div><a href="#" name="haut_page"></a></div> + + <h1>Guide de l'utilisateur du logiciel EasyTAG (version 1.99.11)<br/> - chapitre 6 et 7 -</h1> + +<!-- TABLE DES MATIERES =====================================================================--> + <p id="titre_TM">Table des matières.</p> + <ul class="TM1"> + <li><a href="USERS-GUIDE-11_fr1.html">1 - Introduction.</a></li> + <li><a href="USERS-GUIDE-11_fr2.html">2 - Description de l'interface.</a></li> + <li><a href="USERS-GUIDE-11_fr3.html">3 - Recherche rapide dans votre collection de fichiers audio.</a></li> + <li><a href="USERS-GUIDE-11_fr4.html">4 - Editer/corriger les tags.</a></li> + <li><a href="USERS-GUIDE-11_fr5.html">5 - Renommer les fichiers/les répertoires.</a></li> + <li> + <a href="#ch_6">6 - Autres fonctions.</a> + <ul class="TM2"> + <li><a href="#ch_6_1">6.1 - Création d'une liste de lecture M3U.</a></li> + <li><a href="#ch_6_2">6.2 - Ecoute des fichiers audio.</a></li> + </ul> + </li> + <li><a href="#ch_7">7 - Pré-requis.</a></li> + </ul> + +<!-- FIN TABLE DES MATIERES =================================================================--> + +<!-- AUTRES FONCTIONS =====================================================================--> + + <h2><a name="ch_6" id="ch_6">6 - Autres fonctions.</a></h2> + <h3><a name="ch_6_1" id="ch_6_1">6.1 - Création d'une liste de lecture M3U.</a></h3> + <p>Dans EasyTAG vous avez la possibilité de créer une liste de lecture de type m3u directement utilisable par un lecteur de fichiers audio externe (WinAmp, Xmms, Totem …)</p> + <p>Cette fonction est accessible depuis le menu «Divers» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_4">paragraphe 2.1.4</a>). La fenêtre correspondante est présentée ci-contre.</p> + <div><img class="droite" src="images/fen_playlist.png" alt="image fenêtre -Générer une liste de lecture-"/></div> + <p>Pour que la liste de lecture ne contienne seulement que les fichiers sélectionnés, il faut faire attention que la case <span class="entree">Inclure seulement les fichiers sélectionnés</span> soit bien cochée. En effet, si cette case n'est pas cochée, la liste de lecture comprend alors l'ensemble de tous les fichiers audio présents dans le répertoire courant (ce qui peut représenter un nombre important de fichiers).</p> + <p>De plus, nous voyons que deux options font appel à certains codes (%a, %b, …). Ces codes sont les mêmes que ceux utilisés pour la fonction scanner (voir, par exemple, <a href="USERS-GUIDE-11_fr4.html#ch_4_2">paragraphe 4.2</a>). La signification des quelques codes visibles sur la figure est donnée dans le tableau ci-dessous.</p> + <div><table class="tab_c"> + <tr><th>Code</th><th>Champ du tag</th></tr> + <tr><td>%a</td><td>Artiste </td></tr> + <tr><td>%b</td><td> Album </td></tr> + <tr><td>%n</td><td> Numéro de piste </td></tr> + <tr><td>%l</td><td> Nbre total de pistes </td></tr> + <tr><td>%t</td><td> Titre </td></tr> + </table></div> + <p class="sans-retrait">Une fois les différentes options choisies, il suffit, pour créer la liste de lecture, de cliquer alors sur le bouton «Ecrire».</p> + <hr class="fin_img"/> + + <h3><a name="ch_6_2" id="ch_6_2">6.2 - Ecoute des fichiers audio.</a></h3> + <p>EasyTAG permet la lecture des fichiers audio grâce au lancement depuis le logiciel d'une application externe de lecture de fichiers audio. Ceci peut être réalisé de trois façons différentes :</p> + <ul class="liste1"> + <li><span class="entree">Lancer Lecteur Audio</span> : Cette entrée du menu «Divers» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_4">paragraphe 2.1.4</a>) permet de lancer le lecteur audio par défaut. Ce lecteur peut être défini dans l'onglet «Divers» du menu «Préférences» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_5">paragraphe 2.1.5</a>).</li> + </ul> + <div><img class="droite" src="images/fen_lect1.png" alt="image fenêtre -Ouvrir le fichier avec-"/></div> + <ul class="liste1"> + <li><span class="entree">Ouvrir le(s) Fichier(s) avec …</span> : Cette entrée du menu «Fichier» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_1">paragraphe 2.1.1</a>) ouvre une fenêtre (voir figure ci-contre) qui permet de saisir l'application externe à lancer. Cette application traite l'ensemble des fichiers audio sélectionnés. Pour lancer l'application, il faut cliquer sur le bouton «Exécuter».<br/>Dans le cas présent, l'application lancée 'Xmms -e' permet d'écouter les fichiers sélectionnés avec Xmms. De plus, l'option choisie permet de placer ces fichiers à la suite des fichiers audio déja en écoute.</li> + </ul> + <hr class="fin_img"/> + <div><img class="droite" src="images/fen_lect2.png" alt="image fenêtre -Parcourir le répertoire avec-"/></div> + <ul class="liste1"> + <li><span class="entree">Parcourir le Répertoire avec …</span> : Cette entrée du menu «Sélecteur» (voir le <a href="USERS-GUIDE-11_fr2.html#ch_2_1_2">paragraphe 2.1.2</a>) ouvre une fenêtre (voir figure ci-contre) qui permet de saisir l'application externe à lancer. Cette application traite l'ensemble des fichiers audio présents dans le répertoire courant. Pour lancer l'application, il faut cliquer sur le bouton «Exécuter».<br/>Dans le cas présent, l'application lancée 'Xmms -p' permet d'écouter tous les fichiers avec Xmms.</li> + </ul> + <hr class="fin_img"/> + +<!-- FIN AUTRES FONCTIONS =================================================================--> + +<!-- PRE-REQUIS =============================================================================--> + + <h2><a name="ch_7" id="ch_7">7 - Pré-requis.</a></h2> + <p>Pour fonctionner, EasyTAG doit disposer des librairies suivantes :</p> + <ul class="liste1"> + <li>GTK 2.4,</li> + <li>id3lib pour les fichiers MP3,</li> + <li>libogg,</li> + <li>libvorbis pour les fichiers Ogg Vorbis,</li> + <li>libFLAC (en complément de libogg and libvorbis) pour les fichiers FLAC Vorbis,</li> + <li>mpeg4ip pour les fichiers MP4.</li> + </ul> + +<!-- FIN PRE-REQUIS =========================================================================--> + + <p class="img_c"><br/><a href="#haut_page">- RETOUR A LA TABLE DES MATIERES -</a></p> +</body> +</html> + diff --git a/doc/users_guide_french/USERS-GUIDE.css b/doc/users_guide_french/USERS-GUIDE.css new file mode 100755 index 0000000..1deba45 --- /dev/null +++ b/doc/users_guide_french/USERS-GUIDE.css @@ -0,0 +1,144 @@ +/************************************************************************************
+ * USERS-GUIDE.css *
+ * auteur Emmanuel Brun < manub91[at]gmail.com > *
+ * date : 28/12/06 mise en conformité avec W3C xhtml 1.0 strict *
+ * test Firefox + IE6 *
+ * *
+ * Fichier CSS du Guide de l'utilisateur de EasyTAG (version 1.99.11) *
+ * *
+ ************************************************************************************/
+
+ body {
+ font-family: Verdana, "Trebuchet MS", Arial, sans-serif;
+ margin: 0;
+ padding: 0 30px 0 30px;
+ background-color: #FDFDE7;
+ font-size: 0.9em;
+ line-height: 1.5em;
+ }
+
+ /* LISTES */
+ /* ====== */
+ /* Table des matières */
+ .TM1 li {
+ margin-top:0.5em;
+ margin-left: 3em;
+ list-style-type: none;
+ list-style-position: outside;
+ text-indent: 0em;
+ line-height: 1.5em;
+ }
+
+ .TM2 li {
+ margin-top:0em;
+ margin-left: 3em;
+ list-style-type: none;
+ list-style-position: outside;
+ text-indent: 0em;
+ line-height: 1.5em;
+ }
+
+ .TM3 li {
+ margin-top:0em;
+ margin-left: 3em;
+ list-style-type: none;
+ list-style-position: outside;
+ text-indent: 0em;
+ line-height: 1.5em;
+ }
+
+ /* Liste - paragraphe */
+ .liste1 li {
+ margin-top:0.5em;
+ margin-left: 3em;
+ list-style-type: disc;
+ list-style-position: outside;
+ text-indent: 0em;
+ line-height: 1.5em;
+ }
+
+ .liste2 li {
+ margin-top:0em;
+ margin-left: 3em;
+ list-style-type: circle;
+ list-style-position: outside;
+ text-indent: 0em;
+ line-height: 1.5em;
+ }
+
+ /* Chapitre */
+ h1 {
+ font-size: 1.5em;
+ font-weight: bold;
+ text-align: center;
+ line-height: 1.5em;
+ border-top: 1px solid #CCCCCC;
+ border-bottom: 1px solid #CCCCCC;
+ border-left: 1px solid #CCCCCC;
+ border-right: 1px solid #CCCCCC;
+ color: blue;
+ background-color: #D2E6FF;
+ }
+ h2 {
+ font-size: 1.1em;
+ text-decoration: none;
+ text-indent: 0em;
+ margin-top: 2em;
+ border-top: 1px solid #CCCCCC;
+ border-bottom: 1px solid #CCCCCC;
+ border-left: 1px solid #CCCCCC;
+ border-right: 1px solid #CCCCCC;
+ color: blue;
+ background-color: #D2E6FF;
+ }
+ h3 {
+ font-size: 1.1em;
+ text-decoration: none;
+ margin-top: 1.5em;
+ margin-left: 2em;
+ color: blue;
+ }
+ h4 {
+ font-size: 1.1em;
+ text-decoration: none;
+ margin-top: 1.5em;
+ margin-left: 5em;
+ color: blue;
+ }
+
+ p { text-align: justify; text-indent: 2em; line-height: 1.5em; }
+
+ .sans-retrait { text-align: justify; text-indent: 0em; }
+
+ /* CARACTERES */
+ /* ========== */
+ #titre_TM { font-size: 1.5em; color: blue; }
+
+ .entree { font-weight: bold; }
+
+ .souligne { text-decoration: underline; }
+
+
+ /* TABLEAU */
+ /* ======= */
+ table { border: 1px solid #666666; margin: 0px; padding: 0px; }
+
+ th { background-color: #CCCCCC; border: 1px solid; font-size: 0.8em; text-align: center; }
+
+ td { background-color: #F9F9F9; border: 1px solid #CECECE; font-size: 0.8em; text-align: center; }
+
+ /* IMAGES */
+ /* ====== */
+ .img_c { margin-top: 2em; margin-bottom:2em; text-align: center; } /* image centree */
+
+ .droite { margin-bottom: 1em; margin-left: 2em; margin-right: 0; float: right; } /* image à droite */
+
+ .fin_img { clear: both; visibility: hidden; } /* cale les paragraphes sur les images */
+
+ /* LIENS */
+ /* ===== */
+ a { text-decoration: none; }
+
+ a:hover { background-color: #E8F8FC; color: #FF02F5; }
+
+ .tab_c {margin: 1em auto 1em auto; }
diff --git a/doc/users_guide_french/images/bouton_arbo.png b/doc/users_guide_french/images/bouton_arbo.png Binary files differnew file mode 100755 index 0000000..0d0344d --- /dev/null +++ b/doc/users_guide_french/images/bouton_arbo.png diff --git a/doc/users_guide_french/images/bouton_img1.png b/doc/users_guide_french/images/bouton_img1.png Binary files differnew file mode 100755 index 0000000..310d85f --- /dev/null +++ b/doc/users_guide_french/images/bouton_img1.png diff --git a/doc/users_guide_french/images/bouton_img2.png b/doc/users_guide_french/images/bouton_img2.png Binary files differnew file mode 100755 index 0000000..c32978b --- /dev/null +++ b/doc/users_guide_french/images/bouton_img2.png diff --git a/doc/users_guide_french/images/bouton_img3.png b/doc/users_guide_french/images/bouton_img3.png Binary files differnew file mode 100755 index 0000000..611c362 --- /dev/null +++ b/doc/users_guide_french/images/bouton_img3.png diff --git a/doc/users_guide_french/images/bouton_scan1.png b/doc/users_guide_french/images/bouton_scan1.png Binary files differnew file mode 100755 index 0000000..817806e --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan1.png diff --git a/doc/users_guide_french/images/bouton_scan2.png b/doc/users_guide_french/images/bouton_scan2.png Binary files differnew file mode 100755 index 0000000..6d0b22c --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan2.png diff --git a/doc/users_guide_french/images/bouton_scan3.png b/doc/users_guide_french/images/bouton_scan3.png Binary files differnew file mode 100755 index 0000000..12c1c13 --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan3.png diff --git a/doc/users_guide_french/images/bouton_scan4.png b/doc/users_guide_french/images/bouton_scan4.png Binary files differnew file mode 100755 index 0000000..2d78847 --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan4.png diff --git a/doc/users_guide_french/images/bouton_scan5.png b/doc/users_guide_french/images/bouton_scan5.png Binary files differnew file mode 100755 index 0000000..82bf213 --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan5.png diff --git a/doc/users_guide_french/images/bouton_scan6.png b/doc/users_guide_french/images/bouton_scan6.png Binary files differnew file mode 100755 index 0000000..5ac656c --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan6.png diff --git a/doc/users_guide_french/images/bouton_scan7.png b/doc/users_guide_french/images/bouton_scan7.png Binary files differnew file mode 100755 index 0000000..fe49ce3 --- /dev/null +++ b/doc/users_guide_french/images/bouton_scan7.png diff --git a/doc/users_guide_french/images/fen_boutons.png b/doc/users_guide_french/images/fen_boutons.png Binary files differnew file mode 100755 index 0000000..d9f3782 --- /dev/null +++ b/doc/users_guide_french/images/fen_boutons.png diff --git a/doc/users_guide_french/images/fen_cddb1.png b/doc/users_guide_french/images/fen_cddb1.png Binary files differnew file mode 100755 index 0000000..a463006 --- /dev/null +++ b/doc/users_guide_french/images/fen_cddb1.png diff --git a/doc/users_guide_french/images/fen_cddb2.png b/doc/users_guide_french/images/fen_cddb2.png Binary files differnew file mode 100755 index 0000000..6ff4dda --- /dev/null +++ b/doc/users_guide_french/images/fen_cddb2.png diff --git a/doc/users_guide_french/images/fen_fic_txt.png b/doc/users_guide_french/images/fen_fic_txt.png Binary files differnew file mode 100755 index 0000000..d9aec03 --- /dev/null +++ b/doc/users_guide_french/images/fen_fic_txt.png diff --git a/doc/users_guide_french/images/fen_fich.png b/doc/users_guide_french/images/fen_fich.png Binary files differnew file mode 100755 index 0000000..8e0379a --- /dev/null +++ b/doc/users_guide_french/images/fen_fich.png diff --git a/doc/users_guide_french/images/fen_lect1.png b/doc/users_guide_french/images/fen_lect1.png Binary files differnew file mode 100755 index 0000000..9f0f284 --- /dev/null +++ b/doc/users_guide_french/images/fen_lect1.png diff --git a/doc/users_guide_french/images/fen_lect2.png b/doc/users_guide_french/images/fen_lect2.png Binary files differnew file mode 100755 index 0000000..7ed442a --- /dev/null +++ b/doc/users_guide_french/images/fen_lect2.png diff --git a/doc/users_guide_french/images/fen_playlist.png b/doc/users_guide_french/images/fen_playlist.png Binary files differnew file mode 100755 index 0000000..dd538e2 --- /dev/null +++ b/doc/users_guide_french/images/fen_playlist.png diff --git a/doc/users_guide_french/images/fen_rech1.png b/doc/users_guide_french/images/fen_rech1.png Binary files differnew file mode 100755 index 0000000..7404e93 --- /dev/null +++ b/doc/users_guide_french/images/fen_rech1.png diff --git a/doc/users_guide_french/images/fen_scan1.png b/doc/users_guide_french/images/fen_scan1.png Binary files differnew file mode 100755 index 0000000..132e83c --- /dev/null +++ b/doc/users_guide_french/images/fen_scan1.png diff --git a/doc/users_guide_french/images/fen_scan2.png b/doc/users_guide_french/images/fen_scan2.png Binary files differnew file mode 100755 index 0000000..705e518 --- /dev/null +++ b/doc/users_guide_french/images/fen_scan2.png diff --git a/doc/users_guide_french/images/fen_scan3.png b/doc/users_guide_french/images/fen_scan3.png Binary files differnew file mode 100755 index 0000000..d34cef5 --- /dev/null +++ b/doc/users_guide_french/images/fen_scan3.png diff --git a/doc/users_guide_french/images/fen_scan4.png b/doc/users_guide_french/images/fen_scan4.png Binary files differnew file mode 100755 index 0000000..5eaceac --- /dev/null +++ b/doc/users_guide_french/images/fen_scan4.png diff --git a/doc/users_guide_french/images/fen_sel1.png b/doc/users_guide_french/images/fen_sel1.png Binary files differnew file mode 100755 index 0000000..ec31e39 --- /dev/null +++ b/doc/users_guide_french/images/fen_sel1.png diff --git a/doc/users_guide_french/images/fen_sel2.png b/doc/users_guide_french/images/fen_sel2.png Binary files differnew file mode 100755 index 0000000..7667254 --- /dev/null +++ b/doc/users_guide_french/images/fen_sel2.png diff --git a/doc/users_guide_french/images/fen_sel3.png b/doc/users_guide_french/images/fen_sel3.png Binary files differnew file mode 100755 index 0000000..bf61edd --- /dev/null +++ b/doc/users_guide_french/images/fen_sel3.png diff --git a/doc/users_guide_french/images/fen_tag_bout1.png b/doc/users_guide_french/images/fen_tag_bout1.png Binary files differnew file mode 100755 index 0000000..d028421 --- /dev/null +++ b/doc/users_guide_french/images/fen_tag_bout1.png diff --git a/doc/users_guide_french/images/fen_tag_bout2.png b/doc/users_guide_french/images/fen_tag_bout2.png Binary files differnew file mode 100755 index 0000000..bf50fea --- /dev/null +++ b/doc/users_guide_french/images/fen_tag_bout2.png diff --git a/doc/users_guide_french/images/fen_tag_gen.png b/doc/users_guide_french/images/fen_tag_gen.png Binary files differnew file mode 100755 index 0000000..b3a9b96 --- /dev/null +++ b/doc/users_guide_french/images/fen_tag_gen.png diff --git a/doc/users_guide_french/images/fen_tag_img.png b/doc/users_guide_french/images/fen_tag_img.png Binary files differnew file mode 100755 index 0000000..ddeb5b2 --- /dev/null +++ b/doc/users_guide_french/images/fen_tag_img.png diff --git a/doc/users_guide_french/images/interface.png b/doc/users_guide_french/images/interface.png Binary files differnew file mode 100755 index 0000000..6375f19 --- /dev/null +++ b/doc/users_guide_french/images/interface.png diff --git a/doc/users_guide_french/images/menu_context1.png b/doc/users_guide_french/images/menu_context1.png Binary files differnew file mode 100755 index 0000000..30c0ac8 --- /dev/null +++ b/doc/users_guide_french/images/menu_context1.png diff --git a/doc/users_guide_french/images/menu_context2.png b/doc/users_guide_french/images/menu_context2.png Binary files differnew file mode 100755 index 0000000..959e229 --- /dev/null +++ b/doc/users_guide_french/images/menu_context2.png diff --git a/doc/users_guide_french/images/menu_context3.png b/doc/users_guide_french/images/menu_context3.png Binary files differnew file mode 100755 index 0000000..6c4218c --- /dev/null +++ b/doc/users_guide_french/images/menu_context3.png diff --git a/doc/users_guide_french/images/menu_div.png b/doc/users_guide_french/images/menu_div.png Binary files differnew file mode 100755 index 0000000..c7c1b64 --- /dev/null +++ b/doc/users_guide_french/images/menu_div.png diff --git a/doc/users_guide_french/images/menu_fic.png b/doc/users_guide_french/images/menu_fic.png Binary files differnew file mode 100755 index 0000000..8dd1147 --- /dev/null +++ b/doc/users_guide_french/images/menu_fic.png diff --git a/doc/users_guide_french/images/menu_pref.png b/doc/users_guide_french/images/menu_pref.png Binary files differnew file mode 100755 index 0000000..7e8e722 --- /dev/null +++ b/doc/users_guide_french/images/menu_pref.png diff --git a/doc/users_guide_french/images/menu_recherche.png b/doc/users_guide_french/images/menu_recherche.png Binary files differnew file mode 100755 index 0000000..ee368c7 --- /dev/null +++ b/doc/users_guide_french/images/menu_recherche.png diff --git a/doc/users_guide_french/images/menu_recherche1.png b/doc/users_guide_french/images/menu_recherche1.png Binary files differnew file mode 100755 index 0000000..cddbe7c --- /dev/null +++ b/doc/users_guide_french/images/menu_recherche1.png diff --git a/doc/users_guide_french/images/menu_recherche2.png b/doc/users_guide_french/images/menu_recherche2.png Binary files differnew file mode 100755 index 0000000..da8cebe --- /dev/null +++ b/doc/users_guide_french/images/menu_recherche2.png diff --git a/doc/users_guide_french/images/menu_scan.png b/doc/users_guide_french/images/menu_scan.png Binary files differnew file mode 100755 index 0000000..a88d1cc --- /dev/null +++ b/doc/users_guide_french/images/menu_scan.png diff --git a/doc/users_guide_french/images/menu_sel.png b/doc/users_guide_french/images/menu_sel.png Binary files differnew file mode 100755 index 0000000..c1ea0e3 --- /dev/null +++ b/doc/users_guide_french/images/menu_sel.png diff --git a/doc/users_guide_french/images/sousmenu_fic1.png b/doc/users_guide_french/images/sousmenu_fic1.png Binary files differnew file mode 100755 index 0000000..b8cdb97 --- /dev/null +++ b/doc/users_guide_french/images/sousmenu_fic1.png diff --git a/doc/users_guide_french/images/sousmenu_fic2.png b/doc/users_guide_french/images/sousmenu_fic2.png Binary files differnew file mode 100755 index 0000000..f527825 --- /dev/null +++ b/doc/users_guide_french/images/sousmenu_fic2.png diff --git a/doc/users_guide_german/bedienung1.htm b/doc/users_guide_german/bedienung1.htm new file mode 100755 index 0000000..c205bd9 --- /dev/null +++ b/doc/users_guide_german/bedienung1.htm @@ -0,0 +1,54 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> +<title>Bedienung</title> +<link href="easy.css" rel="stylesheet" type="text/css" /> +<link rel="icon" href="images/EasyTAG.png" type="image/png"> +</head> +<body> +<div style="margin:50px;" align="center">[<a href="einleitung.htm">Über</a>] - [<a href="bedienung1.htm#browser">Browser</a>] - [<a href="bedienung1.htm#dateiliste">Dateiliste</a>] - [<a href="bedienung1.htm#eigenschaftenfeld">Eigenschaftenfeld</a>] - [<a href="bedienung2.htm#playlist">Playlistgenerator</a>] - [<a href="bedienung2.htm#such">Suchfenster</a>]</div> +<table align="center" width="700" name="Das Hauptfenster" title="Das Hauptfenster" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"> +<div class="anders">Das Hauptfenster</div> +</td></tr> + +<tr><td bgcolor="#ffffff"> +<p><img src="images/t_easytag.jpg" width="311" height="150" border="0" alt="Das Hauptfenster" align="right" /> +Das Hauptfenster enthält drei Bereiche:</p> +<ul> +<li>Der Browser</li> +<lI>Die Dateiliste</li> +<li>Das Eigenschaftenfeld</li> +</ul> +</td></tr></tbody></table> + + +<table align="center" width="700" name="Der Browser" title="Der Browser" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"><a name="browser"></a> +<div class="anders">Der Browser</div> +</td> </tr> +<tr><td bgcolor="#ffffff"> +<p><img style="margin-right:20px;" src="images/treeview.png" width="180" height="227" border="0" alt="Brwoser" name="Browser" align="left" /> +Im Browser kann man schnell zwischen den Verzeichnissen wechseln und zu den zu bearbeitenden Dateien gelangen. Wenn die Option "<i>Dursuche Unterverzeichnisse</i>" aktiviert ist, sollte man bei großen Verezeichnissen nicht die Ordnersymbole anklicken, da hier jedesmal die gesamten Unterverzeichnisse durchsucht werden, was unter Umständen sehr lange dauert. Stattdessen sollte man nur das Plus - Symbol neben dem Ordnersymbol anklicken um dann das gewünschte Unterverzeichnis zu erreichen.</p> +</td></tr></tbody></table> + +<table align="center" width="700" name="Die Dateiliste" title="Die Dateiliste" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"><a name="dateiliste"></a> +<div class="anders">Die Dateiliste</div> +</td></tr> +<tr><td bgcolor="#ffffff"> +<p><img style="margin-left:20px;" src="images/filelist.png" width="173" height="225" alt="Dateiliste" name="Dateiliste" align="right" /> +Hier werden alle eingelesenen Musikstücke angezeigt. Es werden nur unterstützte Dateitypen aufgelistet. In der Dateiliste kann man einzelne Einträge auswählen, deren Informationen anzeigen und verändern. Wenn sich die Liste über mehrere Verzeichnisse erstreckt, werden die Dateien der einzelnen Verzeichnisse jeweils mit einem andersfarbigen Hintergrund <span style="background-color:#deeeff;">hervorgehoben</span>. Veränderte Einträge sind <span style="color:red;">rot</span>. +</td></tr></tbody></table> + +<table align="center" width="700" name="Das Eigenschaftenfeld" title="Das Eigenschaftenfeld" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"><a name="eigenschaftenfeld"></a> +<div class="anders">Das Eigenschaftenfeld</div> +</td></tr> +<tr><td bgcolor="#ffffff"> +<p><img style="margin-right:20px;" src="images/eigensch.png" alt="Eigenschaftenfeld" align="left" /> +Im Eigenschaftenfeld werden alle vorhandenen Informationen der Datei angezeigt. Hier können die einzelnen Tagfelder bearbeitet werden. Wenn man eines der kleinen Quadrate auf der rechten Seite anklickt, bekommen alle Dateien im aktuellen Verzeichnis den Wert der links vom Quadrat eingetragen ist. Bsp. Sollen alle Lieder das selbe im Feld "Album" stehen haben, klicke man einmal auf das Quadrat rechts daneben und alle in der Dateiliste angezeigten Titel sind auf ein Album getrimmt.</p> +</td></tr></tbody></table> +<div style="height:250px;"></div> +</body> +</html>
\ No newline at end of file diff --git a/doc/users_guide_german/bedienung2.htm b/doc/users_guide_german/bedienung2.htm new file mode 100755 index 0000000..621eb0b --- /dev/null +++ b/doc/users_guide_german/bedienung2.htm @@ -0,0 +1,43 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> +<title>Bedienung</title> +<link href="easy.css" rel="stylesheet" type="text/css" /> +<link rel="icon" href="images/EasyTAG.png" type="image/png"> +</head> +<body> +<div style="margin:50px;" align="center">[<a href="einleitung.htm">Über</a>] - [<a href="bedienung1.htm#browser">Browser</a>] - [<a href="bedienung1.htm#dateiliste">Dateiliste</a>] - [<a href="bedienung1.htm#eigenschaftenfeld">Eigenschaftenfeld</a>] - [<a href="bedienung2.htm#playlist">Playlistgenerator</a>] - [<a href="bedienung2.htm#such">Suchfenster</a>]</div> +<table align="center" width="700" name="Der Playlistgenerator" title="Der Playlistgenerator" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"><a name="playlist"></a> +<div class="anders">Der Playlistgenerator</div> +</td></tr> + +<tr><td bgcolor="#ffffff"> +<p><img style="margin-right:20px;" src="images/playlist.png" width="413" height="353" alt="Der Playlistgenerator" name="Der Playlistgenerator" align="left" /> +Der Playlistgenerator erstellt Listen aller Lieder im aktuell ausgewählten Verzeichnis und allen Unterverzeichnissen (wenn die Option <i>Unterverzeichnisse durchsuchen</i> aktiviert ist). Die Liste wird im gewählten Verzeichnis abgelegt. (In der Statuszeile werden alle Aktionen bekanntgegeben)<br> +Beim Schreiben der Liste hat man die Möglichkeit den Inhalt derselben selbst zu bestimmen. Als Vorgabe hat man die Zeile <div style="margin:15px;"><tt>"%n/%l - %a - %b - %t (%y)"</tt></div> zur Verfügung, was soviel heißt wie: Stücknummer/Anzahl - Künstler - Album - Titel (Jahr)".</p> +<br> +<p><br><br>Hier die Bedeutung der einzelnen Abkürzungen: +<ul> +<li>%t - Titel</li> +<li>%a - Künstler</li> +<li>%b - Album</li> +<li>%y - Jahr</li> +<li>%g - Genre</li> +<li>%n - Stück</li> +<li>%l - Anzahl von Stücken</li> +<li>%c - Kommentar</li> +<li>%i - wird ignoriert</li> +</ul></p> +</td></tr></tbody></table> + +<table align="center" width="700" name="Die Suchmaschine" title="Die Suchmaschine" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"><a name="such"></a> +<div class="anders">Die Suchmaschine</div> +</td></tr> +<tr><td bgcolor="#ffffff"> +<p><img style="margin-left:20px;" src="images/search.png" width="506" height="262" alt="Suchmaschine" name="Suchmaschine" align="right" />In dem Suchfenster können alle Lieder, die sich gerade im Speicher befinden (also im gewählten Verzeichnis und in ev. eingescannten Unterverzeichnissen) nach Suchbegriffen gefiltert werden. Wenn man ein Ergebnis einmal anklickt, springt der Focus in der <a href="bedienung1.htm#dateiliste">Dateiliste</a> zum gewählten Eintrag und man kann ihn bearbeiten/abspielen/was auch immer.</p> +</td></tr></tbody></table> +<div style="height:250px;"></div> +</body> +</html>
\ No newline at end of file diff --git a/doc/users_guide_german/easy.css b/doc/users_guide_german/easy.css new file mode 100755 index 0000000..9ea6959 --- /dev/null +++ b/doc/users_guide_german/easy.css @@ -0,0 +1,10 @@ +body { background-color:#f0f0ff; color:#000000; margin-left:10px; margin-right:20px; } +* { font-face:lucida, helvetica, sans-serif; } + +a:link { Color:#0000ee; Text-Decoration:none; } +a:visited { Color:#551a8b; Text-Decoration:none; } +a:active { Color:#ff0000; Text-Decoration:none; } +a:hover { Color:#0000ff; Text-Decoration:underline; } +table { background-color:#ccccff; } + +.anders { color:#000066; font-weight:bolder; font-size:larger; text-align:center; } diff --git a/doc/users_guide_german/einleitung.htm b/doc/users_guide_german/einleitung.htm new file mode 100755 index 0000000..fa815ca --- /dev/null +++ b/doc/users_guide_german/einleitung.htm @@ -0,0 +1,61 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> +<title>Einleitung</title> +<link href="easy.css" rel="stylesheet" type="text/css" /> +<link rel="icon" href="images/EasyTAG.png" type="image/png"> +</head> +<body> +<div style="margin:50px;" align="center">[<a href="einleitung.htm">Über</a>] - [<a href="bedienung1.htm#browser">Browser</a>] - [<a href="bedienung1.htm#dateiliste">Dateiliste</a>] - [<a href="bedienung1.htm#eigenschaftenfeld">Eigenschaftenfeld</a>] - [<a href="bedienung2.htm#playlist">Playlistgenerator</a>] - [<a href="bedienung2.htm#such">Suchfenster</a>]</div> + +<table align="center" width="700" border="0" cellpadding="3" cellspacing="3"> +<tr><td bgcolor="#ffffff"> +<p>Easytag ist ein Werkzeug zum Anschauen, Editieren und Schreiben von Tags Ihrer MP3-, MP2-, FLAC- und OGG-Dateien. Seine einfache und hübsche GTK+ - Oberfläche macht das Taggen einfacher.</p> +</td></tr></table> +<br> + + +<table align="center" width="700" border="0" cellspacing="3" cellpadding="3"> +<tbody><tr><td height="27"> +<div class="anders">Easytag kann:</div> +</td></tr> + +<tr><td bgcolor="#ffffff"> +<ul> +<li>Den Tag von MP3, MP2, <a href="http://flac.sourceforge.net" target="_neu">FLAC</a> Dateien (mit ID3v2.2 und v1.x) und natürlich <a href="http://www.vorbis.com" target="_neu">OGG's</a> betrachten, Editieren und schreiben.</li> +<li>Automatisches Tagging: Anhand von Datei- und Verzeichnisnamen können Tags mit Hilfe von Masken automatisch geschrieben werden.</li> +<li>Umbenennen von Dateien anhand des Tags oder einer Textdatei (mit Hilfe von Masken)</li> +<li>Alle Dateien des aktuellen Verzeichnisses bearbeiten</li> +<li>Durch die Verzeichnisstruktur Browsen</li> +<li>Rekursives Taggen, Verschieben, Umbenennen, Speichern, ...</li> +<li>Bestimmte Felder (Künstler, Titel, ...) auf alle gewünschten Dateien anwenden>/li> +<li>Lesen von Dateiinformationen (Bitrate, Zeit, ...) und Anzeigen derselben</li> +<li>Automatische Vervollständigung von unvollständigen Datumsangaben</li> +<li>Letzte Änderungen rückgängig machen (und wiederholen)</li> +<li>Groß/Kleinschreibung im Tag und im Dateinamen anpassen</li> +<li>Dateien und Verzeichnisse mit anderen Programmen öffnen</li> +<li>Die CDDB - Datenbank abfragen (über http)</li> +<li>Französisch, Deutsch, Russisch, Ungarisch, Schwedisch, Italienisch, Japanisch, Ukrainisch, Tschechisch, Spanisch, Polnisch und Romanische Sprachen</li> +</ul> +</td></tr></tbody></table> + + + +<table align="center" width="700" border="0" cellspacing="3" cellpadding="3"> +<tbody> <tr> <td height="27"> +<div class="anders">Easytag hat:</div> +</td> </tr> +<tr><td bgcolor="#ffffff"> +<ul> +<li>Einen <a href="bedienung1.htm#browser">Browser</a> in Baumstrukur</li> +<li>Eine <a href="bedienung1.htm#dateiliste">Dateiliste</a> zum Auswählen</li> +<li>Einen <a href="bedienung2.htm#playlist">Playlistgenerator</a></li> +<li>Eine <a href="bedienung2.htm#such">Suchmaschine</a></li> +<li>Eine einfache Oberfläche</li> +<li>Eine Menüleiste und Lesezeichen</li> +<li>Statusmeldungen in der Statusleiste</li> +</ul> +</td></tr></tbody></table> + +</body> +</html>
\ No newline at end of file diff --git a/doc/users_guide_german/images/EasyTAG.png b/doc/users_guide_german/images/EasyTAG.png Binary files differnew file mode 100755 index 0000000..fd132d3 --- /dev/null +++ b/doc/users_guide_german/images/EasyTAG.png diff --git a/doc/users_guide_german/images/eigensch.png b/doc/users_guide_german/images/eigensch.png Binary files differnew file mode 100755 index 0000000..71d7edc --- /dev/null +++ b/doc/users_guide_german/images/eigensch.png diff --git a/doc/users_guide_german/images/filelist.png b/doc/users_guide_german/images/filelist.png Binary files differnew file mode 100755 index 0000000..237198e --- /dev/null +++ b/doc/users_guide_german/images/filelist.png diff --git a/doc/users_guide_german/images/playlist.png b/doc/users_guide_german/images/playlist.png Binary files differnew file mode 100755 index 0000000..18c491e --- /dev/null +++ b/doc/users_guide_german/images/playlist.png diff --git a/doc/users_guide_german/images/search.png b/doc/users_guide_german/images/search.png Binary files differnew file mode 100755 index 0000000..8910228 --- /dev/null +++ b/doc/users_guide_german/images/search.png diff --git a/doc/users_guide_german/images/t_easytag.jpg b/doc/users_guide_german/images/t_easytag.jpg Binary files differnew file mode 100755 index 0000000..50c00c1 --- /dev/null +++ b/doc/users_guide_german/images/t_easytag.jpg diff --git a/doc/users_guide_german/images/treeview.png b/doc/users_guide_german/images/treeview.png Binary files differnew file mode 100755 index 0000000..3407b8c --- /dev/null +++ b/doc/users_guide_german/images/treeview.png diff --git a/doc/vorbis/v-comment.html b/doc/vorbis/v-comment.html new file mode 100755 index 0000000..4089d81 --- /dev/null +++ b/doc/vorbis/v-comment.html @@ -0,0 +1,194 @@ +<HTML><HEAD><TITLE>xiph.org: Ogg Vorbis documentation</TITLE> +<BODY bgcolor="#ffffff" text="#202020" link="#006666" vlink="#000000"> +<nobr><img src="white-ogg.png"><img src="vorbisword2.png"></nobr><p> + + +<h1><font color=#000070> +Ogg Vorbis comment field specification +</font></h1> + +<em>Last update to this document: January 19, 2001</em><p> + +The text comment header is the second (of three) header packets that +begin a Vorbis bitstream. It is meant for short, text comments, +not arbitrary metadata; arbitrary metadata belongs in a +metadata stream (usually an XML stream type).<p> + +<h2>Comment use rationale</h2> + +The comment field is meant to be used much like someone jotting a +quick note on the bottom of a CDR. It should be a little information to +remember the disc by and explain it to others; a short, to-the-point +text note that need not only be a couple words, but isn't going to be +more than a short paragraph. The essentials, in other words, whatever +they turn out to be, eg: + +<blockquote> +"Honest Bob and the Factory-to-Dealer-Incentives, _I'm Still Around_, +opening for Moxy Fruvous, 1997" +</blockquote> + +<h2>Structure</h2> + +The comment header logically is a list of eight-bit-clean vectors; the +number of vectors is bounded to 2^32-1 and the length of each vector +is limited to 2^32-1 bytes. The vector length is encoded; the vector +is not null terminated. In addition to the vector list, there is a +single vector for vendor name (also 8 bit clean, length encoded in 32 +bits). Libvorbis currently sets the vendor string to "Xiphophorus +libVorbis I 20010119".<p> + +The comment vectors are structured similarly to a UNIX environment. +That is, comment fields consist of a field name and a field value and +look like: + +<pre> +comment[0]="ARTIST=me"; +comment[1]="TITLE=the sound of vorbis"; +</pre> + +<h2>Content vector format</h2> + +<ul> +<li>A case-insensitive field name that may consist of ASCII 0x20 through +0x7D, 0x3D ('=') excluded. ASCII 0x41 through 0x5A inclusive (A-Z) is +to be considered equivalent to ASCII 0x61 through 0x7A inclusive +(a-z). + +<li>The field name is immediately followed by ASCII 0x3D ('='); this +equals sign is used to terminate the field name. + +<li>0x3D is followed by 8 bit clean UTF-8 field contents to the end of +the field. +</ul> + +<h3>Field names</h3> + +Below is a proposed, minimal list of standard filed names with a +description of intended use. No single or group of field names is +mandatory; a comment header may contain one, all or none of the names +in this list. +<dl> +<dt>TITLE<dd>Track name + +<dt>VERSION<dd>The version field may be used to differentiate multiple +version of the same track title in a single collection. (e.g. remix info) + +<dt>ALBUM<dd>The collection name to which this track belongs + +<dt>TRACKNUMBER<dd>The track number of this piece if part of a specific larger collection or album + +<dt>ARTIST<dd>Track performer + +<dt>ORGANIZATION<dd>Name of the organization producing the track (i.e. +the 'record label') + +<dt>DESCRIPTION<dd>A short text description of the contents + +<dt>GENRE<dd>A short text indication of music genre + +<dt>DATE<dd>Date the track was recorded + +<dt>LOCATION<dd>Location where track was recorded + +<dt>COPYRIGHT<dd>Copyright information + +<dt>ISRC<dd>ISRC number for the track; see <a href="http://www.ifpi.org/online/isrc_intro.html">the ISRC intro page</a> for more information on ISRC numbers. + +</dl> + +<h3>Implications</h3> +<ul> +<li> +Field names should not be 'internationalized'; this is a +concession to simplicity not an attempt to exclude the majority of +the world that doesn't speak English. Field *contents*, however, +are represented in UTF-8 to allow easy representation of any language. +<li> +We have the length of the entirety of the field and restrictions on +the field name so that the field name is bounded in a known way. Thus +we also have the length of the field contents. +<li> +Individual 'vendors' may use non-standard field names within +reason. The proper use of comment fields should be clear through +context at this point. Abuse will be discouraged. +<li> +There is no vendor-specific prefix to 'nonstandard' field names. +Vendors should make some effort to avoid arbitrarily polluting the +common namespace. +<li> +Field names are not required to be unique (occur once) within a +comment header. As an example, assume a track was recorded by three +well know artists; the following is permissible, and encouraged: +<pre> + ARTIST=Dizzy Gillespie + ARTIST=Sonny Rollins + ARTIST=Sonny Stitt +</pre> + +</ul> + +<h2>Encoding</h2> + +The comment header comprises the entirety of the second bitstream +header packet. Unlike the first bitstream header packet, it is not +generally the only packet on the second page and may not be restricted +to within the second bitstream page. The length of the comment header +packet is [practically] unbounded. The comment header packet is not +optional; it must be present in the bitstream even if it is +effectively empty.<p> + +The comment header is encoded as follows (as per Ogg's standard +bitstream mapping which renders least-significant-bit of the word to be +coded into the least significant available bit of the current +bitstream octet first): + +<ol> +<li> +Vendor string length (32 bit unsigned quantity specifying number of octets) + +<li> +Vendor string ([vendor string length] octets coded from beginning of string to end of string, not null terminated) + +<li>Number of comment fields (32 bit unsigned quantity specifying number of fields) + +<li>Comment field 0 length (if [Number of comment fields]>0; 32 bit unsigned quantity specifying number of octets) + +<li> +Comment field 0 ([Comment field 0 length] octets coded from beginning of string to end of string, not null terminated) + +<li>Comment field 1 length (if [Number of comment fields]>1...)... +</ol> + +This is actually somewhat easier to describe in code; implementation of the above can be found in vorbis/lib/info.c:_vorbis_pack_comment(),_vorbis_unpack_comment() + +<hr> +<a href="http://www.xiph.org/"> +<img src="white-xifish.png" align=left border=0> +</a> +<font size=-2 color=#505050> + +Ogg is a <a href="http://www.xiph.org">Xiphophorus</a> effort to +protect essential tenets of Internet multimedia from corporate +hostage-taking; Open Source is the net's greatest tool to keep +everyone honest. See <a href="http://www.xiph.org/about.html">About +Xiphophorus</a> for details. +<p> + +Ogg Vorbis is the first Ogg audio CODEC. Anyone may +freely use and distribute the Ogg and Vorbis specification, +whether in a private, public or corporate capacity. However, +Xiphophorus and the Ogg project (xiph.org) reserve the right to set +the Ogg/Vorbis specification and certify specification compliance.<p> + +Xiphophorus's Vorbis software CODEC implementation is distributed +under the Lesser/Library GNU Public License. This does not restrict +third parties from distributing independent implementations of Vorbis +software under other licenses.<p> + +OggSquish, Vorbis, Xiphophorus and their logos are trademarks (tm) of +<a href="http://www.xiph.org/">Xiphophorus</a>. These pages are +copyright (C) 1994-2000 Xiphophorus. All rights reserved.<p> + +</body> + diff --git a/doc/vorbis/white-ogg.png b/doc/vorbis/white-ogg.png Binary files differnew file mode 100755 index 0000000..45dc0ac --- /dev/null +++ b/doc/vorbis/white-ogg.png |
