El manual del Kid3

Fleisch, Urs

Desenvolupament de programari 

Antoni Bella

Traductor 

3.9.3

Resum

El Kid3 és una aplicació per editar les etiquetes ID3 versió 1 i 2 en els fitxers MP3 de manera eficient. També s'admeten les etiquetes a fitxers Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els mòduls del seguidor de peces (MOD, S3M, IT i XM). És fàcil establir etiquetes a múltiples fitxers amb els mateixos valors (p. ex., àlbum, artista, any i gènere en tots els fitxers del mateix àlbum) i generar les etiquetes a partir del nom del fitxer o viceversa.


Sumari

Sinopsi
Opcions
kid3
kid3-qt
kid3-cli
1. Introducció
2. Usar el Kid3
Característiques del Kid3
Exemple d'ús
3. Referència d'ordres
Els elements de la IGU
Llista de fitxers
Editar una llista de reproducció
Llista de carpetes
Fitxer
Etiqueta 1
Etiqueta 2
Etiqueta 3
Llista de marcs
Lletra sincronitzada i els Codis de temps dels esdeveniments
Capítols ens els fitxers MP4
El menú Fitxer
El menú Edita
El menú Eines
El menú Arranjament
El menú Ajuda
4. kid3-cli
Ordres
Ajuda
Temps d'espera
Sortir de l'aplicació
Canviar de carpeta
Imprimir el nom de fitxer de la carpeta de treball actual
Llistar les carpetes
Desar els fitxers canviats
Seleccionar un fitxer
Seleccionar una etiqueta
Obtenir un marc d'etiqueta
Establir un marc d'etiqueta
Revertir
Importar des del fitxer
Importar automàticament
Descarregar el treball artístic de la caràtula de l'àlbum
Exportar a un fitxer
Crear una llista de reproducció
Aplicar el format per al nom de fitxer
Aplicar el format per a l'etiqueta
Aplicar la codificació del text
Reanomenar una carpeta
Nombre de peces
Filtrar
Convertir des d'ID3 versió 2.3 a 2.4
Convertir des d'ID3 versió 2.4 a 2.3
Nom del fitxer des de l'etiqueta
Etiquetar des del nom de fitxer
Etiquetar a una altra etiqueta
Copiar
Enganxar
Eliminar
Configurar el Kid3
Executa el programa o script en QML
Exemples
Format JSON
5. Crèdits i llicència
A. Instal·lació
Com obtenir el Kid3
Requisits
Compilació i instal·lació
Configuració
B. Interfície de D-Bus
Exemples de D-Bus
API de D-Bus
Obrir un fitxer o carpeta
Descarregar les etiquetes de tots els fitxers que no han estat modificats o seleccionats
Desar tots els fitxers modificats
Obtenir un missatge d'error detallat proporcionat per alguns mètodes
Revertir els canvis fets als fitxers seleccionats
Iniciar automàticament una importació per lots
Importar etiquetes des d'un fitxer
Importar etiquetes des d'altres etiquetes
Importar etiquetes des d'altres etiquetes als fitxers seleccionats
Descarregar una caràtula de l'àlbum
Exportar les etiquetes a un fitxer
Crear una llista de reproducció
Obtenir els elements d'una llista de reproducció
Establir els elements d'una llista de reproducció
Surt de l'aplicació
Seleccionar tots els fitxers
Desseleccionar tots els fitxers
Establir el primer fitxer com a fitxer actual
Establir el fitxer anterior com a fitxer actual
Establir el següent fitxer com a fitxer actual
Selecciona el primer fitxer
Seleccionar el fitxer anterior
Seleccionar el següent fitxer
Seleccionar el fitxer actual
Expandir o contraure l'element de fitxer actual si es tracta d'una carpeta
Aplicar el format per al nom del fitxer
Aplicar el format per a les etiquetes
Aplicar la codificació del text
Establir el nom de la carpeta a partir de les etiquetes
Establir els números de peça subsegüents en els fitxers seleccionats
Filtratge de fitxers
Convertir entre les etiquetes ID3 versió 2.3 i 2.4
Convertir entre les etiquetes ID3 versió 2.4 i 2.3
Obtenir el camí de la carpeta
Obtenir el nom del fitxer actual
Establir el nom del fitxer seleccionat
Establir el format que s'utilitzarà en establir el nom del fitxer a partir de les etiquetes
Establir els noms de fitxer a partir dels fitxers seleccionats des de les etiquetes
Obtenir el valor del marc
Establir el valor del marc
Obtenir tots els marcs d'una etiqueta
Obtenir la informació tècnica sobre el fitxer
Establir l'etiqueta a partir del nom de fitxer
Establir l'etiqueta a partir d'una altra etiqueta
Copiar una etiqueta
Enganxar una etiqueta
Eliminar una etiqueta
Tornar a analitzar la configuració
Reproduir els fitxers seleccionats
C. Interfície QML
Exemples en QML
API de QML
Kid3Script
Funcions de creació de scripts
Context de l'aplicació
Configuració dels objectes

Llistat de taules

3.1. Associacions dels tipus de marcs unificats amb els diversos formats
3.2. Entrada a la taula de puntuació

Sinopsi

kid3 [ --help | --author | --version | --license | --desktopfile FITXER ] [FITXER...]

kid3-qt [ --portable ] [ Opcions de les Qt ] [FITXER...]

kid3-cli [ --portable ] [ --dbus ] [ -h | --help ] [ -c ORDRE_1 ] [ -c ORDRE_2 ...] [FITXER...]

Opcions

--portable

Emmagatzema la configuració al fitxer kid3.ini a dins de la carpeta de l'aplicació.

FITXER

Si FITXER és el camí a una carpeta, s'obrirà. Si es proporcionen un o més camins de fitxer, s'obrirà la seva carpeta comuna i se seleccionaran els fitxers.

kid3

--help

Mostra ajuda quant a les opcions.

--author

Mostra informació sobre l'autor.

--version

Mostra informació sobre la versió.

--license

Mostra informació sobre la llicència.

--desktopfile FITXER

El nom del fitxer base de l'entrada de l'escriptori per a aquesta aplicació.

kid3-qt

Opcions de les Qt

Vegeu qt5options(7).

kid3-cli

--dbus

Activa la interfície de D-Bus.

-c

Executa una ordre. Són possibles múltiples opcions -c, s'executaran en seqüència. Vegeu la secció sobre el kid3-cli per a una descripció de les ordres disponibles.

-h|--help

Mostra ajuda quant a les opcions i ordres.

Capítol 1. Introducció

El Kid3 és una aplicació per editar les etiquetes ID3 versió 1 i 2 en els fitxers MP3 de manera eficient. La majoria dels reproductors de MP3 poden editar aquestes etiquetes, però no d'una manera molt còmoda i eficient. A més, també s'admeten les etiquetes als fitxers Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els mòduls del seguidor de peces (MOD, S3M, IT i XM).

El Kid3 no enregistra ni codifica els fitxers MP3, però està dirigit a editar les etiquetes ID3 de tots els fitxers d'un àlbum de manera eficient, és a dir, amb el menor nombre de clics i pulsacions de tecles possibles. On la majoria dels altres programes poden editar etiquetes ID3 versió 1 o 2, el Kid3 té un control total sobre ambdues versions, pot convertir les etiquetes entre els dos formats i té accés a totes les etiquetes ID3 versió 2. Es poden establir les etiquetes de múltiples fitxers amb el mateix valor, p. ex., l'artista, àlbum, any i gènere de tots els fitxers d'un àlbum que generalment tenen els mateixos valors i es poden configurar junts. Si la informació de les etiquetes està continguda en el nom del fitxer, les etiquetes es podran establir automàticament a partir del nom del fitxer. També és possible establir el nom del fitxer a partir de les etiquetes trobades en el fitxer en formats arbitraris.

La tasca d'edició se sosté addicionalment amb la substitució automàtica de caràcters o subcadenes, per exemple, per eliminar caràcters il·legals dels noms de fitxer. El control automàtic de majúscules i minúscules facilita l'ús d'un esquema de noms coherent en totes les etiquetes.

La informació de l'etiqueta per a àlbums sencers es pot obtenir des de gnudb.org, MusicBrainz, Discogs, Amazon o altres fonts de llistes de peces. El format d'importació és lliurement configurable amb expressions regulars.

Podreu informar de qualsevol problema o petició de característica a l'autor.

Capítol 2. Usar el Kid3

Característiques del Kid3

  • Edita les etiquetes ID3 versió 1

  • Edita tots els marcs ID3 versió 2.3 i 2.4

  • Edita les etiquetes de múltiples fitxers

  • Converteix entre les etiquetes ID3 versió 1 i 2

  • Edita les etiquetes dels MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV i AIFF

  • Genera les etiquetes a partir del nom del fitxer

  • Genera les etiquetes a partir del contingut als camps d'etiqueta

  • Genera els noms de fitxer a partir de les etiquetes

  • Genera i canvia els noms de les carpetes a partir de les etiquetes

  • Genera un fitxer de llista de reproducció

  • Conversió automàtica entre majúscules i minúscules, i traducció de les cadenes

  • Importa des de gnudb.org, MusicBrainz, Discogs, Amazon i altres fonts de dades

  • Exporta com a CSV, HTML, llista de reproducció, XML del Kover i altres formats. Els fitxers CSV exportats es podran importar de nou.

Exemple d'ús

Aquesta secció descriu una sessió típica amb el Kid3. Suposem que tenim una carpeta que conté fitxers MP3 amb les peces de l'àlbum «I si canto trist» del cantautor «Lluís Llach». La carpeta s'anomena en el format «artista - àlbum», en el nostre cas «Lluís Llach - I si canto trist». La carpeta conté les peces en el format «títol de la peça.mp3», el qual crec que és útil perquè els noms dels fitxers són curts (important quan s'empren reproductors de MP3 mòbils amb pantalles petites) i en l'ordre correcte quan s'ordenen alfabèticament (important quan es fa servir maquinari reproductor de MP3 que reprodueixen les peces en ordre alfabètic o en l'ordre en què es graven en el CD i aquest ordre és alfabètic quan s'utilitza el mkisofs). A més d'això, la informació de l'artista i de l'àlbum ja es troba al nom de la carpeta i no s'ha de repetir en el nom del fitxer. Però tornant al nostre exemple, el llistat de la carpeta es veurà així:

01 El jorn dels miserables.mp3

02 Cançó a Mahalta.mp3

03 Vaixell de Grècia.mp3

Aquests fitxers encara no tenen etiquetes i volem generar-les utilitzant el Kid3. Emprem l'element de menú FitxerObre... (o el botó a la barra d'eines) i seleccionem un dels fitxers en aquesta carpeta. Tots els fitxers es mostraran en el quadre de llista de fitxers. Mandrosos com som, volem fer servir la informació a la carpeta i els noms de fitxer per a generar les etiquetes. Per tant, seleccionarem tots els fitxers, després farem clic al botó A: Etiqueta 1 a la secció Fitxer. Això establirà els valors de títol, artista, àlbum i peça en tots els fitxers. Per establir els valors d'any i gènere de tots els fitxers, mantindrem seleccionats tots els fitxers i escriurem «2002» per a la Data i seleccionem Cantautor des del quadre combinat Gènere. Per establir només aquests dos valors, les seves caselles de selecció es marcaran automàticament i totes les altres caselles es deixaran sense marcar. Ara canviarem la selecció seleccionant només el primer fitxer i veurem que totes les etiquetes contenen els valors correctes. Les etiquetes dels altres fitxers també es poden verificar seleccionant-los un per un. Quan estiguem satisfets amb les etiquetes, emprem l'element de menú FitxerDesa (o el botó a la barra d'eines). En seleccionar l'element de menú FitxerCrea una llista de reproducció... (o el botó a la barra d'eines) es generarà un fitxer «Lluís Llach - I si canto trist.m3u» a la carpeta.

Capítol 3. Referència d'ordres

Els elements de la IGU

La IGU del Kid3 està separada en sis seccions: a l'esquerra hi ha els quadres de llista de fitxers i carpetes, el costat dret conté les seccions Fitxer, Etiqueta 1, Etiqueta 2 i Etiqueta 3.

Per a navegar entre les diferents seccions emprant el teclat, s'admeten diverses dreceres de teclat. A les seccions d'etiquetes, les dreceres estaran actives mentre no s'edita text o quan s'està a la primera columna.

  • Alt+Fletxa esquerra: Va a la selecció anterior (Ordre+] en el macOS®)

  • Alt+Fletxa dreta: Va a la següent selecció (Ordre+] en el macOS®)