KID3(1) El manual del Kid3 KID3(1) NOM kid3, kid3-qt, kid3-cli - Kid3 ID3 Tagger 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 configuracio al fitxer kid3.ini a dins de la carpeta de l'aplicacio. FITXER Si FITXER es el cami a una carpeta, s'obrira. Si es proporcionen un o mes camins de fitxer, s'obrira la seva carpeta comuna i se seleccionaran els fitxers. kid3 --help Mostra ajuda quant a les opcions. --author Mostra informacio sobre l'autor. --version Mostra informacio sobre la versio. --license Mostra informacio sobre la llicencia. --desktopfile FITXER El nom del fitxer base de l'entrada de l'escriptori per a aquesta aplicacio. kid3-qt Opcions de les Qt Vegeu qt5options(7). kid3-cli --dbus Activa la interficie de D-Bus. -c Executa una ordre. Son possibles multiples opcions -c, s'executaran en sequencia. Vegeu la seccio sobre el kid3-cli per a una descripcio de les ordres disponibles. -h|--help Mostra ajuda quant a les opcions i ordres. INTRODUCCIO El Kid3 es una aplicacio per a editar les etiquetes ID3 versio 1 i 2 en els fitxers MP3 de manera eficient. La majoria dels reproductors d'MP3 poden editar aquestes etiquetes, pero no d'una manera molt comoda i eficient. A mes, tambe s'admeten les etiquetes als fitxers Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els moduls del seguidor de peces (MOD, S3M, IT i XM). El Kid3 no enregistra ni codifica els fitxers MP3, pero esta dirigit a editar les etiquetes ID3 de tots els fitxers d'un album de manera eficient, es a dir, amb el menor nombre de clics i pulsacions de tecles possibles. On la majoria dels altres programes poden editar etiquetes ID3 versio 1 o 2, el Kid3 te un control total sobre ambdues versions, pot convertir les etiquetes entre els dos formats i te acces a totes les etiquetes ID3 versio 2. Es poden establir les etiquetes de multiples fitxers amb el mateix valor, p. ex., l'artista, album, any i genere de tots els fitxers d'un album que generalment tenen els mateixos valors i es poden configurar junts. Si la informacio de les etiquetes esta continguda en el nom del fitxer, les etiquetes es podran establir automaticament a partir del nom del fitxer. Tambe es possible establir el nom del fitxer a partir de les etiquetes trobades en el fitxer en formats arbitraris. La tasca d'edicio se soste addicionalment amb la substitucio automatica de caracters o subcadenes, per exemple, per a eliminar caracters il.legals dels noms de fitxer. El control automatic de majuscules i minuscules facilita l'us d'un esquema de noms coherent en totes les etiquetes. La informacio de l'etiqueta per a albums sencers es pot obtenir des de gnudb.org[1], MusicBrainz[2], Discogs[3], Amazon[4] o altres fonts de llistes de peces. El format d'importacio es lliurement configurable amb expressions regulars. Podreu informar de qualsevol problema o peticio de caracteristica a l'autor. USAR EL KID3 Caracteristiques del Kid3 o Edita les etiquetes ID3 versio 1 o Edita tots els marcs ID3 versio 2.3 i 2.4 o Edita les etiquetes de multiples fitxers o Converteix entre les etiquetes ID3 versio 1 i 2 o Edita les etiquetes dels MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV i AIFF o Genera les etiquetes a partir del nom del fitxer o Genera les etiquetes a partir del contingut als camps d'etiqueta o Genera els noms de fitxer a partir de les etiquetes o Genera i canvia els noms de les carpetes a partir de les etiquetes o Genera un fitxer de llista de reproduccio o Conversio automatica entre majuscules i minuscules, i traduccio de les cadenes o Importa des de gnudb.org[1], MusicBrainz[2], Discogs[3], Amazon[4] i altres fonts de dades o Exporta com a CSV, HTML, llista de reproduccio, XML del Kover i altres formats. Els fitxers CSV exportats es podran importar de nou. Exemple d'us Aquesta seccio descriu una sessio tipica amb el Kid3. Suposem que tenim una carpeta que conte fitxers MP3 amb les peces de l'album <> del cantautor <>. La carpeta s'anomena en el format <>, en el nostre cas <>. La carpeta conte les peces en el format <>, el qual crec que es util perque els noms dels fitxers son curts (important quan s'empren reproductors d'MP3 mobils amb pantalles petites) i en l'ordre correcte quan s'ordenen alfabeticament (important quan es fa servir maquinari reproductor d'MP3 que reprodueixen les peces en ordre alfabetic o en l'ordre en que es graven en el CD i aquest ordre es alfabetic quan s'utilitza el mkisofs). A mes d'aixo, la informacio de l'artista i de l'album ja es troba al nom de la carpeta i no s'ha de repetir en el nom del fitxer. Pero tornant al nostre exemple, el llistat de la carpeta es veura aixi: 01 El jorn dels miserables.mp3 02 Canco a Mahalta.mp3 03 Vaixell de Grecia.mp3 Aquests fitxers encara no tenen etiquetes i volem generar-les utilitzant el Kid3. Emprem l'element de menu Fitxer -> Obre... (o el boto 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 informacio a la carpeta i els noms de fitxer per a generar les etiquetes. Per tant, seleccionarem tots els fitxers, despres farem clic al boto A: Etiqueta 1 a la seccio Fitxer. Aixo establira els valors de titol, artista, album i peca en tots els fitxers. per a establir els valors d'any i genere de tots els fitxers, mantindrem seleccionats tots els fitxers i escriurem <<2002>> per a la Data i seleccionem Cantautor des del quadre combinat Genere. per a establir nomes aquests dos valors, les seves caselles de seleccio es marcaran automaticament i totes les altres caselles es deixaran sense marcar. Ara canviarem la seleccio seleccionant nomes el primer fitxer i veurem que totes les etiquetes contenen els valors correctes. Les etiquetes dels altres fitxers tambe es poden verificar seleccionant-los un per un. Quan estiguem satisfets amb les etiquetes, emprem l'element de menu Fitxer -> Desa (o el boto a la barra d'eines). En seleccionar l'element de menu Fitxer -> Crea una llista de reproduccio... (o el boto a la barra d'eines) es generara un fitxer <> a la carpeta. REFERENCIA DORDRES Els elements de la IGU La IGU del Kid3 esta separada en sis seccions: a l'esquerra hi ha els quadres de llista de fitxers i carpetes, el costat dret conte 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'esta a la primera columna. o Alt+Fletxa esquerra: Va a la seleccio anterior (Ordre+] en el macOS(R)) o Alt+Fletxa dreta: Va a la seguent seleccio (Ordre+] en el macOS(R)) o Ctrl+Maj+V: Des d'una altra etiqueta o Ctrl+C: Copia o Ctrl+V: Enganxa o Maj+Supr: Elimina o F2: Edita o Inser: Afegeix o Supr: Suprimeix Llista de fitxers La llista de fitxers conte els noms de tots els fitxers a la carpeta oberta que coincideixen amb el filtre de nom de fitxer seleccionat (generalment *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac *.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Es poden seleccionar un o multiples fitxers. Per no seleccionar cap fitxer, feu clic a l'area buida despres de les entrades del quadre de llista. La seleccio determinara els fitxers afectats per les operacions que hi hagi disponibles mitjancant l'us dels botons que es descriuen a continuacio. A mes del Nom, tambe es poden mostrar altres columnes de Mida, Tipus i Data de modificacio amb els detalls del fitxer. Les columnes es poden ocultar desmarcant el seu nom al menu contextual de la capcalera. L'ordre de les columnes es pot canviar arrossegant i deixant anar. L'ordre de classificacio es pot alternar fent clic sobre la capcalera de la columna. Els valors de les etiquetes estandard tambe es poden mostrar i editar en columnes de la llista de fitxers. A l'esquerra dels noms es pot mostrar una icona: un disc per a mostrar que el fitxer ha estat modificat o la informacio sobre quines etiquetes hi ha presents (V1, V2, V1V2 o SENSE ETIQUETA, no es mostrara cap icona si encara no s'ha llegit el fitxer). Les carpetes es mostren amb una icona de carpeta. Si s'obre una carpeta, els fitxers es mostraran en un arbre jerarquic. En seleccionar fitxers des de subcarpetes, les operacions es podran executar sobre els fitxers en carpetes diferents, el qual es util si la col.leccio de musica esta organitzada amb una carpeta per a cada artista que conte les carpetes per als albums d'aquest artista. En fer clic amb el boto dret del ratoli dins de la llista de fitxers, s'obrira un menu contextual amb les seguents ordres: o Expandeix-ho tot: expandeix tots els arbres de carpetes (nomes l'arbre actual si es prem la tecla Maj) o Redueix-ho tot: contrau tots els arbres de carpetes o Reanomena: canvia el nom d'un fitxer o Mou a la paperera: mou un fitxer a la paperera o Reprodueix: reprodueix un fitxer, vegeu Reproduir. Si el fitxer seleccionat es una llista de reproduccio, es reproduiran els fitxers de la llista de reproduccio. o Edita: edita una llista de reproduccio, vegeu Editar una llista de reproduccio. o Les entrades posteriors son ordres d'usuari, les quals es poden definir a la pestanya Accions de l'usuari de Configura el Kid3. La reproduccio amb doble clic tambe es pot activar alla. Quan s'activa Selecciona el fitxer en reproduccio, la peca actual en reproduccio se selecciona automaticament en la llista de fitxers. Editar una llista de reproduccio Es pot crear una llista de reproduccio buida o que contingui les peces d'una carpeta, vegeu Crear una llista de reproduccio. El fitxer de la llista de reproduccio sera creat de tal manera que es podra editar fent-hi doble clic o emprant l'element Edita des del menu contextual de la llista de fitxers. Es mostrara un dialeg amb les entrades de la llista de reproduccio. Es possible obrir multiples llistes de reproduccio simultaniament. Es poden afegir entrades noves arrossegant i deixant anar des de la llista de fitxers, un gestor de fitxers o una altra llista de reproduccio. Si s'arrossega una entrada des d'una altra llista de reproduccio, es moura o copiara segons el sistema. Per a invocar l'altra operacio, respectivament, s'haura de premer la tecla Maj, Ctrl o Alt (per a copiar en lloc de moure al macOS(R)). Tambe es possible tornar a ordenar les entrades dins de la llista de reproduccio arrossegant i deixant anar. De manera alternativa, les entrades es poden moure emprant les dreceres de teclat Ctrl+Maj+Fletxa amunt i Ctrl+Maj+Fletxa avall (en el macOS(R), s'ha de premer Ordre en lloc de Ctrl). Es pot eliminar una entrada amb la tecla Supr. Tingueu en compte el seguent: per a arrossegar les entrades de la llista de fitxers, s'han de mantenir al costat esquerre (a prop de les icones), el mateix gest en el costat dret realitzara una seleccio multiple, de manera que aquesta accio encara sera possible. Quan s'ha modificat una llista de reproduccio, els canvis es podran emmagatzemar utilitzant Desa o descartar-los utilitzant Cancel.la. Quan es tanca la finestra, es mostrara un missatge de confirmacio si hi ha canvis sense desar. Les peces seleccionades en una llista de reproduccio se seleccionaran automaticament a la llista de fitxers, el qual permetra editar les etiquetes. Per a executar accions en una llista de reproduccio, s'haura de seleccionar el seu fitxer a la llista de fitxers. L'entrada Edita des del menu contextual portara el dialeg descrit en aquesta seccio, i Reprodueix iniciara el reproductor multimedia amb les peces de la llista de reproduccio. Les accions de l'usuari poden actuar sobre les llistes de reproduccio, per exemple, Exporta la llista de reproduccio a una carpeta copiara els fitxers d'una llista de reproduccio a dins d'una carpeta. Llista de carpetes La llista de carpetes conte els noms de les carpetes que hi ha a la carpeta oberta, aixi com la carpeta actual (.) i la carpeta pare (..). Permet canviar rapidament de carpeta sense emprar l'ordre Obre... o l'accio d'arrossegar i deixar anar. La visibilitat, l'ordre i la classificacio de la columna es poden configurar com es descriu a la seccio sobre la llista de fitxers. Fitxer Mostra informacio sobre la codificacio (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV i AIFF), velocitat de bits, frequencia de mostreig, canals i la longitud del fitxer. La linia d'edicio Nom: conte el nom del fitxer (si nomes se selecciona un fitxer). Si es canvia aquest nom, el fitxer canviara de nom quan es faci servir l'ordre Desa. El quadre combinat Format: i la linia d'edicio conte el format que s'utilitzara quan es generi el nom del fitxer a partir de la primera o la segona etiqueta. El nom del fitxer podra contenir caracters arbitraris, fins i tot una part de la carpeta separada del nom del fitxer per una barra diagonal, pero aquesta carpeta ja haura d'existir perque el canvi de nom tingui exit. S'empren els seguents codis especials per a inserir valors d'etiqueta en el nom del fitxer: o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca (p. ex., 01) o %t %{track.n} Peca amb l'amplada del camp <> (p. ex., 001 per a %{track.3}) o %T %{tracknumber} Peca (sense zeros a l'esquerra, p. ex., 1) o %g %{genre} Genere o %{ignore} Ignorada en generar les etiquetes a partir del nom del fitxer Els codis de format no estan restringits als exemples donats anteriorment. Es pot indicar un nom de marc, per exemple, noms de marc unificats com %{albumartist}, %{discnumber.1}, %{bpm} o noms especifics de format com %{popm}. Es possible anteposar i annexar cadenes a la substitucio d'un codi de format afegint entre cometes dobles dins de les claus d'un codi de format. Aquestes cadenes nomes es col.locaran a la cadena resultant si els camps del codi de format produeixen un valor no buit. Per exemple, si el nom del fitxer ha de contenir el titol i el subtitol, es podria utilitzar %{title} [%{subtitle}] a la cadena de format. Pero aixo donaria com a resultat una cadena que acaba amb [] si no hi ha un marc de subtitols per a un fitxer. Per a ometre els claudators si no hi ha subtitols, en el seu lloc s'utilitzara %{title}%{"["subtitle"]"}. Aixo ometra els claudators, l'espai inicial i el subtitol si no existeix el subtitol. La llista de formats disponibles es pot editar en el dialeg que apareix en fer clic al boto Nom del fitxer des de l'etiqueta a la pestanya Fitxer del dialeg de configuracio. S'utilitza un segon quadre combinat Format (amb una fletxa cap avall) per a generar les etiquetes a partir del nom de fitxer. Si el format del nom de fitxer no coincideix amb aquest patro, s'intentaran alguns altres formats d'us habitual. Alguns formats del nom de fitxer utilitzats habitualment ja estan disponibles al quadre combinat, pero tambe es possible escriure algun format especial a la linia d'edicio. La llista de formats disponibles es pot editar en el dialeg que apareix en fer clic al boto Etiqueta des del nom de fitxer a la pestanya Fitxer del dialeg de configuracio. De manera interna, es construeix una expressio regular a partir dels codis de format. Si es requereixen expressions regulars avancades, el format per a generar les etiquetes a partir dels noms de fitxer es podra indicar tot com una expressio regular amb captures precedides pels codis de format, p. ex., per a extreure els numeros de peca sense eliminar els zeros a l'esquerra, es podria emprar un format com <>. Des de: Etiqueta 1, Etiqueta 2: estableix el nom de fitxer utilitzant el format seleccionat i la primera o la segona etiqueta, respectivament. A: Etiqueta 1, Etiqueta 2: les etiquetes s'estableixen a partir del nom de fitxer. Primer, s'utilitza el format especificat a Format:. Si el nom de fitxer existent no coincideix amb aquest format, s'intentara amb els seguents formats: o Artista - Album/Peca Canco o Album/Peca - Artista - Canco o /Artista - Album - Peca - Canco o Album/Artista - Peca - Canco o Album/Artista - Canco o Artista/Album/Peca Canco Si se selecciona un unic fitxer, els controls de la IGU s'ompliran amb els valors extrets del nom de fitxer. Si se seleccionen multiples fitxers, les etiquetes dels fitxers s'establiran directament d'acord amb els noms dels fitxers. Etiqueta 1 Els ginys de linia d'edicio per al Titol, Artista, Album, Comentari, Data, Numero de la peca, Genere i Codificador s'utilitzen per a editar el valor corresponent a la primera etiqueta dels fitxers seleccionats. El valor canviara quan es modifiqui la seleccio del fitxer o abans d'operacions com Desa i Surt i quan es marqui la casella de seleccio corresponent a l'esquerra del nom de camp. Aixo es util per a nomes canviar alguns valors i deixar els altres sense canviar. Si se selecciona un unic fitxer, totes les caselles de seleccio estaran marcades i els ginys de linia d'edicio contindran els valors trobats a les etiquetes d'aquest fitxer. Si no es troba una etiqueta al fitxer, es mostrara el valor buit corresponent, el qual sera una cadena buida per a les linies d'edicio del Titol, Artista, Album i Comentari, 0 per a les linies d'edicio numerica com la Data i Numero de peca i un valor buit seleccionat per al quadre combinat Genere. Els valors es poden canviar i si la casella de seleccio corresponent esta marcada, s'establiran per al fitxer seleccionat despres de canviar la seleccio. El fitxer sera marcat com a modificat amb un simbol de disc en el quadre de llista de fitxers, pero romandra sense canvis fins que s'utilitzi l'ordre Desa. Si se seleccionen multiples fitxers, nomes es mostraran els valors que son identics en tots els fitxers seleccionats. En tots els altres controls, es mostraran els valors buits com s'ha descrit anteriorment. Totes les caselles de seleccio estaran desmarcades per a evitar canvis no desitjats. Si s'ha d'establir un valor per a tots els fitxers seleccionats, es pot editar i s'ha de marcar la casella de seleccio. Els valors s'establiran per a tots els fitxers seleccionats quan es canvii la seleccio i es podran desar amb l'ordre Desa. Les caselles de seleccio tambe controlen el funcionament de la majoria de les ordres que afecten les etiquetes, com copiar, enganxar i transferir entre les etiquetes 1 i 2. Per a facilitar el seu us amb multiples fitxers, on totes les caselles de seleccio no estaran marcades, aquestes ordres es comportaran de la mateixa manera que quan estan marcades o desmarcades totes les caselles de seleccio. Des de l'etiqueta 2: els camps de l'etiqueta 1 s'estableixen a partir dels valors corresponents a l'etiqueta 2. Si se selecciona un unic fitxer, els controls de la IGU s'ompliran amb els valors de l'etiqueta 2. Si se seleccionen multiples fitxers, les etiquetes dels fitxers s'establiran directament. Copia: la memoria intermedia de l'ordre Copia s'omplira amb els valors de l'Etiqueta 1. Nomes s'utilitzaran els valors amb la casella de seleccio marcada en les subseguents ordres Enganxa. Enganxa: enganxara els valors des de la memoria intermedia copiada a dins dels controls de la IGU. Elimina: establira tots els controls de la IGU amb els seus valors buits, el qual resultara en l'eliminacio de tots els valors. El fitxer desat no contindra l'etiqueta 1. Etiqueta 2 Els controls de la IGU funcionen de la mateixa manera com es descriu a la seccio Etiqueta 1, pero la mida de les cadenes no esta limitada. Per al Genere a l'etiqueta 2, tambe podreu utilitzar els vostres propis noms a mes dels generes llistats en el quadre combinat, simplement escriviu el nom a la linia d'edicio. L'etiqueta 2 no nomes podra contenir els mateixos valors que l'etiqueta 1, el format es construeix de manera flexible a partir de diversos marcs que estan compostos per diversos camps. La taula de l'etiqueta 2 mostra tots els marcs que hi ha disponibles al fitxer seleccionat. Edita: obrira una finestra que permet editar tots els camps del marc seleccionat. Si se seleccionen multiples fitxers, els camps editats s'aplicaran a tots els fitxers seleccionats que continguin aquest marc. Afegeix: apareixera una sol.licitud per a seleccionar el tipus de marc i es podra editar i afegir al fitxer. Tambe funciona per a afegir un marc als multiples fitxers seleccionats. Suprimeix: suprimira el marc seleccionat en els fitxers seleccionats. Es mostrara Arrossegueu aqui la caratula si el fitxer no conte cap caratula incrustada. Es pot afegir una imatge arrossegant i deixant anar des d'un navegador o gestor de fitxers i es mostrara aqui. Els marcs de la imatge es poden editar o afegir fent doble clic sobre aquest control. Etiqueta 3 Alguns fitxers poden tenir mes de dues etiquetes, i sera visible una tercera seccio d'etiquetes. Els seguents tipus de fitxer poden contenir una seccio Etiqueta 3: o Els fitxers MP3 poden tenir una etiqueta ID3 versio 1.1, una etiqueta ID3 versio 2 (2.3.0 o 2.4.0) i a la tercera seccio una etiqueta APE. Aquestes etiquetes APE s'utilitzen per a reproduir la informacio del guany. A la seccio Etiqueta 3, aquesta informacio sera visible i l'etiqueta APE es pot eliminar amb el boto Elimina. o El fragment INFO del RIFF als fitxers WAV es troba disponible a la seccio Etiqueta 3 perque la seccio Etiqueta 1 esta dedicada a les etiquetes ID3 versio 1.1 i te les seves restriccions. L'Etiqueta 2 encara es fa servir per a les etiquetes ID3 versio 2.4.0, les quals tambe estan admeses per als fitxers WAV, pero els fragments INFO del RIFF semblen estar mes ben admesos. o Els fitxers FLAC normalment utilitzen un comentari Vorbis per a les seves metadades. No obstant aixo, hi ha fitxers FLAC que tenen etiquetes ID3 versio 1 i versio 2, les quals es troben a les seccions Etiqueta 1 i Etiqueta 3. Les etiquetes ID3 en els fitxers FLAC nomes estan admeses per la TagLib, per tant, el connector <> haura d'estar inhabilitat a la pestanya Connectors del dialeg de configuracio. Els controls de la IGU funcionen de la mateixa manera que a la seccio Etiqueta 2. Lletra sincronitzada i els Codis de temps dels esdeveniments Per a obtenir informacio sincronitzada amb les dades de l'audio, hi ha disponible un editor especific. Aquests marcs estan admesos per les etiquetes ID3 versio 2.3.0 i 2.4.0. Per a afegir aquest marc, s'haura de seleccionar el nom especific del marc a la llista que apareixera quan feu clic al boto Afegeix -la Lletra sincronitzada i els Codis de temps dels esdeveniments, respectivament-. L'editor es el mateix per a ambdos tipus, per als codis de temps dels esdeveniments, nomes hi ha disponible un conjunt predefinit d'esdeveniments, mentre que per a la lletra sincronitzada, s'haura d'introduir el text. A continuacio, s'explica l'edicio de la lletra sincronitzada. Un fitxer que te seleccionada l'etiqueta ID3 versio 2, s'entra a l'editor de la lletra emprant Afegeix i seleccionant Lletra sincronitzada. Per a un marc existent de Lletra sincronitzada, se seleccionara i es fara clic a Edita. El reproductor s'obrira automaticament amb el fitxer actual perque el fitxer es pugui reproduir i fer pausa per tal de sincronitzar la lletra. La configuracio que hi ha a la part superior de l'editor SYLT normalment no s'han de canviar. Si la lletra conte caracters que no estan presents en el joc de caracters Llatin 1, es recomanable canviar la codificacio del text a UTF16 (o UTF8 per a l'ID3 versio 2.4.0). Per a la lletra en angles i una maxima compatibilitat, s'haura d'utilitzar la ISO-8859-1. La seccio Lletra conte cinc botons a la part superior. Afegeix afegira un esdeveniment de temps nou a la taula. El temps es prendra des de la posicio del reproductor, per tant, afegir una entrada mentre es reprodueix la peca afegira una linia per a la posicio de reproduccio actual. Els esdeveniments a la taula s'ordenaran de forma cronologica, per tant, la fila s'inserira en consequencia. Les entrades amb un temps no valid es tractaran especialment: si la fila seleccionada te un temps no valid, la seva marca de temps sera substituida pel temps actual en lloc d'afegir una fila nova. Si el temps actual no es valid, si esta present s'emprara la primera fila amb un temps no valid. Aquest comportament hauria de facilitar afegir marques de temps si el text de la lletra ja es troba a la taula, pero manquen les marques de temps (el qual es el cas en importar lletra sense sincronitzar). Tingueu en compte que el temps no valid es representa com a 00:00,00, es a dir, el mateix que el temps al comencament absolut de la peca, el qual no es valid. Per a invalidar un temps, premeu la tecla Supr o utilitzeu Neteja des del menu contextual. Les files noves inserides emprant Insereix una fila des del menu contextual o creades en importar la lletra sense sincronitzar amb Des del porta-retalls o Importa tambe contindran marques de temps no valides. Les files de la taula es poden suprimir fent clic al boto Suprimeix o utilitzant Suprimeix les files des del menu contextual. La lletra sincronitzada es pot importar des d'un fitxer fent servir Importa. El format esperat es LRC senzill o millorat. Si el fitxer seleccionat no conte un claudator a la primera linia, se suposara que es tracta d'un senzill fitxer de text amb lletra sense sincronitzar. Les linies en aquest fitxer s'importaran amb marques de temps no valides. La informacio de temps es podra afegir mitjancant el boto Afegeix o la introduccio manual. Tambe es possible importar la lletra mitjancant copia i enganxat utilitzant Des del porta-retalls. La lletra sincronitzada es pot escriure en els fitxers LRC utilitzant Exporta. Recordeu que nomes s'exportaran les entrades amb marques de temps valides i que les entrades s'ordenaran per hora. Les entrades amb temps no valid no s'emmagatzemaran en el marc SYLT, aixi que assegureu-vos d'incloure tota la informacio de temps abans de deixar el dialeg. L'especificacio ID3[5] suggereix una marca de temps per a cada sil.laba. No obstant aixo, la majoria dels reproductors nomes admeten la granularitat d'una linia o frase. Per a admetre ambdos casos d'us, el Kid3 segueix les mateixes convencions que l'editor SYLT[6]. Se suposa que el text que s'introdueix a la taula comencara una linia nova a menys que comenci amb un espai o un guio. Les excepcions a aquesta regla son possibles quan es comenca una linia amb un guio baix (<<_>>) per a forcar la continuacio o una marca de numeral (<<#>>) per a forcar una linia nova. Aquests caracters d'escapament no s'emmagatzemaran dins del marc SYLT. Dins del marc SYLT, les linies noves comencaran amb un caracter d'avanc de linia (0A hexadecimal) mentre que les continuacions no. En llegir els marcs SYLT, el Kid3 comprovara si la primera entrada comenca amb un salt de linia. Si aquest no es el cas, se suposara que totes les entrades son linies noves i que no s'utilitzen continuacions de sil.laba. Mentre es reprodueix la peca, es ressaltara la fila associada amb la posicio de reproduccio actual, de manera que es pugui verificar l'exactitud de la informacio de sincronitzacio. Si s'ha d'afegir un desplacament a una o mes marques de temps, aixo es pot aconseguir amb l'entrada Afegeix un desplacament... des del menu contextual. Els valors negatius es poden utilitzar per a reduir el temps. Utilitzant l'entrada Ves a la posicio des del menu contextual, es possible establir la fila seleccionada amb el temps de la posicio de reproduccio. Procediment recomanat per a afegir una lletra sincronitzada nova o Obteniu la lletra sense sincronitzar, p. ex., utilitzant l'element Lletra -> Lletra incrustada des del menu contextual a la llista de fitxers. o Copieu al porta-retalls la lletra sense sincronitzar, simplement aneu a la fila Lletra a la taula de marcs i premeu Ctrl+C. o Afegiu un marc de lletra sincronitzada (Afegeix..., Lletra, D'acord), feu clic a Des del porta-retalls. o Ara totes les linies de la lletra sense sincronitzar estaran a la taula, totes les marques de temps no seran valides (0:0:0,00). Per endavant, podreu suprimir les entrades buides. o Comenceu a reproduir la canco fent clic al boto de reproduccio que es troba a la barra d'eines de reproduccio a la part inferior de la finestra principal. o Quan aparegui la seguent linia de la lletra amb una marca de temps no valida, feu clic a Afegeix o premeu Alt+A, la marca de temps sera actualitzada. o Continueu aixi fins que s'estableixin totes les marques de temps. Si s'ha perdut alguna cosa, atureu la reproduccio i netegeu les marques de temps amb la tecla Supr o seleccionant-les i utilitzant Neteja des del menu contextual. Per a tornar a iniciar la reproduccio des d'una marca de temps en concret, utilitzeu Ves a la posicio des del menu contextual. Capitols en els fitxers MP4 Els audiollibres MP4 normalment solen tenir una extensio .m4b i son bastant grans perque contenen tots els capitols en un sol fitxer. Per a navegar en aquests fitxers, poden contenir marques de capitols, que es poden editar en el Kid3 en un pseudomarc de <> utilitzant el mateix editor que s'utilitza per a les lletres sincronitzades. No obstant aixo, cal tenir en compte que aquesta caracteristica nomes esta disponible amb el connector Mp4v2Metadata, aixi que assegureu-vos que esta activat i per sobre del connector TaglibMetadata a la pestanya Connectors de la configuracio si heu d'editar capitols MP4. El menu Fitxer Fitxer -> Obre... ( Ctrl+O ) Obre una carpeta. Tots els fitxers que coincideixin amb el filtre del nom de fitxer seleccionat es mostraran en el quadre de llista de fitxers i se seleccionara el fitxer triat. Fitxer -> Obre'n una recent Obre una carpeta que ha estat oberta recentment. Fitxer -> Obre una carpeta... ( Ctrl+D ) Obre una carpeta. Tots els fitxers que coincideixin amb el filtre del nom de fitxer seleccionat es mostraran en el quadre de llista de fitxers. Fitxer -> Torna a carregar ( F5 ) Torna a carregar la carpeta. Primer s'hauran de desar tots els fitxers modificats. Les subcarpetes expandides es contrauran. Fitxer -> Desa ( Ctrl+S ) Desa tots els fitxers modificats a la carpeta. Els fitxers modificats es marcaran amb un simbol de disc al quadre de llista de fitxers. Si s'ha canviat algun nom de fitxer, es canviara el nom d'aquests fitxers. Fitxer -> Reverteix Reverteix els canvis d'un o multiples fitxers. Si no se seleccionen fitxers en el quadre de llista de fitxers, es revertiran els canvis de tots els fitxers. En cas contrari, nomes es revertiran els canvis dels fitxers seleccionats. Fitxer -> Importa... El dialeg Importa es pot utilitzar per a importar les dades directament des d'un servidor freedb.org, des d'un servidor MusicBrainz, des de Discogs, Amazon o altres fonts de llistes de peces d'album en un format de text. Es possible la importacio des d'un servidor freedb.org utilitzant un dialeg que apareix quan a Des del servidor: se selecciona gnudb.org. L'artista i el nom de l'album per a cercar es poden introduir en els dos camps de sobre, els albums que coincideixin amb la consulta apareixeran quan feu clic a Cerca i es rebran els resultats des de www.gnudb.org[7]. La importacio de les dades de les peces per a un album es realitza fent doble clic sobre l'album a la llista. Es pot seleccionar el servidor freedb.org per a importar, aixi com el cami CGI. Les dades importades es mostraran a la taula de vista previa del dialeg d'importacio. Quan estigueu satisfet amb les peces mostrades, es podran importar finalitzant el dialeg d'importacio amb D'acord. Si ja teniu obert un resultat de cerca al navegador web, podeu introduir l'URL al primer camp de cerca. El resultat apareixera a la llista d'albums i es podra importar directament al Kid3. Es pot fer una cerca al servidor Discogs utilitzant Discogs. Com en el dialeg gnudb.org, podreu introduir l'artista i album, i despres triar des d'una llista de llancaments. Es pot introduir un Testimoni: per a utilitzar l'API RESTful de Discogs en lloc de la seva interficie web, la qual canvia sovint, trencant aixi l'analitzador d'importacio. Heu de registrar-vos per a obtenir un compte a Discogs[8] i despres generar un testimoni al seu lloc web (Settings/Developers, Generate new token -Arranjament/Desenvolupadors, Genera un testimoni nou). No us oblideu de premer el boto Desa la configuracio despres d'introduir el testimoni per a emprar-lo tambe en les sol.licituds posteriors. Si es marca Etiquetes estandard, s'importara la informacio estandard, p. ex., artista, album i titol. Si es marca Etiquetes addicionals, s'importara mes informacio si esta disponible, p. ex., interprets, arranjadors o l'editor. Si es marca la Caratula, es descarregara la caratula si esta disponible. Es pot fer una cerca al servidor Amazon utilitzant Amazon. Com en el dialeg gnudb.org, podreu introduir l'artista i album, i despres triar d'una llista de llancaments. Si es marca Etiquetes addicionals, s'importara mes informacio si esta disponible, p. ex., interprets, arranjadors o l'editor. Si es marca la Caratula, es descarregara la caratula si esta disponible. Podreu fer cerques de la mateixa manera que amb la base de dades de llancament de MusicBrainz utilitzant Des del Llancament de MusicBrainz. El flux de treball es el mateix que es descriu per a Des de gnudb.org. Es possible la importacio des d'un servidor MusicBrainz utilitzant el dialeg que apareix quan se selecciona Des de l'Empremta digital de MusicBrainz. El servidor es pot seleccionar com en el dialeg d'importacio de freedb. A sota es mostrara una taula mostrant les dades importades de les peces. La columna de la dreta mostrara l'estat de la consulta a MusicBrainz, la qual comenca amb <> quan s'obre el dialeg. Despres, se cercara l'empremta digital i, si no produeix un resultat, s'intentara una altra cerca utilitzant les etiquetes al fitxer. Per tant, pot ser util per a una consulta amb exit a MusicBrainz i aixi emmagatzemar la informacio coneguda (p. ex., artista i album) en les etiquetes abans de fer la importacio. Si es troba un resultat, la cerca acabara amb l'estat <>, en cas contrari es que no s'ha trobat res o que s'han obtingut multiples resultats ambigus i l'usuari n'haura de seleccionar un. Accepta i Aplica utilitzaran les dades importades, Cancel.la tancara el dialeg. El tancament pot trigar una estona, ja que s'haura de tancar tota la maquinaria del MusicBrainz. Per a la importacio de dades textuals, Des del fitxer/porta-retalls... obrira un subdialeg, on hi haura disponibles diversos formats d'importacio preconfigurats. Els dos primers, <> i <> es poden fer servir per a importar les dades que s'han exportat mitjancant el dialeg Exporta. Les dades CSV es podran editar amb un full de calcul i s'escriuran emprant tabulacions com a delimitadors. La importacio hauria de ser possible utilitzant <>, el qual es mes flexible que el <>. No obstant aixo, els seus camps no poden contenir cometes dobles. Si nomes exporteu des del Kid3 i importeu mes tard, es pot utilitzar el <> com un format senzill per a aquesta finalitat. Recordeu que tambe hi ha les ordres <> i <> al menu contextual de la llista de fitxers, les quals utilitzen scripts per a exportar i importar les dades CSV d'una manera mes completa, potent i flexible. El seguent format, <>, es pot utilitzar per a copiar la informacio des d'una pagina HTML de freedb.org[9]. Cerqueu un album a freedb i si la informacio desitjada es mostra en el navegador web, copieu el contingut al porta-retalls. Despres feu clic al boto Des del porta-retalls i les peces importades es mostraran a la taula de vista previa a la part superior del dialeg. Si esteu satisfet amb les dades importades, finalitzeu el dialeg amb D'acord, el qual inserira les dades en les etiquetes de la carpeta actual. La destinacio (Etiqueta 1, Etiqueta 2 o Etiqueta 1 i Etiqueta 2) es pot seleccionar amb un quadre combinat. Els fitxers a la carpeta actual hauran d'estar en l'ordre de peces correcte per a assignar les seves etiquetes. Aquest sera el cas si estan numerades. Si les dades estan disponibles com un document HTML, es podra utilitzar el seguent format d'importacio preconfigurat, <>. La importacio es possible utilitzant el boto Des del fitxer..., el qual obrira un selector de fitxers, o copiant el seu contingut des d'un editor i despres important des del porta-retalls. Aquest format pot ser util per a la importacio sense connexio, tot i que el document HTML tambe podria obrir-se en un navegador i despres importar-se en el primer format mitjancant el porta-retalls. Hi ha disponibles mes formats preconfigurats, p. ex., <>. Es pot crear un format personalitzat buit amb Afegeix perque sigui configurat per l'usuari. Es poden establir dues linies a sota del nom del format amb una expressio regular per a capturar els camps de text a importar. S'analitzara la primera expressio regular un cop per document per a recopilar les dades per album; com ara l'artista, album, any i genere. La segona linia intenta fer coincidir des del comencament del document fins al final per a obtenir les dades de les peces, generalment el numero i titol. Les expressions regulars inclouen totes les caracteristiques que ofereixen les Qt(TM), les quals son la major part del que ofereix Perl. Les construccions de parentesis <<(..)>> creen memories intermedies de captura per als camps a importar i estan precedides per codis especifics del Kid3 per a especificar quin camp capturar. Els codis son els mateixos que es fan servir per al format del nom de fitxer, a mes dels codis llistats a continuacio, es possible qualsevol nom de marc: o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca o %g %{genre} Genere o %d %{duration} Durada Per exemple, una expressio regular de peca (segona linia) per a importar des d'una llista de reproduccio .m3u podria ser <<%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]>>. Tots els formats es poden canviar editant les expressions regulars i el nom, i despres fent clic a Desa la configuracio. S'emmagatzemaran al fitxer kid3rc a la carpeta de configuracio. Aquest fitxer es pot editar directament per a tenir mes formats d'importacio o es pot eliminar per a tornar als formats predeterminats. Els formats es poden eliminar amb Elimina. La Precisio: mostra una estimacio de com es de bona la coincidencia de la informacio importada amb les peces indicades. Utilitza durades de peca o noms de fitxer per a calcular el nivell de similitud en percentatge. La Caratula: mostra l'URL de la imatge per a la portada de l'album que es descarregara. Per a comprovar si les peces importades coincideixen amb el conjunt actual de fitxers, es pot comparar la durada de les peces importades amb la durada dels fitxers. Aquesta opcio es pot habilitar amb la casella de seleccio Comprova la diferencia maxima de temps permesa (seg): i la diferencia de temps maxima tolerada es pot establir en segons. Si es detecta una manca de coincidencia en una durada, la durada es mostrara amb un fons vermell a la taula de vista previa. Si els fitxers estan ordenats de manera diferent que les peces importades, les peces assignades s'hauran de canviar. Aquesta tasca es pot facilitar utilitzant l'opcio Coincideix amb: amb els botons Durada, Peca i Titol, la qual reordenara les peces d'acord amb el camp corresponent. Per a corregir les assignacions manualment, es pot arrossegar una peca amb el boto esquerre del ratoli i mantenint premuda la tecla Ctrl, i despres deixar-la anar a la nova ubicacio. Quan s'obri el dialeg d'importacio, aquest contindra el contingut real de les etiquetes. El tipus d'etiqueta (Etiqueta 1, Etiqueta 2, Etiqueta 1 i Etiqueta 2) es podra seleccionar utilitzant el quadre combinat Destinacio:. El boto a la dreta d'aquest quadre combinat es pot utilitzar per a revertir la taula al contingut actual de les etiquetes. Es poden utilitzar les caselles de seleccio a la primera columna de la taula per a seleccionar les peces que s'importaran. Aixo pot ser util si una carpeta conte les peces d'ambdos CD d'un CD doble i nomes s'han d'importar les peces del segon CD. Per a identificar les pistes que s'importaran, es possible mostrar els noms de fitxer o els camins sencers als fitxers utilitzant el menu contextual a la capcalera de la taula. Els valors en la taula d'importacio es poden editar. El boto Reverteix que hi ha a la dreta del quadre combinat Destinacio: es pot utilitzar per a restaurar el contingut de les etiquetes, el qual tambe pot ser util despres de canviar la Destinacio:. Gairebe tots els dialegs tenen un boto Desa la configuracio, el qual es pot utilitzar per a emmagatzemar les opcions de configuracio especifiques del dialeg i fer que la mida de la finestra sigui persistent. Des de les etiquetes... porta a un subdialeg per a establir els marcs de les etiquetes a partir del contingut d'altres marcs d'etiqueta. Es pot utilitzar per a simplement copiar la informacio entre les etiquetes o extreure una part d'un marc i inserir-la en un altre. Com en el dialeg Importa des del fitxer/porta-retalls, hi ha formats lliurement configurables per a realitzar diferents operacions. Son formats que ja estan preconfigurats per a copiar el valor de l'Album a l'Artista, Compositor o Director de l'album, i per a extreure el numero de la peca dels camps Titol que contenen un numero. Tambe hi ha un format per a extreure un subtitol des d'un camp Titol. El seguent exemple explica com afegir un format personalitzat, el qual estableix la informacio del camp Subtitol tambe en el camp Comentari. Creeu un format nou amb el boto Afegeix i establiu un nom nou, p. ex., <>. Despres introduiu <<%{subtitle}>> a Font: i <<%{comment}(.*)>> per a Extraccio: i feu clic a Desa la configuracio. L'expressio a Font: pot contenir codis de format per a marcs d'etiqueta arbitraris, es poden utilitzar multiples codis per a combinar el contingut de diferents marcs. Per a cada pista, es generara un text a partir de les seves etiquetes utilitzant el format Font:, i l'expressio regular des d'Extraccio: s'aplicara a aquest text per a establir valors nous per a les etiquetes. Els codis de format s'utilitzen abans dels parentesis de captura per a especificar el marc de l'etiqueta on s'emmagatzemara el text capturat. Funciona de la mateixa manera que per a Importar des d'un fitxer/porta-retalls. Importa des de les etiquetes... tambe esta disponible directament des del menu Fitxer. La diferencia entre aquestes dues funcions es que el subdialeg del dialeg d'importacio funciona sobre tots els fitxers de la carpeta actual, mentre que la funcio de menu funciona sobre els fitxers seleccionats (els quals poden estar en carpetes diferents). La funcio de menu admet un codi addicional <<%{__return}>> per a retornar el valor extret, el qual pot ser util amb les interficies CLI i QML. Fitxer -> Importa des de gnudb.org... Importa des d'un servidor freedb.org utilitzant la cerca d'albums de gnudb.org. Aquest element de menu obrira el mateix dialeg d'importacio que Importa..., pero obrira directament el dialeg de gnudb.org. Fitxer -> Importa des de Discogs... Importa des d'un servidor Discogs. Aquest element de menu obrira el mateix dialeg d'importacio que Importa..., pero obrira directament el dialeg de Des de Discogs. Fitxer -> Importa des d'Amazon... Importa des d'Amazon. Aquest element de menu obrira el mateix dialeg d'importacio que Importa..., pero obrira directament el dialeg de Des d'Amazon. Fitxer -> Importa des de Llancament de MusicBrainz... Importa des d'una base de dades de Llancament de MusicBrainz. Aquest element de menu obrira el mateix dialeg d'importacio que Importa..., pero obrira directament el dialeg Des del Llancament de MusicBrainz. Fitxer -> Importa des de l'Empremta digital de MusicBrainz... Importa des d'un servidor de MusicBrainz. Aquest element de menu obrira el mateix dialeg d'importacio que Importa..., pero obrira directament el dialeg Des de l'Empremta digital de MusicBrainz. Fitxer -> Importa des de les etiquetes... Com Des de les etiquetes, pero la importacio s'aplicara als fitxers seleccionats. Fitxer -> Importa automaticament... La importacio automatica permet importar la informacio per a multiples albums des de diversos serveis web. Si se seleccionen carpetes a la llista de fitxers, s'importaran les dades de les peces per a les carpetes seleccionades. Si no se selecciona cap carpeta, s'importaran totes les carpetes a la llista de fitxers. Es pot seleccionar el tipus d'etiqueta (Etiqueta 1, Etiqueta 2, Etiqueta 1 i Etiqueta 2) utilitzant el quadre combinat Destinacio:. Els perfils determinen quins servidors seran contactats per a obtenir la informacio de l'album. Alguns perfils estan predefinits (Tots, MusicBrainz, Discogs, Caratula), es poden afegir perfils personalitzats emprant el boto Afegeix que hi ha a la dreta del quadre combinat Perfil:. La seguent taula mostra els servidors que s'utilitzaran en importar la informacio de l'album utilitzant el perfil seleccionat. El proces d'importacio per a un album finalitzara si s'ha trobat tota la informacio requerida, per la qual cosa l'ordre de les files a la taula es important. Es pot canviar amb els botons Mou amunt i Mou avall. Es pot emprar Edita... per a canviar una entrada existent. La seleccio del Servidor ofereix els mateixos servidors que es poden utilitzar en les funcions d'importacio. Les Etiquetes estandard, Etiquetes addicionals i la Caratula determinen la informacio que s'obtindra del servidor. Finalment, la Precisio es la precisio minima que s'haura d'aconseguir per a acceptar les dades importades. Si la precisio es insuficient, es provara el seguent servidor de la llista. El mateix dialeg que conte les propietats del servidor apareixera quan feu clic a Afegeix... per a afegir una entrada nova de servidor. Les entrades existents es poden eliminar utilitzant Elimina. Per a iniciar una importacio automatica per lots amb el perfil seleccionat, feu clic a Inicia. Els detalls sobre la importacio en execucio es mostraran a la part superior del dialeg. El proces es pot interrompre amb el boto Interromp. Fitxer -> Explora les caratules... El dialeg Explora les caratules ajuda a trobar la caratula de l'album. Si es possible, Artista/Album s'omplira amb les etiquetes. Font: oferira una varietat de llocs web amb caratules d'albums. L'URL amb l'artista i l'album com a parametres es troba a sota del nom. Els valors codificats en l'URL per a l'artista i l'album es poden inserir utilitzant <<%u{artist}>> i <<%u{album}>>, tambe son possibles altres valors des de les etiquetes, com es descriu a Configurar el Kid3, Accions de l'usuari. Es poden introduir mes fonts despres de l'entrada <> en substitucio de la <> amb el nom de la font, prement Retorn, despres introduint l'URL i finalment prement Desa la configuracio. L'ordre resultant del navegador es mostrara a la part superior del dialeg i es podra iniciar fent clic a Explora. El navegador, el qual es pot configurar a les opcions de configuracio, s'iniciara amb la font seleccionada. Despres podreu arrossegar una imatge de caratula des del navegador a la finestra del Kid3 i s'establira al marc de la imatge dels fitxers seleccionats. A causa que no tots els navegadors admeten arrossegar i deixar anar imatges, i les imatges en els llocs web sovint tenen un URL, en aquests casos, el Kid3 rebra l'URL i no la imatge. Si l'URL apunta a una imatge, es descarregara. No obstant aixo, si l'URL es refereix a algun altre recurs web, s'haura de traduir a la imatge corresponent. Aquestes assignacions es defineixen a la taula Extraccio de l'URL. La columna esquerra Coincidencia conte una expressio regular que es comparara amb l'URL. Si coincideix, les expressions capturades entre parentesis s'inseriran en el patro de la columna dreta URL de la imatge (en les posicions marcades amb \1, etc.) L'expressio regular substituida contindra l'URL de la imatge. D'aquesta manera, la caratula es podra importar des d'Amazon, Google Images, etc., mitjancant arrossegar i deixar anar. Tambe es possible definir les vostres propies assignacions. Fitxer -> Exporta... El dialeg Exporta s'utilitza per a emmagatzemar les dades de les etiquetes en un fitxer o al porta-retalls. L'editor a la part superior mostrara una vista previa de les dades a exportar. Si les dades d'exportacio contenen caracters de tabulacio, l'exportacio es mostrara en una taula. Les dades es generaran a partir de les etiquetes a la carpeta actual d'acord amb el format configurat. La configuracio del format es similar a la del dialeg Importa: el camp superior conte el titol (p. ex., <>), seguit de la capcalera, el qual es generara al comencament del fitxer. Segueixen les dades de la peca -s'utilitzaran per a cada peca-. Finalment, el trailer es podra utilitzar per a generar algun text final. Els camps de format no contenen expressions regulars com en el dialeg Importa, sino nomes expressions del format de la sortida amb expressions <<%>> especials, les quals seran substituides pels valors de les etiquetes. Tot funciona com el format del nom de fitxer, i s'utilitzen els mateixos codis mes alguns codis addicionals. No nomes es podran fer servir els codis llistats a continuacio, sino tambe tots els noms dels marcs d'etiqueta. o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca (p. ex., 01) o %t %{track.n} Peca amb l'amplada del camp <> (p. ex., 001 per a %{track.3}) o %T %{tracknumber} Peca (sense zeros a l'esquerra, p. ex., 1) o %g %{genre} Genere o %f %{file} Nom del fitxer o %p %{filepath} Cami o %{modificationdate} Data de modificacio o %{creationdate} Data de creacio o %u %{url} URL o %{dirname} Nom de la carpeta o %d %{duration} Durada en minuts:segons o %D %{seconds} Durada en segons o %n %{tracks} Nombre de peces de l'album o %e %{extension} Extensio del fitxer o %O %{tag1} El format de l'etiqueta 1 (ID3 versio 1.1 o buida si no existeix) o %o %{tag2} El format de l'etiqueta 2 (ID3 versio 2.3.0, 2.4.0, 2.2.0, 2.2.1, Vorbis, APE, MP4, ASF o buida si no existeix) o %b %{bitrate} Taxa de bits en kbit/s o %v %{vbr} VBR o buida (nomes per a l'ID3 versio 2.3 amb la id3lib) o %r %{samplerate} Frequencia de mostreig en Hz o %m %{mode} Mode del canal (Estereo o Estereo combinat) o %h %{channels} Nombre de canals (1 o 2) o %k %{codec} Codec (p. ex., MPEG 1 Capa 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF o WAV) Hi ha alguns formats predefinits. <> separara els camps per pestanyes. Les dades en aquest format es podran importar de nou al Kid3 utilitzant el format d'importacio amb el mateix nom. <> tambe incloura els camps entre cometes dobles, el qual facilitara la importacio en les aplicacions de full de calcul. No obstant aixo, els camps no hauran de contenir cometes dobles quan s'utilitza aquest format. <> i <> generaran llistes de reproduccio amb atributs estesos i noms de cami absoluts. <> es pot utilitzar per a generar una pagina HTML amb enllacos a les peces. <> creara un fitxer el qual podra importar des del programa d'impressio de caratules Kover. <> proporcionara la informacio sobre la velocitat dels bits, la frequencia de mostreig, els canals, etc. Finalment, el "Format personalitzat" es deixara buit per a la definicio d'un format personalitzat. Podreu definir mes formats propis afegint linies al fitxer kid3rc a la carpeta de la configuracio. Els altres formats es podran adaptar a les vostres necessitats. La Font: de les etiquetes per a generar les dades d'exportacio (Etiqueta 1 o Etiqueta 2) es podra seleccionar amb un quadre combinat. Prement A un fitxer... o Al porta-retalls s'emmagatzemaran les dades en un fitxer o al porta-retalls. D'acord i Cancel.la tancaran el dialeg, mentre que D'acord acceptara la configuracio del dialeg actual. Fitxer -> Crea una llista de reproduccio... Creara una llista de reproduccio. El format i el contingut de la llista de reproduccio es poden establir mitjancant diverses opcions. El nom de la llista de reproduccio pot ser El mateix, com el nom de la carpeta o utilitzar un Format: amb els valors de les etiquetes, p. ex., <<%{artist} - %{album}>> per a tenir el nom de l'artista i l'album en el nom del fitxer de llista de reproduccio. Els codis de format son els mateixos que per a Exporta. La llista de formats disponibles es pot editar a la seccio Format de la pestanya Fitxers a la configuracio. Crea una nova llista de reproduccio buida: creara una llista de reproduccio buida amb el nom indicat. L'extensio dependra del format de la llista de reproduccio. La ubicacio de la llista de reproduccio generada estara determinada per la seleccio del quadre combinat Crea dins:. Carpeta actual Es creara la llista de reproduccio a la carpeta actual i nomes contindra els fitxers de la carpeta actual. La carpeta actual sera la carpeta on es troba el fitxer actual. Si se seleccionen multiples fitxers, el fitxer actual probablement sera l'ultim fitxer seleccionat. Cada carpeta Es creara una llista de reproduccio a cada carpeta que contingui els fitxers llistats, i cada llista de reproduccio contindra els fitxers en aquesta carpeta. Carpeta de nivell superior Nomes creara una llista de reproduccio a la carpeta de nivell superior (es a dir, la carpeta de la llista de fitxers) i contindra els fitxers llistats a la carpeta de nivell superior i totes les seves subcarpetes. El Format: de la llista de reproduccio pot ser M3U, PLS o XSPF. Si es marca Inclou nomes els fitxers seleccionats, nomes s'inclouran els fitxers seleccionats a la llista de reproduccio. Si se selecciona una carpeta, se seleccionaran tots els seus fitxers. Si aquesta casella de seleccio no esta marcada, s'inclouran tots els fitxers d'audio a la llista de reproduccio. Ordena per nom de fitxer seleccionara el cas habitual on els fitxers s'ordenen per nom de fitxer. Amb Ordena pel camp de l'etiqueta, es possible ordenar per una cadena de format amb els valors dels camps d'etiqueta. Per exemple, <<%{track.3}>> es pot utilitzar per a ordenar per numero de peca (el <<.3>> s'utilitza per a obtenir tres digits amb zeros a l'esquerra, de manera que les cadenes s'utilitzaran per a ordenar). Tambe es possible utilitzar multiples camps, p. ex., <<%{genre}%{year}>> per a ordenar utilitzant una cadena composta del genere i any. Les entrades a la llista de reproduccio tindran camins de fitxer relatius o absoluts depenent de si s'estableix Empra un cami relatiu per als fitxers a la llista de reproduccio o Empra un cami absolut per als fitxers a la llista de reproduccio. Quan s'estableix Escriu nomes la llista de fitxers, la llista de reproduccio nomes contindra els camins als fitxers. Per a generar una llista de reproduccio estesa amb informacio addicional, es podra establir una cadena de format utilitzant el control Escriu la informacio usant. Fitxer -> Surt ( Ctrl+Q ) Surt de l'aplicacio. El menu Edita Edita -> Selecciona-ho tot ( Alt+A ) Selecciona tots els fitxers. Edita -> Desselecciona ( Ctrl+Maj+A ) Desselecciona tots els fitxers. Edita -> Selecciona-ho tot a la carpeta Selecciona tots els fitxers en la carpeta actual. Edita -> Fitxer anterior ( Alt+Fletxa amunt ) Selecciona el fitxer anterior. Edita -> Fitxer seguent ( Alt+Fletxa avall ) Selecciona el fitxer seguent. Edita -> Cerca... ( Ctrl+F ) Cerca les cadenes en els noms de fitxer i les etiquetes. El dialeg Cerca es un subconjunt del dialeg Substitueix, el qual es descriu a continuacio. Edita -> Substitueix... ( Ctrl+R ) Aquesta funcio obrira un dialeg per a cercar i substituir les cadenes en els noms de fitxer i les etiquetes. El conjunt de marcs on es realitza la cerca es pot restringir desactivant la casella de seleccio Selecciona-ho tot i seleccionant els marcs que se cercaran. Tambe hi ha opcions de cerca disponibles per a cercar cap enrere, majuscules i minuscules, i per a utilitzar expressions regulars. Depenent de la quantitat de fitxers, la cerca es podria demorar una mica, per tant, es podra interrompre tancant el dialeg. El menu Eines Eines -> Aplica el format del nom de fitxer Quan Aplica automaticament el format esta desactivada per al format del nom de fitxer en el dialeg de configuracio, aquest element de menu es podra utilitzar per a aplicar el format configurat als noms dels fitxers seleccionats. Aixo tambe es pot fer servir per a comprovar si els noms dels fitxers s'ajusten al format configurat aplicant el format a tots els fitxers desats i despres comprovant si es van modificar els fitxers (i, per tant, es van marcar amb un simbol de disc en el quadre de llista de fitxers). Eines -> Aplica el format de l'etiqueta Quan Aplica automaticament el format esta desactivada per al format de l'etiqueta en el dialeg de configuracio, aquest element de menu es podra utilitzar per a aplicar el format configurat a les etiquetes dels fitxers seleccionats. Aixo tambe es pot fer servir per a comprovar si els noms dels fitxers s'ajusten al format configurat aplicant el format a tots els fitxers desats i despres comprovant si es van modificar els fitxers (i, per tant, es van marcar amb un simbol de disc en el quadre de llista de fitxers). Eines -> Aplica la codificacio del text Estableix la Codificacio del text seleccionada a Arranjament -> Configura el Kid3... -> seccio Etiquetes -> pestanya Etiqueta 2 per a tots els fitxers seleccionats. Si se selecciona UTF8, s'usara UTF16 per a les etiquetes ID3 versio 2.3.0 perque UTF8 no s'admet amb aquest format. Eines -> Reanomena la carpeta... Aquest dialeg ofereix la possibilitat de canviar automaticament el nom de la carpeta actualment oberta d'acord amb les etiquetes en els fitxers. Hi ha preconfigurats diversos formats per a incloure la informacio sobre l'artista, l'album i l'any en el nom de la carpeta. Tambe es possible establir un format personalitzat i fer Edita sobre la llista de formats disponibles. S'utilitzaran els seguents codis especials per a inserir valors d'etiqueta en el nom de la carpeta: o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca (p. ex., 01) o %t %{track.n} Peca amb l'amplada del camp <> (p. ex., 001 per a %{track.3}) o %T %{tracknumber} Peca (sense zeros a l'esquerra, p. ex., 1) o %g %{genre} Genere o %{dirname} Nom de la carpeta (p. ex., %{year" "}%{dirname} anteposara l'any al nom de la carpeta actual) o %{max-year} El valor d'any maxim trobat per a aquesta carpeta, tambe es pot emprar amb altres codis que no siguin <> o %{min-year} El valor d'any minim trobat per a aquesta carpeta o %{unq-year} El valor d'any unic trobat per a aquesta carpeta o be si no es unic Si en el format es troba un separador de carpeta <>, es crearan multiples carpetes. Per a crear una carpeta nova en lloc de canviar el nom de la carpeta actual, al quadre combinat Accio: seleccioneu Crea una carpeta en lloc de Reanomena la carpeta. La Font: de la informacio de les etiquetes es pot triar entre Etiqueta 1 i etiqueta 2, Etiqueta 1 i Etiqueta 2. Al dialeg es disposara d'una vista previa de l'operacio del canvi de nom realitzada en el primer fitxer a les seccions Des de: i A:. Es podra canviar el nom de multiples carpetes seleccionant-les. Eines -> Numeros de les peces... Si els numeros de peca a les etiquetes no estan establerts o tenen valors incorrectes, aquesta funcio podra donar numero automaticament a les peces en ordre ascendent. El numero d'inici es podra establir en el dialeg. Si nomes s'han de numerar part de les peces, s'hauran de seleccionar. Quan es marca Nombre total de peces:, tambe s'establira en les etiquetes el nombre de peces. Es possible donar numero a les pistes en multiples carpetes. S'hauran d'expandir i seleccionar les carpetes. Si es marca Restableix el comptador en cada carpeta, la numeracio de les peces es reiniciara amb el numero donat per a cada carpeta quan se seleccionen multiples carpetes. El dialeg Numeros de les peces tambe es pot utilitzar per a donar format als numeros de les peces existents sense canviar els valors quan la casella de seleccio esquerra a Numero d'inici: esta desactivada. El nombre total de peces s'afegira si la casella de seleccio corresponent esta activa, el qual es pot utilitzar per a establir el total de totes les pistes seleccionades. Si nomes es vol donar format als numeros existents, tambe s'haura de desactivar aquesta casella de seleccio. Eines -> Filtre... El filtre es pot utilitzar per a mostrar nomes aquells fitxers que coincideixin amb certs criteris. Aixo es util si voleu organitzar una gran col.leccio i nomes editar els fitxers que no estan en l'esquema desitjat. L'expressio que defineix quins fitxers mostrar utilitza els mateixos codis de format que s'utilitzen en el format del nom de fitxer, importar i exportar. o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca (p. ex., 01) o %t %{track.n} Peca amb l'amplada del camp <> (p. ex., 001 per a %{track.3}) o %T %{tracknumber} Peca (sense zeros a l'esquerra, p. ex., 1) o %g %{genre} Genere o %f %{file} Nom del fitxer o %p %{filepath} Cami absolut cap al fitxer o %e %{extension} Extensio del fitxer o %O %{tag1} El format de l'etiqueta 1 (ID3 versio 1.1 o buida si no existeix) o %o %{tag2} El format de l'etiqueta 2 (ID3 versio 2.3.0, 2.4.0, 2.2.0, 2.2.1, Vorbis, APE, MP4, ASF o buida si no existeix) o %b %{bitrate} Taxa de bits en kbit/s o %v %{vbr} VBR o buida (nomes per a l'ID3 versio 2.3 amb la id3lib) o %r %{samplerate} Frequencia de mostreig en Hz o %m %{mode} Mode del canal (Estereo o Estereo combinat) o %h %{channels} Nombre de canals (1 o 2) o %k %{codec} Codec (p. ex., MPEG 1 Capa 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF o WAV) o %w %{marked} Marcat, sera 1 si el fitxer esta marcat (p. ex., per trencament o violacio de l'estandard), en cas contrari estara buida o %1a %1{artist}, ... Empra el prefix 1 per a obtenir els valors de l'etiqueta 1 o %2a %2{artist}, ... Empra el prefix 2 per a obtenir els valors de l'etiqueta 2 Aquests codis se substituiran amb els valors del fitxer, i les cadenes resultants es podran comparar amb les seguents operacions: o s1 es igual que s2: cert si s1 i s2 son iguals. o s1 conte s2: cert si s1 conte s2, es a dir, s2 es una subcadena de s1. o <> coincideix amb <>: cert si <> coincideix amb l'expressio regular <>. Les expressions veritables se substituiran per <<1>>, les falses per <<0>>. Els valors veritables es representen per <<1>>, <>, <> i <>, els valors falsos per <<0>>, <>, <> i <>. Les operacions booleanes son <>, i, <> (en aquest ordre de precedencia) i es poden agrupar entre parentesis. Hi ha predefinides algunes regles de filtre i poden servir com a exemples per a les vostres propies expressions: Tot Quan es filtra la llista de fitxers -aixo es mostra amb <<[filtrada]>> al titol de la finestra- i es mostren de nou tots els fitxers, el filtratge es podra revertir utilitzant aquest filtre. Utilitza una expressio buida, pero un valor veritable tindria el mateix efecte. L'etiqueta del nom de fitxer no coincideix (%{filepath} no conte "%{artist} - %{album}/%{track} %{title}") Comprova si el cami del fitxer s'ajusta al format del nom del fitxer. Aquesta regla s'adaptara automaticament si canvia el format del nom del fitxer. Sense etiqueta 1 %{tag1} igual que "" Nomes mostra els fitxers que no tenen una etiqueta 1. Sense etiqueta 2 %{tag2} igual que "" Nomes mostra els fitxers que no tenen una etiqueta 2. Etiqueta ID3 versio 2.3.0 %{tag2} igual que "ID3 versio 2.3.0" Nomes mostra els fitxers que tenen una etiqueta ID3 versio 2.3.0. Etiqueta ID3 versio 2.4.0 %{tag2} igual que "ID3 versio 2.4.0" Nomes mostra els fitxers que tenen una etiqueta ID3 versio 2.4.0. Etiqueta 1 != Etiqueta 2 no (%1{title} igual que %2{title} i %1{album} igual que %2{album} i %1{artist} igual que %2{artist} i %1{comment} igual que %2{comment} i %1{year} igual que %2{year} i %1{track} igual que %2{track} i %1{genre} igual que %2{genre}) Mostra els fitxers amb diferencies entre l'etiqueta 1 i l'etiqueta 2. Etiqueta 1 == Etiqueta 2 %1{title} igual que %2{title} i %1{album} igual que %2{album} i %1{artist} igual que %2{artist} i %1{comment} igual que %2{comment} i %1{year} igual que %2{year} i %1{track} igual que %2{track} i %1{genre} igual que %2{genre} Mostra els fitxers on l'etiqueta 1 i l'etiqueta 2 son identiques. Incompletes %{title} igual que "" o %{artist} igual que "" o %{album} igual que "" o %{year} igual que "" o %{tracknumber} igual que "" o %{genre} igual que "" Mostra els fitxers amb valors buits a les etiquetes estandard (titol, artista, album, data, numero de la peca, genere). Cap imatge %{picture} igual que "" Nomes mostra els fitxers que no tenen una imatge. Marcada no (%{marked} igual que "") Nomes mostra els fitxers que estan marcats perque violen l'estandard ID3, es trenca o la imatge es massa gran. Filtratge personalitzat Per a afegir el vostre propi filtre, seleccioneu aquesta entrada. Per exemple, si voleu tenir un filtre per a artistes que comencin amb <>, substituiu <> amb el nom <> i premeu Retorn. Despres inseriu la seguent expressio a la linia d'edicio: %{artist} coincideix amb "El.*" Despres feu clic a Desa la configuracio. Feu clic a Aplica per a filtrar els fitxers. Tots els fitxers processats es mostraran a la vista de text, amb un <<+>> per a aquells que coincideixin amb el filtre i un <<->> per als altres. Quan acabeu, nomes es mostraran els fitxers amb un artista que comenci per <>, i el titol de la finestra es marcara amb <<[filtrada]>>. Eines -> Converteix ID3 versio 2.3 a 2.4 Si hi ha etiquetes ID3 versio 2.3 en els fitxers seleccionats, es convertiran en etiquetes ID3 versio 2.4. Els marcs que no estiguin admesos per la TagLib seran descartats. Nomes es convertiran els fitxers sense canvis i que no s'hagin desat. Eines -> Converteix ID3 versio 2.4 a 2.3 Si hi ha etiquetes ID3 versio 2.4 en els fitxers seleccionats, es convertiran en etiquetes ID3 versio 2.3. Nomes es convertiran els fitxers sense canvis i que no s'hagin desat. Eines -> Reprodueix Obre una barra d'eines senzilla per a reproduir els fitxers d'audio. Conte botons per a les operacions basiques (Reprodueix/Pausa, Atura la reproduccio, Peca anterior, Peca seguent, Tanca), controls lliscants per a la posicio i el volum, i una vista de la posicio actual. Si se seleccionen multiples fitxers, es reproduiran les peces seleccionades. En cas contrari, es reproduiran tots els fitxers. El temps mostrat es pot alternar entre el temps transcorregut i el temps restant fent clic a la pantalla. El menu Arranjament Arranjament -> Mostra la barra d'eines Alterna la visualitzacio de la barra d'eines. Arranjament -> Mostra la barra d'estat Alterna la visualitzacio de la barra d'estat, la qual mostra accions mes llargues com obrir o desar una carpeta. Arranjament -> Mostra la imatge Alterna la visualitzacio de la imatge de vista previa per a la caratula de l'album. Arranjament -> Oculta automaticament les etiquetes Les etiquetes buides s'ocultaran automaticament si aquesta opcio esta activa. Les seccions Fitxer, Etiqueta 1 i Etiqueta 2 es podran contraure i expandir manualment fent clic als botons -/+ corresponents. Arranjament -> Configura les dreceres de teclat... Obre un dialeg per a assignar les dreceres de teclat per a la majoria de les funcions del programa. Fins i tot hi ha funcions sense un menu o boto corresponent disponible, p. ex., Fitxer seguent, Fitxer anterior o Selecciona-ho tot. Arranjament -> Configura el Kid3... Obre el dialeg de configuracio, el qual consta de pagines per a les etiquetes, fitxers, accions de l'usuari i configuracio de xarxa. Les opcions especifiques de les etiquetes es troben a la pagina Etiquetes, la qual esta dividida en quatre pestanyes per a Etiqueta 1, Etiqueta 2, Etiqueta 3 i Totes les etiquetes. Si Marca els camps truncats esta marcada, els camps truncats ID3 versio 1.1 es marcaran en vermell. Els camps de text de les etiquetes ID3 versio 1.1 nomes poden contenir 30 caracters i el comentari nomes 28 caracters. A mes, el genere i els numeros de peca estan restringits, de manera que els camps es poden truncar quan s'importen o transfereixen des d'ID3 versio 2. Els camps truncats i el fitxer es marcaran en vermell, i la marca s'eliminara una vegada s'hagi editat el camp. Amb la Codificacio del text per a ID3 versio 1 es possible establir el joc de caracters utilitzat en les etiquetes ID3 versio 1. Se suposa que aquesta codificacio ha de ser ISO-8859-1, de manera que es recomana mantenir aquest valor predeterminat. No obstant aixo, hi ha etiquetes amb codificacions diferents, de manera que es pot establir aqui i les etiquetes ID3 versio 1 es poden copiar a ID3 versio 2, la qual admet Unicode. La casella de seleccio Empra el nombre de peces/total del format de les peces controla si el camp del numero de peca de les etiquetes ID3 versio 2 conte simplement el numero de pista o, a mes, el nombre total de peces a la carpeta. Quan Genera com a text en lloc d'una cadena numerica esta marcada, tots els generes d'ID3 versio 2 s'emmagatzemaran com una cadena de text, fins i tot si hi ha un codi corresponent per als generes d'ID3 versio 1. Si no s'estableix aquesta opcio, els generes per als quals hi ha un codi d'ID3 versio 1 s'emmagatzemaran com el numero del codi de genere (entre parentesis per a ID3 versio 2.3). Per tant, el genere Metal s'emmagatzemara com a <> o <<(9)>> depenent d'aquesta opcio. Els generes que no es trobin a la llista de generes ID3 versio 1 sempre s'emmagatzemaran com una cadena de text. La finalitat d'aquesta opcio es una compatibilitat millorada amb els dispositius que no interpretin correctament els codis de genere. Quan Fitxers WAV amb el bloc id3 en minuscules esta marcada, el fragment RIFF utilitzat per a emmagatzemar les etiquetes ID3 versio 2 en els fitxers WAV s'anomenara <> en lloc d'<>. De manera predeterminada, el Kid3 i altres aplicacions que fan servir la TagLib admeten tant la variant en minuscules com en majuscules quan llegeixen els fitxers WAV, pero fan servir <> quan escriuen les etiquetes ID3 versio 2 en els fitxers WAV. Com a altres aplicacions que nomes admeten <> (p. ex., JRiver Media Center i foobar2000), aquesta opcio es pot utilitzar per a crear etiquetes que aquestes aplicacions puguin llegir. Quan Marca les infraccions de l'estandard esta marcada, els camps ID3 versio 2 que violen l'estandard es marcaran en vermell. Els detalls sobre la violacio es mostraran en un consell d'eina: o Cal que sigui unica o La linia nova esta prohibida o El retorn de carro esta prohibit o El propietari no pot estar buit o Ha de ser numerica o Ha de ser numerica o numero/total o El format es DDMM o El format es HHMM o El format es AAAA o Ha de comencar amb un any i un caracter espacial o Ha de ser la data/hora en l'ISO 8601 o Ha de ser clau musical, de 3 caracters, <>, <>, <<#>>, <> o <> o Ha de tenir un codi d'idioma en l'ISO 639-2, 3 caracters en minuscula o Ha de ser un codi ISRC, 12 caracters en minuscula o S'han de llistar les cadenes separades per <<|>> o Hi ha exces en l'espai en blanc Els documents de l'estandard ID3 estan disponibles en linia: o Etiqueta ID3 versio 2.3.0[10] o Etiqueta ID3 versio 2.4.0: estructura principal[11] o Etiqueta ID3 versio 2.4.0: marcs natius[5] La Codificacio del text defineix la codificacio predeterminada emprada per als marcs ID3 versio 2 i es pot establir en l'ISO-8859-1, UTF16 o UTF8. L'UTF8 no es valid per a marcs ID3 versio 2.3.0. Si esta establert, es fara servir UTF16 al seu lloc. Per als marcs ID3 versio 2.4.0, seran possibles les tres codificacions. La Versio per a les etiquetes noves: determina si les etiquetes noves ID3 versio 2 es crearan com a versio 2.3.0 o 2.4.0. Els Digits del numero de la peca: son la quantitat de digits en els camps de Numero de la peca. Els zeros inicials s'empren per a omplir. Per exemple, amb un valor de 2, la peca numero 5 s'establira com a <<05>>. El quadre combinat Nom del camp de comentari: nomes es rellevant per als fitxers Ogg/Vorbis i FLAC, i estableix el nom del camp emprat per als comentaris. Sembla que diferents aplicacions fan servir noms diferents, <>, per exemple, es emprat pel XMMS, mentre que l'Amarok fa servir <>. El format de les imatges en els fitxers Ogg/Vorbis esta determinat pel Nom del camp de la imatge:, el qual pot ser <> o <>. El primer es l'estandard oficial i utilitza el mateix format que les imatges en les etiquetes FLAC. La <> es una forma no oficial anterior d'incloure imatges en els comentaris de Vorbis. Es pot emprar per a compatibilitat amb els reproductors heretats. Si la casella de seleccio Marca si es mes gran que (bytes): esta activada, els fitxers que tinguin incrustada la caratula de l'album i que excedeixi la mida indicada en bytes es marcaran en vermell. Aixo es pot utilitzar per a trobar els fitxers que continguin imatges de grans dimensions que algunes aplicacions i reproductors no acceptaran. De manera predeterminada es 131.072 bytes (128 kB). Els Generes personalitzats es poden utilitzar per a definir generes que no estiguin disponibles a la llista de generes estandard, p. ex., <>. Aquests generes personalitzats apareixeran en el quadre combinat Genere de l'Etiqueta 2. Per a les etiquetes ID3 versio 1.1, nomes es podran emprar els generes predefinits. La llista de generes personalitzats tambe es pot emprar per a reduir la quantitat de generes disponibles al quadre combinat Genere als que s'utilitzen habitualment. Si la vostra col.leccio principalment conte musica en els generes Metal, Gothic Metal, Ancient i Hard Rock, podreu introduir aquests generes i marcar Mostra nomes els generes personalitzats. El quadre combinat Genere de l'Etiqueta 2 nomes contindra aquests quatre generes i no haura de cercar-los a tota la llista. En aquest exemple, nomes es llistaran Metal i Hard Rock a la llista de l'etiqueta 1, perque aquestes dues entrades de generes personalitzats son generes estandard. Si Mostra nomes els generes personalitzats no esta activada, els generes personalitzats es podran trobar al final de la llista de generes. A Marcs personalitzats, es poden definir fins a vuit noms de marc personalitzats, els quals despres es poden utilitzar com els marcs unificats, per exemple, com a marcs d'acces rapid. Els Marcs d'acces rapid defineixen quins tipus de marcs es mostraran sempre a la seccio Etiqueta 2. Aquests marcs es podran afegir sense fer servir primer el boto Afegeix. L'ordre d'aquests marcs d'acces rapid es pot canviar arrossegant i deixant anar els elements. El quadre combinat Nom de camp del numero de la peca: nomes es rellevant per a la informacio del RIFF i estableix el nom del camp emprat per als numeros de les peces. Els numeros de les peces no s'especifiquen en l'estandard RIFF original, hi ha aplicacions que fan servir <>, altres fan servir <>. El Format de l'etiqueta conte opcions per al format de les etiquetes. Quan l'opcio Aplica automaticament el format esta marcada, s'emprara automaticament la configuracio del format mentre s'editi el text a les linies d'edicio. La Validacio habilita els validadors en els controls amb els valors de peca/total i data/hora. La Conversio entre majuscules i minuscules: es pot establir a Sense canvis, Tot en minuscula, Tot en majuscula, Primera lletra en majuscula o Totes les primeres lletres en majuscula. Per a utilitzar la conversio del reconeixement segons la configuracio regional entre caracters en minuscula i majuscula, es pot seleccionar en el quadre combinat a continuacio. La llista de substitucio de cadenes es pot establir a assignacions arbitraries de cadenes. Per a afegir una assignacio nova, seleccioneu la cel.la Des de: d'una fila i inseriu el text a substituir, despres aneu a la columna A: i introduiu el text de substitucio. Quan el text a substituir comenca i acaba amb una barra diagonal (<>), s'utilitzara una expressio regular. Per a les expressions regulars que contenen grups de captura, les ocurrencies de \1, \2, <<...>> a A: se substituiran amb la cadena capturada pel grup de captura corresponent. Per a eliminar una assignacio, establiu la cel.la Des de: un valor buit (p. ex., escrivint primer un espai i despres la tecla Retroces). Tambe es possible inserir i suprimir files fent servir un menu contextual que apareixera quan feu clic amb el boto dret del ratoli. La substitucio nomes estara activa si la casella de seleccio Cadena de substitucio: esta marcada. La taula a Puntuacio conte l'assignacio de les estrelles valorades als valors efectius emmagatzemats a l'etiqueta. Els marcs amb informacio de puntuacio es llisten a la fila Puntuacio de la llista de marcs. Per a aquests marcs, la puntuacio es podra establir donant una quantitat d'estrelles de cinc estrelles. Els diferents formats d'etiqueta i les diferents aplicacions utilitzen diferents valors per a assignar la puntuacio d'estrelles al valor emmagatzemat a l'etiqueta. Per a mostrar el nombre correcte d'estrelles, el Kid3 cercara un mapa en aquesta taula. La clau per a cercar l'assignacio sera el nom del marc, per exemple <> tal com s'empra per als comentaris a Vorbis o <> per a la informacio de RIFF. Per a les etiquetes ID3 versio 2, s'utilitza una clau combinada que consisteix en l'ID del marc <> del marc Mesurador de la popularitat i el seu camp <>, separats per un punt. Per tant, hi ha diferents claus per a ID3 versio 2, p. ex., <> per a l'assignacio emprada pel Windows Media Player i Explorer, i simplement <> per als marcs POPM amb un camp <> buit. Com hi poden haver multiples entrades per a <>, el seu ordre es important. Quan el Kid3 afegeix un marc nou de Mesurador de la popularitat, utilitzara la primera entrada <> per a determinar el valor que s'escriura al camp <>. Aquest valor especificara l'assignacio que s'utilitzara per a la puntuacio d'estrelles. Tambe s'emprara la primera entrada si no es troba cap clau, per tant, es l'entrada predeterminada. A mes de la columna Nom que conte les claus, la taula te les columnes de l'1 al 5 per als valors que s'emmagatzemaran quan es proporcioni el nombre corresponent d'estrelles. Al reves, els valors determinaran el nombre d'estrelles que es mostraran per al valor emmagatzemat en el marc. Per exemple, la fila de la taula a continuacio conte els valors 1, 64, 128, 196 i 255. Els llindars per a la quantitat d'estrelles que es mostraran es troben entre aquests valors i son compatibles amb el que utilitza el Windows(R) Explorer. Taula 1. Entrada a la taula de puntuacio +---------+------+-------+--------+---------+---------+ |Nom | 1 | 2 | 3 | 4 | 5 | +---------+------+-------+--------+---------+---------+ |POPM | 1 | 64 | 128 | 196 | 255 | +---------+------+-------+--------+---------+---------+ |Interval | 1-31 | 32-95 | 96-159 | 160-223 | 224-255 | +---------+------+-------+--------+---------+---------+ A la pagina Fitxers, la casella de seleccio Carrega els ultims fitxers oberts es pot marcar de manera que la proxima vegada que s'obri el Kid3 ho faci amb els ultims fitxers seleccionats. Es pot marcar Manten la marca de temps del fitxer per a mantenir la marca de temps de modificacio del fitxer. Nom de fitxer per a la caratula: estableix el nom que s'aconsella quan s'exporta una imatge incrustada a un fitxer. Amb la Codificacio del text (Exporta, Llista de reproduccio) es pot establir la codificacio emprada en escriure els fitxers. El Sistema predeterminat es pot canviar, per exemple, si s'han d'emprar les llistes de reproduccio en un dispositiu diferent. Si Marca els canvis esta activa, els camps modificats es marcaran amb un fons d'etiqueta en gris clar. La seccio Llista de fitxers determina quins fitxers es mostraran a la llista de fitxers. Es pot utilitzar un Filtre per a restringir els elements d'aquesta llista als fitxers amb extensions admeses. Per a especificar explicitament quines carpetes mostrar a la llista de fitxers o excloure certes carpetes, es poden emprar les opcions Carpetes a incloure: i Carpetes a excloure:. Poden contenir expressions de comodi, per exemple */Musica/* per a incloure nomes la carpeta Musica, o */iTunes/* per a excloure la carpeta iTunes de la llista de fitxers. Si s'han d'emprar multiples d'aquestes expressions, es podran separar amb espais o punt i coma. Els botons Nom del fitxer des de l'etiqueta i Etiqueta des del nom de fitxer a la seccio Format obriran els dialegs per a editar els formats que hi ha disponibles als quadres combinats Format (amb les fletxes amunt i avall), que es poden trobar a la seccio Fitxer de la finestra principal. El boto Llista de reproduccio es pot utilitzar per a editar els formats disponibles de noms de fitxer al dialeg Crear una llista de reproduccio. El Format del nom de fitxer conte opcions per al format dels noms de fitxer. Hi ha disponibles les mateixes opcions que en el Format de l'etiqueta. A mes, es pot configurar la Longitud maxima permesa per als noms de fitxer. La majoria dels sistemes de fitxers moderns tenen un limit de 255 caracters, pero si voleu escriure fitxers en un CD, haureu d'establir-la a 64. Si es marca Emprar-ho per als noms de llistes de reproduccio i de carpetes, el format del nom de fitxer tambe s'emprara quan es crein llistes de reproduccio i es reanomenin carpetes. La pagina Accions de l'usuari conte una taula amb les ordres que hi ha disponibles al menu contextual de la llista de fitxers. Per a operacions critiques com suprimir fitxers, es recomanable marcar Confirma perque aparegui un dialeg de confirmacio abans d'executar l'ordre. La Sortida es pot marcar per a veure la sortida escrita per les ordres de la consola (sortida estandard i d'error estandard). El Nom es el nom que es mostra en el menu contextual. L'Ordre es la linia d'ordres que s'executara. Es poden passar els arguments utilitzant els seguents codis: o %F %{files} Camins de fitxer (una llista si hi ha seleccionats multiples fitxers) o %f %{file} Cami de fitxer a un unic fitxer o %uF %{urls} Els URL (una llista si hi ha seleccionats multiples fitxers) o %uf %{url} URL a un unic fitxer o %d %{directory} Carpeta o %s %{title} Titol (canco) o %a %{artist} Artista o %l %{album} Album o %c %{comment} Comentari o %y %{year} Any o %t %{track} Peca (p. ex., 01) o %t %{track.n} Peca amb l'amplada del camp <> (p. ex., 001 per a %{track.3}) o %T %{tracknumber} Peca (sense zeros a l'esquerra, p. ex., 1) o %g %{genre} Genere o %b %{browser} Ordre per a iniciar el navegador web o %q %{qmlpath} Carpeta base dels fitxers QML proporcionats El codi especial @separator es pot establir com una ordre per a inserir un separador al menu contextual de les accions de l'usuari. Els elements de menu es poden posar en un submenu tancat amb les ordres @beginmenu i @endmenu. El nom del submenu esta determinat per la columna Nom de l'ordre @beginmenu. Per a executar scripts QML, s'utilitza @qml com a nom de l'ordre. El cami cap a l'script QML es passa com un parametre. Els scripts proporcionats es troben a la carpeta %{qmlpath}/script/ (a Linux(R) tipicament /usr/share/kid3/qml/script/, a Windows qml/script/ dins de la carpeta d'instal.lacio i a macOS(R) a la carpeta de l'aplicacio kid3.app/Contents/Resources/qml/script/). Els scripts personalitzats es poden emmagatzemar en qualsevol carpeta. Si el codi QML fa servir components de la IGU, s'utilitzara @qmlview en lloc de @qml. Es passaran parametres addicionals a l'script QML i estaran disponibles mitjancant la funcio getArguments(). Trobareu una descripcio general d'algunes funcions i propietats que hi ha disponibles al QML a la seccio Interficie QML de l'apendix. L'ordre que s'inserira amb %{browser} es podra definir a l'anterior linia d'edicio del Navegador web. Les ordres que comencin amb %{browser} es podran emprar per a obtenir informacio sobre els fitxers d'audio del web, per exemple %{browser} http://lyricwiki.org/%u{artist}:%u{title} consultara la lletra per a la canco actual a LyricWiki[12]. La <> a %u{artist} i %u{title} s'utilitza per a codificar a l'URL la informacio de l'artista %{artist} i la canco %{title}. Es facil definir les vostres propies consultes de la mateixa manera, p. ex., una cerca d'imatges amb Google[13]: %{browser} http://images.google.com/images?q=%u{artist}%20%u{album} Per a afegir la caratula de l'album a l'etiqueta 2, podreu cercar imatges amb Google o Amazon utilitzant les ordres descrites anteriorment. La imatge es podra afegir a l'etiqueta arrossegant i deixant anar. Tambe podreu afegir una imatge amb Afegeix, despres seleccioneu el Marc de la imatge i importeu un fitxer d'imatge o enganxeu-lo des del porta-retalls. Els marcs d'imatge estan admesos per les etiquetes ID3 versio 2, MP4, FLAC, Ogg i ASF. Per a afegir i suprimir entrades a la taula, es pot emprar un menu contextual. La pagina Xarxa nomes conte un camp per a inserir l'adreca de l'intermediari i, de manera opcional, el port, separat per dos punts. El servidor intermediari s'utilitzara en importar des d'un servidor d'Internet quan la casella de seleccio estigui marcada. A la pagina Connectors, els connectors disponibles es podran habilitar o inhabilitar. Els connectors estan separats en dues seccions. La llista Connectors de metadades i prioritat conte els connectors que admeten formats de fitxers d'audio. L'ordre dels connectors es important perque es proven de dalt a baix. Alguns formats son admesos per multiples connectors, de manera que els fitxers s'obriran amb el primer connector que l'admeti. El TaglibMetadata admet la majoria dels formats, si es troba a la part superior de la llista, obrira la majoria dels fitxers. Si voleu utilitzar un connector diferent per a un format de fitxer, comproveu que aparegui abans d'aquest. Els detalls sobre el connector de metadades i perque es possible que vulgueu utilitzar-los en lloc de la TagLib es llisten a continuacio. o Id3libMetadata: utilitza la id3lib[14] per a les etiquetes ID3 versio 1.1 i 2.3 en els fitxers MP3, MP2 i AAC. Admet alguns tipus de marcs mes que la TagLib. o OggFlacMetadata: utilitza les libogg[15], libvorbis i libvorbisfile[16] per als fitxers Ogg, i addicionalment les libFLAC++ i libFLAC[17] per als fitxers FLAC. Aquestes son les biblioteques oficials per a aquests formats. o TaglibMetadata: utilitza la TagLib[18], la qual admet molts formats de fitxers d'audio. Es pot fer servir per a tots els fitxers d'audio admesos pel Kid3. o Mp4v2Metadata: la mp4v2[19] va ser utilitzada originalment pel Kid3 per a admetre els fitxers M4A. Es pot utilitzar en cas de problemes amb el suport M4A de la TagLib. La seccio Connectors disponibles llista els connectors restants. El seu ordre no es important, pero es poden habilitar o inhabilitar mitjancant les caselles de seleccio. o AmazonImport: utilitzat per a la funcio Importa des d'Amazon.... o DiscogsImport: utilitzat per a la funcio Importa des de Discogs.... o FreedbImport: emprat per a la funcio Importa des de gnudb.org.... o MusicBrainzImport: utilitzat per a la funcio Importa des del Llancament de MusicBrainz.... o AcoustidImport: utilitzat per a la funcio Importa des de l'Empremta digital de MusicBrainz..., la que depen de les biblioteques Chromaprint[20] i libav[21]. Els connectors que estiguin inhabilitats no es carregaran. Aixo es pot utilitzar per a optimitzar l'us dels recursos i el temps d'inici. La configuracio d'aquesta pagina nomes tindra efecte despres de reiniciar el Kid3. El menu Ajuda Ajuda -> Manual del Kid3 Obre aquest manual. Ajuda -> Quant al Kid3 Mostra la informacio curta sobre el Kid3. KID3-CLI Ordres El kid3-cli ofereix una interficie de linia d'ordres per al Kid3. Si s'utilitza un cami de carpeta, s'obrira la carpeta. Si es proporcionen un o mes camins de fitxer, s'obrira la carpeta comuna i se seleccionaran els fitxers. Les ordres posteriors treballaran sobre aquests fitxers. Les ordres s'especifiquen emprant les opcions -c. Si es passen multiples ordres, s'executaran en l'ordre indicat. Si les ordres modifiquen els fitxers, es desaran en finalitzar. Si no passen opcions d'ordre, el kid3-cli s'iniciara en el mode interactiu. Es poden introduir ordres i operaran sobre la seleccio actual. Les seguents seccions llisten totes les ordres disponibles. Ajuda help [NOM_ORDRE] Mostrara l'ajuda sobre els parametres de NOM_ORDRE o sobre totes les ordres si no es proporciona cap nom. Temps d'espera timeout [ | default | off | TEMPS ] Se sobreescriura el temps d'espera predeterminat de l'ordre. Les ordres de la CLI s'interrompran despres d'un temps d'espera especific en el qual expirara una ordre. Aquest temps d'espera es de 10 segons per a ls i albumart, 60 segons per a autoimport i filter, i 3 segons per a totes les altres ordres. Si s'ha de processar una gran quantitat de fitxers, aquests temps d'espera podrien ser massa restrictius, per tant, el temps d'espera per a totes les ordres es podra establir en TEMPS ms, no pensar-hi o deixar-ho en els valors predeterminats. Sortir de l'aplicacio exit [force] Sortira de l'aplicacio. Si hi ha fitxers sense desar que han estat modificats, es requerira el parametre force. Canviar de carpeta cd [CARPETA] Si no es proporciona la CARPETA, es canviara a la carpeta d'inici. Si es proporciona una carpeta, es canviara a dins de la carpeta. Si es proporcionen un o mes camins de fitxer, es canviara a la seva carpeta comuna i se seleccionaran els fitxers. Imprimir el nom de fitxer de la carpeta de treball actual pwd Imprimira el nom de fitxer de la carpeta de treball actual. Llistar les carpetes ls Llistara el contingut de la carpeta actual. Aixo correspon a la llista de fitxers a la IGU del Kid3. Cinc caracters abans dels noms de fitxer es mostrara l'estat del fitxer. o > El fitxer esta seleccionat. o * El fitxer esta modificat. o El fitxer 1 te una etiqueta 1, en cas contrari es mostrara <<->>. o El fitxer 2 te una etiqueta 2, en cas contrari es mostrara <<->>. o El fitxer 3 te una etiqueta 3, en cas contrari es mostrara <<->>. kid3-cli> ls 1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3 En aquest exemple, tots els fitxers tenen una etiqueta 1, el segon fitxer tambe te una etiqueta 2 i esta seleccionat. El tercer fitxer sera el modificat. Desar els fitxers canviats save Seleccionar un fitxer select [ | all | none | first | previous | next | FITXER... ] Per a seleccionar tots els fitxers, introduiu select all, per a desseleccionar tots els fitxers, introduiu select none. Per a recorrer els fitxers a la carpeta actual comenceu amb select first, despres aneu endavant emprant select next o cap enrere emprant select previous. Es poden afegir fitxers especifics a la seleccio actual indicant els seus noms de fitxer. Son possibles els comodins, de manera que select *.mp3 seleccionara tots els fitxers MP3 a la carpeta actual. kid3-cli> select first kid3-cli> ls > 1-- 01 Intro.mp3 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3 kid3-cli> select next kid3-cli> ls 1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3 kid3-cli> select *.mp3 kid3-cli> ls > 1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 >*1-- 03 Outro.mp3 Seleccionar una etiqueta tag [NUMEROS_D'ETIQUETA] Moltes ordres tenen un parametre opcional NUMEROS_D'ETIQUETA, el qual especifica si l'ordre operara sobre l'etiqueta 1, 2 o 3. Si s'omet aquest parametre, s'utilitzaran els numeros d'etiqueta predeterminats, els quals es poden establir mitjancant aquesta ordre. A l'inici, s'estableix a 12, el qual vol dir que la informacio es llegira de l'etiqueta 2, si esta disponible, en cas contrari, de l'etiqueta 1, les modificacions es realitzaran a l'etiqueta 2. Els NUMEROS_D'ETIQUETA es poden establir a 1, 2 o 3 per a nomes operar sobre l'etiqueta corresponent. Si s'omet el parametre, es mostrara l'opcio de configuracio actual. Obtenir un marc d'etiqueta get [ | all | NOM_MARC ] [NUMEROS_D'ETIQUETA] Aquesta ordre es pot emprar per a llegir el valor d'un marc d'etiqueta especific o obtenir informacio sobre tots els marcs d'etiqueta (si s'omet l'argument o s'utilitza all). Els marcs modificats seran marcats amb un <<*>>. kid3-cli> get File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo Name: 01 Intro.mp3 Tag 1: ID3v1.1 Title Intro Artist Lluis Llach Album I si canto trist Date 1974 Track Number 1 Genre Lied kid3-cli> get title Intro Per a desar a un fitxer el contingut d'un marc d'imatge, utilitzeu get picture:'/cami/a/carpeta.jpg' Per a desar una lletra sincronitzada en un fitxer LRC, utilitzeu get SYLT:'/cami/a/lletra.lrc' Es possible obtenir nomes un camp especific des d'un marc, per exemple, get POPM.Email per al camp Correu electronic d'un marc Mesurador de la popularitat. Si un fitxer te multiples marcs del mateix tipus, els diferents marcs es podran indexar amb parentesis, per exemple, el primer interpret d'un comentari de Vorbis es pot recuperar emprant get performer[0], el segon emprant get performer[1]. El nom del pseudocamp <> es pot fer servir per a comprovar si s'ha seleccionat un marc, per exemple, get artist.selected retornara 1 si esta seleccionat el marc de l'artista, en cas contrari 0. Es pot utilitzar el nom del pseudomarc <> per a obtenir el valor del marc <> com a valor del format especific corresponent al nombre d'estrelles (0 a 5). En usar el <>, es retorna el valor intern. Establir un marc d'etiqueta set {NOM_MARC} {VALOR_MARC} [NUMEROS_D'ETIQUETA] Aquesta ordre estableix el valor d'un marc d'etiqueta especific. Si VALOR_MARC esta buit, se suprimira el marc. kid3-cli> set remixer 'I si canto trist' Per a establir des d'un fitxer el contingut d'un marc d'imatge, utilitzeu set picture:'/cami/a/carpeta.jpg' 'Descripcio de la imatge' Per a establir una lletra sincronitzada en un fitxer LRC, utilitzeu set SYLT:'/cami/a/lletra.lrc' 'Descripcio de la lletra' Per a establir un camp especific d'un marc, el nom del camp es podra indicar despres d'un punt, p. ex., per a establir el camp Comptador d'un marc Mesurador de la popularitat, utilitzeu set POPM.Counter 5 Una aplicacio per a especificacions de camp es el cas en el qual voldreu un marc TXXX personalitzat amb una descripcio de <> en lloc d'un marc Mesurador de la popularitat estandard (alguns connectors semblen utilitzar-lo). Podreu crear-lo com un marc de puntuacio TXXX amb el kid3-cli, pero, primer haureu de crear un marc TXXX amb la descripcio <> i despres establir el valor d'aquest marc al valor de la puntuacio. kid3-cli> set rating "" kid3-cli> set TXXX.Description rating kid3-cli> set rating 5 La primera ordre suprimira un marc POPM existent, perque si existeix, set rating 5 establira el marc POPM i no el marc TXXX. Una altra possibilitat seria utilitzar set TXXX.Text 5, pero aixo nomes funcionara si no hi ha un altre marc TXXX present. Per a establir multiples marcs del mateix tipus, es pot indicar un index entre parentesis, p. ex., per a establir multiples interprets en un comentari de Vorbis, utilitzeu kid3-cli> set performer[0] 'Liza don Getti (soprano)' kid3-cli> set performer[1] 'Joe Barr (piano)' Per a seleccionar certs marcs abans d'una accio de copia, enganxat o eliminacio, es pot emprar el nom del pseudocamp <>. Normalment, se seleccionaran tots els marcs, per a desseleccionar-los empreu set '*.selected' 0, despres, per exemple, set artist.selected 1 per a seleccionar el marc de l'artista. Es pot utilitzar el nom del pseudomarc <> per a establir el valor del marc <> com a valor del format especific corresponent al nombre d'estrelles (0 a 5). Es pot usar el nom de marc <> per a establir el valor intern. Establir <> en diversos fitxers que tinguin formats diferents d'etiqueta no funcionara perque el marc amb el valor mapat del comptador d'estrelles es crea en el primer fitxer i despres s'utilitza per a tots els fitxers. Aixi que en lloc de kid3-cli -c "set ratingstars 2" * cal usar for f in *; do kid3-cli -c "set ratingstars 2" "$f"; done. Revertir revert Revertir totes les modificacions en els fitxers seleccionats (o tots els fitxers si no hi ha fitxers seleccionats). Importar des del fitxer import {FITXER} {NOM_FORMAT} [NUMEROS_D'ETIQUETA] Les etiquetes s'importen des del FITXER en el format amb el nom NOM_FORMAT (p. ex., "CSV unquoted", vegeu Importar). Si s'indiquen etiquetes (tags) per a FITXER, les etiquetes seran importades des d'altres etiquetes. En lloc dels parametres NOM_FORMAT, FONT i EXTRACCIO els quals son obligatoris, vegeu Importar des de les etiquetes. Per a aplicar la importacio des de les etiquetes en els fitxers seleccionats, utilitzeu tagsel en lloc de tags. Aquesta funcio tambe admet la sortida del valor extret mitjancant l'us d'una EXTRACCIO amb el valor %{__return}(.+). Importar automaticament autoimport [NOM_PERFIL] [NUMEROS_D'ETIQUETA] Importara per lots utilitzant el NOM_PERFIL (vegeu Importar automaticament, si s'utilitza "All" sera omes). Descarregar el treball artistic de la caratula de l'album albumart {URL} [all] Establira la caratula de l'album descarregant una imatge des de l'URL. Les regles definides al dialeg Explora les caratules... s'utilitzen per a transformar els URL generals (p. ex., des d'Amazon) en un URL de la imatge. Per a establir la caratula de l'album a partir d'un fitxer d'imatge local, utilitzeu l'ordre set. kid3-cli> albumart http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC Exportar a un fitxer export {FITXER} {NOM_FORMAT} [NUMEROS_D'ETIQUETA] Les etiquetes s'exportaran al FITXER en el format amb el nom NOM_FORMAT (p. ex., "CSV unquoted", vegeu Exportar). Crear una llista de reproduccio playlist Crear una llista de reproduccio en el format establert a la configuracio, vegeu Crear una llista de reproduccio. Aplicar el format per al nom de fitxer filenameformat Aplicar el format per al nom de fitxer establert a la configuracio, vegeu Aplicar el format per al nom de fitxer. Aplicar el format per a l'etiqueta tagformat Aplicar el format per al nom de l'etiqueta establert a la configuracio, vegeu Aplicar el format per a l'etiqueta. Aplicar la codificacio del text textencoding Aplica la codificacio de text establert en la configuracio, vegeu Aplicar la codificacio de text. Reanomenar una carpeta renamedir [FORMAT] [ | create | rename | dryrun ] [NUMEROS_D'ETIQUETA] Canviara el nom o creara carpetes a partir dels valors en les etiquetes d'acord amb un FORMAT indicat (p. ex., %{artist} - %{album}, vegeu Canviar el nom d'una carpeta), si no s'indica un format, s'utilitzara el format definit al dialeg Reanomena la carpeta. El mode predeterminat es rename (canvia el nom). Per a crear carpetes, s'haura d'indicar create explicitament. Les accions de canvi de nom es realitzaran immediatament, per a veure que es faria, utilitzeu l'opcio dryrun. Nombre de peces numbertracks [NUMERO_PECA] [NUMEROS_D'ETIQUETA] Numera les peces seleccionades comencant amb NUMERO_PECA (1 si s'omet). Filtrar filter [ | NOM_FILTRE | FORMAT_FILTRE ] Filtrara els fitxers de manera que nomes siguin visibles els fitxers que coincideixin amb FORMAT_FILTRE. Es podra utilitzar el nom d'una expressio de filtre predefinit (p. ex., "Filename Tag Mismatch") en lloc d'una expressio de filtre, consulteu Filtre. kid3-cli> filter '%{title} contains "tro"' Started /home/urs/One Hit Wonder - Let's Tag + 01 Intro.mp3 - 02 We Only Got This One.mp3 + 03 Outro.mp3 Finished kid3-cli> ls 1-- 01 Intro.mp3 1-- 03 Outro.mp3 kid3-cli> filter All Started /home/urs/One Hit Wonder - Let's Tag + 01 Intro.mp3 + 02 We Only Got This One.mp3 + 03 Outro.mp3 Finished kid3-cli> ls 1-- 01 Intro.mp3 12- 02 We Only Got This One.mp3 1-- 03 Outro.mp3 Convertir des d'ID3 versio 2.3 a 2.4 to24 Convertir des d'ID3 versio 2.4 a 2.3 to23 Nom del fitxer des de l'etiqueta fromtag [FORMAT] [NUMEROS_D'ETIQUETA] Estableix els noms dels fitxers seleccionats a partir dels valors trobats en les etiquetes, per exemple, fromtag '%{track} - %{title}' 1. Si no s'especifica cap format, s'utilitzara el format establert a la IGU. Etiquetar des del nom de fitxer totag [FORMAT] [NUMEROS_D'ETIQUETA] Estableix els marcs d'etiqueta a partir dels noms de fitxer, per exemple, totag '%{albumartist} - %{album}/%{track} %{title}' 2. Si no s'especifica cap format, s'utilitzara el format establert a la IGU. Si el format per al nom de fitxer no coincideix amb aquest patro, s'intentaran alguns altres formats d'us habitual. Etiquetar a una altra etiqueta syncto {NUMERO_ETIQUETA} Copia els marcs d'etiqueta des d'una etiqueta a l'altra etiqueta, p. ex., per a establir l'etiqueta ID3 versio 2 a partir de l'etiqueta ID3 versio 1, utilitzeu syncto 2. Copiar copy [NUMERO_ETIQUETA] Copia els marcs d'etiqueta des del fitxer seleccionat a la memoria intermedia de copiar interna. Despres es podran establir en un altre fitxer utilitzant l'ordre paste (enganxa). Per a copiar nomes un subconjunt de marcs, utilitzeu el pseudocamp <> amb l'ordre set. Per exemple, per a copiar nomes els marcs numero del disc i drets d'autor, utilitzeu set '*.selected' 0 set discnumber.selected 1 set copyright.selected 1 copy Enganxar paste [NUMERO_ETIQUETA] Estableix els marcs d'etiqueta a partir del contingut de la memoria intermedia copy en els fitxers seleccionats. Eliminar remove [NUMERO_ETIQUETA] Elimina una etiqueta. Es possible eliminar nomes un subconjunt de marcs seleccionant-los com es descriu en l'ordre copy. Configurar el Kid3 config [OPCIO] [VALOR] Consulta o estableix una opcio de configuracio. L'OPCIO consta d'un nom de grup i un nom de propietat separats per un punt. Quan no es dona cap OPCIO, es mostraran tots els grups disponibles. Si nomes es proporciona un nom de grup, es mostraran totes les propietats disponibles del grup. Per a un grup i propietat determinats, es mostrara el valor configurat actualment. Per a canviar l'opcio de configuracio, el nou valor es pot passar com a un segon argument. Si el valor d'una opcio de configuracio es una llista, tots els elements de la llista s'hauran de proporcionar com a arguments. Aixo vol dir que per a afegir un element a una llista existent d'elements, tots els elements existents s'hauran de passar seguits de l'element nou. En aquesta situacio, es mes facil utilitzar el mode JSON, on la llista actual es pot copiar amb el nou element afegit. Executa el programa o script en QML execute [@qml] {FITXER} [ARGUMENTS] Executa un script en QML o un executable. Sense @qml un programa s'executa amb arguments. Quan s'indica @qml com a primer argument, els arguments seguents seran l'script en QML i els seus arguments. Per exemple, les etiquetes d'una carpeta es poden exportar al fitxer exporta.csv amb l'ordre seguent. kid3-cli -c "execute @qml /usr/share/kid3/qml/script/ExportCsv.qml exporta.csv" /cami/a/la/carpeta/ Aqui, exporta.csv es l'argument per a l'script ExportCsv.qml, mentre que /cami/a/la/carpeta/ es l'argument FITXER per a kid3-cli. Exemples Establir el titol que conte un apostrof. Les ordres passades al kid3-cli amb -c hauran d'estar entre cometes si no consisteixen nomes d'una sola paraula. Si aquesta ordre en si te un argument que conte espais, aquest argument tambe ha d'anar entre cometes. En els interprets d'ordres d'UNIX(R) es poden utilitzar cometes simples o dobles, pero a l'indicatiu d'ordres de Windows, es important que les cometes externes es realitzin amb cometes dobles i dintre d'aquestes cometes, s'utilitzaran cometes simples. Si el text dins de les cometes simples conte una cometa simple, s'haura d'escapar utilitzant un caracter de barra inversa, com es mostra en el seguent exemple: kid3-cli -c "set title 'I\'ll be there for you'" /cami/a/carpeta Estableix la caratula de l'album a tots els fitxers d'una carpeta utilitzant la funcio d'importacio per lots: kid3-cli -c "autoimport 'Cover Art'" /cami/a/carpeta Elimina els marcs de comentari i aplica el format d'etiqueta en ambdues etiquetes de tots els fitxers MP3 d'una carpeta: kid3-cli -c "set comment '' 1" -c "set comment '' 2" \ -c "tagformat 1" -c "tagformat 2" /cami/a/carpeta/*.mp3 Importa automaticament l'etiqueta 2, sincronitza amb l'etiqueta 1, estableix els noms de fitxer a partir de l'etiqueta 2 i finalment crea una llista de reproduccio: kid3-cli -c autoimport -c "syncto 1" -c fromtag -c playlist \ /cami/a/carpeta/*.mp3 Per a tots els fitxers amb una etiqueta ID3 versio 2.4.0, converteix a ID3 versio 2.3.0 i elimina el marc de l'organitzador: kid3-cli -c "filter 'ID3 versio2.4.0 Tag'" -c "select all" -c to23 \ -c "set arranger ''" /cami/a/carpeta Aquest script de Python utilitza el kid3-cli per a generar marcs d'iTunes Sound Check iTunNORM a partir de la informacio del guany en la reproduccio. #!/usr/bin/env python3 # Generate iTunes Sound Check from ReplayGain. import os, sys, subprocess def rg2sc(dirpath): for root, dirs, files in os.walk(dirpath): for name in files: if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')): fn = os.path.join(root, name) rg = subprocess.check_output([ 'kid3-cli', '-c', 'get "replaygain_track_gain"', fn]).strip() if rg.endswith(b' dB'): rg = rg[:-3] try: rg = float(rg) except ValueError: print('Value %s of %s in not a float' % (rg, fn)) continue sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10 subprocess.call([ 'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn]) if __name__ == '__main__': rg2sc(sys.argv[1]) Format JSON Per a facilitar l'analisi dels resultats del kid3-cli, es possible obtenir la sortida en el format JSON. Quan la sol.licitud esta en el format JSON, la resposta tambe sera en JSON. Un format compacte de la sol.licitud tambe donara una representacio compacta de la resposta. Si la sol.licitud conte un camp <>, se suposa que es una sol.licitud RPC de JSON i la resposta contindra un camp <> i l'<> de la sol.licitud. El format de la sol.licitud utilitzara les mateixes ordres que la CLI estandard, el camp <> contindra l'ordre i els parametres (si n'hi ha cap), i es troben a la llista <>. La resposta contindra un objecte <>, el qual tambe pot ser nul si l'ordre kid3-cli corresponent no retorna un resultat. En cas d'error, es tornara un objecte <> amb els camps <> i <> com s'utilitza en el RPC de JSON. kid3-cli> {"method":"set","params":["artist","An Artist"]} {"result":null} kid3-cli> {"method":"get","params":["artist",2]} {"result":"An Artist"} kid3-cli> {"method": "get", "params": ["artist"]} { "result": "An Artist" } kid3-cli> {"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]} {"id":"123","jsonrpc":"2.0","result":"An Artist"} CREDITS I LLICENCIA Kid3 Programa escrit per en Urs Fleisch Traductor de la documentacio: Antoni Bella .PP FDL[22] .PP GPL[23] INSTAL.LACIO Com obtenir el Kid3 El Kid3 es pot trobar a https://kid3.kde.org. Requisits El Kid3 necessita les Qt(TM)[24]. Es recomana el KDE[25] pero no cal, ja que el Kid3 tambe es pot compilar com una aplicacio de les Qt(TM). El Kid3 es pot compilar per a sistemes on aquestes biblioteques estiguin disponibles, p. ex., per a GNU/Linux(R), Windows(R) i macOS(R). Per a etiquetar els fitxers Ogg/Vorbis, es requereixen les libogg[15], libvorbis i libvorbisfile[16], per als fitxers FLAC, les libFLAC++ i libFLAC[17]. La id3lib[14] s'utilitza per als fitxers MP3. Aquests quatre formats tambe son admesos per la TagLib[18], la qual tambe pot manejar els fitxers Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els moduls dels seguidors de peces. Per a importar a partir d'empremtes digitals acustiques, s'utilitzen les Chromaprint[20] i libav[21]. El Kid3 esta disponible per a la majoria de les distribucions de Linux(R), Windows(R) i macOS(R). Els enllacos es poden trobar a https://kid3.kde.org. Compilacio i instal.lacio Podreu compilar el Kid3 amb el KDE o sense. Sense, el Kid3 sera una senzilla aplicacio Qt(TM) i no tindra algunes caracteristiques de configuracio i de sessio. Per a una versio del KDE, aneu a la carpeta superior i escriviu % cmake . % make % make install Per a compilar per a diferents versions de les Qt(TM) o del KDE, establiu les opcions de cmake corresponents. Si no estan presents totes les biblioteques, el Kid3 es construira amb una funcionalitat reduida. Per tant, haureu de tenir cura de tenir instal.lats tots els paquets de desenvolupament desitjats. D'altra banda, les opcions del cmake controlen quines biblioteques es compilaran. De manera predeterminada son -DWITH_TAGLIB:BOOL=ON -DWITH_MP4V2:BOOL=OFF -DWITH_ID3LIB:BOOL=ON -DWITH_CHROMAPRINT:BOOL=ON -DWITH_VORBIS:BOOL=ON -DWITH_FLAC:BOOL=ON . Aquestes opcions es poden inhabilitar emprant OFF. Per a construir el Kid3 com una aplicacio Qt(TM) sense el KDE, utilitzeu l'opcio -DWITH_APPS=Qt del cmake. Per a construir una aplicacio KDE i una de les Qt(TM), establiu -DWITH_APPS="Qt;KDE". Per a utilitzar una instal.lacio especifica de les Qt(TM), establiu -DQT_QMAKE_EXECUTABLE=/cami/a/qmake. La generacio dels paquets RPM esta admesa pel fitxer kid3.spec, per als paquets de la Debian(R), executeu build.sh deb. L'aplicacio Qt(TM) tambe es pot compilar per a Windows(R) i macOS(R). Es pot emprar l'script build.sh per a descarregar i compilar totes les biblioteques necessaries i crear un paquet del Kid3. Configuracio Amb el KDE, la configuracio s'emmagatzema a .config/kid3rc i l'estat de l'aplicacio a .local/share/kid3/kid3staterc. Com una aplicacio Qt(TM), aquest fitxer estara a .config/Kid3/Kid3.conf. Al Windows(R), la configuracio s'emmagatzemara en el registre. Al macOS(R) en un fitxer .plist (llista de propietats). Es pot emprar la variable d'entorn KID3_CONFIG_FILE per a establir el cami cap al fitxer de configuracio. INTERFICIE DE D-BUS Exemples de D-Bus Al Linux(R), es pot utilitzar una interficie de D-Bus per a controlar el Kid3 mitjancant scripts. Els scripts es poden escriure en qualsevol llenguatge amb vinculacions de D-Bus (p. ex., en Python) i es poden afegir a les Accions de l'usuari per a ampliar la funcionalitat del Kid3. Es pot establir l'artista a l'etiqueta 2 del fitxer actual amb el valor <> amb el seguent codi: Interpret d'ordres dbus-send --dest=org.kde.kid3 --print-reply=literal \ /Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \ string:'Lluis Llach' o mes facil amb el qdbus de les Qt(TM) (es pot utilitzar el qdbusviewer per a explorar la interficie en una IGU): qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \ 'Lluis Llach' Python import dbus kid3 = dbus.SessionBus().get_object( 'org.kde.kid3', '/Kid3') kid3.setFrame(2, 'Artist', 'Lluis Llach') Perl use Net::DBus; $kid3 = Net::DBus->session->get_service( "org.kde.kid3")->get_object( "/Kid3", "org.kde.Kid3"); $kid3->setFrame(2, "Artist", "Lluis Llach"); API de D-Bus L'API de D-Bus s'especifica a org.kde.Kid3.xml. La interficie del Kid3 disposa dels seguents metodes: Obrir un fitxer o carpeta boolean openDirectory(string cami); .PP cami cami cap al fitxer o carpeta .RE Retornara cert si va be. Descarregar les etiquetes de tots els fitxers que no han estat modificats o seleccionats unloadAllTags(void); Desar tots els fitxers modificats boolean save(void); Retornara cert si va be. Obtenir un missatge d'error detallat proporcionat per alguns metodes string getErrorMessage(void); Retornara un missatge d'error detallat. Revertir els canvis fets als fitxers seleccionats revert(void); Iniciar automaticament una importacio per lots boolean batchImport(int32 tagMask, string Nom_Perfil); .PP tagMask mascara de l'etiqueta (bit 0 per a l'etiqueta 1, bit 1 per a l'etiqueta 2) .RE .PP Nom_Perfil el nom del perfil que s'emprara per a la importacio per lots .RE Importar etiquetes des d'un fitxer boolean importFromFile(int32 tagMask, string cami, int32 fmtIdx); .PP tagMask bit de l'etiqueta (1 per a l'etiqueta 1, 2 per a l'etiqueta 2) .RE .PP cami cami del fitxer .RE .PP fmtIdx index del format .RE Retornara cert si va be. Importar etiquetes des d'altres etiquetes importFromTags(int32 tagMask, string source, string extraction); .PP tagMask bit de l'etiqueta (1 per a l'etiqueta 1, 2 per a l'etiqueta 2) .RE .PP font format per a obtenir el text font a partir de les etiquetes .RE .PP extraccio expressio regular amb els noms de marc i captures per a extreure del text font .RE Importar etiquetes des d'altres etiquetes als fitxers seleccionats array importFromTagsToSelection(int32 tagMask, string font, string extraccio); bit de l'etiqueta (1 per a l'etiqueta 1, 2 per a l'etiqueta 2) .RE .PP font format per a obtenir el text font a partir de les etiquetes .RE .PP extraccio expressio regular amb els noms de marc i captures per a extreure del text font .RE .PP Valors_Retornats valor extret per <<%{__return}(.+)>> .RE Descarregar una caratula de l'album downloadAlbumArt(string URL, boolean tots_els_fitxers_a_la_carpeta); URL del fitxer d'imatge o recurs de caratula .RE .PP tots_els_fitxers_a_la_carpeta cert per a afegir la imatge a tots els fitxers que hi ha a la carpeta .RE Exportar les etiquetes a un fitxer boolean exportToFile(int32 tagMask, string cami, int32 fmtIdx); .RE .PP cami Retornara cert si va be. Crear una llista de reproduccio boolean createPlaylist(void); Retornara cert si va be. Obtenir els elements d'una llista de reproduccio array getPlaylistItems(string cami); Retornara la llista dels camins absoluts als elements de la llista de reproduccio. Establir els elements d'una llista de reproduccio boolean setPlaylistItems(string cami, array elements); Retornara cert si va be i fals si no s'han trobat tots els elements, tambe si s'ha fallat en afegir o desar. Surt de l'aplicacio quit(void); Seleccionar tots els fitxers selectAll(void); Desseleccionar tots els fitxers deselectAll(void); Establir el primer fitxer com a fitxer actual boolean firstFile(void); Retornara cert si hi ha un primer fitxer. Establir el fitxer anterior com a fitxer actual boolean previousFile(void); Retornara cert si hi ha un fitxer anterior. Establir el seguent fitxer com a fitxer actual boolean nextFile(void); Retornara cert si hi ha un fitxer seguent. Selecciona el primer fitxer boolean selectFirstFile(void); Retornara cert si hi ha un primer fitxer. Seleccionar el fitxer anterior boolean selectPreviousFile(void); Retornara cert si hi ha un fitxer anterior. Seleccionar el seguent fitxer boolean selectNextFile(void); Retornara cert si hi ha un fitxer seguent. Seleccionar el fitxer actual boolean selectCurrentFile(void); Retornara cert si hi ha un fitxer actual. Expandir o contraure l'element de fitxer actual si es tracta d'una carpeta boolean expandDirectory(void); Un element de la llista de fitxers sera una carpeta si <> retorna un nom amb <> com a ultim caracter. Retornara cert si l'element de fitxer actual es una carpeta. Aplicar el format per al nom del fitxer applyFilenameFormat(void); Aplicar el format per a les etiquetes applyTagFormat(void); Aplicar la codificacio del text applyTextEncoding(void); Establir el nom de la carpeta a partir de les etiquetes boolean setDirNameFromTag(int32 tagMask, string format, boolean create); Retornara cert si va be, en cas contrari, el missatge d'error estara disponible utilitzant <>. Establir els numeros de peca subseguents en els fitxers seleccionats numberTracks(int32 tagMask, int32 NumPrimeraPeca); Filtratge de fitxers filter(string expressio); Convertir entre les etiquetes ID3 versio 2.3 i 2.4 convertToId3v24(void); Convertir entre les etiquetes ID3 versio 2.4 i 2.3 convertToId3v23(void); Retornara cert si va be. Obtenir el cami de la carpeta string getDirectoryName(void); Retornara el cami absolut de la carpeta. Obtenir el nom del fitxer actual string getFileName(void); Retornara el nom de fitxer absolut veritable, finalitzara amb <> si es una carpeta. Establir el nom del fitxer seleccionat setFileName(string nom); El fitxer sera reanomenat quan es desi la carpeta. Establir el format que s'utilitzara en establir el nom del fitxer a partir de les etiquetes setFileNameFormat(string format); Establir els noms de fitxer a partir dels fitxers seleccionats des de les etiquetes setFileNameFromTag(int32 tagMask); Obtenir el valor del marc string getFrame(int32 tagMask, string nom); Per a obtenir les dades binaries com una imatge, es podra afegir el nom d'un fitxer per a escriure despres del nom, p. ex., <>. De la mateixa manera, es pot exportar una lletra sincronitzada, p. ex., <>. Retornara el valor del marc. Establir el valor del marc boolean setFrame(int32 tagMask, string nom, string valor); Per a l'etiqueta 2 (tagMask 2), si no hi ha un marc amb nom, s'afegira un marc nou, si el valor esta buit, el marc se suprimira. Per a afegir dades binaries com una imatge, es pot afegir un fitxer despres del nom, p. ex., es pot fer servir <>. "SYLT:/cami/a/fitxer" per a importar la lletra sincronitzada. Retornara cert si va be. Obtenir tots els marcs d'una etiqueta array of string getTag(int32 tagMask); Retornara una llista amb els noms i valors dels marcs de forma alterna. Obtenir la informacio tecnica sobre el fitxer array of string getInformation(void); Les propietats son Format, Velocitat de bits, Velocitat de mostreig, Canals, Durada, Mode del canal, VBR, Etiqueta 1, Etiqueta 2. S'ometran les propietats que no estiguin disponibles. Retornara una llista amb els noms i valors de les propietats de forma alterna. Establir l'etiqueta a partir del nom de fitxer setTagFromFileName(int32 tagMask); Establir l'etiqueta a partir d'una altra etiqueta setTagFromOtherTag(int32 tagMask); Copiar una etiqueta copyTag(int32 tagMask); Enganxar una etiqueta pasteTag(int32 tagMask); Eliminar una etiqueta removeTag(int32 tagMask); Tornar a analitzar la configuracio reparseConfiguration(void); Es possible fer canvis automatitzats de la configuracio modificant el fitxer de configuracio i despres tornant a analitzar la configuracio. Reproduir els fitxers seleccionats playAudio(void); INTERFICIE QML Exemples en QML Els scripts QML es poden invocar a traves del menu contextual de la llista de fitxers i es poden configurar a la pestanya Accions de l'usuari del dialeg de configuracio. Els scripts que s'estableixen alla es poden emprar com a exemples per a programar scripts personalitzats. El QML fa servir JavaScript, aqui teniu l'obligatori <>: import Kid3 1.0 Kid3Script { onRun: { console.log("Hola mon, la carpeta es", app.dirName) Qt.quit() } } Si aquest script es desa com /cami/a/Exemple.qml, l'ordre d'usuari es pot definir com a @qml /cami/a/Exemple.qml amb el nom Prova de QML i Sortida marcades. Despres es podra iniciar emprant l'element Prova de QML al menu contextual de la llista de fitxers, i la sortida sera visible a la finestra. Malauradament, iniciar els scripts en QML emprant qml (p. ex., qml -apptype widget -I /usr/lib/kid3/plugins/imports /cami/a/Exemple.qml) esta trencat en les versions recents de les Qt. Pero el kid3-cli ofereix una forma alternativa d'executar un script en QML des de la linia d'ordres utilitzant la seva ordre execute. kid3-cli -c "execute @qml /cami/a/Exemple.qml" Per a llistar els titols a les etiquetes 2 de tots els fitxers en la carpeta actual, es podria emprar el seguent script: import Kid3 1.0 Kid3Script { onRun: { app.firstFile() do { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { console.log(app.getFrame(tagv2, "title")) } } while (app.nextFile()) } } Si la carpeta conte molts fitxers, aquest script podria bloquejar la interficie d'usuari durant algun temps. Per a operacions mes llargues, aquest hauria de disposar d'un descans de tant en tant. La seguent implementacio alternativa te la feina per a un sol fitxer mogut a una funcio. Aquesta funcio s'invoca amb un temps d'espera d'1 ms al final, ates que s'han de processar mes fitxers. Aixo assegurara que la IGU segueixi responent mentre s'executa l'script. import Kid3 1.0 Kid3Script { onRun: { function doWork() { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { console.log(app.getFrame(tagv2, "title")) } if (!app.nextFile()) { Qt.quit() } else { setTimeout(doWork, 1) } } app.firstFile() doWork() } } En emprar app.firstFile() amb app.nextFile(), es processaran tots els fitxers de la carpeta actual. Si nomes es veuen afectats els fitxers seleccionats, utilitzeu firstFile() i NextFile() en el seu lloc, aquestes son funcions convenients del component Kid3Script. El seguent exemple es un script que nomes copia els marcs de numero del disc i drets d'autor del fitxer seleccionat. import Kid3 1.1 Kid3Script { onRun: { function doWork() { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { app.setFrame(tagv2, "*.selected", false) app.setFrame(tagv2, "discnumber.selected", true) app.setFrame(tagv2, "copyright.selected", true) app.copyTags(tagv2) } if (!nextFile()) { Qt.quit() } else { setTimeout(doWork, 1) } } firstFile() doWork() } } Amb el Kid3 venen mes scripts d'exemple i ja estan registrats com a ordres d'usuari. o ReplayGain to SoundCheck (ReplayGain2SoundCheck.qml): crea la informacio de comprovacio del so d'iTunNORM a partir dels marcs de guany de la reproduccio. o Redimensiona la caratula (ResizeAlbumArt.qml): canvia la mida de les imatges incrustades de caratula que tinguin mes de 500x500 pixels. o Extreu la caratula (ExtractAlbumArt.qml): extreu totes les imatges incrustades de caratula evitant duplicats. o Caratula incrustada (EmbedAlbumArt.qml): incrusta la caratula que es troba en els fitxers d'imatge als fitxers d'audio, tot a la mateixa carpeta. o Lletra incrustada (EmbedLyrics.qml): obte la lletra no sincronitzada des del servei web. o Codifica el text ID3 versio 1 (ShowTextEncodingV1.qml): ajuda a trobar la codificacio de les etiquetes ID3 versio 1 mostrant les etiquetes del fitxer actual en totes les codificacions de caracters disponibles. o ID3 versio 1 a ASCII (Tag1ToAscii.qml): translitera a ASCII els caracters llatins estesos a l'etiqueta ID3 versio 1. o Posa en majuscules el titol en angles (ExportCsv.qml): dona format en majuscules al text de les etiquetes en angles. o Reescriu les etiquetes (RewriteTags.qml): reescriu totes les etiquetes en els fitxers seleccionats. o Exporta CSV (ExportCsv.qml): exporta recursivament totes les etiquetes de tots els fitxers a un fitxer CSV. o Importa CSV (ImportCsv.qml): importa recursivament totes les etiquetes de tots els fitxers des d'un fitxer CSV. o Exporta JSON (ExportJson.qml): exporta recursivament totes les etiquetes de tots els fitxers a un fitxer JSON. o Importa JSON (ImportJson.qml): importa recursivament totes les etiquetes de tots els fitxers des d'un fitxer JSON. o Exporta a una carpeta de llista de reproduccio (ExportPlaylist.qml): copia tots els fitxers d'una llista de reproduccio en una carpeta i en canvia el nom segons la seva posicio. o Consola QML (QmlConsole.qml): consola senzilla per a jugar amb l'API de QML del Kid3. API de QML L'API es pot explorar amb facilitat utilitzant la consola QML, la qual esta disponible com un script d'exemple amb una interficie d'usuari. Kid3Script El Kid3Script es un component QML regular ubicat a dins de la carpeta del connector. Tambe podria emprar un altre connector QML. L'us del Kid3Script facilita l'inici de la funcio de script utilitzant el controlador del senyal onRun. A mes ofereix algunes funcions: onRun: controlador del senyal que s'invoca quan s'inicia l'script tagv1, tagv2, tagv2v1: constants per als parametres d'etiqueta script: acces a les funcions per a la creacio de scripts configs: acces als objectes de la configuracio getArguments(): llista d'arguments de l'script isStandalone(): cert si l'script no es va iniciar des del Kid3 setTimeout (crida de retorn, retard): inicia la crida de retorn despres del retard en ms firstFile(): al primer fitxer seleccionat NextFile(): al seguent fitxer seleccionat Funcions de creacio de scripts Com al JavaScript, el QML tambe te nomes un conjunt limitat de funcions per a la creacio de scripts, l'objecte script te alguns metodes addicionals, per exemple: script.properties(obj): cadena amb les propietats de les Qt script.writeFile(filePath, dades): escriu les dades al fitxer, cert si va be script.readFile(filePath): llegeix les dades del fitxer script.removeFile(filePath): elimina un fitxer, cert si va be script.fileExists(filePath): cert si el fitxer existeix script.fileIsWritable(filePath): cert si el fitxer es d'escriptura script.getFilePermissions(filePath): obte els bits per al mode de permis del fitxer script.setFilePermissions(filePath, modeBits): estableix els bits per al mode de permis del fitxer script.classifyFile(filePath): obte la classe de fitxer (carpeta <>, enllac simbolic <<@>>, executable <<*>>, fitxer <<>>) script.renameFile(oldname, NEWNAME): canvia el nom del fitxer, cert si va be script.copyFile(font, dest): copia un fitxer, cert si va be script.makeDir(cami): crea una carpeta, cert si va be script.removeDir(cami): elimina una carpeta, cert si va be script.tempPath(): cami de la carpeta temporal script.musicPath(): cami de la carpeta de musica script.listDir(cami, [nameFilters], [classify]): llista les entrades de la carpeta script.system(programa, [args], [msecs]): inicia de mode sincronic una ordre del sistema, [codi de sortida, sortida estandard, error estandard] si no es temps d'espera script.systemAsync(programa, [args], [callback]): inicia una ordre del sistema en el mode asincron, la crida de retorn es cridara amb [codi de sortida, sortida estandard, error estandard] script.getEnv(varname): obte el valor de la variable d'entorn script.setEnv(varname, valor): estableix el valor a partir de la variable d'entorn script.getQtVersion(): cadena de versio de les Qt, p. ex., <<5.4.1>> script.getDataMd5(dades): obte una cadena hexadecimal per a la suma MD5 de les dades script.getDataSize(data): obte la mida de la matriu de bytes script.dataToImage(dades, [format]): crea una imatge a partir dels bytes de les dades script.dataFromImage(imatge, [format]): obte els bytes de les dades de la imatge script.loadImage(filePath): carrega una imatge des d'un fitxer script.saveImage(imatge, filePath, [format]): desa una imatge en un fitxer, cert si va be script.imageProperties(imatge): obte les propietats d'una imatge, un mapa que contindra <>, <>, <> i <>, buit si la imatge no es valida script.scaleImage(imatge, amplada, [alt]): escala una imatge, retornara una imatge escalada Context de l'aplicacio Emprant QML, es pot accedir a una gran part de les funcions del Kid3. L'API es similar a la utilitzada per al D-Bus. Per a mes detalls, consulteu les respectives notes. app.openDirectory(cami): obre la carpeta app.unloadAllTags(): descarrega totes les etiquetes app.saveDirectory(): desa la carpeta app.revertFileModifications(): reverteix app.importTags(etiqueta, cami, fmtIdx): importa el fitxer app.importFromTags(etiqueta, font, extraccio): importa des de les etiquetes app.importFromTagsToSelection(etiqueta, font, extraccio): importa des de les etiquetes dels fitxers seleccionats app.downloadImage(url, allFilesInDir): descarrega la imatge app.exportTags(etiqueta, cami, fmtIdx): fitxer d'exportacio app.writePlaylist(): escriu una llista de reproduccio app.getPlaylistItems(cami): obte els elements d'una llista de reproduccio app.setPlaylistItems(cami, elements): estableix els elements d'una llista de reproduccio app.selectAllFiles(): ho selecciona tot app.deselectAllFiles(): desselecciona app.firstFile([select], [onlyTaggedFiles]): al primer fitxer app.nextFile([select], [onlyTaggedFiles]): al seguent fitxer app.previousFile([select], [onlyTaggedFiles]): al fitxer anterior app.selectCurrentFile([select]): selecciona el fitxer actual app.selectFile(cami, [select]): selecciona un fitxer especific app.getSelectedFilePaths([onlyTaggedFiles]): obte els camins dels fitxers seleccionats app.requestExpandFileList(): ho expandeix tot app.applyFilenameFormat(): aplica el format al nom del fitxer app.applyTagFormat(): aplicar el format a l'etiqueta app.applyTextEncoding(): aplica la codificacio del text app.numberTracks(num., total, etiqueta, [options]): numeros de peca app.applyFilter(expr): filtre app.convertToId3v23(): converteix ID3 versio 2.4.0 a 2.3.0 app.convertToId3v24(): converteix ID3 versio 2.3.0 a 2.4.0 app.getFilenameFromTags(etiqueta): nom de fitxer a partir de les etiquetes app.getTagsFromFilename(etiqueta): nom de fitxer a les etiquetes app.getAllFrames(etiqueta): obte un objecte amb tots els marcs app.getFrame(etiqueta, nom): obte un marc app.setFrame(etiqueta, nom, valor): estableix un marc app.getPictureData(): obte les dades a partir del marc de la imatge app.setPictureData(dades): estableix les dades al marc de la imatge app.copyToOtherTag(etiqueta): etiquetes a altres etiquetes app.copyTags(etiqueta): copia app.pasteTags(etiqueta): enganxa app.removeTags(etiqueta): elimina app.playAudio(): reprodueix app.readConfig(): llegeix la configuracio app.applyChangedConfiguration(): aplica la configuracio app.dirName: nom de la carpeta app.selectionInfo.fileName: nom del fitxer app.selectionInfo.filePath: cami absolut cap al fitxer app.selectionInfo.detailInfo: detalls del format app.selectionInfo.tag(Frame.Tag_1).tagFormat: format de l'etiqueta 1 app.selectionInfo.tag(Frame.Tag_2).tagFormat: format de l'etiqueta 2 app.selectionInfo.formatString(etiqueta, format): substitueix els codis en una cadena de format app.selectFileName(subtitol, carpeta, filtre, desa el fitxer): obre el dialeg de fitxers i en selecciona un app.selectDirName(titol, carpeta): obre el dialeg de fitxers per a seleccionar una carpeta Per a operacions asincrones, les crides de retorn podran connectar-se amb els senyals. function automaticImport(profile) { function onAutomaticImportFinished() { app.batchImporter.finished.disconnect(onAutomaticImportFinished) } app.batchImporter.finished.connect(onAutomaticImportFinished) app.batchImport(profile, tagv2) } function renameDirectory(format) { function onRenameActionsScheduled() { app.renameActionsScheduled.disconnect(onRenameActionsScheduled) app.performRenameActions() } app.renameActionsScheduled.connect(onRenameActionsScheduled) app.renameDirectory(tagv2v1, format, false) } Configuracio dels objectes Es pot accedir a les diferents seccions de configuracio a traves de metodes de configs. Les seves propietats es poden llistar a la consola QML. script.properties(configs.networkConfig()) Es poden establir les propietats: 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() AUTORS Fleisch, Urs Desenvolupament de programari Antoni Bella Traductor DRET DE REPRODUCCIO Dret de reproduccio (C) 2024 Urs Fleisch FDL NOTES 1. gnudb.org http://gnudb.org 2. MusicBrainz http://musicbrainz.org 3. Discogs http://discogs.com 4. Amazon http://www.amazon.com 5. especificacio ID3 http://id3.org/id3v2.4.0-frames 6. editor SYLT http://www.compuphase.com/software_sylteditor.htm 7. www.gnudb.org http://www.gnudb.org 8. Discogs https://www.discogs.com/ 9. freedb.org http://freedb.org 10. Etiqueta ID3 versio 2.3.0 http://id3.org/id3v2.3.0 11. Etiqueta ID3 versio 2.4.0: estructura principal http://id3.org/id3v2.4.0-structure 12. LyricWiki http://www.lyricwiki.org 13. Google http://www.google.com 14. id3lib http://id3lib.sourceforge.net 15. libogg http://xiph.org/ogg/ 16. libvorbis i libvorbisfile http://xiph.org/vorbis/ 17. libFLAC++ i libFLAC http://flac.sourceforge.net 18. TagLib http://taglib.github.io/ 19. mp4v2 https://mp4v2.org/ 20. Chromaprint http://acoustid.org/chromaprint 21. libav http://libav.org/ 22. FDL http://www.gnu.org/licenses/licenses.html#FDL 23. GPL http://www.gnu.org/licenses/licenses.html#GPL 24. Qt(TM) https://www.qt.io 25. KDE http://www.kde.org 3.9.5 24 de febrer de 2024 KID3(1)