Manipuler les tags des fichiers Ogg et FLAC

Les tags des fichiers Ogg (Vorbis, FLAC et Speex), ainsi que des fichiers FLAC natifs sont stockés au format Vorbis Comment. Les spécifications(1) de ce format sont disponibles iciSpécifications du format Vorbis Comment. Chaque tag au format Vorbis Comment est composé d'une paire clef-valeur sous la forme "TAG_NAME=Tag Value". La clef est une chaîne de caractère codée en ASCII (à l'exception du caractère "=", exclu car il sert à délimiter le nom du tag de sa valeur) et insensible à la casse (même si le nom du tag est souvent formaté en majuscule par convention). La valeur du tag est une chaîne de caractère codée en UTF8.

Le format Vorbis Comment définit quinze tags standards :

Au-delà de ces tags standards, tout tag arbitraire peut bien évidemment être ajouté. Le risque étant que les lecteurs audio ne sachent comment interpréter ces tags non standards.

Les tags Vorbis Comment peuvent être définis un nombre de fois illimité. Par exemple, il est tout à fait possible de définir plusieurs fois le tag ARTIST : "ARTIST=John Lennon" et "ARTIST=Paul McCartney".

Le standard Vorbis Comment ne prévoit pas le stockage de contenu autre que textuel. Ceci est problématique pour le stockage de contenu binaire comme les images.

Le développeur du codec FLAC ayant souhaité ajouter le support des images dans son format, il a prévu la possibilité d'ajouter un "bloc image" comparable à la frame APICSpécifications id3v2.4 du standard ID3v2 du format MP3.

Le constructeur des classes OggTagger et FlacTagger prend en paramètre une chaîne de caractère correspondant au chemin du fichier. Les tags du fichier sont alors immédiatement lus.

Il est possible de forcer la lecture des tags d'un autre fichier sans avoir à instancier un nouvel objet en utilisant la méthode ReadMetadata.

OggTagger ogg = new OggTagger(@"C:\Song.ogg");
ogg.ReadMetadata(@"C:\Song2.ogg");

Les tags sont stockés dans un objet de type SortedList<string, List<string>> pour gérer les tags multiples. Il est possible de récupérer l'intégralité des tags du fichier avec la méthode GetAllTags.

string artist = ogg.Artist; // == tags["ARTIST"][0] || null
ReadOnlyCollection<string> artists = tags["ARTIST"];
ogg.Title = "My Immortal";
ogg.AddTag("LYRICS", "I am singing in the rain...");
ogg.SetTag("LYRICS", "I am not singing in the rain...");
ogg.RemoveTag("LYRICS");

Pour enregistrer les tags dans le fichier, il suffit d'appeler la méthode SaveMetadata.

ogg.SaveMetadata();

Les tags "images" ne sont prises en charge que dans les fichiers Ogg FLAC ou FLAC natifs. Les images sont encapsulées dans des objets de type System.Windows.Media.Imaging.BitmapFrame (classe disponible dans l'assemblage PresentationCore.dll de l'API WPF).

OggTagger ogg = new OggTagger(@"C:\SongFLAC.ogg");
Collection<ID3PictureFrame> arts = ogg.FlacArts; 
BitmapFrame cover = null;
foreach (ID3PictureFrame picture in arts)
{
	if (picture.PictureType == ID3PictureType.FrontCover)
		cover = picture.Picture;
}

La librairie ne se limite pas à l'accès aux tags mais permet de récupérer de nombreuses informations techniques sur les fichiers.

Voici la liste des informations auxquelles la classe OggTagger permet d'accéder :

Voici la liste des informations auxquelles la classe FlacTagger permet d'accéder :

Les tags Vorbis Comment sont enregistrés au début du fichier ce qui suppose la réécriture complète du fichier en cas de modification. Toutefois, les développeurs du format FLAC ont prévu la possibilité d'insérer un bloc "padding" au début de fichier pour servir de variable d'ajustement pour l'écriture des métadonnées. Ainsi, ce bloc peut être réduit pour laisser plus de place aux tags ou au contraire agrandit pour prendre la place des tags supprimés. Il est alors possible d'éviter la longue reconstruction du fichier, très lente dans le cas du FLAC, un format de compression sans perte dont les fichiers font souvent plusieurs dizaines de mégaoctets par morceaux.

La librairie gère le bloc "padding". Par défaut, ce bloc servira donc autant que faire se peut de variable d'ajustement pour accélérer la sauvegarde des modifications sur les tags. Il est toutefois possible de placer la propriété OptimizeFileSizeWhenSaving à vraie, ce qui aura pour effet de mettre la taille du bloc "padding" à 0 et de récupérer l'espace disque éventuellement laissé vacant par la suppression des tags.

Lorsque que la reconstruction du fichier est nécessaire parce que la taille du bloc "padding" n'est pas suffisante pour enregistrer les tags, ou lorsque la propriété OptimizeFileSizeWhenSaving est vraie, le développeur a la possibilité d'indiquer la taille du bloc "padding" qu'il souhaite voir insérer dans le fichier à l'occasion de sa reconstruction. Pour cela, il convient de définir la propriété DesiredPaddingSize (la valeur par défaut est fixée à 4 Ko).