kid3-core - En ligne dans le Cloud

PROGRAMME:

Nom

kid3, kid3-qt, kid3-cli - Étiqueteur Kid3 ID3

SYNOPSIS

kid3 [--Aidez-moi | --help-qt | --help-kde | --aide-à tous
|--auteur | --version | --Licence] [DOSSIER...]

enfant3-qt [Options Qt] [DOSSIER...]

kid3-cli [-h | --Aidez-moi] [-c COMMANDE1] [-c COMMANDE2...] [DOSSIER...]

OPTIONS

DOSSIER
If DOSSIER est le chemin d'accès à un répertoire, il sera ouvert. Si un ou plusieurs chemins de fichiers sont
donné, leur répertoire commun est ouvert et les fichiers sont sélectionnés.

kid3
--Aidez-moi
Afficher l'aide sur les options.

--help-qt
Afficher les options spécifiques à Qt, voir qtoptions (7).

--help-kde
Afficher les options spécifiques à KDE, voir kdeoptions (7).

--aide-à tous
Afficher toutes les options.

--auteur
Afficher les informations sur l'auteur.

--version
Afficher les informations sur la version.

--Licence
Afficher les informations de licence.

enfant3-qt
Options Qt
See qtoptions(7), cependant, les options ont "-" comme préfixe, pas "--".

kid3-cli
-c
Exécutez une commande. Plusieurs -c options sont possibles, elles sont exécutées en séquence.
Voir la section sur kid3-cli pour une description des commandes disponibles.

-h|--Aidez-moi
Afficher l'aide sur les options et les commandes.

INTRODUCTION

Kid3 est une application pour éditer les tags ID3v1 et ID3v2 dans les fichiers MP3 de manière efficace.
Ces balises peuvent être éditées par la plupart des lecteurs MP3, mais pas de manière très confortable et efficace.
manière. De plus les tags en Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex,
Les fichiers TrueAudio, WavPack, WMA, WAV, AIFF et les modules de suivi (MOD, S3M, IT, XM) sont
pris en charge aussi.

Kid3 ne récupère ni n'encode les fichiers MP3, mais il est destiné à éditer les balises ID3 de tous
fichiers d'un album de manière efficace, c'est-à-dire avec aussi peu de clics de souris et de frappes que
possible. Là où la plupart des autres programmes peuvent éditer les balises ID3v1 ou ID3v2, Kid3 a plein
contrôle sur les deux versions, peut convertir les balises entre les deux formats et a accès à tous
Balises ID3v2. Les balises de plusieurs fichiers peuvent être définies sur la même valeur, par exemple l'artiste, l'album,
l'année et le genre de tous les fichiers d'un album ont généralement les mêmes valeurs et peuvent être définis
ensemble. Si les informations pour les balises sont contenues dans le nom du fichier, les balises peuvent être
défini automatiquement à partir du nom du fichier. Il est également possible de définir le nom du fichier en fonction
aux balises trouvées dans le fichier dans des formats arbitraires.

La tâche d'édition est en outre prise en charge par le remplacement automatique des caractères ou
sous-chaînes, par exemple pour supprimer les caractères illégaux des noms de fichiers. Contrôle automatique de
les caractères majuscules et minuscules facilitent l'utilisation d'un schéma de nommage cohérent dans tous les
Mots clés.

Les informations de balise pour les albums complets peuvent être extraites de gnudb.org[1] TrackType.org[2]
MusicBrainz[3] Discogs[4] Amazon[5] ou d'autres sources de listes de pistes. Le format d'importation
est librement configurable par des expressions régulières.

Veuillez signaler tout problème ou demande de fonctionnalité à l'auteur.

EN UTILISANT KID3

Kid3 Caractéristiques
· Modifier les balises ID3v1.1

· Modifier tous les cadres ID3v2.3 et ID3v2.4

· Modifier les balises de plusieurs fichiers

· Convertir entre les balises ID3v1 et ID3v2

· Éditer MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio,
Balises WavPack, WMA, WAV et AIFF

· Générer des balises à partir du nom de fichier

· Générer des balises à partir du contenu des champs de balise

· Générer un nom de fichier à partir de balises

· Générer et modifier les noms de répertoire à partir de balises

· Générer un fichier de liste de lecture

· Conversion de casse automatique et traduction de chaîne

· Importer de gnudb.org[1] TrackType.org[2] MusicBrainz[3] Discogs[4] Amazon[5] et
autres sources de données

· Exporter au format CSV, HTML, liste de lecture, Kover XML et d'autres formats. Les fichiers CSV exportés peuvent être
importé à nouveau.

Exemple Utilisation
Cette section décrit une session type avec Kid3. Supposons que nous ayons un répertoire
contenant des fichiers MP3 avec les morceaux de l'album "Let's Tag" du groupe "One Hit
Wonder". Le répertoire est nommé au format "artiste - album", dans notre cas One Hit Wonder
- Let's Tag. Le répertoire contient les pistes au format "titre de la piste.mp3", que j'ai
penser est utile car les noms de fichiers sont courts (important lors de l'utilisation de lecteurs MP3 mobiles
avec de petits affichages) et dans le bon ordre lorsqu'ils sont triés par ordre alphabétique (important lorsque
en utilisant des lecteurs MP3 matériels qui lisent les pistes par ordre alphabétique ou dans l'ordre
lequel ils sont gravés sur CD et cet ordre est alphabétique lors de l'utilisation mkisofs). outre
cela, les informations sur l'artiste et l'album sont déjà dans le nom du répertoire et n'ont pas
à répéter dans le nom du fichier. Mais revenons à notre exemple, la liste des répertoires ressemble à
ce:

01 Introduction.mp3

02 Nous n'avons que celui-ci.mp3

03 Outro.mp3

Ces fichiers n'ont pas encore de balises et nous souhaitons les générer à l'aide de Kid3. Nous utilisons Open (Fichier
menu ou barre d'outils) et sélectionnez l'un des fichiers de ce répertoire. Tous les fichiers seront
affiché dans la liste de fichiers. Paresseux comme nous sommes, nous voulons utiliser les informations dans le
répertoire et noms de fichiers pour générer des balises. Par conséquent, nous sélectionnons tous les fichiers, puis cliquez sur le
Bouton To:Tag 1 dans la section Fichier. Cela définira le titre, l'artiste, l'album et la piste
valeurs dans tous les fichiers. Pour définir les valeurs d'année et de genre de tous les fichiers, nous conservons tous les fichiers
sélectionné et tapez "2002" pour l'année et sélectionnez "Pop" dans la liste déroulante Genre. Mettre en place
seules ces deux valeurs, leurs cases à cocher sont automatiquement cochées et toutes les autres cases à cocher
sont laissés sans contrôle. Maintenant, nous modifions la sélection en sélectionnant uniquement le premier fichier et nous
voir que toutes les balises contiennent les valeurs correctes. Les tags des autres fichiers peuvent être vérifiés
aussi en les sélectionnant un par un. Lorsque nous sommes satisfaits des balises, nous utilisons Save (File
menu ou barre d'outils). La sélection de Créer une liste de lecture dans le menu Fichier générera un fichier Un
Hit Wonder - Let's Tag.m3u dans le répertoire.

COMMAND RÉFÉRENCE

La GUI Éléments
L'interface graphique de Kid3 est séparée en cinq sections : à gauche se trouvent le fichier et le répertoire
listboxes, le côté droit contient les sections Fichier, Balise 1 et Balise 2.

Déposez votre dernière attestation Liste
La liste des fichiers contient les noms de tous les fichiers du répertoire ouvert qui correspondent
le filtre de nom de fichier sélectionné (généralement *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Un seul ou
plusieurs fichiers peuvent être sélectionnés. Pour ne sélectionner aucun fichier, cliquez dans la zone vide après le
entrées de la liste. La sélection détermine les fichiers qui sont affectés par le
opérations disponibles à l'aide des touches décrites ci-dessous.

Outre le nom, d'autres colonnes Taille, Type, Date de modification avec les détails du fichier peuvent être
affiché. Les colonnes peuvent être masquées en décochant leur nom dans le menu contextuel du
en-tête de liste. L'ordre des colonnes peut être modifié par glisser-déposer. L'ordre de tri
peut être basculé en cliquant sur l'en-tête de colonne.

A gauche des noms une icône peut être affichée : un disque pour montrer que le fichier a
été modifié ou des informations sur les balises présentes (V1, V2, V1V2 ou NO TAG, non
s'affiche si le fichier n'a pas encore été lu).

Les répertoires sont affichés avec une icône de dossier. Si un répertoire est ouvert, ses fichiers sont
affiché dans une arborescence hiérarchique. En sélectionnant des fichiers dans des sous-répertoires, les opérations
peut être exécuté sur des fichiers dans des répertoires différents, ce qui est utile si la musique
collection est organisée avec un dossier pour chaque artiste contenant des dossiers pour les albums de
cet artiste.

Cliquer sur le bouton droit de la souris dans la liste des fichiers ouvre un menu contextuel avec le
commandes suivantes:

· Développer tout : Développe toutes les arborescences de dossiers (uniquement l'arborescence actuelle si la touche Maj est
pressé)

· Tout réduire : réduit toutes les arborescences de dossiers

· Renommer : Change le nom d'un fichier

· Déplacer vers la corbeille : déplace un fichier vers la corbeille

· Lecture : lit un fichier, voir Lecture

· Les entrées suivantes sont des commandes utilisateur, qui peuvent être définies dans les actions utilisateur
onglet de Configurer Kid3. La lecture sur double clic peut également y être activée.

Annuaire Liste
La liste des répertoires contient les noms des répertoires dans le répertoire ouvert, comme
ainsi que le répertoire courant (.) et le répertoire parent (..). Il permet de changer rapidement
le répertoire sans utiliser la commande Ouvrir... ou glisser-déposer.

La visibilité, l'ordre et le tri des colonnes peuvent être configurés comme décrit dans la section
à propos de la liste des fichiers.

Déposez votre dernière attestation
Affiche des informations sur l'encodage (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), débit binaire, fréquence d'échantillonnage, canaux et
la longueur du fichier.

L'édition de la ligne Nom contient le nom du fichier (si un seul fichier est sélectionné).
Si ce nom est modifié, le fichier sera renommé lors de l'utilisation de la commande Enregistrer.

La zone de liste déroulante Format et l'édition de ligne contiennent le format à utiliser lorsque le nom de fichier est
généré à partir de la première ou de la deuxième balise. Le nom de fichier peut contenir arbitrairement
caractères, même une partie de répertoire séparée par une barre oblique du nom de fichier, mais cela
répertoire doit déjà exister pour que le changement de nom réussisse. Les codes spéciaux suivants
sont utilisés pour insérer des valeurs de balise dans le nom de fichier :

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} Piste (par exemple 01)

· %t %{track.n} Piste avec une largeur de champ n (par exemple 001 pour %{track.3})

· %T %{tracknumber} Piste (sans zéros non significatifs, par exemple 1)

· %g %{genre} Genre

· %{ignore} Ignoré lors de la génération de balises à partir du nom de fichier

Les codes de format ne sont pas limités aux exemples donnés ci-dessus. Tout nom de cadre peut être
utilisé, par exemple les noms de trame unifiés comme %{bpm} ou formater des noms spécifiques comme
%{pop}.

Une seconde zone de liste déroulante Format (avec flèche vers le bas) permet de générer les balises à partir du
nom de fichier. Si le format du nom de fichier ne correspond pas à ce modèle, quelques autres
les formats couramment utilisés sont essayés.

Certains formats de nom de fichier couramment utilisés sont déjà disponibles dans la zone de liste déroulante, mais il est
également possible de saisir un format spécial dans l'édition de ligne.

From:Tag 1, Tag 2: Définit le nom de fichier en utilisant le format sélectionné et la première balise ou
la deuxième balise, respectivement.

To:Tag 1, Tag 2: Les tags sont définis à partir du nom de fichier. Premièrement, le format spécifié dans
Le format est utilisé. Si le nom de fichier existant ne correspond pas à ce format, les éléments suivants
les formats sont essayés :

· Artiste - Album/Piste Chanson

· Album/Piste - Artiste - Chanson

· /Artiste - Album - Piste - Chanson

· Album/Artiste - Piste - Chanson

· Album/Artiste - Chanson

· Artiste/Album/Piste Chanson

Si un seul fichier est sélectionné, les contrôles GUI sont remplis avec les valeurs extraites
à partir du nom de fichier. Si plusieurs fichiers sont sélectionnés, les balises des fichiers sont directement
défini en fonction des noms de fichiers.

Jour 1
Les widgets d'édition de ligne pour le titre, l'artiste, l'album, le commentaire, l'année, la piste et le genre sont
utilisé pour éditer la valeur correspondante dans la première balise des fichiers sélectionnés. La valeur
sera modifié lorsque la sélection de fichier est modifiée ou avant des opérations telles que Enregistrer et
Quitter et lorsque la case à cocher correspondante à gauche du nom du champ est cochée.
Ceci est utile pour ne changer que certaines valeurs et laisser les autres valeurs inchangées.

Si un seul fichier est sélectionné, toutes les cases à cocher sont cochées et les widgets d'édition de ligne
contiennent les valeurs trouvées dans les balises de ce fichier. Si une balise n'est pas trouvée dans le fichier,
la valeur vide correspondante est affichée, qui est une chaîne vide pour le Titre,
Modifications des lignes d'artiste, d'album et de commentaire, 0 pour les modifications numériques de l'année et de la piste et un
valeur sélectionnée vide pour la zone de liste déroulante Genre. Les valeurs peuvent être modifiées et si le
case à cocher correspondante est cochée, ils seront définis pour le fichier sélectionné après la
la sélection est modifiée. Le fichier est alors marqué comme modifié par un symbole de disque dans le fichier
listbox mais reste inchangé jusqu'à ce que la commande Enregistrer soit utilisée.

Si plusieurs fichiers sont sélectionnés, seules les valeurs identiques dans tous les fichiers sélectionnés
les fichiers sont affichés. Dans tous les autres contrôles, les valeurs vides décrites ci-dessus sont
affiché. Toutes les cases à cocher sont décochées pour éviter les modifications indésirables. Si une valeur doit
être défini pour tous les fichiers sélectionnés, il peut être modifié et la case à cocher doit être cochée. Les
les valeurs seront définies pour tous les fichiers sélectionnés lorsque la sélection est modifiée et peuvent être
enregistré à l'aide de la commande Enregistrer.

Les cases à cocher contrôlent également le fonctionnement de la plupart des commandes affectant les balises, telles que
comme copier, coller et transférer entre les balises 1 et 2. Pour le rendre plus facile à utiliser avec
plusieurs fichiers où toutes les cases à cocher sont décochées, ces commandes se comportent de la même
manière lorsque toutes les cases à cocher sont cochées et lorsque toutes les cases à cocher sont décochées.

De la balise 2 : Les champs de la balise 1 sont définis à partir des valeurs correspondantes de la balise 2. Si un
seul fichier est sélectionné, les commandes GUI sont remplies avec les valeurs de la balise 2. Si
plusieurs fichiers sont sélectionnés, les balises des fichiers sont directement définies.

Copie : le tampon de copie est rempli avec les valeurs de Tag 1. Seules les valeurs avec cochée
La case à cocher sera utilisée dans les commandes Coller suivantes.

Coller : colle les valeurs du tampon de copie dans les commandes de l'interface graphique.

Supprimer : cela définira tous les contrôles de l'interface graphique sur leurs valeurs vides, ce qui entraînera la suppression
toutes les valeurs. Le fichier enregistré ne contiendra alors aucune balise 1.

Jour 2
Les commandes de l'interface graphique fonctionnent de la même manière que celle décrite pour la section Tag 1, mais le
la taille des chaînes n'est pas limitée.

Pour le tag 2 Genre, vous pouvez également utiliser vos propres noms en plus des genres répertoriés dans le
zone de liste déroulante, tapez simplement le nom dans la ligne d'édition.

La balise 2 peut non seulement contenir les mêmes valeurs que la balise 1, le format est construit dans un
manière flexible à partir de plusieurs cadres eux-mêmes composés de plusieurs champs. Les
Le tableau tag 2 montre tous les cadres qui sont disponibles dans le fichier sélectionné.

Editer : Cela ouvrira une fenêtre qui permet d'éditer tous les champs du
Cadre. Si plusieurs fichiers sont sélectionnés, les champs modifiés sont appliqués à tous les fichiers sélectionnés
fichiers qui contiennent un tel cadre.

Ajouter : un demandeur pour sélectionner le type de cadre apparaîtra et un cadre du type sélectionné
peut être modifié et ajouté au fichier. Cela fonctionne également pour ajouter un cadre à plusieurs
fichiers sélectionnés.

Supprimer : supprime le cadre sélectionné dans les fichiers sélectionnés.

Faites glisser la pochette de l'album ici s'affiche si le fichier ne contient pas de pochette intégrée. UNE
l'image peut être ajoutée par glisser-déposer depuis un navigateur ou un gestionnaire de fichiers et sera
affiché ici. Les cadres photo peuvent être modifiés ou ajoutés en double-cliquant dessus
.

Synchronisé paroles ainsi que événement Temps de livraison Codes
Pour les informations synchronisées avec les données audio, un éditeur spécifique est disponible.
Ces cadres sont pris en charge pour les balises ID3v2.3.0 et ID3v2.4.0. Pour ajouter un tel cadre, le
un nom de cadre spécifique doit être sélectionné dans la liste qui apparaît lorsque le bouton Ajouter
est cliqué - Paroles synchronisées ou codes de synchronisation d'événement, respectivement. L'éditeur est
le même pour les deux types, pour les codes de chronométrage des événements, uniquement un ensemble prédéfini d'événements
est disponible alors que pour les paroles synchronisées, le texte doit être saisi. Dans le
Ensuite, l'édition des paroles synchronisées est expliquée.

Un fichier ayant une balise ID3v2 est sélectionné, l'éditeur de paroles est entré en utilisant Ajouter et
en sélectionnant Paroles synchronisées. Pour un cadre de paroles synchronisées existant, il est
sélectionné et sur Modifier est cliqué. Le lecteur s'ouvre automatiquement avec le fichier en cours
afin que le fichier puisse être lu et mis en pause pour synchroniser les paroles.

Les paramètres en haut de l'éditeur SYLT n'ont normalement pas besoin d'être modifiés. Si la
les paroles contiennent des caractères qui ne sont pas présents dans le jeu de caractères Latin 1,
il est conseillé de changer l'encodage du texte en UTF16 (ou UTF8 pour ID3v2.4.0). Pour l'anglais
paroles et compatibilité maximale, ISO-8859-1 doit être utilisé.

La section Paroles a cinq boutons en haut. Ajouter ajoutera un nouvel événement temporel dans le
table. Le temps est pris à partir de la position du joueur, ajoutant ainsi une entrée tout en
la lecture de la piste ajoutera une ligne pour la position actuellement jouée. Les événements dans le
le tableau doit être classé par ordre chronologique, donc la ligne sera insérée
par conséquent. Les entrées avec une heure invalide sont traitées spécialement : Si le
la ligne sélectionnée a une heure invalide, son horodatage sera remplacé par l'heure actuelle
au lieu d'ajouter une nouvelle ligne. Si l'heure actuelle n'est pas invalide, la première ligne avec un
l'heure invalide sera utilisée si elle est présente. Ce comportement devrait faciliter l'ajout de temps
tampons si le texte des paroles est déjà dans le tableau mais que les tampons horaires sont manquants
(ce qui est le cas lors de l'importation de paroles non synchronisées). Notez que l'heure invalide
est représenté par 00:00.00, c'est-à-dire le même que l'heure au début absolu de la
piste, qui n'est pas invalide. Pour rendre une heure invalide, appuyez sur la touche Suppr ou utilisez
Effacer à partir du menu contextuel. Nouvelles lignes insérées à l'aide de Insérer une ligne dans le menu contextuel
ou créé lors de l'importation de paroles non synchronisées avec From Clipboard ou Import également
contiennent des horodatages non valides. Les lignes du tableau peuvent être supprimées en cliquant sur le bouton Supprimer
ou en utilisant Supprimer les lignes dans le menu contextuel.

Les paroles synchronisées peuvent être importées à partir d'un fichier à l'aide d'Import. Le format attendu est
LRC simple ou amélioré. Si le fichier sélectionné ne contient pas de crochet dans le
première ligne, il est censé être un simple fichier texte avec des paroles non synchronisées. Les
les lignes d'un tel fichier sont alors importées avec des horodatages invalides. Le temps
des informations peuvent être ajoutées à l'aide du bouton Ajouter ou par saisie manuelle. Il est également possible
pour importer des paroles par copier-coller à l'aide du presse-papiers. Les paroles synchronisées peuvent être
écrit dans des fichiers LRC à l'aide d'Export. Notez que seules les entrées avec des horodatages valides seront
être exporté et que les entrées seront triées par heure. Entrées avec heure invalide
ne sera pas non plus stocké dans le cadre SYLT, alors assurez-vous d'inclure toutes les synchronisations
informations avant de quitter la boîte de dialogue.

La ID3 spécification[6] propose un horodatage pour chaque syllabe. Cependant, la plupart des joueurs
ne prennent en charge que la granularité d'une ligne ou d'une phrase. Pour prendre en charge les deux cas d'utilisation, Kid3
suit les mêmes conventions que Sylt Éditeur[7]. Texte entré dans le tableau
est supposé commencer une nouvelle ligne à moins qu'elle ne commence par un espace ou un tiret. Exceptions
à cette règle sont possibles en commençant une ligne avec un trait de soulignement ('_') pour forcer
continuation ou un signe dièse ("#") pour forcer une nouvelle ligne. Ces caractères d'échappement ne sont pas
stocké à l'intérieur du cadre SYLT. À l'intérieur du cadre SYLT, les nouvelles lignes commencent par un saut de ligne
caractère (hex 0A) alors que les suites ne le font pas. Lors de la lecture des trames SYLT, Kid3 vérifie
si la première entrée commence par un saut de ligne. Si ce n'est pas le cas, on suppose
que toutes les entrées sont des nouvelles lignes et qu'aucune continuation de syllabe n'est utilisée.

Pendant la lecture du morceau, la ligne associée à la position de lecture actuelle est
mis en évidence, afin que l'exactitude des informations de synchronisation puisse être
vérifié. Si un décalage doit être ajouté à un ou plusieurs horodatages, cela peut être
accompli avec le menu contextuel Ajouter un décalage. Des valeurs négatives peuvent être utilisées pour réduire
le temps. En utilisant Chercher pour positionner dans le menu contextuel, il est possible de régler le
position de lecture à l'heure de la ligne sélectionnée.

La Déposez votre dernière attestation Menu
Fichier → Ouvrir... (Ctrl+O)
Ouvre un répertoire. Tous les fichiers correspondant au filtre de nom de fichier sélectionné seront affichés
dans la liste de fichiers et le fichier choisi est sélectionné.

Fichier → Ouvrir récent
Ouvre un répertoire récemment ouvert.

Fichier → Ouvrir le répertoire... (Ctrl+D)
Ouvre un répertoire. Tous les fichiers correspondant au filtre de nom de fichier sélectionné seront affichés
dans la liste de fichiers.

Fichier → Enregistrer (Ctrl+S)
Enregistre tous les fichiers modifiés dans le répertoire. Les fichiers modifiés sont marqués d'un disque
symbole dans la liste de fichiers. Si des noms de fichiers ont été modifiés, ces fichiers seront
renommé.

Fichier → Rétablir
Annule les modifications d'un ou plusieurs fichiers. Si aucun fichier n'est sélectionné dans le fichier
listbox, les modifications de tous les fichiers seront annulées, sinon seules les modifications du
les fichiers sélectionnés sont rétablis.

Fichier → Importer ...
La boîte de dialogue Importer peut être utilisée pour importer des données directement depuis un serveur freedb.org, depuis un
Serveur MusicBrainz, de Discogs, Amazon ou d'autres sources de listes de pistes d'album dans
format textuel.

L'importation à partir d'un serveur freedb.org est possible à l'aide d'une boîte de dialogue qui apparaît lorsque De
Server:gnudb.org ou TrackType.org est sélectionné. L'artiste et le nom de l'album à rechercher
peuvent être saisis dans les deux champs du haut, les albums qui correspondent à la requête seront
affiché lorsque Rechercher est cliqué et les résultats de www.gnudb.org[8] sont reçus.
L'importation des données de piste d'un album se fait en double-cliquant sur l'album dans la
liste. Le serveur freedb.org à partir duquel importer peut être sélectionné ainsi que le chemin CGI.
Les données importées sont affichées dans le tableau d'aperçu de la boîte de dialogue d'importation. Lorsque
satisfait des pistes affichées, elles peuvent être importées en mettant fin à l'import
dialogue avec OK.

Une recherche sur le serveur Discogs peut être effectuée à l'aide de Discogs. Comme sur gnudb.org
boîte de dialogue, vous pouvez entrer l'artiste et l'album, puis choisir parmi une liste de versions. Si
Les balises standard sont marquées, les informations standard sont importées, par exemple l'artiste, l'album et
Titre. Si des balises supplémentaires sont cochées, plus d'informations sont importées si elles sont disponibles, par ex.
les artistes interprètes ou exécutants, les arrangeurs ou l'éditeur. Si la pochette est cochée, la pochette sera
téléchargé si disponible.

Une recherche sur Amazon peut être effectuée à l'aide d'Amazon. Comme dans la boîte de dialogue gnudb.org, vous pouvez
entrez l'artiste et l'album, puis choisissez parmi une liste de sorties. Si Balises supplémentaires est
marqué, plus d'informations sont importées si disponibles, par exemple les interprètes, les arrangeurs ou le
éditeur. Si la pochette est cochée, la pochette sera téléchargée si disponible.

Vous pouvez rechercher de la même manière dans la base de données des versions de MusicBrainz en utilisant From
Sortie MusicBrainz. Le flux de travail est le même que celui décrit pour From gnudb.org.

L'importation depuis un serveur MusicBrainz est possible à l'aide de la boîte de dialogue qui apparaît lorsque From
L'empreinte digitale MusicBrainz est sélectionnée. Le serveur peut être sélectionné comme dans la freedb
boîte de dialogue d'importation. Vous trouverez ci-dessous un tableau affichant les données de piste importées. La colonne de droite
montre l'état de la requête MusicBrainz, qui commence par "En attente" lorsque la boîte de dialogue
est ouvert. Ensuite, l'empreinte digitale est recherchée et si elle ne donne pas de résultat,
une autre recherche utilisant les balises dans le fichier est tentée. Ainsi, il peut être utile pour un
requête MusicBrainz réussie pour stocker des informations connues (par exemple, artiste et album) dans le
balises avant l'importation. Si un résultat a été trouvé, la recherche se termine dans l'état
"Reconnu", sinon rien n'a été trouvé ou plusieurs résultats ambigus et l'un des
elles doivent être sélectionnées par l'utilisateur. OK et Appliquer utilisent les données importées, Annuler
ferme la boîte de dialogue. La fermeture peut prendre un certain temps car toute la machinerie MusicBrainz
doit être fermé.

Pour l'import de données textuelles, From File/Clipboard ouvre une sous-boîte de dialogue, où plusieurs
des formats d'importation préconfigurés sont disponibles. Les deux premiers, "CSV non cités" et "CSV
quoted" peut être utilisé pour importer des données qui ont été exportées par la boîte de dialogue Exporter. Le fichier CSV
les données peuvent être modifiées avec une feuille de calcul et doivent être écrites en utilisant des tabulations comme délimiteurs.
L'import devrait alors être possible en utilisant "CSV quoted", qui est plus flexible que "CSV
sans guillemets". Cependant, ses champs ne peuvent pas contenir de guillemets doubles. Si vous exportez uniquement
de Kid3 et importer plus tard, "CSV sans guillemets" peut être utilisé comme format simple pour cela
but. Notez qu'il existe également des commandes "Exporter CSV" et "Importer CSV" dans le
menu contextuel de la liste de fichiers, qui utilise des scripts pour exporter et importer des données CSV dans un
manière plus complète, puissante et flexible.

Le format suivant, "freedb HTML text", peut être utilisé pour copier des informations à partir d'une page HTML
of freedb.org[9]. Recherchez un album dans freedb et si l'information souhaitée est
affiché dans le navigateur Web, copiez le contenu dans le presse-papiers. Cliquez ensuite sur le bouton De
Presse-papiers et les pistes importées seront affichées dans le tableau de prévisualisation à la
haut de la boîte de dialogue. Si vous êtes satisfait des données importées, fermez la boîte de dialogue
avec OK, qui insérera les données dans les balises du répertoire courant. Les
La destination (Tag 1, Tag 2 ou Tag 1 et Tag 2) peut être sélectionnée avec une zone de liste déroulante. Les
les fichiers dans le répertoire actuel doivent être dans le bon ordre de piste pour obtenir leurs balises
attribué. C'est le cas s'ils sont numérotés.

Le prochain format d'import préconfiguré, "freedb HTML source", peut être utilisé, si les données
est disponible sous forme de document HTML. L'importation est possible à l'aide du bouton À partir du fichier, qui
ouvre un sélecteur de fichier ou copie son contenu depuis un éditeur puis importe depuis
presse-papiers. Ce format peut être utile pour l'importation hors ligne, bien que le document HTML
pourrait également être ouvert dans un navigateur puis être importé dans le premier format via le
presse-papiers.

Des formats plus préconfigurés, par exemple "Track Title Time", sont disponibles. Une coutume vide
le format peut être créé avec Ajouter pour être défini par l'utilisateur. Deux lignes sous le nom du format
peut être défini avec une expression régulière pour capturer les champs du texte d'importation. Les
la première expression régulière sera analysée une fois par document pour collecter des données par album
tels que l'artiste, l'album, l'année et le genre. La deuxième ligne est tentée de correspondre à partir du
du début du document à la fin pour obtenir les données de la piste, généralement le numéro et le titre. Les
les expressions régulières incluent toutes les fonctionnalités offertes par Qt, qui est la plupart des
propose Perl. Les constructions de bracketing "(..)" créent des tampons de capture pour les champs à
import et sont précédés de codes spécifiques à Kid3 pour spécifier le champ à capturer. Les
les codes sont les mêmes que ceux utilisés pour le format du nom de fichier, en plus des codes listés ci-dessous,
n'importe quel nom de cadre est possible :

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} piste

· %g %{genre} Genre

· %d %{duration} Durée

Par exemple, une expression régulière de piste (deuxième ligne) à importer depuis une liste de lecture .m3u
peut être "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]". Tous les formats peuvent être modifiés
en modifiant les expressions régulières et le nom, puis en cliquant sur Enregistrer les paramètres. Ils
sera stocké dans le fichier kid3rc dans le répertoire de configuration. Ce fichier peut être
directement édité pour avoir plus de formats d'importation ou il peut être supprimé pour revenir au
format par défaut. Les formats peuvent être supprimés à l'aide de Supprimer.

La précision montre une estimation de la qualité des informations importées correspondant aux données
des pistes. Il utilise des durées de piste ou des noms de fichiers pour calculer le niveau de similitude dans
pour cent. Cover Art affiche l'URL de l'image de couverture de l'album qui sera téléchargée.

Pour vérifier si les pistes importées correspondent à l'ensemble de fichiers actuel, la durée de
les pistes importées peuvent être comparées à la durée des fichiers. Cette option peut être
activé avec la case à cocher Vérifier le décalage horaire maximum autorisé et le
la différence de temps tolérée peut être réglée en secondes. Si une discordance dans une longueur est
détectée, la longueur est affichée sur fond rouge dans le tableau de prévisualisation.

Si les fichiers sont classés différemment des pistes importées, leurs pistes assignées
doivent être changés. Cette tâche peut être facilitée à l'aide des boutons Match with Length,
Piste et Titre, qui réorganiseront les pistes en fonction du champ correspondant.
Pour corriger les affectations manuellement, une piste peut être glissée avec le bouton gauche de la souris
et la touche Ctrl enfoncée, puis déposé au nouvel emplacement.

Lorsque la boîte de dialogue d'importation est ouverte, elle contient le contenu réel des balises. La balise
Le type (Tag 1, Tag 2, Tag 1 et Tag 2) peut être sélectionné à l'aide de la zone de liste déroulante Destination.
Le bouton à droite de cette liste déroulante peut être utilisé pour revenir au tableau
contenu actuel des balises. Les cases à cocher de la première colonne du tableau peuvent être utilisées pour
sélectionnez les pistes qui sont importées. Cela peut être utile si un dossier contient le
pistes des deux CD d'un double CD et seules les pistes du deuxième CD doivent être
importé.

Pour identifier les pistes qui sont importées, il est possible d'afficher les noms de fichiers ou
les chemins complets des fichiers à l'aide du menu contextuel de l'en-tête du tableau. Les valeurs en
la table d'importation peut être modifiée. Le bouton de retour à droite de la destination
la zone de liste déroulante peut être utilisée pour restaurer le contenu des balises, ce qui peut également être utile
après avoir modifié la destination.

Presque toutes les boîtes de dialogue comportent un bouton Enregistrer les paramètres, qui peut être utilisé pour stocker les
les paramètres spécifiques de la boîte de dialogue et la taille de la fenêtre de manière persistante.

À partir des balises mène à une sous-boîte de dialogue pour définir des cadres de balises à partir du contenu d'une autre balise
cadres. Cela peut être utilisé pour copier simplement des informations entre les balises ou extraire une partie
d'un cadre et insérez-le dans un autre.

Comme pour l'importation à partir d'un fichier/presse-papiers, il existe des formats librement configurables à effectuer
différentes opérations. Les formats pour copier la valeur de l'album sont déjà préconfigurés
Artiste de l'album, compositeur ou chef d'orchestre, et extraire le numéro de piste des champs de titre
qui contiennent un nombre. Il existe également un format pour extraire un sous-titre d'un titre
champ.

L'exemple suivant explique comment ajouter un format personnalisé, qui définit les informations
du champ Sous-titre également dans le champ Commentaire. Créez un nouveau format en utilisant Ajouter et
définissez un nouveau nom, par exemple « Sous-titre au commentaire ». Ensuite, entrez "%{subtitle}" dans Source et
"%{comment}(.*)" pour l'extraction et cliquez sur Enregistrer les paramètres.

L'expression dans Source peut contenir des codes de format pour des cadres de balise arbitraires, plusieurs
les codes peuvent être utilisés pour combiner le contenu de différentes trames. Pour chaque piste, un
le texte est généré à partir de ses balises en utilisant le format Source, et l'expression régulière
from Extraction est appliqué à ce texte pour définir de nouvelles valeurs pour les balises. Codes de format
sont utilisés avant les parenthèses de capture pour spécifier le cadre de balise où le
le texte doit être stocké. Cela fonctionne de la même manière que pour l'import depuis un fichier/presse-papiers.

Fichier → Importer depuis gnudb.org...
Importez depuis un serveur freedb.org à l'aide de la recherche d'albums gnudb.org. Cet élément de menu s'ouvre
la même boîte de dialogue d'importation que Importer..., mais ouvre directement la boîte de dialogue gnudb.org.

Fichier → Importer depuis TrackType.org...
Importez depuis le serveur TrackType.org. Cet élément de menu ouvre la même boîte de dialogue d'importation que
Importer..., mais ouvre directement la boîte de dialogue TrackType.org.

Fichier → Importer depuis Discogs...
Importer depuis le serveur Discogs. Cet élément de menu ouvre la même boîte de dialogue d'importation que
Importer..., mais ouvre directement la boîte de dialogue From Discogs.

Fichier → Importer depuis Amazon...
Importation d'Amazon. Cet élément de menu ouvre la même boîte de dialogue d'importation que Importer..., mais
ouvre directement la boîte de dialogue Depuis Amazon.

Fichier → Importer depuis MusicBrainz Release...
Importez à partir de la base de données des versions de MusicBrainz. Cet élément de menu ouvre le même import
dialogue comme Importer..., mais ouvre directement la boîte de dialogue From MusicBrainz Release.

Fichier → Importer depuis MusicBrainz Fingerprint...
Importation depuis un serveur MusicBrainz. Cet élément de menu ouvre la même boîte de dialogue d'importation que
Importer..., mais ouvre directement la boîte de dialogue From MusicBrainz Fingerprint.

Fichier → Importation automatique...
L'importation automatique permet d'importer des informations pour plusieurs albums à partir de divers sites Web.
prestations de service. Si des répertoires sont sélectionnés dans la liste de fichiers, suivez les données pour le
les répertoires seront importés. Si aucun répertoire n'est sélectionné, tous les répertoires du fichier
la liste sera importée.

Le type de balise (Tag 1, Tag 2, Tag 1 et Tag 2) peut être sélectionné à l'aide de la
boîte combo.

Les profils déterminent quels serveurs seront contactés pour récupérer les informations sur l'album. Certains
les profils sont prédéfinis (All, MusicBrainz, Discogs, Cover Art), des profils personnalisés peuvent être
ajouté à l'aide du bouton Ajouter à droite de la zone de liste déroulante Profil.

Le tableau ci-dessous montre les serveurs qui seront utilisés lors de l'importation des informations sur l'album
en utilisant le profil sélectionné. Le processus d'importation d'un album est terminé si tous
les informations requises ont été trouvées, donc l'ordre des lignes dans le tableau est
important. Il peut être modifié à l'aide des boutons Monter et Descendre. Modifier peut être
utilisé pour modifier une entrée existante. La sélection de serveurs propose les mêmes serveurs que peut
être utilisé dans les fonctions d'importation. Les balises standard, les balises supplémentaires, la pochette déterminent
les informations qui seront extraites du serveur. Enfin, la précision est le
précision minimale qui doit être atteinte pour accepter les données importées. Si la précision
est insuffisant, le prochain serveur de la liste sera essayé. La même boîte de dialogue contenant
les propriétés du serveur s'affichent lorsque vous cliquez sur Ajouter pour ajouter une nouvelle entrée de serveur. Existant
les entrées peuvent être supprimées à l'aide de Supprimer.

Pour lancer une importation automatique par lots avec le profil sélectionné, cliquez sur Démarrer. Des détails
sur l'import en cours sont affichés en haut de la boîte de dialogue. Le processus peut être
annulé avec le bouton Abandonner.

Fichier → Parcourir la pochette...
La boîte de dialogue Parcourir les pochettes permet de trouver les pochettes d'album. L'artiste/l'album est rempli
à partir des balises si possible. Source propose une variété de sites Web avec des pochettes d'album.
L'URL avec l'artiste et l'album comme paramètres se trouve sous le nom. URL codé
les valeurs pour l'artiste et l'album peuvent être insérées à l'aide %u{artiste} ainsi que %u{album}, autre
les valeurs des balises sont également possibles, comme décrit dans Configurer Kid3, Actions utilisateur.
D'autres sources peuvent être saisies après l'entrée « Source personnalisée » en remplaçant « Personnalisée
Source" avec le nom de la source, en appuyant sur Entrée, puis en insérant l'URL et enfin
en appuyant sur Enregistrer les paramètres. La commande de navigateur résultante s'affiche en haut de la
dialogue et peut être démarré en cliquant sur Parcourir. Le navigateur, qui peut être configuré dans
les réglages, démarre avec la source sélectionnée. Une image de couverture peut ensuite être glissée
du navigateur dans la fenêtre Kid3 et sera défini dans le cadre de l'image du
fichiers sélectionnés.

Parce que tous les navigateurs ne prennent pas en charge le glisser-déposer des images et des images sur les sites Web
ont souvent une URL, dans ce cas, Kid3 recevra l'URL et non l'image. Si la
L'URL pointe vers une image, elle sera téléchargée. Cependant, si l'URL fait référence à certains
autre ressource Web, il doit être traduit dans l'image correspondante. Tel
les mappages sont définis dans la table d'extraction d'URL. La colonne de gauche Match contient un
expression régulière qui est comparée à l'URL. S'il correspond, le capturé
les expressions entre parenthèses sont insérées dans le modèle de l'URL de l'image de droite
colonne (aux positions marquées par \1 etc.). L'expression régulière remplacée
contient l'URL de l'image. Par ce moyen, la pochette peut être importée d'Amazon,
Google Images, etc. par glisser-déposer. Il est également possible de définir votre propre
mappages.

Fichier → Exporter ...
La boîte de dialogue d'exportation est utilisée pour stocker les données des balises dans un fichier ou dans le presse-papiers. Les
l'éditeur en haut affiche un aperçu des données à exporter. Si les données d'exportation contiennent
caractères de tabulation, l'export est affiché dans un tableau. Les données seront générées
à partir des balises du répertoire courant selon le format configuré.

Les paramètres de format sont similaires à ceux de la boîte de dialogue Importer : le champ le plus haut contient
le titre (par exemple "CSV sans guillemets"), suivi de l'en-tête, qui sera généré à
le début du fichier. Les données de piste suivent ; il est utilisé pour chaque piste. Finalement,
la bande-annonce peut être utilisée pour générer du texte de finition.

Les champs de format ne contiennent pas d'expressions régulières comme dans la boîte de dialogue Importer, mais uniquement
expressions de format de sortie avec des expressions % spéciales, qui seront remplacées par des valeurs
à partir des balises. Le tout fonctionne comme le format de nom de fichier, et les mêmes codes sont
utilisé plus quelques codes supplémentaires. Non seulement les codes énumérés ci-dessous, mais tous les cadres de balises
les noms peuvent être utilisés.

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} Piste (par exemple 01)

· %t %{track.n} Piste avec une largeur de champ n (par exemple 001 pour %{track.3})

· %T %{tracknumber} Piste (sans zéros non significatifs, par exemple 1)

· %g %{genre} Genre

· %f %{file} Nom du fichier

· %p %{filepath} Chemin

· URL %u %{url}

· %d %{duration} Durée en minutes : secondes

· %D %{seconds} Durée en secondes

· %n %{tracks} Nombre de pistes de l'album

· %e %{extension} Extension de fichier

· %O %{tag1} Le format du tag 1 (ID3v1.1 ou vide si non existant)

· %o %{tag2} Le format de la balise 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF, ou vide si non existant)

· %b %{bitrate} Débit en kbit/s

· %v %{vbr} VBR ou vide (uniquement pour ID3v2.3 avec id3lib)

· %r %{samplerate} Fréquence d'échantillonnage en Hz

· %m %{mode} Mode canal (stéréo ou stéréo conjoint)

· %h %{channels} Nombre de canaux (1 ou 2)

· %k %{codec} Codec (par exemple MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

Quelques formats sont prédéfinis. "CSV sans guillemets" sépare les champs par des onglets. Données dans
ce format peut être réimporté dans Kid3 en utilisant le format d'import avec le même
Nom. "CSV quoted" entoure en outre les champs par des guillemets doubles, ce qui facilite la
importer dans des tableurs. Cependant, les champs ne doivent pas contenir de double
guillemets lorsque ce format est utilisé. « Extended M3U » et « Extended PLS » génèrent des listes de lecture
avec des attributs étendus et des noms de chemin absolus. "HTML" peut être utilisé pour générer un
Page HTML avec des hyperliens vers les pistes. "Kover XML" crée un fichier qui peut être
importé par le programme d'impression de couverture Kover. « Détails techniques » fournit des informations
sur le débit binaire, le taux d'échantillonnage, les canaux, etc. Enfin, "Custom Format" est laissé vide pour
définition d'un format personnalisé. Vous pouvez définir plus de formats de votre choix en ajoutant des lignes
dans le fichier kid3rc dans le répertoire de configuration. Les autres formats peuvent être adaptés à
vos besoins.

La source des tags pour générer les données d'export (Tag 1 ou Tag 2) peut être sélectionnée
avec une zone de liste déroulante. Push To File ou To Clipboard stocke les données dans un fichier ou sur le
presse-papiers. OK et Annuler ferment la boîte de dialogue, alors que OK accepte la boîte de dialogue actuelle
paramètres.

Fichier → Créer une liste de lecture
Crée une liste de lecture. Le format et le contenu de la liste de lecture peuvent être définis par divers
options.

Le nom de la liste de lecture peut être le même que le nom du répertoire ou utiliser un format avec des valeurs
à partir des balises, par exemple "%{artist} - %{album}" pour avoir l'artiste et le nom de l'album dans le
nom du fichier de liste de lecture. Les codes de format sont les mêmes que pour l'Export. L'extension dépend
au format liste de lecture.

L'emplacement de la liste de lecture générée est déterminé par la sélection du bouton Créer dans
boîte combo.

Répertoire actuel
La liste de lecture est créée dans le répertoire courant et ne contient que les fichiers du
répertoire actuel.

Chaque répertoire
Une liste de lecture est créée dans chaque répertoire qui contient les fichiers répertoriés, et chaque
playlist contient les fichiers de ce répertoire.

Répertoire de niveau supérieur
Une seule liste de lecture est créée dans le répertoire de niveau supérieur (c'est-à-dire le répertoire du
liste de fichiers) et il contient les fichiers répertoriés du répertoire de niveau supérieur et tous
ses sous-répertoires.

Le format de la liste de lecture peut être M3U, PLS ou XSPF.

Si Inclure uniquement les fichiers sélectionnés est coché, seuls les fichiers sélectionnés seront
inclus dans la liste de lecture. Si un répertoire est sélectionné, tous ses fichiers sont sélectionnés.
Si cette case n'est pas cochée, tous les fichiers audio sont inclus dans la liste de lecture.

Trier par nom de fichier sélectionne le cas habituel où les fichiers sont classés par nom de fichier.
Avec le champ Trier par balise, il est possible de trier par une chaîne de format avec les valeurs de la balise
des champs. Par exemple, "%{track.3}" peut être utilisé pour trier par numéro de piste (le ".3" est
utilisé pour obtenir trois chiffres avec des zéros non significatifs car des chaînes sont utilisées pour le tri). Ce
est également possible d'utiliser plusieurs champs, par exemple "%{genre}%{year}" pour trier à l'aide d'une chaîne
composé du genre et de l'année.

Les entrées de la liste de lecture auront des chemins de fichiers relatifs ou absolus selon que
Utiliser le chemin relatif pour les fichiers dans la liste de lecture ou Utiliser le chemin complet pour les fichiers dans la liste de lecture est défini.

Lorsque Write only list of files est défini, la liste de lecture ne contiendra que les chemins vers le
des dossiers. Pour générer une liste de lecture étendue avec des informations supplémentaires, une chaîne de format
peut être défini à l'aide de la commande Écrire les informations à l'aide.

Fichier → Quitter (Ctrl+Q)
Quitte l'application.

La Modifier Menu
Modifier → Tout sélectionner (Alt+A)
Sélectionne tous les fichiers.

Édition → Désélectionner (Ctrl+Maj+A)
Désélectionne tous les fichiers.

Modifier → Tout sélectionner dans le répertoire
Sélectionne tous les fichiers du répertoire courant.

Édition → Fichier précédent (Alt+Up)
Sélectionne le fichier précédent.

Édition → Fichier suivant (Alt+Bas)
Sélectionne le fichier suivant.

Édition → Rechercher... (Ctrl+F)
Recherchez des chaînes dans les noms de fichiers et les balises. La boîte de dialogue Rechercher est un sous-ensemble de la
Remplacer la boîte de dialogue, qui est décrite ci-dessous.

Édition → Remplacer... (Ctrl+R)
Cette fonction ouvre une boîte de dialogue pour rechercher et remplacer des chaînes dans les noms de fichiers et le
Mots clés. L'ensemble de trames où la recherche est effectuée peut être restreint par
en désactivant la case à cocher Tout sélectionner et en sélectionnant les cadres qui doivent être recherchés.
Il existe également des options de recherche disponibles pour rechercher en arrière, en tenant compte de la casse et pour
utiliser des expressions régulières.

Selon le nombre de fichiers, la recherche peut prendre un certain temps, il peut donc être
annulé en fermant la boîte de dialogue.

La Outils Menu
Outils → Appliquer le format de nom de fichier
Lorsque Formater pendant l'édition est désactivé pour le format de nom de fichier dans la configuration
dialogue, cet élément de menu peut être utilisé pour appliquer le format configuré aux noms des
fichiers sélectionnés. Cela peut également être utilisé pour vérifier si les noms de fichiers sont conformes à la
format configuré en appliquant le format à tous les fichiers enregistrés, puis en vérifiant s'il y en a
les fichiers ont été modifiés (et donc marqués d'un symbole de disque dans la liste des fichiers).

Outils → Appliquer le format de balise
Lorsque Formater pendant l'édition est désactivé pour le format de balise dans la configuration
dialogue, cet élément de menu peut être utilisé pour appliquer le format configuré aux variables du
fichiers sélectionnés. Cela peut également être utilisé pour vérifier si les balises sont conformes aux
format configuré en appliquant le format à tous les fichiers enregistrés, puis en vérifiant s'il y en a
les fichiers ont été modifiés (et donc marqués d'un symbole de disque dans la liste des fichiers).

Outils → Appliquer l'encodage de texte
Définit l'encodage du texte sélectionné dans Paramètres/Configurer Kid3.../Tags/Tag 2 pour tous
fichiers sélectionnés. Si UTF8 est sélectionné, UTF16 sera utilisé pour les balises ID3v2.3.0 car
UTF8 n'est pas pris en charge pour ce format.

Outils → Renommer le répertoire...
Cette boîte de dialogue offre la possibilité de renommer automatiquement le fichier actuellement ouvert
répertoire selon les balises dans les fichiers. Plusieurs formats sont préconfigurés pour
inclure des informations sur l'artiste, l'album et l'année dans le nom du répertoire. C'est aussi
possible de définir un format personnalisé, les codes spéciaux suivants sont utilisés pour insérer la balise
valeurs dans le nom du répertoire :

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} Piste (par exemple 01)

· %t %{track.n} Piste avec une largeur de champ n (par exemple 001 pour %{track.3})

· %T %{tracknumber} Piste (sans zéros non significatifs, par exemple 1)

· %g %{genre} Genre

Si un séparateur de répertoire "/" est trouvé dans le format, plusieurs répertoires sont créés.
Si vous souhaitez créer un nouveau répertoire au lieu de renommer le répertoire actuel,
sélectionnez Créer un répertoire au lieu de Renommer le répertoire. La source des informations de balise
peut être choisi entre From Tag 1 et Tag 2, From Tag 1 et From Tag 2. Un aperçu pour
l'opération de renommage effectuée sur le premier fichier est visible dans les champs From et To
sections de la boîte de dialogue.

Plusieurs répertoires peuvent être renommés en les sélectionnant.

Outils → Numéroter les pistes...
Si les numéros de piste dans les balises ne sont pas définis ou ont des valeurs incorrectes, cette fonction
peut numéroter les pistes automatiquement dans l'ordre croissant. Le numéro de départ peut être défini dans
le dialogue. Si seulement une partie des pistes doit être numérotée, elles doivent être sélectionnées.

Lorsque le nombre total de pistes est coché, le nombre de pistes sera également défini dans le
Mots clés.

Il est possible de numéroter les pistes sur plusieurs répertoires. Les dossiers doivent être
étendu et sélectionné.

Si Réinitialiser le compteur pour chaque répertoire est coché, la numérotation des pistes est relancée avec le
numéro donné pour chaque répertoire lorsque plusieurs dossiers sont sélectionnés.

La boîte de dialogue de numérotation des pistes peut également être utilisée pour formater des numéros de piste existants sans
changer les valeurs lorsque la case à cocher laissée à Numéro de départ est désactivée. Le total
nombre de pistes sera ajouté si la case à cocher correspondante est active, ce qui peut être
utilisé pour régler le total pour toutes les pistes sélectionnées. Si seulement le formatage de l'existant
numéros est souhaitée, cette case à cocher doit également être désactivée.

Outils → Filtrer...
Le filtre peut être utilisé pour afficher uniquement les fichiers qui correspondent à certains critères. Cette
est utile si vous souhaitez organiser une grande collection et ne modifier que les fichiers qui
ne sont pas dans le schéma souhaité. L'expression définissant les fichiers à afficher utilise le
mêmes codes de format qui sont utilisés dans le format de nom de fichier, l'importation et l'exportation.

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} Piste (par exemple 01)

· %t %{track.n} Piste avec une largeur de champ n (par exemple 001 pour %{track.3})

· %T %{tracknumber} Piste (sans zéros non significatifs, par exemple 1)

· %g %{genre} Genre

· %f %{file} Nom du fichier

· %p %{filepath} Chemin absolu vers le fichier

· %e %{extension} Extension de fichier

· %O %{tag1} Le format du tag 1 (ID3v1.1 ou vide si non existant)

· %o %{tag2} Le format de la balise 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF, ou vide si non existant)

· %b %{bitrate} Débit en kbit/s

· %v %{vbr} VBR ou vide (uniquement pour ID3v2.3 avec id3lib)

· %r %{samplerate} Fréquence d'échantillonnage en Hz

· %m %{mode} Mode canal (stéréo ou stéréo conjoint)

· %h %{channels} Nombre de canaux (1 ou 2)

· %k %{codec} Codec (par exemple MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

· %1a %1{artist}, ... Utilisez le préfixe 1 pour obtenir les valeurs de la balise 1

· %2a %2{artist}, ... Utilisez le préfixe 2 pour obtenir les valeurs de la balise 2

Ces codes sont remplacés par les valeurs du fichier et les chaînes résultantes peuvent
comparer avec les opérations suivantes :

· s1 est égal à s2 : vrai si s1 et s2 sont égaux.

· s1 contient s2 : vrai si s1 contient s2, c'est-à-dire que s2 est une sous-chaîne de s1.

· s correspond à re : vrai si s correspond à l'expression régulière re.

Les expressions vraies sont remplacées par 1, fausses par 0. Les valeurs vraies sont représentées par 1,
vrai, activé et oui, valeurs fausses par 0, faux, désactivé et non. Les opérations booléennes ne le sont pas,
et, ou (dans cet ordre de priorité) et peuvent être regroupés par parenthèses.

Certaines règles de filtrage sont prédéfinies et peuvent servir d'exemples pour vos propres expressions :

Tous
Lorsque la liste des fichiers est filtrée - ceci est indiqué par "[filtered]" dans le titre de la fenêtre
- et tous les fichiers doivent être affichés à nouveau, le filtrage peut être inversé à l'aide de cette
filtre. Il utilise une expression vide, mais une valeur vraie aurait le même effet.

Incompatibilité de balise de nom de fichier
ne sauraient (%{chemin du fichier} contient "%{artiste} - %{album}/%{piste} %{Titre}")

Teste si le chemin du fichier est conforme au format du nom de fichier. Cette règle est
automatiquement adapté si le format du nom de fichier change.

Pas de balise 1
%{balise1} équivaut à ""

Affiche uniquement les fichiers qui n'ont pas de balise 1.

Pas de balise 2
%{balise2} équivaut à ""

Affiche uniquement les fichiers qui n'ont pas de balise 2.

Balise ID3v2.3.0
%{balise2} équivaut à "ID3v2.3.0"

Affiche uniquement les fichiers qui ont une balise ID3v2.3.0.

Balise ID3v2.4.0
%{balise2} équivaut à "ID3v2.4.0"

Affiche uniquement les fichiers qui ont une balise ID3v2.4.0.

Balise 1 != Balise 2
ne sauraient (%1{titre} équivaut à %2{titre} ainsi que %1{album} équivaut à %2{album} ainsi que %1{artiste}
équivaut à %2{artiste} ainsi que %1 commentaire} équivaut à %2 commentaire} ainsi que %1 an} équivaut à %2 an}
ainsi que %1{piste} équivaut à %2{piste} ainsi que %1{genre} équivaut à %2{genre})

Affiche les fichiers avec des différences entre la balise 1 et la balise2.

Balise 1 == Balise 2
%1{titre} équivaut à %2{titre} ainsi que %1{album} équivaut à %2{album} ainsi que %1{artiste} équivaut à
%2{artiste} ainsi que %1 commentaire} équivaut à %2 commentaire} ainsi que %1 an} équivaut à %2 an} ainsi que
%1{piste} équivaut à %2{piste} ainsi que %1{genre} équivaut à %2{genre}

Affiche les fichiers avec la balise 1 et la balise 2 identiques.

Couverture
%{Titre} équivaut à "" or %{artiste} équivaut à "" or %{album} équivaut à "" or %{année} équivaut à
"" or %{numéro de piste} équivaut à "" or %{le genre} équivaut à ""

Affiche les fichiers avec des valeurs vides dans les balises standard (titre, artiste, album, date,
numéro de piste, genre).

Pas d'image
%{photo} équivaut à ""

Affiche uniquement les fichiers qui n'ont pas d'image.

Filtre personnalisé
Pour ajouter votre propre filtre, sélectionnez cette entrée. Par exemple, si vous voulez avoir un
filtre pour les artistes commençant par « Le », remplacez « Filtre personnalisé » par le nom « Le
Bands" et appuyez sur Entrée. Insérez ensuite l'expression suivante dans la ligne d'édition :

%{artiste} allumettes "Les.*"

Cliquez ensuite sur Enregistrer les paramètres. Cliquez sur Appliquer pour filtrer les fichiers. Tous les fichiers traités sont
affiché dans la vue texte, avec un "+" pour ceux qui correspondent au filtre et un "-"
pour les autres. Une fois terminé, seuls les fichiers avec un artiste commençant par "The"
s'affichent et le titre de la fenêtre est marqué de "[filtré]".

Outils → Convertir ID3v2.3 en ID3v2.4
S'il y a des balises ID3v2.3 dans les fichiers sélectionnés, elles seront converties en ID3v2.4
Mots clés. Les cadres qui ne sont pas pris en charge par TagLib seront supprimés. Seuls les fichiers sans
les modifications non enregistrées seront converties.

Outils → Convertir ID3v2.4 en ID3v2.3
S'il y a des balises ID3v2.4 dans les fichiers sélectionnés, elles seront converties en ID3v2.3
Mots clés. Seuls les fichiers sans modifications non enregistrées seront convertis.

Outils → Jouer
Cela ouvre une barre d'outils simple pour lire les fichiers audio. Il contient des boutons pour la base
(Lecture/Pause, Arrêter la lecture, Piste précédente, Piste suivante, Fermer), curseurs pour
position et le volume et un affichage de la position actuelle. Si plusieurs fichiers sont
sélectionné, les pistes sélectionnées sont lues, sinon tous les fichiers seront lus.

La Paramètres Menu
Paramètres → Afficher la barre d'outils
Bascule l'affichage de la barre d'outils.

Paramètres → Afficher la barre d'état
Bascule l'affichage de la barre d'état, qui affiche des actions plus longues telles que l'ouverture ou
sauvegarde d'un répertoire.

Paramètres → Afficher l'image
Bascule l'affichage de l'image d'aperçu de la pochette de l'album.

Paramètres → Masquer automatiquement les balises
Les balises vides sont automatiquement masquées si cette option est active. Le fichier, la balise 1 et la balise
2 sections peuvent être réduites et développées manuellement en cliquant sur le -/+ correspondant
boutons.

Paramètres → Configurer Kid3...
Ouvre la boîte de dialogue de configuration, qui se compose de pages pour les balises, les fichiers, les actions utilisateur,
et les paramètres réseau.

Les options spécifiques aux balises se trouvent sur la page Balises, elle-même séparée en
trois onglets pour Tag 1, Tag 2 et Tag 1 et Tag 2.

Si Marquer les champs tronqués est coché, les champs ID3v1.1 tronqués seront marqués en rouge. Les
les champs de texte des balises ID3v1.1 ne peuvent avoir que 30 caractères, le commentaire seulement 28
personnages. De plus, le genre et les numéros de piste sont restreints, de sorte que les champs peuvent être
tronqué lors de l'importation ou du transfert depuis ID3v2. Les champs tronqués et le fichier seront
être marqué en rouge et la marque sera supprimée une fois le champ modifié.

Avec l'encodage de texte pour ID3v1, il est possible de définir le jeu de caractères utilisé dans ID3v1
Mots clés. Cet encodage est censé être ISO-8859-1, il est donc recommandé de le conserver
valeur par défaut. Cependant, il existe des balises avec un codage différent, il peut donc être
défini ici et les balises ID3v1 peuvent ensuite être copiées vers ID3v2 qui prend en charge Unicode.

La case à cocher Utiliser le format piste/nombre total de pistes contrôle si la piste
le champ numérique des balises ID3v2 contient simplement le numéro de piste ou en plus le total
nombre de pistes dans le répertoire.

Lorsque Genre comme texte au lieu d'une chaîne numérique est coché, tous les genres ID3v2 seront
stocké sous forme de chaîne de texte même s'il existe un code correspondant pour les genres ID3v1. Si
cette option n'est pas définie, les genres pour lesquels un code ID3v1 existe sont stockés en tant que numéro
du code de genre (entre parenthèses pour ID3v2.3). Ainsi le genre Metal est stocké comme
"Métal" ou "(9)" selon cette option. Genres qui ne sont pas dans la liste d'ID3v1
les genres sont toujours stockés sous forme de chaîne de texte. Le but de cette option est amélioré
compatibilité avec des appareils qui n'interprètent pas correctement les codes de genre.

L'encodage du texte définit l'encodage par défaut utilisé pour les trames ID3v2 et peut être défini sur
ISO-8859-1, UTF16 ou UTF8. UTF8 n'est pas valide pour les trames ID3v2.3.0 ; s'il est défini,
UTF16 sera utilisé à la place. Pour les trames ID3v2.4.0, les trois encodages sont possibles.

La version utilisée pour les nouvelles balises détermine si les nouvelles balises ID3v2 sont créées en tant que version
2.3.0 ou 2.4.0. Dans le premier cas, id3lib est utilisé comme dans les versions précédentes de
Kid3 et TagLib ne sont appliqués que lorsqu'une balise ID3v2.4.0 est rencontrée. Dans la seconde
cas, ID3v2.4.0 (TagLib), TagLib est généralement utilisé pour les fichiers MP3 ; changé ou nouvellement
les balises créées seront alors enregistrées dans la version 2.4.0. Lorsque ID3v2.3.0 (TagLib) est sélectionné,
TagLib est également utilisé pour les balises ID3v2.3.0.

Chiffres du numéro de piste est le nombre de chiffres dans les champs Numéro de piste. Les zéros non significatifs sont
utilisé pour rembourrer. Par exemple, avec une valeur de 2, le numéro de piste 5 est défini sur "05".

Le nom du champ Commentaire de la zone de liste déroulante n'est pertinent que pour les fichiers Ogg/Vorbis et FLAC et
définit le nom du champ utilisé pour les commentaires. Différentes applications semblent utiliser
des noms différents, "COMMENT" par exemple est utilisé par xmms, alors que amaroK utilise
"LA DESCRIPTION".

Le format des images dans les fichiers Ogg/Vorbis est déterminé par le nom du champ Image, qui
peut être METADATA_BLOCK_PICTURE ou COVERART. La première est la norme officielle et utilise
le même format que les images dans les balises FLAC. COVERART est un moyen non officiel antérieur de
inclure des images dans les commentaires Vorbis. Il peut être utilisé pour la compatibilité avec l'héritage
joueurs.

Si la case Marquer si plus grand que est cochée, les fichiers contenant un album intégré
Les pochettes dépassant la taille donnée en octets sont marquées en rouge. Cela peut être utilisé pour trouver
fichiers contenant des images surdimensionnées qui ne sont pas acceptées par certaines applications et
joueurs. La valeur par défaut est de 131072 octets (128 Ko).

Les genres personnalisés peuvent être utilisés pour définir des genres qui ne sont pas disponibles dans la norme
liste des genres, par exemple "Gothic Metal". Ces genres personnalisés apparaîtront dans la zone de liste déroulante Genre
de la balise 2. Pour les balises ID3v1.1, seuls les genres prédéfinis peuvent être utilisés.

La liste des genres personnalisés peut également être utilisée pour réduire le nombre de genres disponibles dans
la zone de liste déroulante Genre à celles généralement utilisées. Si votre collection contient principalement de la musique
dans les genres Metal, Gothic Metal, Ancient et Hard Rock, vous pouvez entrer dans ces genres
et cochez Afficher uniquement les genres personnalisés. La combo de Tag 2Genre ne contiendra alors que
ces quatre genres et vous n'aurez pas à chercher dans la liste complète des genres pour
eux. Dans cet exemple, seuls le Metal et le Hard Rock seront répertoriés dans les genres tag 1
list, car ces deux entrées de genres personnalisés sont des genres standard. Si Afficher uniquement personnalisé
genres n'est pas actif, les genres personnalisés se trouvent à la fin de la liste des genres.

Les cadres d'accès rapide définissent quels types de cadres sont toujours affichés dans la section Tag 2.
Ces cadres peuvent ensuite être ajoutés sans utiliser au préalable le bouton Ajouter. L'ordre de ces
Les cadres d'accès rapide peuvent être modifiés en faisant glisser et en déposant des éléments.

Format de balise contient des options pour le format des balises. Lorsque Formater pendant l'édition est
cochée, la configuration du format est automatiquement utilisée lors de l'édition du texte dans la ligne
édite. La conversion de casse peut être définie sur Aucun changement, Tout en minuscules, Tout en majuscules,
Première lettre majuscule ou Toutes les premières lettres majuscules. Pour utiliser la conversion tenant compte des paramètres régionaux
entre les caractères minuscules et majuscules, une locale peut être sélectionnée dans la liste déroulante
au dessous de. La liste de remplacement de chaînes peut être définie sur des mappages de chaînes arbitraires. Pour ajouter un
nouveau mappage, sélectionnez la cellule De d'une ligne et insérez le texte à remplacer, puis accédez à
la colonne À et entrez le texte de remplacement. Pour supprimer un mappage, définissez la cellule De sur
une valeur vide (par exemple en tapant d'abord espace puis retour arrière). Insertion et suppression
lignes est également possible à l'aide d'un menu contextuel qui apparaît lorsque le bouton droit de la souris
est cliqué. Le remplacement n'est actif que si la case Remplacement de chaîne est cochée.

Sur la page Fichiers, la case à cocher Charger les derniers fichiers ouverts peut être cochée afin que Kid3
ouvrez et sélectionnez le dernier fichier sélectionné au prochain démarrage. Préserver
l'horodatage du fichier peut être vérifié pour conserver l'horodatage de la modification du fichier. Nom de fichier
pour la couverture définit le nom qui est suggéré lorsqu'une image intégrée est exportée vers un
fichier.

Si Marquer les modifications est actif, les champs modifiés sont marqués d'une étiquette gris clair
fond.

Filename Format contient des options pour le format des noms de fichiers. Les mêmes options que
au format Tag sont disponibles.

La page Actions utilisateur contient un tableau avec les commandes disponibles dans le
menu contextuel de la liste des fichiers. Pour les opérations critiques telles que la suppression de fichiers, il est
conseillé de marquer Confirmer pour faire apparaître une boîte de dialogue de confirmation avant d'exécuter le
commander. La sortie peut être marquée pour voir la sortie écrite par les commandes de la console (standard
sortie et erreur standard). Nom est le nom affiché dans le menu contextuel. Commander
est la ligne de commande à exécuter. Les arguments peuvent être transmis à l'aide des codes suivants :

· %F %{files} Chemins de fichiers (une liste si plusieurs fichiers sont sélectionnés)

· %f %{file} Chemin d'accès au fichier unique

· URL %uF %{urls} (une liste si plusieurs fichiers sont sélectionnés)

· %uf %{url} URL vers un seul fichier

· %d %{répertoire} Répertoire

· %s %{title} Titre (chanson)

· %a %{artiste} artiste

· %l %{album} album

· %c %{comment} Commentaire

· %y %{year} Année

· %t %{track} Piste (par exemple 01)

· %t %{track.n} Piste avec une largeur de champ n (par exemple 001 pour %{track.3})

· %T %{tracknumber} Piste (sans zéros non significatifs, par exemple 1)

· %g %{genre} Genre

· %b %{browser} Commande pour démarrer le navigateur Web

· %q %{qmlpath} Répertoire de base des fichiers QML fournis

Le code spécial @séparateur peut être défini comme une commande pour insérer un séparateur dans le
menu contextuel des actions de l'utilisateur. Les éléments de menu peuvent être placés dans un sous-menu en les entourant avec
@beginmenu ainsi que @endmenu commandes. Le nom du sous-menu est déterminé par le Nom
colonne du @beginmenu commander.

Pour exécuter des scripts QML, @qml est utilisé comme nom de commande. Le chemin d'accès au script QML est
passé en paramètre. Les scripts fournis se trouvent dans le dossier
%{qmlpath}/script/ (sur Linux typiquement /usr/share/kid3/qml/script/, sur Windows
qml/script/ dans le répertoire d'installation et sur OS X dans le dossier app
kid3.app/Contents/Resources/qml/script/). Les scripts personnalisés peuvent être stockés dans n'importe quel
annuaire. Si le code QML utilise des composants GUI, @qmlview doit être utilisé à la place de
@qml. Des paramètres supplémentaires sont passés au script QML où ils seront disponibles
via le getArguments() fonction. Un aperçu de certaines fonctions et propriétés qui
sont disponibles en QML se trouvent dans l'annexe Interface QML.

La commande qui sera insérée avec %{browser} peut être définie dans le navigateur Web
modification de la ligne ci-dessus. Les commandes commençant par %{browser} peuvent être utilisées pour récupérer des informations
sur les fichiers audio du Web, par exemple

%{navigateur} http://lyricwiki.org/%u{artiste} :%u{title}

interrogera les paroles de la chanson en cours dans ParoleWiki[dix]. Le "u" dans %u{artist} et
%u{title} est utilisé pour encoder en URL les informations sur l'artiste %{artist} et la chanson %{title}. Ce
est facile de définir vos propres requêtes de la même manière, par exemple une recherche d'images avec
Google[11]:

%{navigateur} http://images.google.com/images?q=%u{artiste}%20%u{album}

Pour ajouter une pochette d'album à la balise 2, vous pouvez rechercher des images avec Google ou Amazon en utilisant
les commandes décrites ci-dessus. L'image peut être ajoutée à la balise par glisser-déposer.
Vous pouvez également ajouter une image avec Ajouter, puis sélectionner le cadre photo et importer une image
fichier ou coller à partir du presse-papiers. Les cadres photo sont pris en charge pour ID3v2, MP4, FLAC,
Balises Ogg et ASF.

Pour ajouter et supprimer des entrées dans le tableau, un menu contextuel peut être utilisé.

La page Réseau ne contient qu'un champ pour insérer l'adresse proxy et éventuellement le
port, séparés par deux points. Le proxy sera utilisé lors de l'importation à partir d'un Internet
serveur lorsque la case est cochée.

Dans la page Plugins, les plugins disponibles peuvent être activés ou désactivés. Les plugins sont
séparés en deux sections. La liste des plugins de métadonnées et de priorité contient des plugins
qui prennent en charge les formats de fichiers audio. L'ordre des plugins est important car ils
sont essayés de haut en bas. Certains formats sont pris en charge par plusieurs plugins, donc les fichiers
sera ouvert avec le premier plugin les prenant en charge. TaglibMetadata prend en charge la plupart des
formats, s'il est en haut de la liste, il ouvrira la plupart des fichiers. Si tu veux
pour utiliser un plugin différent pour un format de fichier, assurez-vous qu'il est répertorié avant le
Plugin TaglibMetadata. Détails sur le plugin de métadonnées et pourquoi vous voudrez peut-être l'utiliser
eux au lieu de TagLib sont répertoriés ci-dessous.

· Id3libMetadata : utilisations id3lib[12] pour les balises ID3v1.1 et ID3v2.3 en MP3, MP2, AAC
des dossiers. Prend en charge quelques types de trames de plus que TagLib. Une autre raison de l'utiliser est
que TagLib ne prend en charge que ID3v2.3 depuis la version 1.8.

· OggFlacMetadata : utilisations libogg[13] libvorbis, fichier libvorbis[14] pour les fichiers Ogg, et
plus libFLAC++ ainsi que libFLAC[15] pour les fichiers FLAC. Les raisons de les utiliser sont
images dans des fichiers Ogg, qui ne sont pas pris en charge par TagLib et que ce sont les
bibliothèques officielles pour ces formats.

· TaglibMetadata : utilisations TagLib[16] qui prend en charge de nombreux formats de fichiers audio. Depuis
version 1.8, il prend également en charge ID3v2.3, il peut donc être utilisé pour tous les fichiers audio
soutenu par Kid3.

· Mp4v2Métadonnées : mp4v2[17] était à l'origine utilisé par Kid3 pour prendre en charge les fichiers M4A.
Cependant, les versions plus récentes de TagLib offrent un bon support M4A, donc ce plugin n'est pas
construit par défaut.

La section Plugins disponibles répertorie les plugins restants. Leur ordre n'est pas
important, mais ils peuvent être activés ou désactivés à l'aide des cases à cocher.

· AmazonImport : Utilisé pour la fonction Importer depuis Amazon....

· DiscogsImport : Utilisé pour la fonction Importer depuis Discogs....

· FreedbImport : utilisé pour l'importation depuis gnudb.org... et l'importation depuis
TrackType.org... fonctions.

· MusicBrainzImport : Utilisé pour l'importation depuis MusicBrainz Release... fonction.

· AcoustidImport : utilisé pour la fonction Importer depuis MusicBrainz Fingerprint...,
qui dépend du Impression chromatique[18] et libre[19] bibliothèques.

Les plugins désactivés ne seront pas chargés. Cela peut être utilisé pour optimiser les ressources
temps d'utilisation et de démarrage. Les paramètres de cette page ne prennent effet qu'après un redémarrage de
Enfant3.

Paramètres → Configurer les raccourcis...
Ouvre une boîte de dialogue pour attribuer des raccourcis clavier pour la plupart des fonctions du programme. Là
sont même des fonctions sans menu ou bouton correspondant disponibles, par exemple le fichier suivant,
fichier précédent, tout sélectionner.

La d’aide Menu
Aide → Manuel Kid3
Ouvre ce manuel.

Aide → À propos de Kid3
Affiche une brève information sur Kid3;.

KID3-CLI

Commandes
kid3-cli offre une interface de ligne de commande pour Kid3. Si un chemin de répertoire est utilisé, le
répertoire est ouvert. Si un ou plusieurs chemins de fichiers sont donnés, le répertoire commun est ouvert
et les fichiers sont sélectionnés. Les commandes suivantes fonctionneront alors sur ces fichiers. Commandes
sont spécifiés à l'aide -c option. Si plusieurs commandes sont passées, elles sont exécutées dans le
ordre donné. Si des fichiers sont modifiés par les commandes, ils seront enregistrés à la fin. Sinon
les options de commande sont passées, kid3-cli démarre en mode interactif. Les commandes peuvent être saisies
et fonctionnera sur la sélection en cours. Les sections suivantes répertorient toutes les
les commandes.

d’aide
aider [COMMANDE-NOM]

Affiche l'aide sur les paramètres de COMMANDE-NOM ou à propos de toutes les commandes si aucune commande
le nom est donné.

Temps mort
temps mort [défaut | off | ]

Écrasez le délai d'expiration de la commande par défaut. Les commandes CLI abandonnent après une commande spécifique
le délai d'attente est expiré. Ce délai d'attente est de 10 secondes pour ls ainsi que album d'art, 60 secondes pour
importation automatique ainsi que une fonction filtre, et 3 secondes pour toutes les autres commandes. Si un grand nombre de fichiers
doit être traité, ce timeout peut être trop restrictif, donc le timeout pour tous
les commandes peuvent être définies sur ms, complètement désactivé ou laissé à la valeur par défaut
valeurs.

quitter application
sortie [Obliger]

Quittez l'application. S'il y a des fichiers modifiés non enregistrés, le forcer le paramètre est
nécessaire.

Modifier annuaire
cd [ANNUAIRE]

Sinon ANNUAIRE est donné, passez au répertoire personnel. Si un répertoire est donné,
changer dans le répertoire. Si un ou plusieurs chemins de fichiers sont indiqués, remplacez-les par leur
répertoire et sélectionnez les fichiers.

Imprimé le actuel de travail annuaire
pwd

Imprimer le nom de fichier du répertoire de travail actuel.

Annuaire liste
ls

Liste le contenu du répertoire courant. Cela correspond à la liste des fichiers dans le
GUI Kid3. Quatre caractères avant les noms de fichiers indiquent l'état du fichier.

· > Le fichier est sélectionné.

· * Le fichier est modifié.

· 1 Le fichier a une balise 1, sinon '-' s'affiche.

· 2 Le fichier a une balise 2, sinon '-' s'affiche.

kid3-cli> ls
1- 01 Introduction.mp3
> 12 02 Nous n'avons que celui-ci.mp3
*1- 03 Outro.mp3

Dans cet exemple, tous les fichiers ont une balise 1, le deuxième fichier a également une balise 2 et il est
choisi. Le troisième fichier est modifié.

Épargnez le modifié fichiers
enregistrer

Sélectionnez filet
Sélectionner [tous | aucun | premier | précédent | suivant | DOSSIER...]

Pour sélectionner tous les fichiers, entrez Sélectionner TOUTE, pour désélectionner tous les fichiers, entrez Sélectionner aucun. Pour
parcourir les fichiers du répertoire courant en commençant par Sélectionner premier, puis avance
en utilisant Sélectionner next ou vers l'arrière en utilisant Sélectionner précédent. Des fichiers spécifiques peuvent être ajoutés à
la sélection en cours en donnant leurs noms de fichiers. Les caractères génériques sont possibles, donc Sélectionner
* .mp3 sélectionnera tous les fichiers MP3 dans le répertoire actuel.

kid3-cli> Sélectionner premier
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Nous n'avons que celui-ci.mp3
*1- 03 Outro.mp3
kid3-cli> Sélectionner next
kid3-cli> ls
1- 01 Introduction.mp3
> 12 02 Nous n'avons que celui-ci.mp3
*1- 03 Outro.mp3
kid3-cli> Sélectionner * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 Nous n'avons que celui-ci.mp3
>*1- 03 Outro.mp3

Sélectionnez Étiquette
Étiquette [NUMÉROS D'ÉTIQUETTE]

De nombreuses commandes ont une option NUMÉROS D'ÉTIQUETTE paramètre, qui spécifie si le
commande opère sur la balise 1 ou la balise 2. Si ce paramètre est omis, la balise par défaut
des nombres sont utilisés, qui peuvent être définis par cette commande. Au démarrage, il est réglé sur 12, ce qui
signifie que les informations sont lues à partir de la balise 2 si elle est disponible, sinon à partir de la balise 1 ; modifications
sont faites sur l'étiquette 2. Le NUMÉROS D'ÉTIQUETTE peut être réglé sur 1 or 2 d'opérer uniquement sur le
balise correspondante. Si le paramètre est omis, le réglage actuel est affiché.

Obtenez Étiquette cadre
obtenez [tous | NOM-FRAME] [NUMÉROS D'ÉTIQUETTE]

Cette commande peut être utilisée pour lire la valeur d'un cadre de balise spécifique ou obtenir des informations
sur tous les cadres de balise (si l'argument est omis ou TOUTE est utilisé). Les cadres modifiés sont
marqué d'un '*'.

kid3-cli> obtenez
Fichier : MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stéréo
Nom : 01 Intro.mp3
Balise 1 : ID3v1.1
Titre Introduction
Artiste One Hit Wonder
Album Let's Tag
Date 2013
Piste numéro 1
Genre Pop
kid3-cli> obtenez titre
Introduction

Pour enregistrer le contenu d'un cadre photo dans un fichier, utilisez

obtenez image :"/chemin/vers/dossier.jpg"

Pour enregistrer les paroles synchronisées dans un fichier LRC, utilisez

obtenez SYLT : "/chemin/vers/paroles.lrc"

Ensemble Étiquette cadre
set {NOM-FRAME} {VALEUR-FRAME} [NUMÉROS D'ÉTIQUETTE]

Cette commande définit la valeur d'un cadre de balise spécifique.

kid3-cli> set remixeur "OH Merveille"

Pour définir le contenu d'un cadre photo à partir d'un fichier, utilisez

set image :"/chemin/vers/dossier.jpg" "Photo La description"

Pour définir des paroles synchronisées à partir d'un fichier LRC, utilisez

set SYLT : "/chemin/vers/paroles.lrc" "Paroles de chanson La description"

Revenir
revenir

Annule toutes les modifications dans les fichiers sélectionnés (ou tous les fichiers si aucun fichier n'est
choisi).

L’ de filet or presse-papiers
importer {DOSSIER} {FORMAT-NOM} [NUMÉROS D'ÉTIQUETTE]

Les balises sont importées du fichier DOSSIER (ou du presse-papiers si presse-papiers est utilisé pour
DOSSIER) au format avec le nom FORMAT-NOM (par exemple "CSV non cité", voir Importer).

Automatique importer
importation automatique [NOM DE PROFIL] [NUMÉROS D'ÉTIQUETTE]

Importation par lots à l'aide du profil NOM DE PROFIL (voir Importation automatique, "Tous" est utilisé si
omis).

Télécharger album couverture œuvres d'art
album d'art {URL} [tous]

Définissez la pochette de l'album en téléchargeant une image à partir de URL. Les règles définies dans le
La boîte de dialogue Parcourir les pochettes est utilisée pour transformer les URL générales (par exemple d'Amazon) en un
URL de la photo. Pour définir la couverture de l'album à partir d'un fichier image local, utilisez la commande set.

kid3-cli> album d'art
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Exportations à filet or presse-papiers
Exporter {DOSSIER} {FORMAT-NOM} [NUMÉROS D'ÉTIQUETTE]

Les balises sont exportées vers un fichier DOSSIER (ou dans le presse-papiers si presse-papiers est utilisé pour DOSSIER) dans
le format avec le nom FORMAT-NOM (par exemple "CSV non cité", voir Exporter).

Création playlist
playlist

Créez une liste de lecture au format défini dans la configuration, voir Créer une liste de lecture.

Appliquer nom de fichier le format
format de nom de fichier

Appliquer le format de nom de fichier défini dans la configuration, voir Appliquer le format de nom de fichier.

Appliquer Étiquette le format
format de balise

Appliquer le format de nom de balise défini dans la configuration, voir Appliquer le format de balise.

Appliquer texte codage
codage de texte

Appliquer l'encodage de texte défini dans la configuration, voir Appliquer l'encodage de texte.

renommer annuaire
renommer [Format] [créer | renommer | essai à sec] [NUMÉROS D'ÉTIQUETTE]

Renommer ou créer des répertoires à partir des valeurs des balises selon un Format
(par exemple %{artiste} - %{album}, voir Renommer le répertoire), si aucun format n'est donné, le format
défini dans la boîte de dialogue Renommer le répertoire est utilisé. Le mode par défaut est rebaptiser; créer
répertoires, engendrent doit être donné explicitement. Les actions de changement de nom seront effectuées
immédiatement, pour juste voir ce qui serait fait, utilisez le tirage à sec option.

Numéro vos titres
numéros de piste [NUMÉRO DE PISTE] [NUMÉROS D'ÉTIQUETTE]

Numéroter les pistes sélectionnées en commençant par NUMÉRO DE PISTE (1 si omis).

Filtre
une fonction filtre [FILTRE-NOM | FILTRE-FORMAT]

Filtrez les fichiers afin que seuls les fichiers correspondant au FILTRE-FORMAT sont visibles. Les
nom d'une expression de filtre prédéfinie (par exemple "Nom de fichier Jour Décalage") peut être utilisé
au lieu d'une expression de filtre, voir Filtre.

kid3-cli> une fonction filtre '%{Titre} contient "tro"'
A débuté
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
- 02 Nous n'avons que celui-ci.mp3
+ 03 Outro.mp3
Fini
kid3-cli> ls
1- 01 Introduction.mp3
1- 03 Outro.mp3
kid3-cli> une fonction filtre Tous
A débuté
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
+ 02 Nous n'avons que celui-ci.mp3
+ 03 Outro.mp3
Fini
kid3-cli> ls
1- 01 Introduction.mp3
12 02 Nous n'avons que celui-ci.mp3
1- 03 Outro.mp3

Convertir ID3v2.3 à ID3v2.4
to24

Convertir ID3v2.4 à ID3v2.3
to23

Nom de fichier de Étiquette
à partir de la balise [Format] [NUMÉROS D'ÉTIQUETTE]

Définissez les noms de fichiers des fichiers sélectionnés à partir des valeurs des balises, par exemple à partir de la balise
"%{Piste} - %{Titre}" 1. Si aucun format n'est spécifié, le format défini dans l'interface graphique est utilisé.

Jour de nom de fichier
taguer [Format] [NUMÉROS D'ÉTIQUETTE]

Définissez les cadres de balises à partir des noms de fichiers, par exemple taguer "%{albumartiste} -
%{album}/%{piste} %{Titre}" 2. Si aucun format n'est spécifié, le format défini dans l'interface graphique est
utilisé. Si le format du nom de fichier ne correspond pas à ce modèle, quelques autres
les formats utilisés sont essayés.

Jour à autre Étiquette
synchro {NUMÉRO D'ÉTIQUETTE}

Copiez les cadres de balise d'une balise à l'autre, par exemple pour définir la balise ID3v2 à partir du
Balise ID3v1, utilisez synchro 2.

Copier
copier [NUMÉRO D'ÉTIQUETTE]

Copiez les cadres de balises du fichier sélectionné dans le tampon de copie interne. Ils peuvent alors être
défini sur un autre fichier à l'aide de la paste commander.

pâtes
paste [NUMÉRO D'ÉTIQUETTE]

Définir des cadres de balises à partir du contenu du copier tampon dans les fichiers sélectionnés.

Effacer
supprimez [NUMÉRO D'ÉTIQUETTE]

Supprimer une balise.

Jouez
jeux et sport [pause | arrêter | précédent | Suivant]

Lancez la lecture audio. Une fois démarré, il peut être contrôlé avec le pause
(pour faire une pause et reprendre), Arrêtez, précédent ainsi que next options.

Exemples
Définissez la couverture de l'album dans tous les fichiers d'un répertoire à l'aide de la fonction d'importation par lots :

kid3-cli -c 'auto-import "Couverture De l'art"' /chemin/vers/répertoire

Supprimez les cadres de commentaires et appliquez le format de balise dans les deux balises de tous les fichiers MP3 d'un
annuaire:

kid3-cli -c 'ensemble commentaire "" 1' -c 'ensemble commentaire "" 2' \
-c 'tagformat 1' -c 'tagformat 2' /chemin/vers/répertoire/*.mp3

Importez automatiquement la balise 2, synchronisez avec la balise 1, définissez les noms de fichiers à partir de la balise 2 et enfin
créer une liste de lecture :

kid3-cli -c importation automatique -c 'syncto 1' -c à partir de la balise -c playlist \
/chemin/vers/répertoire/*.mp3

Pour tous les fichiers avec une balise ID3v2.4.0, convertissez-vous en ID3v2.3.0 et supprimez le cadre de l'arrangeur :

kid3-cli -c "filtre 'ID3v2.4.0 Étiqueter'" -c "sélectionner tous" -c to23 \
-c "ensemble arrangeur ''" /chemin/vers/répertoire

Ce script Python utilise kid3-cli pour générer des images iTunes Sound Check iTunNORM à partir de
rejouer les informations de gain.

#!/ usr / bin / env python
# Générez iTunes Sound Check à partir de ReplayGain.
de __future__ import print_function
importer os, sys, sous-processus

def rg2sc(dirpath) :
pour la racine, les répertoires, les fichiers dans os.walk(dirpath) :
pour le nom dans les fichiers :
if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join(racine, nom)
rg = sous-processus.check_output([
'kid3-cli', '-c', 'get "replaygain_track_gain"',
fn]).strip()
si rg. se termine par (b' dB'):
rg = rg[:-3]
Essai:
rg = flotteur (rg)
sauf ValueError:
print('La valeur %s de %s n'est pas un flottant' % (rg, fn))
continuer
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
sous-processus.appel([
'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

si __name__ == '__main__':
rg2sc(sys.argv[1])

CRÉDITS ET LICENCE

Kid3

Programme écrit par Urs Fleisch

FDL

GPL

INSTALLATION

Comment à obtenir Kid3
Kid3 peut être trouvé à http://kid3.sourceforge.net.

Exigences
Kid3 a besoin Qt[22]. KDE[23] est recommandé mais pas nécessaire, car Kid3 peut également être compilé
en tant qu'application Qt. Kid3 peut être compilé pour les systèmes où ces bibliothèques sont
disponible, par exemple pour GNU/Linux, Windows et Mac OS X. Pour marquer les fichiers Ogg/Vorbis, libogg[13]
libvorbis ainsi que fichier libvorbis[14] sont requis, pour les fichiers FLAC libFLAC++ ainsi que libFLAC[15].
id3lib[12] est utilisé pour les fichiers MP3. Ces quatre formats sont également pris en charge par TagLib[16]
qui peut également gérer les fichiers Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
et des modules de suivi. Pour importer à partir d'empreintes acoustiques, Impression chromatique[18] et libre
sont utilisés.

Kid3 est disponible pour la plupart des distributions Linux, Windows et Mac OS X. Des liens peuvent être trouvés
on http://kid3.sourceforge.net.

Compilation ainsi que Installation
Vous pouvez compiler Kid3 avec ou sans KDE. Sans KDE, Kid3 est une simple application Qt et
manque de certaines fonctionnalités de configuration et de session.

Pour une version de KDE, allez dans le répertoire supérieur et tapez

% cmake .
% faire
% faire installer

Pour compiler pour différentes versions de Qt ou KDE, définissez le cmake options.

Si toutes les bibliothèques ne sont pas présentes, Kid3 est construit avec des fonctionnalités réduites. Ainsi vous devriez
veillez à ce que tous les packages de développement souhaités soient installés. D'un autre côté,
cmake-options contrôle dans quelles bibliothèques sont compilées. La valeur par défaut est -D
WITH_TAGLIB :BOOL=ON -D WITH_MP4V2:BOOL=NON -D WITH_ID3LIB : BOOL=ON -D
WITH_CHROMAPRINT : BOOL=ON -D WITH_VORBIS : BOOL=ON -D AVEC_FLAC:BOOL=ON . Ces options peuvent
être désactivé à l'aide de remise.

Pour construire Kid3 en tant qu'application Qt sans KDE, utilisez le cmake option -DWITH_APPS=Qt. Pour
construisez à la fois une application KDE et une application Qt, définissez -DWITH_APPS="Qt;KDE".

Qt 4 ou Qt 5 peuvent être utilisés. Pour forcer l'utilisation de Qt 4, définissez -DWITH_QT4=OUI, pour forcer l'utilisation de
Qt 5, ensemble -DWITH_QT5=OUI, si ces deux options sont OFF (par défaut), Qt 4 est préféré si
les deux versions sont installées. Pour utiliser une installation Qt spécifique, définissez
-DQT_QMAKE_EXECUTABLE=/chemin/vers/qmake. Si la construction de l'application KDE est activée, la configuration
Qt 4 utilisera KDE 4, tandis que la configuration de Qt 5 utilisera KDE 5.

La génération de RPM-Packages est prise en charge par le fichier kid3.spec, pour Debian-Packages, le
le script build-deb.shis est disponible.

L'application Qt peut également être compilée pour Windows et Mac OS X. Les scripts dans le
Les dossiers win32 et macosx peuvent être utilisés pour construire et créer des packages. Les bibliothèques peuvent être
installé à l'aide de buildlibs.sh.

configuration
Avec KDE, le filtre et le format de nom de fichier, les formats d'import, le nom de fichier et ID3
formats, les paramètres de la barre d'outils et de la barre d'état ainsi que la taille de la fenêtre seront enregistrés dans
l'emplacement standard dans le fichier kid3rc. En tant qu'application Qt, ce fichier est dans
.config/Kid3/Kid3.conf. Sous Windows, la configuration est stockée dans le registre.

D-BUS INTERFACE

Autobus D Exemples
Les versions Qt 4 et KDE 4 sur Linux offrent une interface D-Bus pour contrôler Kid3 par des scripts.
Les scripts peuvent être écrits dans n'importe quel langage avec des liaisons D-Bus (par exemple en Python) et peuvent être
ajouté aux actions de l'utilisateur pour étendre les fonctionnalités de Kid3.

L'artiste dans la balise 2 du fichier actuel peut être mis à la valeur "One Hit Wonder" avec le
code suivant:

coquillage

dbus-send --dest=net.sourceforge.kid3 --print-reply=littéral \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 chaîne : 'Artiste' \
chaîne : 'One Hit Wonder'

ou plus facile avec Qt's qdbus (qdbusviewer peut être utilisé pour explorer l'interface dans une interface graphique) :

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Artiste \
'Un coup étonnant'

Python

importer dbus
kid3 = dbus.SessionBus().get_object(
'net.sourceforge.kid3', '/Kid3')
kid3.setFrame(2, 'Artiste', 'One Hit Wonder')

Perl

utiliser Net::DBus;
$kid3 = Net::DBus->session->get_service(
"net.sourceforge.kid3")->get_object(
"/Kid3", "net.sourceforge.Kid3");
$kid3->setFrame(2, "Artiste", "One Hit Wonder");

Autobus D API
L'API D-Bus est spécifiée dans net.sourceforge.Kid3.xml. L'interface Kid3 a le
méthodes suivantes:

Ouvert filet or annuaire
booléen openDirectory(chaîne chemin);

chemin
chemin d'accès au fichier ou au répertoire

Renvoie vrai si OK.

Épargnez TOUTE modifié fichiers
booléen enregistrer (annuler);

Renvoie vrai si OK.

Obtenez a détaillé erreur message à condition de by quelques méthodes
un magnifique getErrorMessage(void);

Renvoie un message d'erreur détaillé.

Revenir change in le choisi fichiers
revenir (vide);

Accueil an automatique lot importer
booléen batchImport(int32 baliseMasque, un magnifique nom de profil);

baliseMasque
masque de variable (bit 0 pour la variable 1, bit 1 pour la variable 2)

nom de profil
nom du profil d'importation par lots à utiliser

L’ étiquettes de a filet
booléen importFromFile(int32 baliseMasque, un magnifique chemin, int32 fmtIdx);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

chemin
chemin du fichier

fmtIdx
indice de format

Renvoie vrai si OK.

Télécharger album couverture art
downloadAlbumArt(chaîne url, booléen allFilesInDir);

url
URL du fichier image ou de la ressource de pochette d'album

allFilesInDir
true pour ajouter l'image à tous les fichiers du répertoire

Exportations étiquettes à a filet
booléen exportVersFichier(int32 baliseMasque, un magnifique chemin, int32 fmtIdx);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

chemin
chemin du fichier

fmtIdx
indice de format

Renvoie vrai si OK.

Création a playlist
booléen créer une liste de lecture (void);

Renvoie vrai si OK.

quitter le application
quitter (annuler);

Sélectionnez TOUTE fichiers
selectAll (vide);

Désélectionner TOUTE fichiers
desselectAll(void);

Ensemble le premier filet as le actuel filet
booléen premierFichier(void);

Renvoie vrai s'il y a un premier fichier.

Ensemble le précédent filet as le actuel filet
booléen fichier précédent(void);

Renvoie vrai s'il existe un fichier précédent.

Ensemble le next filet as le actuel filet
booléen suivantFichier(void);

Renvoie vrai s'il y a un fichier suivant.

Sélectionnez le premier filet
booléen selectFirstFile(void);

Renvoie vrai s'il y a un premier fichier.

Sélectionnez le précédent filet
booléen selectFichierPrécédent(void);

Renvoie vrai s'il existe un fichier précédent.

Sélectionnez le next filet
booléen selectFichierSuivant(void);

Renvoie vrai s'il y a un fichier suivant.

Sélectionnez le actuel filet
booléen selectCurrentFile (void);

Renvoie vrai s'il existe un fichier courant.

Développer vous or effondrement le actuel filet questions d'examen if it is a annuaire
booléen développerRépertoire(void);

Un élément de liste de fichiers est un répertoire si getFileName() renvoie un nom avec '/' comme dernier
caractère.

Renvoie true si l'élément de fichier actuel est un répertoire.

Appliquer le filet prénom le format
appliquerFormatNomFichier(void);

Appliquer le Étiquette le format
appliquerTagFormat(void);

Appliquer texte codage
appliquerTextEncoding(void);

Ensemble le annuaire prénom de le étiquettes
booléen setDirNameFromTag(int32 baliseMasque, un magnifique le format, booléen engendrent);

baliseMasque
masque de variable (bit 0 pour la variable 1, bit 1 pour la variable 2)

le format
format de nom de répertoire

engendrent
vrai pour créer, faux pour renommer

Renvoie vrai si OK, sinon le message d'erreur est disponible en utilisant getErrorMessage().

Ensemble ultérieur suivre numéros in le choisi fichiers
nombrePistes(int32 baliseMasque, int32 premierTrackNr);

baliseMasque
masque de variable (bit 0 pour la variable 1, bit 1 pour la variable 2)

premierTrackNr
numéro à utiliser pour le premier fichier

Filtre le fichiers
filter(chaîne expression);

expression
expression de filtre

Convertir ID3v2.3 étiquettes à ID3v2.4
convertToId3v24(void);

Convertir ID3v2.4 étiquettes à ID3v2.3
convertToId3v23(void);

Renvoie vrai si OK.

Obtenez chemin of annuaire
un magnifique getDirectoryName(void);

Renvoie le chemin absolu du répertoire.

Obtenez prénom of actuel filet
un magnifique getFileName(void);

Renvoie le vrai nom de fichier absolu, se termine par "/" s'il s'agit d'un répertoire.

Ensemble prénom of choisi filet
setNomFichier(chaîne prénom);

prénom
nom de fichier

Le fichier sera renommé lors de l'enregistrement du répertoire.

Ensemble le format à utilisé quand mise le nom de fichier de le étiquettes
setFileNameFormat(chaîne le format);

le format
format de nom de fichier

Ensemble le filet noms of le choisi fichiers de le étiquettes
setFileNameFromTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Obtenez Plus-value of cadre
un magnifique getFrame(int32 baliseMasque, un magnifique prénom);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

prénom
nom du cadre (par exemple "artiste")

Pour obtenir des données binaires comme une image, le nom d'un fichier à écrire peut être ajouté après le
prénom, par exemple "Image:/chemin/vers/fichier". De la même manière, les paroles synchronisées peuvent être
exporté, par exemple "SYLT:/chemin/vers/fichier".

Renvoie la valeur du cadre.

Ensemble Plus-value of cadre
booléen setFrame(int32 baliseMasque, un magnifique prénom, un magnifique Plus-value);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

prénom
nom du cadre (par exemple "artiste")

Plus-value
valeur du cadre

Pour la balise 2 (baliseMasque 2), si pas de cadre avec prénom existe, un nouveau cadre est ajouté, si Plus-value is
vide, le cadre est supprimé. Pour ajouter des données binaires comme une image, un fichier peut être ajouté
après le prénom, par exemple "Image:/chemin/vers/fichier". "SYLT:/chemin/vers/fichier" peut être utilisé pour
importer des paroles synchronisées.

Renvoie vrai si OK.

Obtenez TOUTE cadres of a Étiquette
tableau of un magnifique getTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Renvoie une liste avec des noms et des valeurs de trame alternés.

Obtenez technique d'information à propos filet
tableau of un magnifique getInformation(vide);

Les propriétés sont Format, Bitrate, Samplerate, Canaux, Durée, Mode de canal, VBR, Tag
1, Tag 2. Les propriétés qui ne sont pas disponibles sont omises.

Renvoie une liste avec des noms et des valeurs de propriété alternés.

Ensemble Étiquette de filet prénom
setTagFromFileName(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Ensemble Étiquette de autre Étiquette
setTagFromAutreTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Copier Étiquette
copieTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

pâtes Étiquette
collerTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Effacer Étiquette
supprimerTag(int32 baliseMasque);

baliseMasque
bit de balise (1 pour la balise 1, 2 pour la balise 2)

Réparer le paramétrage
reparseConfiguration(void);

Des changements de configuration automatisés sont possibles en modifiant le fichier de configuration et
puis en réparant la configuration.

Pièces le choisi fichiers
playAudio (vide);

QML INTERFACE

QML Exemples
Les scripts QML peuvent être invoqués via le menu contextuel de la liste de fichiers et peuvent être définis dans l'onglet
Actions utilisateur de la boîte de dialogue des paramètres. Les scripts qui y sont définis peuvent être utilisés comme
exemples pour programmer des scripts personnalisés. QML utilise JavaScript, voici l'obligatoire "Bonjour
Monde":

importer Kid3 1.0

Kid3Script {
onRun : {
console.log("Bonjour tout le monde, le répertoire est", app.dirName)
Qt.quit()
}
}

Si ce script est enregistré sous /path/to/Example.qml, la commande utilisateur peut être définie comme @qml
/chemin/vers/exemple.qml avec nom QML Teste et Sortie cochée. Il peut alors être démarré en utilisant
l'élément Test QML dans le menu contextuel de la liste de fichiers, et la sortie sera visible dans le
fenêtre.

Alternativement, le script peut également être lancé indépendamment de Kid3 en utilisant les outils QML.

qmlviewer -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

Pour Qt 5, les commandes

qml -apptype widget -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

or

qmlscene -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

peut être utilisé. Sous Windows et OS X, le chemin d'import doit être adapté au dossier d'imports
dans le répertoire d'installation. Les scripts démarrés en dehors de Kid3 utiliseront le
répertoire, il doit donc être modifié au préalable.

Pour lister les titres dans les balises 2 de tous les fichiers du répertoire courant, procédez comme suit
le script peut être utilisé :

importer Kid3 1.0

Kid3Script {
onRun : {
app.firstFile()
faire {
si (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2, "titre"))
} tandis que (app.nextFile())
}
}

Si le répertoire contient de nombreux fichiers, un tel script peut bloquer l'interface utilisateur pour
parfois. Pour des opérations plus longues, il faut donc faire une pause de temps en temps. Les
l'implémentation alternative ci-dessous a le travail pour un seul fichier déplacé dans une fonction.
Cette fonction s'appelle avec un timeout de 1 ms à la fin, étant donné que plus de fichiers ont
à traiter. Cela garantira que l'interface graphique reste réactive pendant que le script est
exécution.

importer Kid3 1.0

Kid3Script {
onRun : {
fonction doWork() {
si (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2, "titre"))
}
si (!app.nextFile()) {
Qt.quit()
} Else {
setTimeout(doWork, 1)
}
}

app.firstFile()
faire du travail()
}
}

D'autres exemples de scripts sont fournis avec Kid3 et sont déjà enregistrés en tant que commandes utilisateur.

· ReplayGain vers SoundCheck (ReplayGain2SoundCheck.qml) : créer iTunNORM SoundCheck
informations provenant des trames de gain de relecture.

· Redimensionner les pochettes d'album (ResizeAlbumArt.qml) : redimensionner les images de pochettes intégrées qui sont
plus grand que 500x500 pixels.

· Extraire les pochettes d'album (ExtractAlbumArt.qml) : extraire toutes les images de pochettes intégrées
éviter les doublons.

· Intégrer la pochette d'album (EmbedAlbumArt.qml) : Intégrer la pochette trouvée dans les fichiers image dans l'audio
fichiers dans le même dossier.

· Intégrer les paroles (EmbedLyrics.qml) : récupérez les paroles non synchronisées du service Web.

· Encodage de texte ID3v1 (ShowTextEncodingV1.qml) : Aide à trouver l'encodage des balises ID3v1
en affichant les balises du fichier en cours dans tous les encodages de caractères disponibles.

· Exporter CSV (ExportCsv.qml) : exporter de manière récursive toutes les balises de tous les fichiers vers un fichier CSV.

· Console QML (QmlConsole.qml) : Console simple pour jouer avec l'API QML de Kid3.

QML API
L'API peut être facilement explorée à l'aide de la console QML, disponible à titre d'exemple
script avec une interface utilisateur.

Kid3Script
Kid3Script est un composant QML standard situé dans le répertoire du plugin. Vous pourriez
utilisez également un autre composant QML. L'utilisation de Kid3Script facilite le démarrage du
fonction de script utilisant le en cours d'exécution gestionnaire de signaux. Il masque également les différences entre
les versions QtQuick, afin de rendre les scripts compatibles à la fois avec Qt 4 et Qt 5.
De plus, il offre quelques fonctions :

onRun : gestionnaire de signal qui est invoqué lorsque le script est démarré
tagv1, tagv2, tagv2v1 : constantes pour les paramètres de balise
script : accès aux fonctions de script
configs : accès aux objets de configuration
getArguments() : liste des arguments du script
isStandalone() : vrai si le script n'a pas été lancé depuis Kid3
setTimeout(callback, delay) : démarre le rappel après un délai ms

Scripting Les fonctions
Comme JavaScript et donc QML n'ont qu'un ensemble limité de fonctions pour le script,
le scénario object a quelques méthodes supplémentaires, par exemple :

script.properties(obj) : chaîne avec les propriétés Qt
script.writeFile(filePath, data): Écrire les données dans le fichier, vrai si OK
script.readFile(filePath): Lire les données du fichier
script.removeFile(filePath): Supprimer le fichier, vrai si OK
script.fileExists(filePath): vrai si le fichier existe
script.renameFile(oldName, newName): renommer le fichier, vrai si OK
script.tempPath() : chemin vers le répertoire temporaire
script.listDir(chemin, [nomFiltres], [classifier]) : liste les entrées du répertoire
script.system(program, [args], [msecs]): Lancer de manière synchrone une commande système,
[code de sortie, sortie standard, erreur standard] si pas de délai d'attente
script.getEnv(varName): Obtenir la valeur de la variable d'environnement
script.setEnv(varName, value): Définir la valeur de la variable d'environnement
script.getQtVersion() : chaîne de version Qt, par exemple "5.4.1"
script.getDataMd5(data): Récupère la chaîne hexadécimale du hachage MD5 des données
script.getDataSize(data): Obtenir la taille du tableau d'octets
script.dataToImage(data, [format]): Créer une image à partir d'octets de données
script.dataFromImage(img, [format]): Récupère les octets de données de l'image
script.loadImage(filePath) : charge une image à partir d'un fichier
script.saveImage(img, filePath, [format]): Enregistre une image dans un fichier, vrai si OK
script.imageProperties(img): Récupère les propriétés d'une image, une carte contenant
"width", "height", "depth" et "colorCount", vide si image invalide
script.scaleImage(img, width, [height]) : met à l'échelle une image, renvoie l'image mise à l'échelle
script.selectFileName(caption, dir, filter, saveFile): Ouvrir la boîte de dialogue du fichier pour
sélectionner un fichier

Candidature Comportementale
En utilisant QML, une grande partie des fonctions de Kid3 sont accessibles. L'API est similaire à
celui utilisé pour le D-Bus. Pour plus de détails, reportez-vous aux notes respectives.

app.openDirectory(chemin): Ouvrir le répertoire
app.saveDirectory() : enregistrer le répertoire
app.revertFileModifications() : Rétablir
app.importTags(tag, path, fmtIdx) : importer le fichier
app.downloadImage(url, allFilesInDir): Télécharger l'image
app.exportTags(tag, path, fmtIdx) : fichier d'exportation
app.writePlaylist() : Écrire une liste de lecture
app.selectAllFiles() : tout sélectionner
app.deselectAllFiles() : désélectionner
app.firstFile([select]): Vers le premier fichier
app.nextFile([sélectionner]): Vers le fichier suivant
app.previousFile([select]): Vers le fichier précédent
app.selectCurrentFile([select]): Sélectionnez le fichier actuel
app.requestExpandFileList() : tout développer
app.applyFilenameFormat() : appliquer le format de nom de fichier
app.applyTagFormat() : appliquer le format de balise
app.applyTextEncoding() : appliquer l'encodage du texte
app.numberTracks(nr, total, tag, [options]) : nombre de pistes
app.applyFilter(expr) : filtre
app.convertToId3v23() : convertir ID3v2.4.0 en ID3v2.3.0
app.convertToId3v24() : convertir ID3v2.3.0 en ID3v2.4.0
app.getFilenameFromTags(tag) : nom de fichier à partir des balises
app.getTagsFromFilename(tag) : nom de fichier vers les balises
app.getAllFrames(tag): Obtenir un objet avec tous les cadres
app.getFrame(tag, nom): Obtenir le cadre
app.setFrame(tag, nom, valeur): Définir le cadre
app.getPictureData() : récupérer les données du cadre photo
app.setPictureData(data): Définir les données dans le cadre de l'image
app.copyToOtherTag(tag) : balises vers d'autres balises
app.copyTags(tag) : copier
app.pasteTags(tag): Coller
app.removeTags(tag): Supprimer
app.playAudio() : Lecture
app.readConfig() : Lire la configuration
app.applyChangedConfiguration() : Appliquer la configuration
app.dirName : nom du répertoire
app.selectionInfo.fileName : nom du fichier
app.selectionInfo.filePath : chemin de fichier absolu
app.selectionInfo.detailInfo : détails du format
app.selectionInfo.tagFormatV1 : format de la balise 1
app.selectionInfo.tagFormatV2 : format de la balise 2
app.selectionInfo.formatString(tag, format) : codes de substitution dans la chaîne de format

Pour les opérations asynchrones, les rappels peuvent être connectés aux signaux.

fonction automatiqueImporter(profil) {
fonction onAutomaticImportFinished() {
app.batchImporter.finished.disconnect (onAutomaticImportFinished)
}
app.batchImporter.finished.connect(onAutomaticImportFinished)
app.batchImport(profil, tagv2)
}

fonction renommerRépertoire (format) {
fonction onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory (tagv2v1, format, faux)
}

configuration Objets
Les différentes sections de configuration sont accessibles via des méthodes de configs. Leur
les propriétés peuvent être répertoriées dans la console QML.

script.properties(configs.networkConfig())

Les propriétés peuvent être définies :

configs.networkConfig().useProxy = false

configs.batchImportConfig()
configs.exportConfig()
configs.fileConfig()
configs.filenameFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
configs.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
configs.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()

Utilisez kid3-core en ligne en utilisant les services onworks.net