-TAGOMAC-

Tag your music files to organize your music database

Téléchargement / Downloads

Manuel utilisateur

1. Description de l’application

Cette application permet de « tagguer » des fichiers mp3 contenus sur un disque dur ou sur une clé USB. Les tags sont des informations accompagnant un morceau de musique, comportant le nom de l’auteur, le nom de l’album, … Cette application permet de réécrire ces méta-informations afin d’ordonner plus clairement les fichiers MP3 dans son lecteur. En effet, les lecteurs MP3 évolués, tels que les iPod (Apple), n’utilisent plus les noms de fichiers afin d’effectuer leur classement, mais utilisent les informations contenues dans les ID3Tag afin de classer les musiques par auteur, par album, par genre, …

2. Qu’est-ce qu’un Tag/ID3Tag

Comme nous l’avons vu précédemment, les ID3Tag permettent de contenir des informations autres que sonores dans un fichier MP3. Le standard des ID3Tag défini tous les champs possibles d’informations, mais cette application ne s’intéresse qu’à certains d’entre eux. Voici les informations que peuvent contenir un tag d’un fichier MP3 après être passé dans ce logiciel :

· Nom de la piste

· Nom de l’album

· Nom de l’auteur

· Genre

· Année

· Numéro de piste

· Pochette.

Nous voyons ici que tous les premiers champs sont des champs « texte » et que le dernier est une image. Effectivement, les ID3Tag peuvent contenir d’autres types d’informations que des simples champs textuels.

A la base, il existait une version des ID3Tag (ID3v1) qui était assez pauvre en terme de conteneurs. Cette version a été rapidement remplacée par la version ID3-v2 (avec plusieurs déclinaisons), et ce logiciel supporte les ID3-v2.3. Lorsqu’un fichier MP3 est taggué avec ce logiciel, il « épure » le tag afin de ne garder que les informations nécessaires (celles précitées). Si aucun tag ID3-v2 n’existe, mais qu’un ID3v1 est présent, un tag ID3-v2 est créé dans le fichier à partir des informations contenues dans le ID3-v1.

3. Utilisation du logiciel

3.1. Description globale

Tout le développement de ce logiciel a été axé sur la simplicité d’utilisation, et sur la rapidité à retrouver les informations importantes.

Aussi, une contrainte était la possibilité de faire fonctionner l’application en « Stand-Alone », à savoir sans avoir à effectuer une installation du logiciel. Une simple copie du loficiel sur le disque dur permet de le faire fonctionner, et aucun fichier annexe n’est utile.

Voici une copie d’écran du logiciel.

Sur la gauche, on voit une arborescence de dossiers. Ce sont les différents dossiers présents sur le disque dur, à partir de dossier donné en bas de l’interface.

En haut à droite, on trouve les différents panneaux permettant de tagguer.

En bas à droite, on trouve la liste des fichiers MP3 présents dans le répertoire sélectionné.

3.2. Choix des fichiers à tagguer

3.2.1. Choix du répertoire de base

Dans un tout premier temps, il faut sélectionner le répertoire contenant un album ou un ensemble d’albums. Pour ceci, il faut cliquer sur le bouton parcourir, sélectionner le dossier, et cliquer sur « Ouvrir » ou « Choisir » selon le système d’exploitation. Une fois le répertoire sélectionné, l’arborescence des dossiers est remplie, et on peut sélectionner un ou plusieurs albums.

La boîte à cocher « récursif » sert à afficher les fichiers MP3 des sous-répertoires de celui sélectionné.

3.2.2. Sélection des MP3

Lorsqu’un album est choisi dans l’arborescence, la liste des fichiers MP3 du répertoire se remplit, et il est possible d’en sélectionner un ou plusieurs. A ce moment là, on trouve les informations communes à tous les fichiers sélectionné sur le panneau « Editeur de tags ».

3.3. Tagguer un ou plusieurs fichiers

Une fois qu’un ou plusieurs fichiers sont sélectionnés, il est possible de mettre à jour les informations ID3-Tag. Par exemple, si on veut mettre à jour l’information « Genre » à jour, il suffit de sélectionner les fichiers pour lesquels on veut modifier les genres, et ticker la boîte à cocher « Genre », en ayant rempli le champ tel qu’on le désire. A ce moment-là, une simple pression sur le bouton « Tag » permet de mettre à jour le genre de toutes les musiques.

Si on veut changer la pochette de l’album, à partir d’une image contenue sur le disque dur, il suffit de sélectionner les fichiers à modifier, de faire glisser l’image depuis l’explorateur de fichiers vers l’espace dédié à la pochette du disque, de tiquer la boîte à cocher « Pochette », et d’appuyer sur le bouton « Tag ».

3.4. Renommer des fichiers selon les informations contenues dans les tags

Parfois, les fichiers du disque dur n’ont pas un nom correspondant à une piste d’un album (par exemple, après l’encodage d’un CD, on peut avoir des fichiers nommés Track01.mp3, track02.mp3, …). Pour résoudre ce problème, la fonction « Renommer les fichiers » permet de renommer les fichiers à partir des informations contenues dans les ID3-Tags.

Pour se faire, sélectionner les fichiers à renommer dans la liste des fichiers MP3, puis activer le panneau « Renommer les fichiers ». Un champ de texte est prévu pour l’utilisateur, afin qu’il indique la règle de nommage des fichiers.

Exemple : un fichier dont l’auteur est AAA, et dont le numéro de piste est 03 pourra être renommé "03 – AAA.mp3" en donnant la règle "%6 - %1.mp3".

Un espace de simulation montre le résultat du renommage des fichiers. Si les fichiers peuvent être renommés, alors « OK » s’inscrit sur le panneau. Le cas où les fichiers ne pourraient pas êtres renommés est le suivant : on cherche à appeler plusieurs fois des fichiers par le même nom.

Il suffit alors d’appuyer sur le bouton « Renommer » et les modifications sont prises en compte.

3.5. Tagguer des fichiers depuis leur nom

Une autre situation classique est la suivante. On cherche à tagguer un ensemble de fichiers, dont le nom contient des informations sur l’album. Ce logiciel permet de tagguer le mp3 à partir d’informations contenues dans le nom du fichier. Pour ceci, il faut activer le panneau « Tagguer depuis les noms ».

Tout comme pour le renommage des fichiers, un champ est prévu pour l’utilisateur afin qu’il indique comment est composé le nom des fichiers.

Exemple : sur un album, les fichiers se nomment « 01 – Nina Simone – Ne me quitte pas.mp3, 02 – Pixies – Santo.mp3, … ». On remarque que le nom de chaque fichier est composé du numéro de piste, de l’auteur et du titre. Pour tagguer à partir des noms, il faut alors écrire dans le champ prévu à cet effet : « %6 - %3 - %1.mp3 ». Un espace de simulation donne le résultat des tags. Il faut alors appuyer sur le bouton « tag » et les modifications seront prises en compte.

3.6. Tagguer des fichiers depuis des informations contenues sur le site Amazon

Dernière méthode supportée par ce logiciel : tagguer des fichiers depuis des informations récupérées sur le site d’Amazon.

En sélectionnant un groupe de fichiers (typiquement, un album), on peut rechercher ses tags sur le site d’Amazon en remplissant le champ « Artiste » et/ou le champ « Album ». Ensuite, il faut lancer la recherche avec le bouton chercher. Les 10 premiers résultats de la recherche sont donnés dans la liste, et pour avoir les dix résultats suivants il suffit de cliquer sur suivant. Lorsque l’utilisateur trouve son bonheur, il suffit de double cliquer sur l’album choisi. Un panneau « tag » s’active alors. On peut choisir de tagguer différents champs avec les boîtes à cocher. Le bouton « tag » permet de prendre en compte les modifications.

La recherche sur Amazon peut prendre un peu de temps, selon le type de connexion à Internet. Une barre de progression au bas de l’application indique si la recherche est en cours ou non.

4. Bug connus

Ce logiciel est en version Bêta, et n’a été testé que par son développeur. Il n’y a pas encore de base de donnée regroupant les bugs.

Retour vers le menu

User Manual

1. Software description

This software allows you to tag mp3 files, present on your hard drive or your USB key. Tags are some information that goes with a music track. Tags may contains artist name, album name, … This program gives the possibility to write those meta-information in order to sort clearly MP3 files. For example, MP3 players, like iPod (from Apple California) don’t use filenames anymore, but use information contained in ID3Tags. This allows the player sorting songs by album, by author, by genre, …

2. What is a Tag / ID3Tag ?

As we saw it in precedent chapter, ID3Tag are a part of MP3 file that contains information about the track, but not sound. The standard defines all the possible fields of this container, but this software manages only some of them. Here is the list of managed information:

· Track name

· Album name

· Author/Artist

· Genre

· Year

· Track number,

· Cover

We can see here that all first fields are text fiels, and the last is a picture. ID3Tags may contain other information than text.

At the beginning, the first version of ID3Tag (ID3-v1) was a bit poor, because of the number of information that it could contain. This ID3-v1 has rapidly been replaced by ID3-v2 (with many subversions). This software manages ID3-v2 tags.

When an MP3 file is tagged with this program, it « cleans » the tag, in order to keep only necessary information (the ones aforesaid). If no ID3-v2 tag exists, but an ID3-v1 is present in the file, the ID3-v1 is converted in ID3-v2.

3. Software utilisation

3.1. Global description

All the development of this software has been based on the utilisation facility. The second constraint was the possibility to use this software in stand alone mode, without any software installation.

Here is a shotscreen.

On the left, we see a folder tree. Each folder is present on the hard drive, from the root given at the panel bottom.

The right part is divided in two : the top one is a container of different taggers, the bottom one is the list of Mp3Files found in the selected folder.

3.2. Files to tag

3.2.1. Root directory selection

In a first time, it’s requested to select the « root » directory, the one containing one or several albums. For this, click the « Browse » button, select your root folder, and click « Open » or « Choose » button, according to your operating system. Once it has been done, you can select each folder of the tree. « Recursive » checkbox allows the application to get subfolders music.

3.2.2. Music selection

When an album is chosen in the tree, the list of Mp3 files is filled. It is possible to select one ore several files, by selecting them maintaining « Ctrl » or « Apple » key, according to your computer. If the “Tag Editor” panel is selected and that you’ve selected many files, all common parts of the tag will appear in the panel.

3.3. Tagging one or many files

Once files has been selected, it is possible to update ID3-Tags. For example, if you want to update the “Genre” of several files, select them, go on the “Tag Editor” panel, tick the “Genre” checkbox, and click on “Tag” button.

Also, if you want to update the cover, to store it in the Mp3 file, just drag and drop a file from your hard drive on the cover part, tick the “Cover” checkbox, and click on “Tag”.

3.4. Renaming file from ID3Tag information

Sometimes, hard drive files are not named with an explicit name, and it’s preferable to rename them with some information contained in tags (example, files are names “Track 01.mp3”, … ). To solve this problem, the “Rename Files” panel allows you to rename files from tag information, and from a naming rule.

Example: imagine a music file containing a tag track name “toto”, and a tag track number “03”. This file is named “Track 03.mp3”. By using a rule “%6 - %1.mp3”, you’ll rename file as “03 – toto.mp3”.

A simulation space is here to check that there are no multiple files that would be renamed with the same name in a folder (which is forbidden by the operating system).

3.5. Tagging file from their names

Another classical situation is the following. Files are correctly named on the hard drive, but don’t contain any ID3 tags. This software offers the possibility to extract information from filename, and store that information into ID3v2 tags.

As for the file renaming, a text field is present for the user to give the construction rule of the filename.

For example, on an album, files are named “01 – Nina Simone – Ne me quitte pas.mp3”, “02 – Pixies – Santo.mp3”, … We can see that filenames are composed of the track number, the artist name, and the track name. In order to tag from filenames, user must activate the file renamer panel, to describe “%6 - %3 - %1.mp3” (%6 for track number, %3 for artist name, %1 for track name). A simulation list shows how files will be tagged. A simple click on the tag button will tag all selected files.

3.6. Tagging files from Amazon database

Last feature of this software is the possibility to tag files from Amazon Web Site research.

By selecting a group of files, and indicating the artist and/or the album name, it is possible to search over Amazon database. The search button will provides ten first results. Search Next button will provides 10 next results. Once the album has been found on the database, just double click on the album in the presentation list, and the second panel will be displayed. Like for other parts of this software, user can choose the part of the tag to write. Also, if some information is incorrect, any part of the list can be edited and modified.

4. Known bugs

For the moment, this application is under Beta version, and has been tested only by its developer. There isn’t bug tracker yet. But a lot of bugs are present ;)

Return to menu

Licence

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

* Neither the name of the Tagomac nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY Thomas Le Dall ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This software uses jid3lib-0.5.4 library, developed by Eric Farng.