{{tag>audio}}
 
====== id3v2 ======
 
**id3v2** est un [[:tagueurs_audio|éditeur de tags id3v2]] (balises ou métadonnées normalisées [[http://id3.org|site]]) pour les fichiers audio mp3, ogg, etc.

**id3v2** est un outil qui s'utilise en ligne de commande et est basé sur la librairie //id3lib//.
 
===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
 
===== Installation =====
 
Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquets]] **[[apt>id3v2]]**.
 
===== Configuration =====
 
Pas de configuration nécessaire.
 
===== Utilisation =====

Lancez l'application via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
<code>id3v2 [ OPTION ] [ FICHIER ]</code>

==== Utilisation basique : voir tous les tags existants ====

La commande ''-l'' permet de lister l'ensemble des tags du fichier :
<code>id3v2 -l musique.mp3</code>

Le résultat obtenu correspond à ce type d'affichage :
<code>id3v1 tag info for /home/utilisateur/Musique/musique.mp3:
Title  : Titre du morceau			Artist: Nom de l'artiste                       
Album  :  Nom de l'album			Year: année, Genre: genre du morceau (entre parenthèse code du genre)
Comment: commentaire			Track: 1 numéro de piste
id3v1 tag info for /home/utilisateur/Musique/musique.mp3:
COMM (Comments): ()[eng]: commentaire
TIT2 (Title/songname/content description): Titre/nom du morceau/description du contenu
TRCK (Track number/Position in set): 1 numéro de piste
TYER (Year): année
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
TPUB (Publisher): éditeur (ou producteur ?)
TCON (Content type): genre du morceau (entre parenthèse code du genre)
TALB (Album/Movie/Show title): Album/Film/Affichage du titre
TPE2 (Band/orchestra/accompaniment): Groupe/Orchestre/Accompagnement
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
PRIV (Private frame):  (unimplemented)
TCOM (Composer): Nom du ou des compositeurs
TPE1 (Lead performer(s)/Soloist(s)): Principal interprète/Soliste
</code>

==== Afficher une balise particulière ====

id3v2 ne semble pas calibré pour afficher les informations d'une seule balise. Un filtrage avec grep et cut est donc proposé.

=== Nom de l'artiste ===
Pour afficher uniquement le nom de l'artiste, utilisez la combinaison des commandes suivantes :
<code>id3v2 -l | grep Artist | cut -d: -f3 | cut -d' ' -f2</code>
<note>Ce filtre a été réalisé en partant du principe que le titre du morceau est renseigné. En cas de résultat bizarre ou inexistant, essayez de remplacer -f3 par -f2 ou bien de se contenter de grep Artist.
Si grep Artist est vide, le tag n'est pas renseigné.</note>

=== Titre du morceau ===
La commande est plus compliquée mais peut être utile dans un script :
<code>regex="^(Title[ ]*:[ ]*)(.*)([ ]*Artist)(.)"; texte=$(id3v2 -l musique.mp3 | grep Title); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[2]}"; fi;</code>

La commande suivante affichera le titre aussi, mais également tout le contenu de la ligne :
<code>id3v2 -l musique.mp3 | grep Title
Title  : Le titre du morceau               Artist: Nom de l'artiste
</code>

=== Nom de l'album ===
Sur le même modèle :
<code>regex="^(Album[ ]*:[ ]*)(.*)([ ]*Year)(.)"; texte=$(id3v2 -l musique.mp3 | grep Album); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[2]}"; fi;</code>
et :
<code>id3v2 -l musique.mp3 | grep Album</code>

=== Année ==

<code>regex="^(Album[ ]*:[ ]*)(.*)([ ]*Year[ ]*:[ ]*)(.*)(,.*)"; texte=$(id3v2 -l musique.mp3 | grep Album); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[4]}"; fi;</code>
et :
<code>id3v2 -l musique.mp3 | grep Year</code>

=== Genre ===
<code>regex="^(Album[ ]*:[ ]*)(.*)([ ]*Genre[ ]*:[ ]*)(.*)"; texte=$(id3v2 -l musique.mp3 | grep Genre); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[4]}"; fi;</code>
et :
<code>id3v2 -l musique.mp3 | grep Genre</code>

La commande suivante permet d'obtenir uniquement le nom du genre :
<code>regex="^(Album[ ]*:[ ]*)(.*)([ ]*Genre[ ]*:[ ]*)(.*)([ ]*\()"; texte=$(id3v2 -l musique.mp3 | grep Genre); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[4]}"; fi;</code>
et celle-ci son numéro :
<code>regex="^(Album[ ]*:[ ]*)(.*)([ ]*Genre[ ]*:[ ]*)(.*)([ ]*\()([0-9]*)(\))"; texte=$(id3v2 -l musique.mp3 | grep Genre); if [[ "$texte" =~ $regex ]]; then echo "${BASH_REMATCH[4]}"; fi;</code>

=== Commentaire ===
<code>id3v2 -l musique.mp3 | grep Comment | cut -d: -f2</code>

==== Informations utiles ====

La liste de l'ensemble des balises id3v2 qu'il est possible de traiter avec l'utilitaire est disponible avec l'option -f.
<code>id3v2 -f</code>

La liste des genres, avec le numéro associé s'affiche en utilisant l'option -L.
<code>id3v2 -L</code>

==== Insertion de balises (tags) ====

=== Insertion des balises les plus courantes ===

Pour les balises les plus courantes, une option simple est prévue.

== Artiste ==

L'option ''-a'' suivie du texte à insérer entre guillemets doubles permet de saisir le nom de l'artiste :
<code>id3v2 -a "Nom de l'artiste" musique.mp3</code>
ou (saisie alternative)
<code>id3v2 --artist "Nom de l'artiste" musique.mp3</code>

== Nom de l'album ==

Option ''-A'' ou ''%%--%%album''.

== Titre ou nom du morceau ==

Option ''-t'' ou ''%%--%%song''.

== Commentaire ==

Option ''-c'' ou ''%%--%%comment''.

Selon le manuel du logiciel, le format suggéré est le suivant :
''"DESCRIPTION":"COMMENTAIRE":"LANGUE" ''

Exemple :
<code>id3v2 -c "Version instrumentale":"Top du top":"en_EN"</code>

== Genre ==

La saisie du genre se fait par son numéro. L'option à saisir est ''-g'' ou ''%%--%%genre''.
<note tip>Rappel : l'option -L permet d'obtenir la liste des genres et les codes associés.<code>id3v2 -L</code></note>
Exemple pour une chanson Rock :
<code>id3v2 -g 17 musique.mp3</code>

== Année ==

Option ''-y'' ou ''%%--%%year''.

== Numéro de piste ==

Option ''-T'' ou ''%%--%%track''.

La syntaxe suggérées consiste à saisir le numéro de piste, optionnellement suivi du nombre total de pistes.
<code>id3v2 -g 5/17 musique.mp3</code>

=== Autres balises (tags) ===

Les autres balises sont fixées par l'appel à un code en 4 lettres précédé d'un double tiret ''%%--%%''.

<note tip>Rappel : l'option ''-f'' permet d'obtenir la liste des codes de balises.<code>id3v2 -f</code></note>

Exemple :
<code>id3v2 --TPUB "Le producteur" musique.mp3</code>
 
===== Désinstallation =====
 
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
 
===== Voir aussi =====
 
  * **(en)** [[https://id3v2.sourceforge.net/|Site officiel du logiciel]]

----
//Contributeurs : zococo, ...//