'\" t .\" Title: kid3 .\" Author: Fleisch, Urs .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 9 de juliol de 2023 .\" Manual: El manual del Kid3 .\" Source: 3.9.4 .\" Language: Catalan .\" .TH "KID3" "1" "9 de juliol de 2023" "3.9.4" "El manual del Kid3" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NOM" kid3, kid3-qt, kid3-cli \- Kid3 ID3 Tagger .SH "SINOPSI" .HP \w'\fBkid3\fR\ 'u \fBkid3\fR [\fB\-\-help\fR | \fB\-\-author\fR | \fB\-\-version\fR | \fB\-\-license\fR | \fB\-\-desktopfile\ \fR\fBFITXER\fR] [\fIFITXER\fR...] .HP \w'\fBkid3\-qt\fR\ 'u \fBkid3\-qt\fR [\fB\-\-portable\fR] [\fBOpcions\ de\ les\ Qt\fR] [\fIFITXER\fR...] .HP \w'\fBkid3\-cli\fR\ 'u \fBkid3\-cli\fR [\fB\-\-portable\fR] [\fB\-\-dbus\fR] [\fB\-h\fR | \fB\-\-help\fR] [\fB\-c\ ORDRE_1\fR] [\fB\-c\ ORDRE_2\fR...] [\fIFITXER\fR...] .SH "OPCIONS" .PP \fB\-\-portable\fR .RS 4 Emmagatzema la configuraci\('o al fitxer kid3\&.ini a dins de la carpeta de l\*(Aqaplicaci\('o\&. .RE .PP \fIFITXER\fR .RS 4 Si \fIFITXER\fR \('es el cam\('i a una carpeta, s\*(Aqobrir\(`a\&. Si es proporcionen un o m\('es camins de fitxer, s\*(Aqobrir\(`a la seva carpeta comuna i se seleccionaran els fitxers\&. .RE .SS "kid3" .PP \fB\-\-help\fR .RS 4 Mostra ajuda quant a les opcions\&. .RE .PP \fB\-\-author\fR .RS 4 Mostra informaci\('o sobre l\*(Aqautor\&. .RE .PP \fB\-\-version\fR .RS 4 Mostra informaci\('o sobre la versi\('o\&. .RE .PP \fB\-\-license\fR .RS 4 Mostra informaci\('o sobre la llic\(`encia\&. .RE .PP \fB\-\-desktopfile \fR\fBFITXER\fR .RS 4 El nom del fitxer base de l\*(Aqentrada de l\*(Aqescriptori per a aquesta aplicaci\('o\&. .RE .SS "kid3\-qt" .PP \fBOpcions de les Qt\fR .RS 4 Vegeu \fBqt5options\fR(7)\&. .RE .SS "kid3\-cli" .PP \fB\-\-dbus\fR .RS 4 Activa la interf\('icie de D\-Bus\&. .RE .PP \fB\-c\fR .RS 4 Executa una ordre\&. S\('on possibles m\('ultiples opcions \fB\-c\fR, s\*(Aqexecutaran en seq\(:u\(`encia\&. Vegeu la secci\('o sobre el kid3\-cli per a una descripci\('o de les ordres disponibles\&. .RE .PP \fB\-h\fR|\fB\-\-help\fR .RS 4 Mostra ajuda quant a les opcions i ordres\&. .RE .SH "INTRODUCCI\('O" .PP El Kid3 \('es una aplicaci\('o per editar les etiquetes ID3 versi\('o 1 i 2 en els fitxers MP3 de manera eficient\&. La majoria dels reproductors de MP3 poden editar aquestes etiquetes, per\(`o no d\*(Aquna manera molt c\(`omoda i eficient\&. A m\('es, tamb\('e s\*(Aqadmeten les etiquetes als fitxers Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els m\(`oduls del seguidor de peces (MOD, S3M, IT i XM)\&. .PP El Kid3 no enregistra ni codifica els fitxers MP3, per\(`o est\(`a dirigit a editar les etiquetes ID3 de tots els fitxers d\*(Aqun \(`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 versi\('o 1 o 2, el Kid3 t\('e un control total sobre ambdues versions, pot convertir les etiquetes entre els dos formats i t\('e acc\('es a totes les etiquetes ID3 versi\('o 2\&. Es poden establir les etiquetes de m\('ultiples fitxers amb el mateix valor, p\&. ex\&., l\*(Aqartista, \(`album, any i g\(`enere de tots els fitxers d\*(Aqun \(`album que generalment tenen els mateixos valors i es poden configurar junts\&. Si la informaci\('o de les etiquetes est\(`a continguda en el nom del fitxer, les etiquetes es podran establir autom\(`aticament a partir del nom del fitxer\&. Tamb\('e \('es possible establir el nom del fitxer a partir de les etiquetes trobades en el fitxer en formats arbitraris\&. .PP La tasca d\*(Aqedici\('o se sost\('e addicionalment amb la substituci\('o autom\(`atica de car\(`acters o subcadenes, per exemple, per eliminar car\(`acters il\(mdlegals dels noms de fitxer\&. El control autom\(`atic de maj\('uscules i min\('uscules facilita l\*(Aq\('us d\*(Aqun esquema de noms coherent en totes les etiquetes\&. .PP La informaci\('o de l\*(Aqetiqueta per a \(`albums sencers es pot obtenir des de \m[blue]\fBgnudb\&.org\fR\m[]\&\s-2\u[1]\d\s+2, \m[blue]\fBMusicBrainz\fR\m[]\&\s-2\u[2]\d\s+2, \m[blue]\fBDiscogs\fR\m[]\&\s-2\u[3]\d\s+2, \m[blue]\fBAmazon\fR\m[]\&\s-2\u[4]\d\s+2 o altres fonts de llistes de peces\&. El format d\*(Aqimportaci\('o \('es lliurement configurable amb expressions regulars\&. .PP Podreu informar de qualsevol problema o petici\('o de caracter\('istica a l\*(Aqautor\&. .SH "USAR EL KID3" .SS "Caracter\('istiques del Kid3" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Edita les etiquetes ID3 versi\('o 1 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Edita tots els marcs ID3 versi\('o 2\&.3 i 2\&.4 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Edita les etiquetes de m\('ultiples fitxers .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Converteix entre les etiquetes ID3 versi\('o 1 i 2 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Edita les etiquetes dels MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV i AIFF .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Genera les etiquetes a partir del nom del fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Genera les etiquetes a partir del contingut als camps d\*(Aqetiqueta .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Genera els noms de fitxer a partir de les etiquetes .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Genera i canvia els noms de les carpetes a partir de les etiquetes .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Genera un fitxer de llista de reproducci\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Conversi\('o autom\(`atica entre maj\('uscules i min\('uscules, i traducci\('o de les cadenes .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Importa des de \m[blue]\fBgnudb\&.org\fR\m[]\&\s-2\u[1]\d\s+2, \m[blue]\fBMusicBrainz\fR\m[]\&\s-2\u[2]\d\s+2, \m[blue]\fBDiscogs\fR\m[]\&\s-2\u[3]\d\s+2, \m[blue]\fBAmazon\fR\m[]\&\s-2\u[4]\d\s+2 i altres fonts de dades .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Exporta com a CSV, HTML, llista de reproducci\('o, XML del Kover i altres formats\&. Els fitxers CSV exportats es podran importar de nou\&. .RE .SS "Exemple d\*(Aq\('us" .PP Aquesta secci\('o descriu una sessi\('o t\('ipica amb el Kid3\&. Suposem que tenim una carpeta que cont\('e fitxers MP3 amb les peces de l\*(Aq\(`album \(FoI si canto trist\(Fc del cantautor \(FoLlu\('is Llach\(Fc\&. La carpeta s\*(Aqanomena en el format \(Foartista \- \(`album\(Fc, en el nostre cas \(FoLlu\('is Llach \- I si canto trist\(Fc\&. La carpeta cont\('e les peces en el format \(Fot\('itol de la pe\(,ca\&.mp3\(Fc, el qual crec que \('es \('util perqu\(`e els noms dels fitxers s\('on curts (important quan s\*(Aqempren reproductors de MP3 m\(`obils amb pantalles petites) i en l\*(Aqordre correcte quan s\*(Aqordenen alfab\(`eticament (important quan es fa servir maquinari reproductor de MP3 que reprodueixen les peces en ordre alfab\(`etic o en l\*(Aqordre en qu\(`e es graven en el CD i aquest ordre \('es alfab\(`etic quan s\*(Aqutilitza el \fBmkisofs\fR)\&. A m\('es d\*(Aqaix\(`o, la informaci\('o de l\*(Aqartista i de l\*(Aq\(`album ja es troba al nom de la carpeta i no s\*(Aqha de repetir en el nom del fitxer\&. Per\(`o tornant al nostre exemple, el llistat de la carpeta es veur\(`a aix\('i: .PP 01 El jorn dels miserables\&.mp3 .PP 02 Can\(,c\('o a Mahalta\&.mp3 .PP 03 Vaixell de Gr\(`ecia\&.mp3 .PP Aquests fitxers encara no tenen etiquetes i volem generar\-les utilitzant el Kid3\&. Emprem l\*(Aqelement de men\('u Fitxer → Obre\&.\&.\&. (o el bot\('o a la barra d\*(Aqeines) i seleccionem un dels fitxers en aquesta carpeta\&. Tots els fitxers es mostraran en el quadre de llista de fitxers\&. Mandrosos com som, volem fer servir la informaci\('o a la carpeta i els noms de fitxer per a generar les etiquetes\&. Per tant, seleccionarem tots els fitxers, despr\('es farem clic al bot\('o A: Etiqueta 1 a la secci\('o Fitxer\&. Aix\(`o establir\(`a els valors de t\('itol, artista, \(`album i pe\(,ca en tots els fitxers\&. Per establir els valors d\*(Aqany i g\(`enere de tots els fitxers, mantindrem seleccionats tots els fitxers i escriurem \(Fo2002\(Fc per a la Data i seleccionem Cantautor des del quadre combinat G\(`enere\&. Per establir nom\('es aquests dos valors, les seves caselles de selecci\('o es marcaran autom\(`aticament i totes les altres caselles es deixaran sense marcar\&. Ara canviarem la selecci\('o seleccionant nom\('es el primer fitxer i veurem que totes les etiquetes contenen els valors correctes\&. Les etiquetes dels altres fitxers tamb\('e es poden verificar seleccionant\-los un per un\&. Quan estiguem satisfets amb les etiquetes, emprem l\*(Aqelement de men\('u Fitxer → Desa (o el bot\('o a la barra d\*(Aqeines)\&. En seleccionar l\*(Aqelement de men\('u Fitxer → Crea una llista de reproducci\('o\&.\&.\&. (o el bot\('o a la barra d\*(Aqeines) es generar\(`a un fitxer \(FoLlu\('is Llach \- I si canto trist\&.m3u\(Fc a la carpeta\&. .SH "REFER\(`ENCIA D\*(AQORDRES" .SS "Els elements de la IGU" .PP La IGU del Kid3 est\(`a separada en sis seccions: a l\*(Aqesquerra hi ha els quadres de llista de fitxers i carpetes, el costat dret cont\('e les seccions Fitxer, Etiqueta 1, Etiqueta 2 i Etiqueta 3\&. .PP Per a navegar entre les diferents seccions emprant el teclat, s\*(Aqadmeten diverses dreceres de teclat\&. A les seccions d\*(Aqetiquetes, les dreceres estaran actives mentre no s\*(Aqedita text o quan s\*(Aqest\(`a a la primera columna\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Alt+Fletxa esquerra: Va a la selecci\('o anterior (Ordre+] en el macOS\(rg) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Alt+Fletxa dreta: Va a la seg\(:uent selecci\('o (Ordre+] en el macOS\(rg) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ctrl+Maj+V: Des d\*(Aquna altra etiqueta .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ctrl+C: Copia .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ctrl+V: Enganxa .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Maj+Supr: Elimina .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} F2: Edita .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Inser: Afegeix .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Supr: Suprimeix .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBLlista de fitxers\fR .RS 4 .PP La llista de fitxers cont\('e 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 m\('ultiples fitxers\&. Per no seleccionar cap fitxer, feu clic a l\*(Aq\(`area buida despr\('es de les entrades del quadre de llista\&. La selecci\('o determinar\(`a els fitxers afectats per les operacions que hi hagi disponibles mitjan\(,cant l\*(Aq\('us dels botons que es descriuen a continuaci\('o\&. .PP A m\('es del Nom, tamb\('e es poden mostrar altres columnes de Mida, Tipus i Data de modificaci\('o amb els detalls del fitxer\&. Les columnes es poden ocultar desmarcant el seu nom al men\('u contextual de la cap\(,calera\&. L\*(Aqordre de les columnes es pot canviar arrossegant i deixant anar\&. L\*(Aqordre de classificaci\('o es pot alternar fent clic sobre la cap\(,calera de la columna\&. .PP Els valors de les etiquetes est\(`andard tamb\('e es poden mostrar i editar en columnes de la llista de fitxers\&. .PP A l\*(Aqesquerra dels noms es pot mostrar una icona: un disc per mostrar que el fitxer ha estat modificat o la informaci\('o sobre quines etiquetes hi ha presents (V1, V2, V1V2 o SENSE ETIQUETA, no es mostrar\(`a cap icona si encara no s\*(Aqha llegit el fitxer)\&. .PP Les carpetes es mostren amb una icona de carpeta\&. Si s\*(Aqobre una carpeta, els fitxers es mostraran en un arbre jer\(`arquic\&. En seleccionar fitxers des de subcarpetes, les operacions es podran executar sobre els fitxers en carpetes diferents, el qual \('es \('util si la col\(mdlecci\('o de m\('usica est\(`a organitzada amb una carpeta per a cada artista que cont\('e les carpetes per als \(`albums d\*(Aqaquest artista\&. .PP En fer clic amb el bot\('o dret del ratol\('i dins de la llista de fitxers, s\*(Aqobrir\(`a un men\('u contextual amb les seg\(:uents ordres: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Expandeix\-ho tot: expandeix tots els arbres de carpetes (nom\('es l\*(Aqarbre actual si es prem la tecla Maj) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Redueix\-ho tot: contrau tots els arbres de carpetes .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Reanomena: canvia el nom d\*(Aqun fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Mou a la paperera: mou un fitxer a la paperera .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Reprodueix: reprodueix un fitxer, vegeu Reproduir\&. Si el fitxer seleccionat \('es una llista de reproducci\('o, es reproduiran els fitxers de la llista de reproducci\('o\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Edita: edita una llista de reproducci\('o, vegeu Editar una llista de reproducci\('o\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Les entrades posteriors s\('on ordres d\*(Aqusuari, les quals es poden definir a la pestanya Accions de l\*(Aqusuari de Configura el Kid3\&. La reproducci\('o amb doble clic tamb\('e es pot activar all\(`a\&. .sp Quan s\*(Aqactiva Selecciona el fitxer en reproducci\('o, la pe\(,ca actual en reproducci\('o se selecciona autom\(`aticament en la llista de fitxers\&. .RE .sp .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEditar una llista de reproducci\('o\fR .RS 4 .PP Es pot crear una llista de reproducci\('o buida o que contingui les peces d\*(Aquna carpeta, vegeu Crear una llista de reproducci\('o\&. El fitxer de la llista de reproducci\('o ser\(`a creat de tal manera que es podr\(`a editar fent\-hi doble clic o emprant l\*(Aqelement Edita des del men\('u contextual de la llista de fitxers\&. Es mostrar\(`a un di\(`aleg amb les entrades de la llista de reproducci\('o\&. \('Es possible obrir m\('ultiples llistes de reproducci\('o simult\(`aniament\&. .PP Es poden afegir entrades noves arrossegant i deixant anar des de la llista de fitxers, un gestor de fitxers o una altra llista de reproducci\('o\&. Si s\*(Aqarrossega una entrada des d\*(Aquna altra llista de reproducci\('o, es mour\(`a o copiar\(`a segons el sistema\&. Per invocar l\*(Aqaltra operaci\('o, respectivament, s\*(Aqhaur\(`a de pr\('emer la tecla Maj, Ctrl o Alt (per a copiar en lloc de moure al macOS\(rg)\&. Tamb\('e \('es possible tornar a ordenar les entrades dins de la llista de reproducci\('o 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\(rg, s\*(Aqha de pr\('emer Ordre en lloc de Ctrl)\&. Es pot eliminar una entrada amb la tecla Supr\&. .PP Tingueu en compte el seg\(:uent: per arrossegar les entrades de la llista de fitxers, s\*(Aqhan de mantenir al costat esquerre (a prop de les icones), el mateix gest en el costat dret realitzar\(`a una selecci\('o m\('ultiple, de manera que aquesta acci\('o encara ser\(`a possible\&. .PP Quan s\*(Aqha modificat una llista de reproducci\('o, els canvis es podran emmagatzemar utilitzant Desa o descartar\-los utilitzant Cancel\(mdla\&. Quan es tanca la finestra, es mostrar\(`a un missatge de confirmaci\('o si hi ha canvis sense desar\&. .PP Les peces seleccionades en una llista de reproducci\('o se seleccionaran autom\(`aticament a la llista de fitxers, el qual permetr\(`a editar les etiquetes\&. .PP Per executar accions en una llista de reproducci\('o, s\*(Aqhaur\(`a de seleccionar el seu fitxer a la llista de fitxers\&. L\*(Aqentrada Edita des del men\('u contextual portar\(`a el di\(`aleg descrit en aquesta secci\('o, i Reprodueix iniciar\(`a el reproductor multim\(`edia amb les peces de la llista de reproducci\('o\&. Les accions de l\*(Aqusuari poden actuar sobre les llistes de reproducci\('o, per exemple, Exporta la llista de reproducci\('o a una carpeta copiar\(`a els fitxers d\*(Aquna llista de reproducci\('o a dins d\*(Aquna carpeta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBLlista de carpetes\fR .RS 4 .PP La llista de carpetes cont\('e els noms de les carpetes que hi ha a la carpeta oberta, aix\('i com la carpeta actual (\&.) i la carpeta pare (\&.\&.)\&. Permet canviar r\(`apidament de carpeta sense emprar l\*(Aqordre Obre\&.\&.\&. o l\*(Aqacci\('o d\*(Aqarrossegar i deixar anar\&. .PP La visibilitat, l\*(Aqordre i la classificaci\('o de la columna es poden configurar com es descriu a la secci\('o sobre la llista de fitxers\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBFitxer\fR .RS 4 .PP Mostra informaci\('o sobre la codificaci\('o (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV i AIFF), velocitat de bits, freq\(:u\(`encia de mostreig, canals i la longitud del fitxer\&. .PP La l\('inia d\*(Aqedici\('o Nom: cont\('e el nom del fitxer (si nom\('es se selecciona un fitxer)\&. Si es canvia aquest nom, el fitxer canviar\(`a de nom quan es faci servir l\*(Aqordre Desa\&. .PP El quadre combinat Format: i la l\('inia d\*(Aqedici\('o cont\('e el format que s\*(Aqutilitzar\(`a quan es generi el nom del fitxer a partir de la primera o la segona etiqueta\&. El nom del fitxer podr\(`a contenir car\(`acters arbitraris, fins i tot una part de la carpeta separada del nom del fitxer per una barra diagonal, per\(`o aquesta carpeta ja haur\(`a d\*(Aqexistir perqu\(`e el canvi de nom tingui \(`exit\&. S\*(Aqempren els seg\(:uents codis especials per inserir valors d\*(Aqetiqueta en el nom del fitxer: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca (p\&. ex\&., 01) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track\&.n} Pe\(,ca amb l\*(Aqamplada del camp \(Fon\(Fc (p\&. ex\&., 001 per a %{track\&.3}) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %T %{tracknumber} Pe\(,ca (sense zeros a l\*(Aqesquerra, p\&. ex\&., 1) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{ignore} Ignorada en generar les etiquetes a partir del nom del fitxer .RE .PP 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 \fB%{albumartist}\fR, \fB%{discnumber\&.1}\fR, \fB%{bpm}\fR o noms espec\('ifics de format com \fB%{popm}\fR\&. .PP \('Es possible anteposar i annexar cadenes a la substituci\('o d\*(Aqun codi de format afegint entre cometes dobles dins de les claus d\*(Aqun codi de format\&. Aquestes cadenes nom\('es es col\(mdlocaran 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 t\('itol i el subt\('itol, es podria utilitzar \fB%{title} [%{subtitle}]\fR a la cadena de format\&. Per\(`o aix\(`o donaria com a resultat una cadena que acaba amb [] si no hi ha un marc de subt\('itols per a un fitxer\&. Per ometre els claud\(`ators si no hi ha subt\('itols, en el seu lloc s\*(Aqutilitzar\(`a \fB%{title}%{"["subtitle"]"}\fR\&. Aix\(`o ometr\(`a els claud\(`ators, l\*(Aqespai inicial i el subt\('itol si no existeix el subt\('itol\&. .PP La llista de formats disponibles es pot editar en el di\(`aleg que apareix en fer clic al bot\('o Nom del fitxer des de l\*(Aqetiqueta a la pestanya Fitxer del di\(`aleg de configuraci\('o\&. .PP S\*(Aqutilitza 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 patr\('o, s\*(Aqintentaran alguns altres formats d\*(Aq\('us habitual\&. .PP Alguns formats del nom de fitxer utilitzats habitualment ja estan disponibles al quadre combinat, per\(`o tamb\('e \('es possible escriure algun format especial a la l\('inia d\*(Aqedici\('o\&. .PP La llista de formats disponibles es pot editar en el di\(`aleg que apareix en fer clic al bot\('o Etiqueta des del nom de fitxer a la pestanya Fitxer del di\(`aleg de configuraci\('o\&. .PP De manera interna, es construeix una expressi\('o regular a partir dels codis de format\&. Si es requereixen expressions regulars avan\(,cades, el format per a generar les etiquetes a partir dels noms de fitxer es podr\(`a indicar tot com una expressi\('o regular amb captures precedides pels codis de format, p\&. ex\&., per extreure els n\('umeros de pe\(,ca sense eliminar els zeros a l\*(Aqesquerra, es podria emprar un format com \(Fo\fB/%{track}(\ed+) %{title}(\&.*)\fR\(Fc\&. .PP Des de: Etiqueta 1, Etiqueta 2: estableix el nom de fitxer utilitzant el format seleccionat i la primera o la segona etiqueta, respectivament\&. .PP A: Etiqueta 1, Etiqueta 2: les etiquetes s\*(Aqestableixen a partir del nom de fitxer\&. Primer, s\*(Aqutilitza el format especificat a Format:\&. Si el nom de fitxer existent no coincideix amb aquest format, s\*(Aqintentar\(`a amb els seg\(:uents formats: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Artista \- \(`Album/Pe\(,ca Can\(,c\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \(`Album/Pe\(,ca \- Artista \- Can\(,c\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} /Artista \- \(`Album \- Pe\(,ca \- Can\(,c\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \(`Album/Artista \- Pe\(,ca \- Can\(,c\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \(`Album/Artista \- Can\(,c\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Artista/\(`Album/Pe\(,ca Can\(,c\('o .RE .PP Si se selecciona un \('unic fitxer, els controls de la IGU s\*(Aqompliran amb els valors extrets del nom de fitxer\&. Si se seleccionen m\('ultiples fitxers, les etiquetes dels fitxers s\*(Aqestabliran directament d\*(Aqacord amb els noms dels fitxers\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEtiqueta 1\fR .RS 4 .PP Els ginys de l\('inia d\*(Aqedici\('o per al T\('itol, Artista, \(`Album, Comentari, Data, N\('umero de la pe\(,ca, G\(`enere i Codificador s\*(Aqutilitzen per editar el valor corresponent a la primera etiqueta dels fitxers seleccionats\&. El valor canviar\(`a quan es modifiqui la selecci\('o del fitxer o abans d\*(Aqoperacions com Desa i Surt i quan es marqui la casella de selecci\('o corresponent a l\*(Aqesquerra del nom de camp\&. Aix\(`o \('es \('util per a nom\('es canviar alguns valors i deixar els altres sense canviar\&. .PP Si se selecciona un \('unic fitxer, totes les caselles de selecci\('o estaran marcades i els ginys de l\('inia d\*(Aqedici\('o contindran els valors trobats a les etiquetes d\*(Aqaquest fitxer\&. Si no es troba una etiqueta al fitxer, es mostrar\(`a el valor buit corresponent, el qual ser\(`a una cadena buida per a les l\('inies d\*(Aqedici\('o del T\('itol, Artista, \(`Album i Comentari, 0 per a les l\('inies d\*(Aqedici\('o num\(`erica com la Data i N\('umero de pe\(,ca i un valor buit seleccionat per al quadre combinat G\(`enere\&. Els valors es poden canviar i si la casella de selecci\('o corresponent est\(`a marcada, s\*(Aqestabliran per al fitxer seleccionat despr\('es de canviar la selecci\('o\&. El fitxer ser\(`a marcat com a modificat amb un s\('imbol de disc en el quadre de llista de fitxers, per\(`o romandr\(`a sense canvis fins que s\*(Aqutilitzi l\*(Aqordre Desa\&. .PP Si se seleccionen m\('ultiples fitxers, nom\('es es mostraran els valors que s\('on id\(`entics en tots els fitxers seleccionats\&. En tots els altres controls, es mostraran els valors buits com s\*(Aqha descrit anteriorment\&. Totes les caselles de selecci\('o estaran desmarcades per evitar canvis no desitjats\&. Si s\*(Aqha d\*(Aqestablir un valor per a tots els fitxers seleccionats, es pot editar i s\*(Aqha de marcar la casella de selecci\('o\&. Els valors s\*(Aqestabliran per a tots els fitxers seleccionats quan es canvi\(:i la selecci\('o i es podran desar amb l\*(Aqordre Desa\&. .PP Les caselles de selecci\('o tamb\('e 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 m\('ultiples fitxers, on totes les caselles de selecci\('o no estaran marcades, aquestes ordres es comportaran de la mateixa manera que quan estan marcades o desmarcades totes les caselles de selecci\('o\&. .PP Des de l\*(Aqetiqueta 2: els camps de l\*(Aqetiqueta 1 s\*(Aqestableixen a partir dels valors corresponents a l\*(Aqetiqueta 2\&. Si se selecciona un \('unic fitxer, els controls de la IGU s\*(Aqompliran amb els valors de l\*(Aqetiqueta 2\&. Si se seleccionen m\('ultiples fitxers, les etiquetes dels fitxers s\*(Aqestabliran directament\&. .PP Copia: la mem\(`oria interm\(`edia de l\*(Aqordre Copia s\*(Aqomplir\(`a amb els valors de l\*(AqEtiqueta 1\&. Nom\('es s\*(Aqutilitzaran els valors amb la casella de selecci\('o marcada en les subseg\(:uents ordres Enganxa\&. .PP Enganxa: enganxar\(`a els valors des de la mem\(`oria interm\(`edia copiada a dins dels controls de la IGU\&. .PP Elimina: establir\(`a tots els controls de la IGU amb els seus valors buits, el qual resultar\(`a en l\*(Aqeliminaci\('o de tots els valors\&. El fitxer desat no contindr\(`a l\*(Aqetiqueta 1\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEtiqueta 2\fR .RS 4 .PP Els controls de la IGU funcionen de la mateixa manera com es descriu a la secci\('o Etiqueta 1, per\(`o la mida de les cadenes no est\(`a limitada\&. .PP Per al G\(`enere a l\*(Aqetiqueta 2, tamb\('e podreu utilitzar els vostres propis noms a m\('es dels g\(`eneres llistats en el quadre combinat, simplement escriviu el nom a la l\('inia d\*(Aqedici\('o\&. .PP L\*(Aqetiqueta 2 no nom\('es podr\(`a contenir els mateixos valors que l\*(Aqetiqueta 1, el format es construeix de manera flexible a partir de diversos marcs que estan compostos per diversos camps\&. La taula de l\*(Aqetiqueta 2 mostra tots els marcs que hi ha disponibles al fitxer seleccionat\&. .PP Edita: obrir\(`a una finestra que permet editar tots els camps del marc seleccionat\&. Si se seleccionen m\('ultiples fitxers, els camps editats s\*(Aqaplicaran a tots els fitxers seleccionats que continguin aquest marc\&. .PP Afegeix: apareixer\(`a una sol\(mdlicitud per a seleccionar el tipus de marc i es podr\(`a editar i afegir al fitxer\&. Tamb\('e funciona per afegir un marc als m\('ultiples fitxers seleccionats\&. .PP Suprimeix: suprimir\(`a el marc seleccionat en els fitxers seleccionats\&. .PP Es mostrar\(`a Arrossegueu aqu\('i la car\(`atula si el fitxer no cont\('e cap car\(`atula incrustada\&. Es pot afegir una imatge arrossegant i deixant anar des d\*(Aqun navegador o gestor de fitxers i es mostrar\(`a aqu\('i\&. Els marcs de la imatge es poden editar o afegir fent doble clic sobre aquest control\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEtiqueta 3\fR .RS 4 .PP Alguns fitxers poden tenir m\('es de dues etiquetes, i ser\(`a visible una tercera secci\('o d\*(Aqetiquetes\&. Els seg\(:uents tipus de fitxer poden contenir una secci\('o Etiqueta 3: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Els fitxers MP3 poden tenir una etiqueta ID3 versi\('o 1\&.1, una etiqueta ID3 versi\('o 2 (2\&.3\&.0 o 2\&.4\&.0) i a la tercera secci\('o una etiqueta APE\&. Aquestes etiquetes APE s\*(Aqutilitzen per a reproduir la informaci\('o del guany\&. A la secci\('o Etiqueta 3, aquesta informaci\('o ser\(`a visible i l\*(Aqetiqueta APE es pot eliminar amb el bot\('o Elimina\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El fragment INFO del RIFF als fitxers WAV es troba disponible a la secci\('o Etiqueta 3 perqu\(`e la secci\('o Etiqueta 1 est\(`a dedicada a les etiquetes ID3 versi\('o 1\&.1 i t\('e les seves restriccions\&. L\*(AqEtiqueta 2 encara es fa servir per a les etiquetes ID3 versi\('o 2\&.4\&.0, les quals tamb\('e estan admeses per als fitxers WAV, per\(`o els fragments INFO del RIFF semblen estar m\('es ben admesos\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Els fitxers FLAC normalment utilitzen un comentari Vorbis per a les seves metadades\&. No obstant aix\(`o, hi ha fitxers FLAC que tenen etiquetes ID3 versi\('o 1 i versi\('o 2, les quals es troben a les seccions Etiqueta 1 i Etiqueta 3\&. Les etiquetes ID3 en els fitxers FLAC nom\('es estan admeses per la TagLib, per tant, el connector \(FoOggFlacMetadata\(Fc haur\(`a d\*(Aqestar inhabilitat a la pestanya Connectors del di\(`aleg de configuraci\('o\&. .RE .PP Els controls de la IGU funcionen de la mateixa manera que a la secci\('o Etiqueta 2\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBLletra sincronitzada i els Codis de temps dels esdeveniments\fR .RS 4 .PP Per obtenir informaci\('o sincronitzada amb les dades de l\*(Aq\(`audio, hi ha disponible un editor espec\('ific\&. Aquests marcs estan admesos per les etiquetes ID3 versi\('o 2\&.3\&.0 i 2\&.4\&.0\&. Per afegir aquest marc, s\*(Aqhaur\(`a de seleccionar el nom espec\('ific del marc a la llista que apareixer\(`a quan feu clic al bot\('o Afegeix \-la Lletra sincronitzada i els Codis de temps dels esdeveniments, respectivament\-\&. L\*(Aqeditor \('es el mateix per a ambd\('os tipus, per als codis de temps dels esdeveniments, nom\('es hi ha disponible un conjunt predefinit d\*(Aqesdeveniments, mentre que per a la lletra sincronitzada, s\*(Aqhaur\(`a d\*(Aqintroduir el text\&. A continuaci\('o, s\*(Aqexplica l\*(Aqedici\('o de la lletra sincronitzada\&. .PP Un fitxer que t\('e seleccionada l\*(Aqetiqueta ID3 versi\('o 2, s\*(Aqentra a l\*(Aqeditor de la lletra emprant Afegeix i seleccionant Lletra sincronitzada\&. Per a un marc existent de Lletra sincronitzada, se seleccionar\(`a i es far\(`a clic a Edita\&. El reproductor s\*(Aqobrir\(`a autom\(`aticament amb el fitxer actual perqu\(`e el fitxer es pugui reproduir i fer pausa per tal de sincronitzar la lletra\&. .PP La configuraci\('o que hi ha a la part superior de l\*(Aqeditor SYLT normalment no s\*(Aqhan de canviar\&. Si la lletra cont\('e car\(`acters que no estan presents en el joc de car\(`acters Llatin 1, \('es recomanable canviar la codificaci\('o del text a UTF16 (o UTF8 per a l\*(AqID3 versi\('o 2\&.4\&.0)\&. Per a la lletra en angl\(`es i una m\(`axima compatibilitat, s\*(Aqhaur\(`a d\*(Aqutilitzar la ISO\-8859\-1\&. .PP La secci\('o Lletra cont\('e cinc botons a la part superior\&. Afegeix afegir\(`a un esdeveniment de temps nou a la taula\&. El temps es prendr\(`a des de la posici\('o del reproductor, per tant, afegir una entrada mentre es reprodueix la pe\(,ca afegir\(`a una l\('inia per a la posici\('o de reproducci\('o actual\&. Els esdeveniments a la taula s\*(Aqordenaran de forma cronol\(`ogica, per tant, la fila s\*(Aqinserir\(`a en conseq\(:u\(`encia\&. Les entrades amb un temps no v\(`alid es tractaran especialment: si la fila seleccionada t\('e un temps no v\(`alid, la seva marca de temps ser\(`a substitu\(:ida pel temps actual en lloc d\*(Aqafegir una fila nova\&. Si el temps actual no \('es v\(`alid, si est\(`a present s\*(Aqemprar\(`a la primera fila amb un temps no v\(`alid\&. Aquest comportament hauria de facilitar afegir marques de temps si el text de la lletra ja es troba a la taula, per\(`o manquen les marques de temps (el qual \('es el cas en importar lletra sense sincronitzar)\&. Tingueu en compte que el temps no v\(`alid es representa com a 00:00,00, \('es a dir, el mateix que el temps al comen\(,cament absolut de la pe\(,ca, el qual no \('es v\(`alid\&. Per a invalidar un temps, premeu la tecla Supr o utilitzeu Neteja des del men\('u contextual\&. Les files noves inserides emprant Insereix una fila des del men\('u contextual o creades en importar la lletra sense sincronitzar amb Des del porta\-retalls o Importa tamb\('e contindran marques de temps no v\(`alides\&. Les files de la taula es poden suprimir fent clic al bot\('o Suprimeix o utilitzant Suprimeix les files des del men\('u contextual\&. .PP La lletra sincronitzada es pot importar des d\*(Aqun fitxer fent servir Importa\&. El format esperat \('es LRC senzill o millorat\&. Si el fitxer seleccionat no cont\('e un claud\(`ator a la primera l\('inia, se suposar\(`a que es tracta d\*(Aqun senzill fitxer de text amb lletra sense sincronitzar\&. Les l\('inies en aquest fitxer s\*(Aqimportaran amb marques de temps no v\(`alides\&. La informaci\('o de temps es podr\(`a afegir mitjan\(,cant el bot\('o Afegeix o la introducci\('o manual\&. Tamb\('e \('es possible importar la lletra mitjan\(,cant copia i enganxa utilitzant Des del porta\-retalls\&. La lletra sincronitzada es pot escriure en els fitxers LRC utilitzant Exporta\&. Recordeu que nom\('es s\*(Aqexportaran les entrades amb marques de temps v\(`alides i que les entrades s\*(Aqordenaran per hora\&. Les entrades amb temps no v\(`alid no s\*(Aqemmagatzemaran en el marc SYLT, aix\('i que assegureu\-vos d\*(Aqincloure tota la informaci\('o de temps abans de deixar el di\(`aleg\&. .PP L\*(Aq\m[blue]\fBespecificaci\('o ID3\fR\m[]\&\s-2\u[5]\d\s+2 suggereix una marca de temps per a cada s\('il\(mdlaba\&. No obstant aix\(`o, la majoria dels reproductors nom\('es admeten la granularitat d\*(Aquna l\('inia o frase\&. Per admetre ambd\('os casos d\*(Aq\('us, el Kid3 segueix les mateixes convencions que l\*(Aq\m[blue]\fBeditor SYLT\fR\m[]\&\s-2\u[6]\d\s+2\&. Se suposa que el text que s\*(Aqintrodueix a la taula comen\(,car\(`a una l\('inia nova a menys que comenci amb un espai o un gui\('o\&. Les excepcions a aquesta regla s\('on possibles quan es comen\(,ca una l\('inia amb un gui\('o baix (\(Fo_\(Fc) per a for\(,car la continuaci\('o o una marca de numeral (\(Fo#\(Fc) per a for\(,car una l\('inia nova\&. Aquests car\(`acters d\*(Aqescapament no s\*(Aqemmagatzemaran dins del marc SYLT\&. Dins del marc SYLT, les l\('inies noves comen\(,caran amb un car\(`acter d\*(Aqavan\(,c de l\('inia (0A hexadecimal) mentre que les continuacions no\&. En llegir els marcs SYLT, el Kid3 comprovar\(`a si la primera entrada comen\(,ca amb un salt de l\('inia\&. Si aquest no \('es el cas, se suposar\(`a que totes les entrades s\('on l\('inies noves i que no s\*(Aqutilitzen continuacions de s\('il\(mdlaba\&. .PP Mentre es reprodueix la pe\(,ca, es ressaltar\(`a la fila associada amb la posici\('o de reproducci\('o actual, de manera que es pugui verificar l\*(Aqexactitud de la informaci\('o de sincronitzaci\('o\&. Si s\*(Aqha d\*(Aqafegir un despla\(,cament a una o m\('es marques de temps, aix\(`o es pot aconseguir amb l\*(Aqentrada Afegeix un despla\(,cament\&.\&.\&. des del men\('u contextual\&. Els valors negatius es poden utilitzar per a reduir el temps\&. Utilitzant l\*(Aqentrada Ves a la posici\('o des del men\('u contextual, \('es possible establir la fila seleccionada amb el temps de la posici\('o de reproducci\('o\&. .PP \fIProcediment recomanat per afegir una lletra sincronitzada nova\fR .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Obteniu la lletra sense sincronitzar, p\&. ex\&., utilitzant l\*(Aqelement Lletra → Lletra incrustada des del men\('u contextual a la llista de fitxers\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Copieu al porta\-retalls la lletra sense sincronitzar, simplement aneu a la fila Lletra a la taula de marcs i premeu Ctrl+C\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Afegiu un marc de lletra sincronitzada (Afegeix\&.\&.\&., Lletra, D\*(Aqacord), feu clic a Des del porta\-retalls\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ara totes les l\('inies de la lletra sense sincronitzar estaran a la taula, totes les marques de temps no seran v\(`alides (0:0:0,00)\&. Per endavant, podreu suprimir les entrades buides\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Comenceu a reproduir la can\(,c\('o fent clic al bot\('o de reproducci\('o ► que es troba a la barra d\*(Aqeines de reproducci\('o a la part inferior de la finestra principal\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Quan aparegui la seg\(:uent l\('inia de la lletra amb una marca de temps no v\(`alida, feu clic a Afegeix o premeu Alt+A, la marca de temps ser\(`a actualitzada\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Continueu aix\('i fins que s\*(Aqestableixin totes les marques de temps\&. Si s\*(Aqha perdut quelcom, atureu la reproducci\('o i netegeu les marques de temps amb la tecla Supr o seleccionant\-les i utilitzant Neteja des del men\('u contextual\&. Per a tornar a iniciar la reproducci\('o des d\*(Aquna marca de temps en concret, utilitzeu Ves a la posici\('o des del men\('u contextual\&. .RE .sp .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCap\('itols ens els fitxers MP4\fR .RS 4 .PP Els audiollibres MP4 normalment solen tenir una extensi\('o \&.m4b i s\('on bastant grans perqu\(`e contenen tots els cap\('itols en un sol fitxer\&. Per navegar en aquests fitxers, poden contenir marques de cap\('itols, que es poden editar en el Kid3 en un pseudomarc de \(FoCap\('itols\(Fc utilitzant el mateix editor que s\*(Aqutilitza per a les lletres sincronitzades\&. No obstant aix\(`o, cal tenir en compte que aquesta caracter\('istica nom\('es est\(`a disponible amb el connector Mp4v2Metadata, aix\('i que assegureu\-vos que est\(`a activat i per sobre del connector TaglibMetadata a la pestanya Connectors de la configuraci\('o si heu d\*(Aqeditar cap\('itols MP4\&. .RE .SS "El men\('u Fitxer" .PP .PP Fitxer → Obre\&.\&.\&. (Ctrl+O) .RS 4 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 seleccionar\(`a el fitxer triat\&. .RE .PP Fitxer → Obre\*(Aqn una recent .RS 4 Obre una carpeta que ha estat oberta recentment\&. .RE .PP Fitxer → Obre una carpeta\&.\&.\&. (Ctrl+D) .RS 4 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\&. .RE .PP Fitxer → Torna a carregar (F5) .RS 4 Torna a carregar la carpeta\&. Primer s\*(Aqhauran de desar tots els fitxers modificats\&. Les subcarpetes expandides es contrauran\&. .RE .PP Fitxer → Desa (Ctrl+S) .RS 4 Desa tots els fitxers modificats a la carpeta\&. Els fitxers modificats es marcaran amb un s\('imbol de disc al quadre de llista de fitxers\&. Si s\*(Aqha canviat algun nom de fitxer, es canviar\(`a el nom d\*(Aqaquests fitxers\&. .RE .PP Fitxer → Reverteix .RS 4 Reverteix els canvis d\*(Aqun o m\('ultiples fitxers\&. Si no se seleccionen fitxers en el quadre de llista de fitxers, es revertiran els canvis de tots els fitxers\&. En cas contrari, nom\('es es revertiran els canvis dels fitxers seleccionats\&. .RE .PP Fitxer → Importa\&.\&.\&. .RS 4 El di\(`aleg Importa es pot utilitzar per importar les dades directament des d\*(Aqun servidor freedb\&.org, des d\*(Aqun servidor MusicBrainz, des de Discogs, Amazon o altres fonts de llistes de peces d\*(Aq\(`album en un format de text\&. .sp \('Es possible la importaci\('o des d\*(Aqun servidor freedb\&.org utilitzant un di\(`aleg que apareix quan a Des del servidor: se selecciona gnudb\&.org\&. L\*(Aqartista i el nom de l\*(Aq\(`album per 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 \m[blue]\fBwww\&.gnudb\&.org\fR\m[]\&\s-2\u[7]\d\s+2\&. La importaci\('o de les dades de les peces per a un \(`album es realitza fent doble clic sobre l\*(Aq\(`album a la llista\&. Es pot seleccionar el servidor freedb\&.org per a importar, aix\('i com el cam\('i CGI\&. Les dades importades es mostraran a la taula de vista pr\(`evia del di\(`aleg d\*(Aqimportaci\('o\&. Quan estigueu satisfet amb les peces mostrades, es podran importar finalitzant el di\(`aleg d\*(Aqimportaci\('o amb D\*(Aqacord\&. .sp Si ja teniu obert un resultat de cerca al navegador web, podeu introduir l\*(AqURL al primer camp de cerca\&. El resultat apareixer\(`a a la llista d\*(Aq\(`albums i es podr\(`a importar directament al Kid3\&. .sp Es pot fer una cerca al servidor Discogs utilitzant Discogs\&. Com en el di\(`aleg gnudb\&.org, podreu introduir l\*(Aqartista i \(`album, i despr\('es triar des d\*(Aquna llista de llan\(,caments\&. Es pot introduir un Testimoni: per a utilitzar l\*(AqAPI RESTful de Discogs en lloc de la seva interf\('icie web, la qual canvia sovint, trencant aix\('i l\*(Aqanalitzador d\*(Aqimportaci\('o\&. Heu de registrar\-vos per a obtenir un compte a \m[blue]\fBDiscogs\fR\m[]\&\s-2\u[8]\d\s+2 i despr\('es generar un testimoni al seu lloc web (Settings/Developers, Generate new token \-Arranjament/Desenvolupadors, Genera un testimoni nou)\&. No us oblideu de pr\('emer el bot\('o Desa la configuraci\('o despr\('es d\*(Aqintroduir el testimoni per a emprar\-lo tamb\('e en les sol\(mdlicituds posteriors\&. Si es marca Etiquetes est\(`andard, s\*(Aqimportar\(`a la informaci\('o est\(`andard, p\&. ex\&., artista, \(`album i t\('itol\&. Si es marca Etiquetes addicionals, s\*(Aqimportar\(`a m\('es informaci\('o si est\(`a disponible, p\&. ex\&., int\(`erprets, arranjadors o l\*(Aqeditor\&. Si es marca la Car\(`atula, es descarregar\(`a la car\(`atula si est\(`a disponible\&. .sp Es pot fer una cerca al servidor Amazon utilitzant Amazon\&. Com en el di\(`aleg gnudb\&.org, podreu introduir l\*(Aqartista i \(`album, i despr\('es triar d\*(Aquna llista de llan\(,caments\&. Si es marca Etiquetes addicionals, s\*(Aqimportar\(`a m\('es informaci\('o si est\(`a disponible, p\&. ex\&., int\(`erprets, arranjadors o l\*(Aqeditor\&. Si es marca la Car\(`atula, es descarregar\(`a la car\(`atula si est\(`a disponible\&. .sp Podreu fer cerques de la mateixa manera que amb la base de dades de llan\(,cament de MusicBrainz utilitzant Des del Llan\(,cament de MusicBrainz\&. El flux de treball \('es el mateix que es descriu per a Des de gnudb\&.org\&. .sp \('Es possible la importaci\('o des d\*(Aqun servidor MusicBrainz utilitzant el di\(`aleg que apareix quan se selecciona Des de l\*(AqEmpremta digital de MusicBrainz\&. El servidor es pot seleccionar com en el di\(`aleg d\*(Aqimportaci\('o de freedb\&. A sota es mostrar\(`a una taula mostrant les dades importades de les peces\&. La columna de la dreta mostrar\(`a l\*(Aqestat de la consulta a MusicBrainz, la qual comen\(,ca amb \(FoPendent\(Fc quan s\*(Aqobre el di\(`aleg\&. Despr\('es, se cercar\(`a l\*(Aqempremta digital i, si no produeix un resultat, s\*(Aqintentar\(`a una altra cerca utilitzant les etiquetes al fitxer\&. Per tant, pot ser \('util per a una consulta amb \(`exit a MusicBrainz i aix\('i emmagatzemar la informaci\('o coneguda (p\&. ex\&., artista i \(`album) en les etiquetes abans de fer la importaci\('o\&. Si es troba un resultat, la cerca acabar\(`a amb l\*(Aqestat \(FoReconeguda\(Fc, en cas contrari \('es que no s\*(Aqha trobat res o que s\*(Aqhan obtingut m\('ultiples resultats ambigus i l\*(Aqusuari n\*(Aqhaur\(`a de seleccionar un\&. Accepta i Aplica utilitzaran les dades importades, Cancel\(mdla tancar\(`a el di\(`aleg\&. El tancament pot trigar una estona ja que s\*(Aqhaur\(`a de tancar tota la maquin\(`aria del MusicBrainz\&. .sp Per a la importaci\('o de dades textuals, Des del fitxer/porta\-retalls\&.\&.\&. obrir\(`a un subdi\(`aleg, on hi haur\(`a disponibles diversos formats d\*(Aqimportaci\('o preconfigurats\&. Els dos primers, \(FoCSV sense cometes\(Fc i \(FoCSV amb cometes\(Fc es poden fer servir per importar les dades que s\*(Aqhan exportat mitjan\(,cant el di\(`aleg Exporta\&. Les dades CSV es podran editar amb un full de c\(`alcul i s\*(Aqescriuran emprant tabulacions com a delimitadors\&. La importaci\('o hauria de ser possible utilitzant \(FoCSV amb cometes\(Fc, el qual \('es m\('es flexible que el \(FoCSV sense cometes\(Fc\&. No obstant aix\(`o, els seus camps no poden contenir cometes dobles\&. Si nom\('es exporteu des del Kid3 i importeu m\('es tard, es pot utilitzar el \(FoCSV sense cometes\(Fc com un format senzill per a aquesta finalitat\&. Recordeu que tamb\('e hi ha les ordres \(FoExporta a CSV\(Fc i \(FoImporta des de CSV\(Fc al men\('u contextual de la llista de fitxers, les quals utilitzen scripts per exportar i importar les dades CSV d\*(Aquna manera m\('es completa, potent i flexible\&. .sp El seg\(:uent format, \(FoText HTML de freedb\(Fc, es pot utilitzar per a copiar la informaci\('o des d\*(Aquna p\(`agina HTML de \m[blue]\fBfreedb\&.org\fR\m[]\&\s-2\u[9]\d\s+2\&. Cerqueu un \(`album a freedb i si la informaci\('o desitjada es mostra en el navegador web, copieu el contingut al porta\-retalls\&. Despr\('es feu clic al bot\('o Des del porta\-retalls i les peces importades es mostraran a la taula de vista pr\(`evia a la part superior del di\(`aleg\&. Si esteu satisfet amb les dades importades, finalitzeu el di\(`aleg amb D\*(Aqacord, el qual inserir\(`a les dades en les etiquetes de la carpeta actual\&. La destinaci\('o (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\*(Aqestar en l\*(Aqordre de peces correcte per assignar les seves etiquetes\&. Aquest ser\(`a el cas si estan numerades\&. .sp Si les dades estan disponibles com un document HTML, es podr\(`a utilitzar el seg\(:uent format d\*(Aqimportaci\('o preconfigurat, \(FoFont HTML des de freedb\(Fc\&. La importaci\('o \('es possible utilitzant el bot\('o Des del fitxer\&.\&.\&., el qual obrir\(`a un selector de fitxers, o copiant el seu contingut des d\*(Aqun editor i despr\('es important des del porta\-retalls\&. Aquest format pot ser \('util per a la importaci\('o sense connexi\('o, tot i que el document HTML tamb\('e podria obrir\-se en un navegador i despr\('es importar\-se en el primer format mitjan\(,cant el porta\-retalls\&. .sp Hi ha disponibles m\('es formats preconfigurats, p\&. ex\&., \(FoTemps del t\('itol de la pe\(,ca\(Fc\&. Es pot crear un format personalitzat buit amb Afegeix perqu\(`e sigui configurat per l\*(Aqusuari\&. Es poden establir dues l\('inies a sota del nom del format amb una expressi\('o regular per a capturar els camps de text a importar\&. S\*(Aqanalitzar\(`a la primera expressi\('o regular un cop per document per a recopilar les dades per \(`album; com ara l\*(Aqartista, \(`album, any i g\(`enere\&. La segona l\('inia intenta fer coincidir des del comen\(,cament del document fins al final per obtenir les dades de les peces, generalment el n\('umero i t\('itol\&. Les expressions regulars inclouen totes les caracter\('istiques que ofereixen les Qt(TM), les quals s\('on la major part del que ofereix Perl\&. Les construccions de par\(`entesis \(Fo(\&.\&.)\(Fc creen mem\(`ories interm\(`edies de captura per als camps a importar i estan precedides per codis espec\('ifics del Kid3 per especificar quin camp capturar\&. Els codis s\('on els mateixos que es fan servir per al format del nom de fitxer, a m\('es dels codis llistats a continuaci\('o, \('es possible qualsevol nom de marc: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %d %{duration} Durada .RE .sp Per exemple, una expressi\('o regular de pe\(,ca (segona l\('inia) per importar des d\*(Aquna llista de reproducci\('o \&.m3u podria ser \(Fo%{track}(\ed+)\es+%{title}(\eS[^\er\en]*)\e\&.mp3[\er\en]\(Fc\&. Tots els formats es poden canviar editant les expressions regulars i el nom, i despr\('es fent clic a Desa la configuraci\('o\&. S\*(Aqemmagatzemaran al fitxer kid3rc a la carpeta de configuraci\('o\&. Aquest fitxer es pot editar directament per tenir m\('es formats d\*(Aqimportaci\('o o es pot eliminar per tornar als formats predeterminats\&. Els formats es poden eliminar amb Elimina\&. .sp La Precisi\('o: mostra una estimaci\('o de com \('es de bona la coincid\(`encia de la informaci\('o importada amb les peces indicades\&. Utilitza durades de pe\(,ca o noms de fitxer per a calcular el nivell de similitud en percentatge\&. La Car\(`atula: mostra l\*(AqURL de la imatge per a la portada de l\*(Aq\(`album que es descarregar\(`a\&. .sp 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 opci\('o es pot habilitar amb la casella de selecci\('o Comprova la difer\(`encia m\(`axima de temps permesa (seg): i la difer\(`encia de temps m\(`axima tolerada es pot establir en segons\&. Si es detecta una manca de coincid\(`encia en una durada, la durada es mostrar\(`a amb un fons vermell a la taula de vista pr\(`evia\&. .sp Si els fitxers estan ordenats de manera diferent que les peces importades, les peces assignades s\*(Aqhauran de canviar\&. Aquesta tasca es pot facilitar utilitzant l\*(Aqopci\('o Coincideix amb: amb els botons Durada, Pe\(,ca i T\('itol, la qual reordenar\(`a les peces d\*(Aqacord amb el camp corresponent\&. Per a corregir les assignacions manualment, es pot arrossegar una pe\(,ca amb el bot\('o esquerre del ratol\('i i mantenint premuda la tecla Ctrl, i despr\('es deixar\-la anar a la nova ubicaci\('o\&. .sp Quan s\*(Aqobri el di\(`aleg d\*(Aqimportaci\('o, aquest contindr\(`a el contingut real de les etiquetes\&. El tipus d\*(Aqetiqueta (Etiqueta 1, Etiqueta 2, Etiqueta 1 i Etiqueta 2) es podr\(`a seleccionar utilitzant el quadre combinat Destinaci\('o:\&. El bot\('o a la dreta d\*(Aqaquest quadre combinat es pot utilitzar per a revertir la taula al contingut actual de les etiquetes\&. Es poden utilitzar les caselles de selecci\('o a la primera columna de la taula per a seleccionar les peces que s\*(Aqimportaran\&. Aix\(`o pot ser \('util si una carpeta cont\('e les peces d\*(Aqambd\('os CD d\*(Aqun CD doble i nom\('es s\*(Aqhan d\*(Aqimportar les peces del segon CD\&. .sp Per identificar les pistes que s\*(Aqimportaran, \('es possible mostrar els noms de fitxer o els camins sencers als fitxers utilitzant el men\('u contextual a la cap\(,calera de la taula\&. Els valors en la taula d\*(Aqimportaci\('o es poden editar\&. El bot\('o Reverteix que hi ha a la dreta del quadre combinat Destinaci\('o: es pot utilitzar per a restaurar el contingut de les etiquetes, el qual tamb\('e pot ser \('util despr\('es de canviar la Destinaci\('o:\&. .sp Gaireb\('e tots els di\(`alegs tenen un bot\('o Desa la configuraci\('o, el qual es pot utilitzar per emmagatzemar les opcions de configuraci\('o espec\('ifiques del di\(`aleg i fer que la mida de la finestra sigui persistent\&. .sp Des de les etiquetes\&.\&.\&. porta a un subdi\(`aleg per establir els marcs de les etiquetes a partir del contingut d\*(Aqaltres marcs d\*(Aqetiqueta\&. Es pot utilitzar per a simplement copiar la informaci\('o entre les etiquetes o extreure una part d\*(Aqun marc i inserir\-la en un altre\&. .sp Com en el di\(`aleg Importa des del fitxer/porta\-retalls, hi ha formats lliurement configurables per a realitzar diferents operacions\&. S\('on formats que ja estan preconfigurats per a copiar el valor de l\*(Aq\(`Album a l\*(AqArtista, Compositor o Director de l\*(Aq\(`album, i per extreure el n\('umero de la pe\(,ca dels camps T\('itol que contenen un n\('umero\&. Tamb\('e hi ha un format per extreure un subt\('itol des d\*(Aqun camp T\('itol\&. .sp El seg\(:uent exemple explica com afegir un format personalitzat, el qual estableix la informaci\('o del camp Subt\('itol tamb\('e en el camp Comentari\&. Creeu un format nou amb el bot\('o Afegeix i establiu un nom nou, p\&. ex\&., \(FoComentari per al subt\('itol\(Fc\&. Despr\('es introdu\(:iu \(Fo\fB%{subtitle}\fR\(Fc a Font: i \(Fo\fB%{comment}(\&.*)\fR\(Fc per a Extracci\('o: i feu clic a Desa la configuraci\('o\&. .sp L\*(Aqexpressi\('o a Font: pot contenir codis de format per a marcs d\*(Aqetiqueta arbitraris, es poden utilitzar m\('ultiples codis per a combinar el contingut de diferents marcs\&. Per a cada pista, es generar\(`a un text a partir de les seves etiquetes utilitzant el format Font:, i l\*(Aqexpressi\('o regular des d\*(AqExtracci\('o: s\*(Aqaplicar\(`a a aquest text per establir valors nous per a les etiquetes\&. Els codis de format s\*(Aqutilitzen abans dels par\(`entesis de captura per especificar el marc de l\*(Aqetiqueta on s\*(Aqemmagatzemar\(`a el text capturat\&. Funciona de la mateixa manera que per a Importar des d\*(Aqun fitxer/porta\-retalls\&. .sp Importa des de les etiquetes\&.\&.\&. tamb\('e est\(`a disponible directament des del men\('u Fitxer\&. La difer\(`encia entre aquestes dues funcions \('es que el subdi\(`aleg del di\(`aleg d\*(Aqimportaci\('o funciona sobre tots els fitxers de la carpeta actual, mentre que la funci\('o de men\('u funciona sobre els fitxers seleccionats (els quals poden estar en carpetes diferents)\&. La funci\('o de men\('u admet un codi addicional \(Fo%{__return}\(Fc per a retornar el valor extret, el qual pot ser \('util amb les interf\('icies CLI i QML\&. .RE .PP Fitxer → Importa des de gnudb\&.org\&.\&.\&. .RS 4 Importa des d\*(Aqun servidor freedb\&.org utilitzant la cerca d\*(Aq\(`albums de gnudb\&.org\&. Aquest element de men\('u obrir\(`a el mateix di\(`aleg d\*(Aqimportaci\('o que Importa\&.\&.\&., per\(`o obrir\(`a directament el di\(`aleg de gnudb\&.org\&. .RE .PP Fitxer → Importa des de Discogs\&.\&.\&. .RS 4 Importa des d\*(Aqun servidor Discogs\&. Aquest element de men\('u obrir\(`a el mateix di\(`aleg d\*(Aqimportaci\('o que Importa\&.\&.\&., per\(`o obrir\(`a directament el di\(`aleg de Des de Discogs\&. .RE .PP Fitxer → Importa des d\*(AqAmazon\&.\&.\&. .RS 4 Importa des d\*(AqAmazon\&. Aquest element de men\('u obrir\(`a el mateix di\(`aleg d\*(Aqimportaci\('o que Importa\&.\&.\&., per\(`o obrir\(`a directament el di\(`aleg de Des d\*(AqAmazon\&. .RE .PP Fitxer → Importa des de Llan\(,cament de MusicBrainz\&.\&.\&. .RS 4 Importa des d\*(Aquna base de dades de Llan\(,cament de MusicBrainz\&. Aquest element de men\('u obrir\(`a el mateix di\(`aleg d\*(Aqimportaci\('o que Importa\&.\&.\&., per\(`o obrir\(`a directament el di\(`aleg Des del Llan\(,cament de MusicBrainz\&. .RE .PP Fitxer → Importa des de l\*(AqEmpremta digital de MusicBrainz\&.\&.\&. .RS 4 Importa des d\*(Aqun servidor de MusicBrainz\&. Aquest element de men\('u obrir\(`a el mateix di\(`aleg d\*(Aqimportaci\('o que Importa\&.\&.\&., per\(`o obrir\(`a directament el di\(`aleg Des de l\*(AqEmpremta digital de MusicBrainz\&. .RE .PP Fitxer → Importa des de les etiquetes\&.\&.\&. .RS 4 Com Des de les etiquetes, per\(`o la importaci\('o s\*(Aqaplicar\(`a als fitxers seleccionats\&. .RE .PP Fitxer → Importa autom\(`aticament\&.\&.\&. .RS 4 La importaci\('o autom\(`atica permet importar la informaci\('o per a m\('ultiples \(`albums des de diversos serveis web\&. Si se seleccionen carpetes a la llista de fitxers, s\*(Aqimportaran les dades de les peces per a les carpetes seleccionades\&. Si no se selecciona cap carpeta, s\*(Aqimportaran totes les carpetes a la llista de fitxers\&. .sp Es pot seleccionar el tipus d\*(Aqetiqueta (Etiqueta 1, Etiqueta 2, Etiqueta 1 i Etiqueta 2) utilitzant el quadre combinat Destinaci\('o:\&. .sp Els perfils determinen quins servidors seran contactats per obtenir la informaci\('o de l\*(Aq\(`album\&. Alguns perfils estan predefinits (Tots, MusicBrainz, Discogs, Car\(`atula), es poden afegir perfils personalitzats emprant el bot\('o Afegeix que hi ha a la dreta del quadre combinat Perfil:\&. .sp La seg\(:uent taula mostra els servidors que s\*(Aqutilitzaran en importar la informaci\('o de l\*(Aq\(`album utilitzant el perfil seleccionat\&. El proc\('es d\*(Aqimportaci\('o per a un \(`album finalitzar\(`a si s\*(Aqha trobat tota la informaci\('o requerida, per la qual cosa l\*(Aqordre 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 selecci\('o del Servidor ofereix els mateixos servidors que es poden utilitzar en les funcions d\*(Aqimportaci\('o\&. Les Etiquetes est\(`andard, Etiquetes addicionals i la Car\(`atula determinen la informaci\('o que s\*(Aqobtindr\(`a del servidor\&. Finalment, la Precisi\('o \('es la precisi\('o m\('inima que s\*(Aqhaur\(`a d\*(Aqaconseguir per a acceptar les dades importades\&. Si la precisi\('o \('es insuficient, es provar\(`a el seg\(:uent servidor de la llista\&. El mateix di\(`aleg que cont\('e les propietats del servidor apareixer\(`a quan feu clic a Afegeix\&.\&.\&. per afegir una entrada nova de servidor\&. Les entrades existents es poden eliminar utilitzant Elimina\&. .sp Per a iniciar una importaci\('o autom\(`atica per lots amb el perfil seleccionat, feu clic a Inicia\&. Els detalls sobre la importaci\('o en execuci\('o es mostraran a la part superior del di\(`aleg\&. El proc\('es es pot interrompre amb el bot\('o Interromp\&. .RE .PP Fitxer → Explora les car\(`atules\&.\&.\&. .RS 4 El di\(`aleg Explora les car\(`atules ajuda a trobar la car\(`atula de l\*(Aq\(`album\&. Si \('es possible, Artista/\(`Album s\*(Aqomplir\(`a amb les etiquetes\&. Font: oferir\(`a una varietat de llocs web amb car\(`atules d\*(Aq\(`albums\&. L\*(AqURL amb l\*(Aqartista i l\*(Aq\(`album com a par\(`ametres es troba a sota del nom\&. Els valors codificats en l\*(AqURL per a l\*(Aqartista i l\*(Aq\(`album es poden inserir utilitzant \(Fo\fB%u{artist}\fR\(Fc i \(Fo\fB%u{album}\fR\(Fc, tamb\('e s\('on possibles altres valors des de les etiquetes, com es descriu a Configurar el Kid3, Accions de l\*(Aqusuari\&. Es poden introduir m\('es fonts despr\('es de l\*(Aqentrada \(FoFont personalitzada\(Fc en substituci\('o de la \(FoFont personalitzada\(Fc amb el nom de la font, prement Retorn, despr\('es introduint l\*(AqURL i finalment prement Desa la configuraci\('o\&. L\*(Aqordre resultant del navegador es mostrar\(`a a la part superior del di\(`aleg i es podr\(`a iniciar fent clic a Explora\&. El navegador, el qual es pot configurar a les opcions de configuraci\('o, s\*(Aqiniciar\(`a amb la font seleccionada\&. Despr\('es podreu arrossegar una imatge de car\(`atula des del navegador a la finestra del Kid3 i s\*(Aqestablir\(`a al marc de la imatge dels fitxers seleccionats\&. .sp 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 rebr\(`a l\*(AqURL i no la imatge\&. Si l\*(AqURL apunta a una imatge, es descarregar\(`a\&. No obstant aix\(`o, si l\*(AqURL es refereix a algun altre recurs web, s\*(Aqhaur\(`a de traduir a la imatge corresponent\&. Aquestes assignacions es defineixen a la taula Extracci\('o de l\*(AqURL\&. La columna esquerra Coincid\(`encia cont\('e una expressi\('o regular que es comparar\(`a amb l\*(AqURL\&. Si coincideix, les expressions capturades entre par\(`entesis s\*(Aqinseriran en el patr\('o de la columna dreta URL de la imatge (en les posicions marcades amb \e1, etc\&.) L\*(Aqexpressi\('o regular substitu\(:ida contindr\(`a l\*(AqURL de la imatge\&. D\*(Aqaquesta manera, la car\(`atula es podr\(`a importar des d\*(AqAmazon, Google Images, etc\&., mitjan\(,cant arrossegar i deixar anar\&. Tamb\('e \('es possible definir les vostres pr\(`opies assignacions\&. .RE .PP Fitxer → Exporta\&.\&.\&. .RS 4 El di\(`aleg Exporta s\*(Aqutilitza per emmagatzemar les dades de les etiquetes en un fitxer o al porta\-retalls\&. L\*(Aqeditor a la part superior mostrar\(`a una vista pr\(`evia de les dades a exportar\&. Si les dades d\*(Aqexportaci\('o contenen car\(`acters de tabulaci\('o, l\*(Aqexportaci\('o es mostrar\(`a en una taula\&. Les dades es generaran a partir de les etiquetes a la carpeta actual d\*(Aqacord amb el format configurat\&. .sp La configuraci\('o del format \('es similar a la del di\(`aleg Importa: el camp superior cont\('e el t\('itol (p\&. ex\&., \(FoCSV sense cometes\(Fc), seguit de la cap\(,calera, el qual es generar\(`a al comen\(,cament del fitxer\&. Segueixen les dades de la pe\(,ca \-s\*(Aqutilitzaran per a cada pe\(,ca\-\&. Finalment, el tr\(`ailer es podr\(`a utilitzar per a generar algun text final\&. .sp Els camps de format no contenen expressions regulars com en el di\(`aleg Importa, sin\('o nom\('es expressions del format de la sortida amb expressions \(Fo%\(Fc especials, les quals seran substitu\(:ides pels valors de les etiquetes\&. Tot funciona com el format del nom de fitxer, i s\*(Aqutilitzen els mateixos codis m\('es alguns codis addicionals\&. No nom\('es es podran fer servir els codis llistats a continuaci\('o, sin\('o tamb\('e tots els noms dels marcs d\*(Aqetiqueta\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca (p\&. ex\&., 01) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track\&.n} Pe\(,ca amb l\*(Aqamplada del camp \(Fon\(Fc (p\&. ex\&., 001 per a %{track\&.3}) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %T %{tracknumber} Pe\(,ca (sense zeros a l\*(Aqesquerra, p\&. ex\&., 1) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %f %{file} Nom del fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %p %{filepath} Cam\('i .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{modificationdate} Data de modificaci\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{creationdate} Data de creaci\('o .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %u %{url} URL .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{dirname} Nom de la carpeta .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %d %{duration} Durada en minuts:segons .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %D %{seconds} Durada en segons .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %n %{tracks} Nombre de peces de l\*(Aq\(`album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %e %{extension} Extensi\('o del fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %O %{tag1} El format de l\*(Aqetiqueta 1 (ID3 versi\('o 1\&.1 o buida si no existeix) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %o %{tag2} El format de l\*(Aqetiqueta 2 (ID3 versi\('o 2\&.3\&.0, 2\&.4\&.0, 2\&.2\&.0, 2\&.2\&.1, Vorbis, APE, MP4, ASF o buida si no existeix) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %b %{bitrate} Taxa de bits en kbit/s .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %v %{vbr} VBR o buida (nom\('es per a l\*(AqID3 versi\('o 2\&.3 amb la id3lib) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %r %{samplerate} Freq\(:u\(`encia de mostreig en Hz .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %m %{mode} Mode del canal (Est\(`ereo o Est\(`ereo combinat) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %h %{channels} Nombre de canals (1 o 2) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %k %{codec} C\(`odec (p\&. ex\&., MPEG 1 Capa 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF o WAV) .RE .sp Hi ha alguns formats predefinits\&. \(FoCSV sense cometes\(Fc separar\(`a els camps per pestanyes\&. Les dades en aquest format es podran importar de nou al Kid3 utilitzant el format d\*(Aqimportaci\('o amb el mateix nom\&. \(FoCSV amb cometes\(Fc tamb\('e inclour\(`a els camps entre cometes dobles, el qual facilitar\(`a la importaci\('o en les aplicacions de full de c\(`alcul\&. No obstant aix\(`o, els camps no hauran de contenir cometes dobles quan s\*(Aqutilitza aquest format\&. \(FoM3U est\(`es\(Fc i \(FoPLS est\(`es\(Fc generaran llistes de reproducci\('o amb atributs estesos i noms de cam\('i absoluts\&. \(FoHTML\(Fc es pot utilitzar per a generar una p\(`agina HTML amb enlla\(,cos a les peces\&. \(FoXML del Kover\(Fc crear\(`a un fitxer el qual podr\(`a importar des del programa d\*(Aqimpressi\('o de car\(`atules Kover\&. \(FoDetalls t\(`ecnics\(Fc proporcionar\(`a la informaci\('o sobre la velocitat dels bits, la freq\(:u\(`encia de mostreig, els canals, etc\&. Finalment, el "Format personalitzat" es deixar\(`a buit per a la definici\('o d\*(Aqun format personalitzat\&. Podreu definir m\('es formats propis afegint l\('inies al fitxer kid3rc a la carpeta de la configuraci\('o\&. Els altres formats es podran adaptar a les vostres necessitats\&. .sp La Font: de les etiquetes per a generar les dades d\*(Aqexportaci\('o (Etiqueta 1 o Etiqueta 2) es podr\(`a seleccionar amb un quadre combinat\&. Prement A un fitxer\&.\&.\&. o Al porta\-retalls s\*(Aqemmagatzemaran les dades en un fitxer o al porta\-retalls\&. D\*(Aqacord i Cancel\(mdla tancaran el di\(`aleg, mentre que D\*(Aqacord acceptar\(`a la configuraci\('o del di\(`aleg actual\&. .RE .PP Fitxer → Crea una llista de reproducci\('o\&.\&.\&. .RS 4 Crear\(`a una llista de reproducci\('o\&. El format i el contingut de la llista de reproducci\('o es poden establir mitjan\(,cant diverses opcions\&. .sp El nom de la llista de reproducci\('o pot ser El mateix, com el nom de la carpeta o utilitzar un Format: amb els valors de les etiquetes, p\&. ex\&., \(Fo\fB%{artist} \- %{album}\fR\(Fc per a tenir el nom de l\*(Aqartista i l\*(Aq\(`album en el nom del fitxer de llista de reproducci\('o\&. Els codis de format s\('on els mateixos que per a Exporta\&. La llista de formats disponibles es pot editar a la secci\('o Format de la pestanya Fitxers a la configuraci\('o\&. Crea una nova llista de reproducci\('o buida: crear\(`a una llista de reproducci\('o buida amb el nom indicat\&. L\*(Aqextensi\('o dependr\(`a del format de la llista de reproducci\('o\&. .sp La ubicaci\('o de la llista de reproducci\('o generada estar\(`a determinada per la selecci\('o del quadre combinat Crea dins:\&. .PP Carpeta actual .RS 4 Es crear\(`a la llista de reproducci\('o a la carpeta actual i nom\('es contindr\(`a els fitxers de la carpeta actual\&. La carpeta actual ser\(`a la carpeta on es troba el fitxer actual\&. Si se seleccionen m\('ultiples fitxers, el fitxer actual probablement ser\(`a l\*(Aq\('ultim fitxer seleccionat\&. .RE .PP Cada carpeta .RS 4 Es crear\(`a una llista de reproducci\('o a cada carpeta que contingui els fitxers llistats, i cada llista de reproducci\('o contindr\(`a els fitxers en aquesta carpeta\&. .RE .PP Carpeta de nivell superior .RS 4 Nom\('es crear\(`a una llista de reproducci\('o a la carpeta de nivell superior (\('es a dir, la carpeta de la llista de fitxers) i contindr\(`a els fitxers llistats a la carpeta de nivell superior i totes les seves subcarpetes\&. .RE .sp El Format: de la llista de reproducci\('o pot ser M3U, PLS o XSPF\&. .sp Si es marca Inclou nom\('es els fitxers seleccionats, nom\('es s\*(Aqinclouran els fitxers seleccionats a la llista de reproducci\('o\&. Si se selecciona una carpeta, se seleccionaran tots els seus fitxers\&. Si aquesta casella de selecci\('o no est\(`a marcada, s\*(Aqinclouran tots els fitxers d\*(Aq\(`audio a la llista de reproducci\('o\&. .sp Ordena per nom de fitxer seleccionar\(`a el cas habitual on els fitxers s\*(Aqordenen per nom de fitxer\&. Amb Ordena pel camp de l\*(Aqetiqueta, \('es possible ordenar per una cadena de format amb els valors dels camps d\*(Aqetiqueta\&. Per exemple, \(Fo\fB%{track\&.3}\fR\(Fc es pot utilitzar per a ordenar per n\('umero de pe\(,ca (el \(Fo\fB\&.3\fR\(Fc s\*(Aqutilitza per obtenir tres d\('igits amb zeros a l\*(Aqesquerra, de manera que les cadenes s\*(Aqutilitzaran per a ordenar)\&. Tamb\('e \('es possible utilitzar m\('ultiples camps, p\&. ex\&., \(Fo\fB%{genre}%{year}\fR\(Fc per a ordenar utilitzant una cadena composta del g\(`enere i any\&. .sp Les entrades a la llista de reproducci\('o tindran camins de fitxer relatius o absoluts depenent de si s\*(Aqestableix Empra un cam\('i relatiu per als fitxers a la llista de reproducci\('o o Empra un cam\('i absolut per als fitxers a la llista de reproducci\('o\&. .sp Quan s\*(Aqestableix Escriu nom\('es la llista de fitxers, la llista de reproducci\('o nom\('es contindr\(`a els camins als fitxers\&. Per a generar una llista de reproducci\('o estesa amb informaci\('o addicional, es podr\(`a establir una cadena de format utilitzant el control Escriu la informaci\('o usant\&. .RE .PP Fitxer → Surt (Ctrl+Q) .RS 4 Surt de l\*(Aqaplicaci\('o\&. .RE .SS "El men\('u Edita" .PP .PP Edita → Selecciona\-ho tot (Alt+A) .RS 4 Selecciona tots els fitxers\&. .RE .PP Edita → Desselecciona (Ctrl+Maj+A) .RS 4 Desselecciona tots els fitxers\&. .RE .PP Edita → Selecciona\-ho tot a la carpeta .RS 4 Selecciona tots els fitxers en la carpeta actual\&. .RE .PP Edita → Fitxer anterior (Alt+Fletxa amunt) .RS 4 Selecciona el fitxer anterior\&. .RE .PP Edita → Fitxer seg\(:uent (Alt+Fletxa avall) .RS 4 Selecciona el fitxer seg\(:uent\&. .RE .PP Edita → Cerca\&.\&.\&. (Ctrl+F) .RS 4 Cerca les cadenes en els noms de fitxer i les etiquetes\&. El di\(`aleg Cerca \('es un subconjunt del di\(`aleg Substitueix, el qual es descriu a continuaci\('o\&. .RE .PP Edita → Substitueix\&.\&.\&. (Ctrl+R) .RS 4 Aquesta funci\('o obrir\(`a un di\(`aleg 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 selecci\('o Selecciona\-ho tot i seleccionant els marcs que se cercaran\&. Tamb\('e hi ha opcions de cerca disponibles per a cercar cap enrere, maj\('uscules i min\('uscules, i per utilitzar expressions regulars\&. .sp Depenent de la quantitat de fitxers, la cerca es podria demorar una mica, per tant, es podr\(`a interrompre tancant el di\(`aleg\&. .RE .SS "El men\('u Eines" .PP .PP Eines → Aplica el format del nom de fitxer .RS 4 Quan Aplica autom\(`aticament el format est\(`a desactivada per al format del nom de fitxer en el di\(`aleg de configuraci\('o, aquest element de men\('u es podr\(`a utilitzar per aplicar el format configurat als noms dels fitxers seleccionats\&. Aix\(`o tamb\('e es pot fer servir per a comprovar si els noms dels fitxers s\*(Aqajusten al format configurat aplicant el format a tots els fitxers desats i despr\('es comprovant si es van modificar els fitxers (i, per tant, es van marcar amb un s\('imbol de disc en el quadre de llista de fitxers)\&. .RE .PP Eines → Aplica el format de l\*(Aqetiqueta .RS 4 Quan Aplica autom\(`aticament el format est\(`a desactivada per al format de l\*(Aqetiqueta en el di\(`aleg de configuraci\('o, aquest element de men\('u es podr\(`a utilitzar per aplicar el format configurat a les etiquetes dels fitxers seleccionats\&. Aix\(`o tamb\('e es pot fer servir per a comprovar si els noms dels fitxers s\*(Aqajusten al format configurat aplicant el format a tots els fitxers desats i despr\('es comprovant si es van modificar els fitxers (i, per tant, es van marcar amb un s\('imbol de disc en el quadre de llista de fitxers)\&. .RE .PP Eines → Aplica la codificaci\('o del text .RS 4 Estableix la Codificaci\('o del text seleccionada a Arranjament → Configura el Kid3\&.\&.\&. → secci\('o Etiquetes → pestanya Etiqueta 2 per a tots els fitxers seleccionats\&. Si se selecciona UTF8, s\*(Aqusar\(`a UTF16 per a les etiquetes ID3 versi\('o 2\&.3\&.0 perqu\(`e UTF8 no s\*(Aqadmet amb aquest format\&. .RE .PP Eines → Reanomena la carpeta\&.\&.\&. .RS 4 Aquest di\(`aleg ofereix la possibilitat de canviar autom\(`aticament el nom de la carpeta actualment oberta d\*(Aqacord amb les etiquetes en els fitxers\&. Hi ha preconfigurats diversos formats per incloure la informaci\('o sobre l\*(Aqartista, l\*(Aq\(`album i l\*(Aqany en el nom de la carpeta\&. Tamb\('e \('es possible establir un format personalitzat i fer Edita sobre la llista de formats disponibles\&. S\*(Aqutilitzaran els seg\(:uents codis especials per inserir valors d\*(Aqetiqueta en el nom de la carpeta: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca (p\&. ex\&., 01) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track\&.n} Pe\(,ca amb l\*(Aqamplada del camp \(Fon\(Fc (p\&. ex\&., 001 per a %{track\&.3}) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %T %{tracknumber} Pe\(,ca (sense zeros a l\*(Aqesquerra, p\&. ex\&., 1) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{dirname} Nom de la carpeta (p\&. ex\&., %{year" "}%{dirname} anteposar\(`a l\*(Aqany al nom de la carpeta actual) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{max\-year} El valor d\*(Aqany m\(`axim trobat per a aquesta carpeta, tamb\('e es pot emprar amb altres codis que no siguin \(Foyear\(Fc .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{min\-year} El valor d\*(Aqany m\('inim trobat per a aquesta carpeta .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %{unq\-year} El valor d\*(Aqany \('unic trobat per a aquesta carpeta o b\('e si no \('es \('unic .RE .sp Si en el format es troba un separador de carpeta \(Fo/\(Fc, es crearan m\('ultiples carpetes\&. Per a crear una carpeta nova en lloc de canviar el nom de la carpeta actual, al quadre combinat Acci\('o: seleccioneu Crea una carpeta en lloc de Reanomena la carpeta\&. La Font: de la informaci\('o de les etiquetes es pot triar entre Etiqueta 1 i etiqueta 2, Etiqueta 1 i Etiqueta 2\&. Al di\(`aleg es disposar\(`a d\*(Aquna vista pr\(`evia de l\*(Aqoperaci\('o del canvi de nom realitzada en el primer fitxer a les seccions Des de: i A:\&. .sp Es podr\(`a canviar el nom de m\('ultiples carpetes seleccionant\-les\&. .RE .PP Eines → N\('umeros de les peces\&.\&.\&. .RS 4 Si els n\('umeros de pe\(,ca a les etiquetes no estan establerts o tenen valors incorrectes, aquesta funci\('o podr\(`a donar n\('umero autom\(`aticament a les peces en ordre ascendent\&. El n\('umero d\*(Aqinici es podr\(`a establir en el di\(`aleg\&. Si nom\('es s\*(Aqhan de numerar part de les peces, s\*(Aqhauran de seleccionar\&. .sp Quan es marca Nombre total de peces:, tamb\('e s\*(Aqestablir\(`a en les etiquetes el nombre de peces\&. .sp \('Es possible donar n\('umero a les pistes en m\('ultiples carpetes\&. S\*(Aqhauran d\*(Aqexpandir i seleccionar les carpetes\&. .sp Si es marca Restableix el comptador en cada carpeta, la numeraci\('o de les peces es reiniciar\(`a amb el n\('umero donat per a cada carpeta quan se seleccionen m\('ultiples carpetes\&. .sp El di\(`aleg N\('umeros de les peces tamb\('e es pot utilitzar per a donar format als n\('umeros de les peces existents sense canviar els valors quan la casella de selecci\('o esquerra a N\('umero d\*(Aqinici: est\(`a desactivada\&. El nombre total de peces s\*(Aqafegir\(`a si la casella de selecci\('o corresponent est\(`a activa, el qual es pot utilitzar per establir el total de totes les pistes seleccionades\&. Si nom\('es es vol donar format als n\('umeros existents, tamb\('e s\*(Aqhaur\(`a de desactivar aquesta casella de selecci\('o\&. .RE .PP Eines → Filtre\&.\&.\&. .RS 4 El filtre es pot utilitzar per a mostrar nom\('es aquells fitxers que coincideixin amb certs criteris\&. Aix\(`o \('es \('util si voleu organitzar una gran col\(mdlecci\('o i nom\('es editar els fitxers que no estan en l\*(Aqesquema desitjat\&. L\*(Aqexpressi\('o que defineix quins fitxers mostrar utilitza els mateixos codis de format que s\*(Aqutilitzen en el format del nom de fitxer, importar i exportar\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca (p\&. ex\&., 01) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track\&.n} Pe\(,ca amb l\*(Aqamplada del camp \(Fon\(Fc (p\&. ex\&., 001 per a %{track\&.3}) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %T %{tracknumber} Pe\(,ca (sense zeros a l\*(Aqesquerra, p\&. ex\&., 1) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %f %{file} Nom del fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %p %{filepath} Cam\('i absolut cap al fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %e %{extension} Extensi\('o del fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %O %{tag1} El format de l\*(Aqetiqueta 1 (ID3 versi\('o 1\&.1 o buida si no existeix) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %o %{tag2} El format de l\*(Aqetiqueta 2 (ID3 versi\('o 2\&.3\&.0, 2\&.4\&.0, 2\&.2\&.0, 2\&.2\&.1, Vorbis, APE, MP4, ASF o buida si no existeix) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %b %{bitrate} Taxa de bits en kbit/s .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %v %{vbr} VBR o buida (nom\('es per a l\*(AqID3 versi\('o 2\&.3 amb la id3lib) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %r %{samplerate} Freq\(:u\(`encia de mostreig en Hz .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %m %{mode} Mode del canal (Est\(`ereo o Est\(`ereo combinat) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %h %{channels} Nombre de canals (1 o 2) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %k %{codec} C\(`odec (p\&. ex\&., MPEG 1 Capa 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF o WAV) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %w %{marked} Marcat, ser\(`a 1 si el fitxer est\(`a marcat (p\&. ex\&., per trencament o violaci\('o de l\*(Aqest\(`andard), en cas contrari estar\(`a buida .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %1a %1{artist}, \&.\&.\&. Empra el prefix 1 per obtenir els valors de l\*(Aqetiqueta 1 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %2a %2{artist}, \&.\&.\&. Empra el prefix 2 per obtenir els valors de l\*(Aqetiqueta 2 .RE .sp Aquests codis se substituiran amb els valors del fitxer, i les cadenes resultants es podran comparar amb les seg\(:uents operacions: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} s1 \('es igual que s2: cert si s1 i s2 s\('on iguals\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} s1 cont\('e s2: cert si s1 cont\('e s2, \('es a dir, s2 \('es una subcadena de s1\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \(Fos\(Fc coincideix amb \(Fore\(Fc: cert si \(Fos\(Fc coincideix amb l\*(Aqexpressi\('o regular \(Fore\(Fc\&. .RE .sp Les expressions veritables se substituiran per \(Fo1\(Fc, les falses per \(Fo0\(Fc\&. Els valors veritables es representen per \(Fo1\(Fc, \(Focert\(Fc, \(Foactiu\(Fc i \(Fos\('i\(Fc, els valors falsos per \(Fo0\(Fc, \(Fofals\(Fc, \(Foinactiu\(Fc i \(Fono\(Fc\&. Les operacions booleanes s\('on \(Fono\(Fc, i, \(Foo\(Fc (en aquest ordre de preced\(`encia) i es poden agrupar entre par\(`entesis\&. .sp Hi ha predefinides algunes regles de filtre i poden servir com a exemples per a les vostres pr\(`opies expressions: .PP Tot .RS 4 Quan es filtra la llista de fitxers \-aix\(`o es mostra amb \(Fo[filtrada]\(Fc al t\('itol de la finestra\- i es mostren de nou tots els fitxers, el filtratge es podr\(`a revertir utilitzant aquest filtre\&. Utilitza una expressi\('o buida, per\(`o un valor veritable tindria el mateix efecte\&. .RE .PP L\*(Aqetiqueta del nom de fitxer no coincideix .RS 4 \fB(%{filepath} no cont\('e "%{artist} \- %{album}/%{track} %{title}") \fR .sp Comprova si el cam\('i del fitxer s\*(Aqajusta al format del nom del fitxer\&. Aquesta regla s\*(Aqadaptar\(`a autom\(`aticament si canvia el format del nom del fitxer\&. .RE .PP Sense etiqueta 1 .RS 4 \fB%{tag1} igual que "" \fR .sp Nom\('es mostra els fitxers que no tenen una etiqueta 1\&. .RE .PP Sense etiqueta 2 .RS 4 \fB%{tag2} igual que "" \fR .sp Nom\('es mostra els fitxers que no tenen una etiqueta 2\&. .RE .PP Etiqueta ID3 versi\('o 2\&.3\&.0 .RS 4 \fB%{tag2} igual que "ID3 versi\('o 2\&.3\&.0" \fR .sp Nom\('es mostra els fitxers que tenen una etiqueta ID3 versi\('o 2\&.3\&.0\&. .RE .PP Etiqueta ID3 versi\('o 2\&.4\&.0 .RS 4 \fB%{tag2} igual que "ID3 versi\('o 2\&.4\&.0" \fR .sp Nom\('es mostra els fitxers que tenen una etiqueta ID3 versi\('o 2\&.4\&.0\&. .RE .PP Etiqueta 1 != Etiqueta 2 .RS 4 \fBno (%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}) \fR .sp Mostra els fitxers amb difer\(`encies entre l\*(Aqetiqueta 1 i l\*(Aqetiqueta 2\&. .RE .PP Etiqueta 1 == Etiqueta 2 .RS 4 \fB%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} \fR .sp Mostra els fitxers on l\*(Aqetiqueta 1 i l\*(Aqetiqueta 2 s\('on id\(`entiques\&. .RE .PP Incompletes .RS 4 \fB%{title} igual que "" o %{artist} igual que "" o %{album} igual que "" o %{year} igual que "" o %{tracknumber} igual que "" o %{genre} igual que "" \fR .sp Mostra els fitxers amb valors buits a les etiquetes est\(`andard (t\('itol, artista, \(`album, data, n\('umero de la pe\(,ca, g\(`enere)\&. .RE .PP Cap imatge .RS 4 \fB%{picture} igual que "" \fR .sp Nom\('es mostra els fitxers que no tenen una imatge\&. .RE .PP Marcada .RS 4 \fBno (%{marked} igual que "") \fR .sp Nom\('es mostra els fitxers que estan marcats perqu\(`e violen l\*(Aqest\(`andard ID3, es trenca o la imatge \('es massa gran\&. .RE .PP Filtratge personalitzat .RS 4 Per afegir el vostre propi filtre, seleccioneu aquesta entrada\&. Per exemple, si voleu tenir un filtre per a artistes que comencin amb \(FoEl\(Fc, substitu\(:iu \(FoFiltre personalitzat\(Fc amb el nom \(FoLa banda\(Fc i premeu Retorn\&. Despr\('es inseriu la seg\(:uent expressi\('o a la l\('inia d\*(Aqedici\('o: .sp \fB%{artist} coincideix amb "El\&.*" \fR .sp Despr\('es feu clic a Desa la configuraci\('o\&. Feu clic a Aplica per a filtrar els fitxers\&. Tots els fitxers processats es mostraran a la vista de text, amb un \(Fo+\(Fc per a aquells que coincideixin amb el filtre i un \(Fo\-\(Fc per als altres\&. Quan acabeu, nom\('es es mostraran els fitxers amb un artista que comenci per \(FoEl\(Fc, i el t\('itol de la finestra es marcar\(`a amb \(Fo[filtrada]\(Fc\&. .RE .RE .PP Eines → Converteix ID3 versi\('o 2\&.3 a 2\&.4 .RS 4 Si hi ha etiquetes ID3 versi\('o 2\&.3 en els fitxers seleccionats, es convertiran en etiquetes ID3 versi\('o 2\&.4\&. Els marcs que no estiguin admesos per la TagLib seran descartats\&. Nom\('es es convertiran els fitxers sense canvis i que no s\*(Aqhagin desat\&. .RE .PP Eines → Converteix ID3 versi\('o 2\&.4 a 2\&.3 .RS 4 Si hi ha etiquetes ID3 versi\('o 2\&.4 en els fitxers seleccionats, es convertiran en etiquetes ID3 versi\('o 2\&.3\&. Nom\('es es convertiran els fitxers sense canvis i que no s\*(Aqhagin desat\&. .RE .PP Eines → Reprodueix .RS 4 Obre una barra d\*(Aqeines senzilla per a reproduir els fitxers d\*(Aq\(`audio\&. Cont\('e botons per a les operacions b\(`asiques (Reprodueix/Pausa, Atura la reproducci\('o, Pe\(,ca anterior, Pe\(,ca seg\(:uent, Tanca), controls lliscants per a la posici\('o i el volum, i una vista de la posici\('o actual\&. Si se seleccionen m\('ultiples fitxers, es reproduiran les peces seleccionades\&. En cas contrari, es reproduiran tots els fitxers\&. .sp El temps mostrat es pot alternar entre el temps transcorregut i el temps restant fent clic a la pantalla\&. .RE .SS "El men\('u Arranjament" .PP .PP Arranjament → Mostra la barra d\*(Aqeines .RS 4 Alterna la visualitzaci\('o de la barra d\*(Aqeines\&. .RE .PP Arranjament → Mostra la barra d\*(Aqestat .RS 4 Alterna la visualitzaci\('o de la barra d\*(Aqestat, la qual mostra accions m\('es llargues com obrir o desar una carpeta\&. .RE .PP Arranjament → Mostra la imatge .RS 4 Alterna la visualitzaci\('o de la imatge de vista pr\(`evia per a la car\(`atula de l\*(Aq\(`album\&. .RE .PP Arranjament → Oculta autom\(`aticament les etiquetes .RS 4 Les etiquetes buides s\*(Aqocultaran autom\(`aticament si aquesta opci\('o est\(`a activa\&. Les seccions Fitxer, Etiqueta 1 i Etiqueta 2 es podran contraure i expandir manualment fent clic als botons \-/+ corresponents\&. .RE .PP Arranjament → Configura les dreceres de teclat\&.\&.\&. .RS 4 Obre un di\(`aleg per assignar les dreceres de teclat per a la majoria de les funcions del programa\&. Fins i tot hi ha funcions sense un men\('u o bot\('o corresponent disponible, p\&. ex\&., Fitxer seg\(:uent, Fitxer anterior o Selecciona\-ho tot\&. .RE .PP Arranjament → Configura el Kid3\&.\&.\&. .RS 4 Obre el di\(`aleg de configuraci\('o, el qual consta de p\(`agines per a les etiquetes, fitxers, accions de l\*(Aqusuari i configuraci\('o de xarxa\&. .sp Les opcions espec\('ifiques de les etiquetes es troben a la p\(`agina Etiquetes, la qual est\(`a dividida en quatre pestanyes per a Etiqueta 1, Etiqueta 2, Etiqueta 3 i Totes les etiquetes\&. .sp Si Marca els camps truncats est\(`a marcada, els camps truncats ID3 versi\('o 1\&.1 es marcaran en vermell\&. Els camps de text de les etiquetes ID3 versi\('o 1\&.1 nom\('es poden contenir 30 car\(`acters i el comentari nom\('es 28 car\(`acters\&. A m\('es, el g\(`enere i els n\('umeros de pe\(,ca estan restringits, de manera que els camps es poden truncar quan s\*(Aqimporten o transfereixen des d\*(AqID3 versi\('o 2\&. Els camps truncats i el fitxer es marcaran en vermell, i la marca s\*(Aqeliminar\(`a una vegada s\*(Aqhagi editat el camp\&. .sp Amb la Codificaci\('o del text per a ID3 versi\('o 1 \('es possible establir el joc de car\(`acters utilitzat en les etiquetes ID3 versi\('o 1\&. Se suposa que aquesta codificaci\('o ha de ser ISO\-8859\-1, de manera que es recomana mantenir aquest valor predeterminat\&. No obstant aix\(`o, hi ha etiquetes amb codificacions diferents, de manera que es pot establir aqu\('i i les etiquetes ID3 versi\('o 1 es poden copiar a ID3 versi\('o 2, la qual admet Unicode\&. .sp La casella de selecci\('o Empra el nombre de peces/total del format de les peces controla si el camp del n\('umero de pe\(,ca de les etiquetes ID3 versi\('o 2 cont\('e simplement el n\('umero de pista o, a m\('es, el nombre total de peces a la carpeta\&. .sp Quan Genera com a text en lloc d\*(Aquna cadena num\(`erica est\(`a marcada, tots els g\(`eneres d\*(AqID3 versi\('o 2 s\*(Aqemmagatzemaran com una cadena de text, fins i tot si hi ha un codi corresponent per als g\(`eneres d\*(AqID3 versi\('o 1\&. Si no s\*(Aqestableix aquesta opci\('o, els g\(`eneres per als quals hi ha un codi d\*(AqID3 versi\('o 1 s\*(Aqemmagatzemaran com el n\('umero del codi de g\(`enere (entre par\(`entesis per a ID3 versi\('o 2\&.3)\&. Per tant, el g\(`enere Metal s\*(Aqemmagatzemar\(`a com a \(FoMetal\(Fc o \(Fo(9)\(Fc depenent d\*(Aqaquesta opci\('o\&. Els g\(`eneres que no es trobin a la llista de g\(`eneres ID3 versi\('o 1 sempre s\*(Aqemmagatzemaran com una cadena de text\&. La finalitat d\*(Aqaquesta opci\('o \('es una compatibilitat millorada amb els dispositius que no interpretin correctament els codis de g\(`enere\&. .sp Quan Fitxers WAV amb el bloc id3 en min\('uscules est\(`a marcada, el fragment RIFF utilitzat per emmagatzemar les etiquetes ID3 versi\('o 2 en els fitxers WAV s\*(Aqanomenar\(`a \(Foid3\(Fc en lloc d\*(Aq\(FoID3\(Fc\&. De manera predeterminada, el Kid3 i altres aplicacions que fan servir la TagLib admeten tant la variant en min\('uscules com en maj\('uscules quan llegeixen els fitxers WAV, per\(`o fan servir \(FoID3\(Fc quan escriuen les etiquetes ID3 versi\('o 2 en els fitxers WAV\&. Com a altres aplicacions que nom\('es admeten \(Foid3\(Fc (p\&. ex\&., JRiver Media Center i foobar2000), aquesta opci\('o es pot utilitzar per a crear etiquetes que aquestes aplicacions puguin llegir\&. .sp Quan Marca les infraccions de l\*(Aqest\(`andard est\(`a marcada, els camps ID3 versi\('o 2 que violen l\*(Aqest\(`andard es marcaran en vermell\&. Els detalls sobre la violaci\('o es mostraran en un consell d\*(Aqeina: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Cal que sigui \('unica .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} La l\('inia nova est\(`a prohibida .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El retorn de carro est\(`a prohibit .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El propietari no pot estar buit .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de ser num\(`erica .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de ser num\(`erica o n\('umero/total .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El format \('es DDMM .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El format \('es HHMM .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El format \('es AAAA .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de comen\(,car amb un any i un car\(`acter espacial .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de ser la data/hora en l\*(AqISO 8601 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de ser clau musical, de 3 car\(`acters, \(FoA\-G\(Fc, \(Fob\(Fc, \(Fo#\(Fc, \(Fom\(Fc o \(Foo\(Fc .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de tenir un codi d\*(Aqidioma en l\*(AqISO 639\-2, 3 car\(`acters en min\('uscula .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ha de ser un codi ISRC, 12 car\(`acters en min\('uscula .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} S\*(Aqhan de llistar les cadenes separades per \(Fo|\(Fc .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Hi ha exc\('es en l\*(Aqespai en blanc .RE .sp Els documents de l\*(Aqest\(`andard ID3 estan disponibles en l\('inia: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \m[blue]\fBEtiqueta ID3 versi\('o 2\&.3\&.0\fR\m[]\&\s-2\u[10]\d\s+2 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \m[blue]\fBEtiqueta ID3 versi\('o 2\&.4\&.0: estructura principal\fR\m[]\&\s-2\u[11]\d\s+2 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \m[blue]\fBEtiqueta ID3 versi\('o 2\&.4\&.0: marcs natius\fR\m[]\&\s-2\u[5]\d\s+2 .RE .sp La Codificaci\('o del text defineix la codificaci\('o predeterminada emprada per als marcs ID3 versi\('o 2 i es pot establir en l\*(AqISO\-8859\-1, UTF16 o UTF8\&. L\*(AqUTF8 no \('es v\(`alid per a marcs ID3 versi\('o 2\&.3\&.0\&. Si est\(`a establert, es far\(`a servir UTF16 al seu lloc\&. Per als marcs ID3 versi\('o 2\&.4\&.0, seran possibles les tres codificacions\&. .sp La Versi\('o per a les etiquetes noves: determina si les etiquetes noves ID3 versi\('o 2 es crearan com a versi\('o 2\&.3\&.0 o 2\&.4\&.0\&. .sp Els D\('igits del n\('umero de la pe\(,ca: s\('on la quantitat de d\('igits en els camps de N\('umero de la pe\(,ca\&. Els zeros inicials s\*(Aqempren per omplir\&. Per exemple, amb un valor de 2, la pe\(,ca n\('umero 5 s\*(Aqestablir\(`a com a \(Fo05\(Fc\&. .sp El quadre combinat Nom del camp de comentari: nom\('es \('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, \(FoCOMMENT\(Fc, per exemple, \('es emprat pel XMMS, mentre que l\*(AqAmarok fa servir \(FoDESCRIPTION\(Fc\&. .sp El format de les imatges en els fitxers Ogg/Vorbis est\(`a determinat pel Nom del camp de la imatge:, el qual pot ser \(FoMETADATA_BLOCK_PICTURE\(Fc o \(FoCOVERART\(Fc\&. El primer \('es l\*(Aqest\(`andard oficial i utilitza el mateix format que les imatges en les etiquetes FLAC\&. La \(FoCOVERART\(Fc \('es una forma no oficial anterior d\*(Aqincloure imatges en els comentaris de Vorbis\&. Es pot emprar per a compatibilitat amb els reproductors heretats\&. .sp Si la casella de selecci\('o Marca si \('es m\('es gran que (bytes): est\(`a activada, els fitxers que tinguin incrustada la car\(`atula de l\*(Aq\(`album i que excedeixi la mida indicada en bytes es marcaran en vermell\&. Aix\(`o 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)\&. .sp Els G\(`eneres personalitzats es poden utilitzar per a definir g\(`eneres que no estiguin disponibles a la llista de g\(`eneres est\(`andard, p\&. ex\&., \(FoGothic Metal\(Fc\&. Aquests g\(`eneres personalitzats apareixeran en el quadre combinat G\(`enere de l\*(AqEtiqueta 2\&. Per a les etiquetes ID3 versi\('o 1\&.1, nom\('es es podran emprar els g\(`eneres predefinits\&. .sp La llista de g\(`eneres personalitzats tamb\('e es pot emprar per a reduir la quantitat de g\(`eneres disponibles al quadre combinat G\(`enere als que s\*(Aqutilitzen habitualment\&. Si la vostra col\(mdlecci\('o principalment cont\('e m\('usica en els g\(`eneres Metal, Gothic Metal, Ancient i Hard Rock, podreu introduir aquests g\(`eneres i marcar Mostra nom\('es els g\(`eneres personalitzats\&. El quadre combinat G\(`enere de l\*(AqEtiqueta 2 nom\('es contindr\(`a aquests quatre g\(`eneres i no haur\(`a de cercar\-los a tota la llista\&. En aquest exemple, nom\('es es llistaran Metal i Hard Rock a la llista de l\*(Aqetiqueta 1, perqu\(`e aquestes dues entrades de g\(`eneres personalitzats s\('on g\(`eneres est\(`andard\&. Si Mostra nom\('es els g\(`eneres personalitzats no est\(`a activada, els g\(`eneres personalitzats es podran trobar al final de la llista de g\(`eneres\&. .sp A Marcs personalitzats, es poden definir fins a vuit noms de marc personalitzats, els quals despr\('es es poden utilitzar com els marcs unificats, per exemple, com a marcs d\*(Aqacc\('es r\(`apid\&. .sp Els Marcs d\*(Aqacc\('es r\(`apid defineixen quins tipus de marcs es mostraran sempre a la secci\('o Etiqueta 2\&. Aquests marcs es podran afegir sense fer servir primer el bot\('o Afegeix\&. L\*(Aqordre d\*(Aqaquests marcs d\*(Aqacc\('es r\(`apid es pot canviar arrossegant i deixant anar els elements\&. .sp El quadre combinat Nom de camp del n\('umero de la pe\(,ca: nom\('es \('es rellevant per a la informaci\('o del RIFF i estableix el nom del camp emprat per als n\('umeros de les peces\&. Els n\('umeros de les peces no s\*(Aqespecifiquen en l\*(Aqest\(`andard RIFF original, hi ha aplicacions que fan servir \(FoITRK\(Fc, altres fan servir \(FoIPRT\(Fc\&. .sp El Format de l\*(Aqetiqueta cont\('e opcions per al format de les etiquetes\&. Quan l\*(Aqopci\('o Aplica autom\(`aticament el format est\(`a marcada, s\*(Aqemprar\(`a autom\(`aticament la configuraci\('o del format mentre s\*(Aqediti el text a les l\('inies d\*(Aqedici\('o\&. La Validaci\('o habilita els validadors en els controls amb els valors de pe\(,ca/total i data/hora\&. La Conversi\('o entre maj\('uscules i min\('uscules: es pot establir a Sense canvis, Tot en min\('uscula, Tot en maj\('uscula, Primera lletra en maj\('uscula o Totes les primeres lletres en maj\('uscula\&. Per utilitzar la conversi\('o del reconeixement segons la configuraci\('o regional entre car\(`acters en min\('uscula i maj\('uscula, es pot seleccionar en el quadre combinat a continuaci\('o\&. La llista de substituci\('o de cadenes es pot establir a assignacions arbitr\(`aries de cadenes\&. Per afegir una assignaci\('o nova, seleccioneu la cel\(mdla Des de: d\*(Aquna fila i inseriu el text a substituir, despr\('es aneu a la columna A: i introdu\(:iu el text de substituci\('o\&. Quan el text a substituir comen\(,ca i acaba amb una barra diagonal (\(Fo/\(Fc), s\*(Aqutilitzar\(`a una expressi\('o regular\&. Per a les expressions regulars que contenen grups de captura, les ocurr\(`encies de \e1, \e2, \(Fo\&.\&.\&.\(Fc a A: se substituiran amb la cadena capturada pel grup de captura corresponent\&. Per eliminar una assignaci\('o, establiu la cel\(mdla Des de: un valor buit (p\&. ex\&., escrivint primer un espai i despr\('es la tecla Retroc\('es)\&. Tamb\('e \('es possible inserir i suprimir files fent servir un men\('u contextual que apareixer\(`a quan feu clic amb el bot\('o dret del ratol\('i\&. La substituci\('o nom\('es estar\(`a activa si la casella de selecci\('o Cadena de substituci\('o: est\(`a marcada\&. .sp La taula a Puntuaci\('o cont\('e l\*(Aqassignaci\('o de les estrelles valorades als valors efectius emmagatzemats a l\*(Aqetiqueta\&. Els marcs amb informaci\('o de puntuaci\('o es llisten a la fila Puntuaci\('o de la llista de marcs\&. Per a aquests marcs, la puntuaci\('o es podr\(`a establir donant una quantitat d\*(Aqestrelles de cinc estrelles\&. Els diferents formats d\*(Aqetiqueta i les diferents aplicacions utilitzen diferents valors per assignar la puntuaci\('o d\*(Aqestrelles al valor emmagatzemat a l\*(Aqetiqueta\&. Per mostrar el nombre correcte d\*(Aqestrelles, el Kid3 cercar\(`a un mapa en aquesta taula\&. La clau per a cercar l\*(Aqassignaci\('o ser\(`a el nom del marc, per exemple \(FoRATING\(Fc tal com s\*(Aqempra per als comentaris a Vorbis o \(FoIRTD\(Fc per a la informaci\('o de RIFF\&. Per a les etiquetes ID3 versi\('o 2, s\*(Aqutilitza una clau combinada que consisteix en l\*(AqID del marc \(FoPOPM\(Fc del marc Mesurador de la popularitat i el seu camp \(FoCorreu electr\(`onic\(Fc, separats per un punt\&. Per tant, hi ha diferents claus per a ID3 versi\('o 2, p\&. ex\&., \(FoPOPM\&.Windows Media Player 9 Series\(Fc per a l\*(Aqassignaci\('o emprada pel Windows Media Player i Explorer, i simplement \(FoPOPM\(Fc per als marcs POPM amb un camp \(FoCorreu electr\(`onic\(Fc buit\&. Com poden hi poden haver m\('ultiples entrades per a \(FoPOPM\(Fc, el seu ordre \('es important\&. Quan el Kid3 afegeix un marc nou de Mesurador de la popularitat, utilitzar\(`a la primera entrada \(FoPOPM\(Fc per a determinar el valor que s\*(Aqescriur\(`a al camp \(FoCorreu electr\(`onic\(Fc\&. Aquest valor especificar\(`a l\*(Aqassignaci\('o que s\*(Aqutilitzar\(`a per a la puntuaci\('o d\*(Aqestrelles\&. Tamb\('e s\*(Aqemprar\(`a la primera entrada si no es troba cap clau, per tant, \('es l\*(Aqentrada predeterminada\&. .sp A m\('es de la columna Nom que cont\('e les claus, la taula t\('e les columnes de l\*(Aq1 al 5 per als valors que s\*(Aqemmagatzemaran quan es proporcioni el nombre corresponent d\*(Aqestrelles\&. Al rev\('es, els valors determinaran el nombre d\*(Aqestrelles que es mostraran per al valor emmagatzemat en el marc\&. Per exemple, la fila de la taula a continuaci\('o cont\('e els valors 1, 64, 128, 196 i 255\&. Els llindars per a la quantitat d\*(Aqestrelles que es mostraran es troben entre aquests valors i s\('on compatibles amb el que utilitza el Windows\(rg Explorer\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .B Taula 1. Entrada a la taula de puntuaci\('o .TS allbox tab(:); lB lB lB lB lB lB. T{ Nom T}:T{ 1 T}:T{ 2 T}:T{ 3 T}:T{ 4 T}:T{ 5 T} .T& l l l l l l l l l l l l. T{ POPM T}:T{ 1 T}:T{ 64 T}:T{ 128 T}:T{ 196 T}:T{ 255 T} T{ Interval T}:T{ 1\-31 T}:T{ 32\-95 T}:T{ 96\-159 T}:T{ 160\-223 T}:T{ 224\-255 T} .TE .sp 1 A la p\(`agina Fitxers, la casella de selecci\('o Carrega els \('ultims fitxers oberts es pot marcar de manera que la pr\(`oxima vegada que s\*(Aqobri el Kid3 ho faci amb els \('ultims fitxers seleccionats\&. Es pot marcar Mant\('en la marca de temps del fitxer per a mantenir la marca de temps de modificaci\('o del fitxer\&. Nom de fitxer per a la car\(`atula: estableix el nom que s\*(Aqaconsella quan s\*(Aqexporta una imatge incrustada a un fitxer\&. Amb la Codificaci\('o del text (Exporta, Llista de reproducci\('o) es pot establir la codificaci\('o emprada en escriure els fitxers\&. El Sistema predeterminat es pot canviar, per exemple, si s\*(Aqhan d\*(Aqemprar les llistes de reproducci\('o en un dispositiu diferent\&. .sp Si Marca els canvis est\(`a activa, els camps modificats es marcaran amb un fons d\*(Aqetiqueta en gris clar\&. .sp La secci\('o Llista de fitxers determina quins fitxers es mostraran a la llista de fitxers\&. Es pot utilitzar un Filtre per a restringir els elements d\*(Aqaquesta llista als fitxers amb extensions admeses\&. Per especificar expl\('icitament 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 comod\('i, per exemple */M\('usica/* per incloure nom\('es la carpeta M\('usica, o */iTunes/* per excloure la carpeta iTunes de la llista de fitxers\&. Si s\*(Aqhan d\*(Aqemprar m\('ultiples d\*(Aqaquestes expressions, es podran separar amb espais o punt i coma\&. .sp Els botons Nom del fitxer des de l\*(Aqetiqueta i Etiqueta des del nom de fitxer a la secci\('o Format obriran els di\(`alegs per editar els formats que hi ha disponibles als quadres combinats Format (amb les fletxes amunt i avall), que es poden trobar a la secci\('o Fitxer de la finestra principal\&. .sp El bot\('o Llista de reproducci\('o es pot utilitzar per editar els formats disponibles de noms de fitxer al di\(`aleg Crear una llista de reproducci\('o\&. .sp El Format del nom de fitxer cont\('e opcions per al format dels noms de fitxer\&. Hi ha disponibles les mateixes opcions que en el Format de l\*(Aqetiqueta\&. .sp A m\('es, es pot configurar la Longitud m\(`axima permesa per als noms de fitxer\&. La majoria dels sistemes de fitxers moderns tenen un l\('imit de 255 car\(`acters, per\(`o si voleu escriure fitxers en un CD, haureu d\*(Aqestablir\-la a 64\&. Si es marca Emprar\-ho per als noms de llistes de reproducci\('o i de carpetes, el format del nom de fitxer tamb\('e s\*(Aqemprar\(`a quan es cre\(:in llistes de reproducci\('o i es reanomenin carpetes\&. .sp La p\(`agina Accions de l\*(Aqusuari cont\('e una taula amb les ordres que hi ha disponibles al men\('u contextual de la llista de fitxers\&. Per a operacions cr\('itiques com suprimir fitxers, \('es recomanable marcar Confirma perqu\(`e aparegui un di\(`aleg de confirmaci\('o abans d\*(Aqexecutar l\*(Aqordre\&. La Sortida es pot marcar per a veure la sortida escrita per les ordres de la consola (sortida est\(`andard i d\*(Aqerror est\(`andard)\&. El Nom \('es el nom que es mostra en el men\('u contextual\&. L\*(AqOrdre \('es la l\('inia d\*(Aqordres que s\*(Aqexecutar\(`a\&. Es poden passar els arguments utilitzant els seg\(:uents codis: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %F %{files} Camins de fitxer (una llista si hi ha seleccionats m\('ultiples fitxers) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %f %{file} Cam\('i de fitxer a un \('unic fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %uF %{urls} Els URL (una llista si hi ha seleccionats m\('ultiples fitxers) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %uf %{url} URL a un \('unic fitxer .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %d %{directory} Carpeta .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %s %{title} T\('itol (can\(,c\('o) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %a %{artist} Artista .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %l %{album} \(`Album .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %c %{comment} Comentari .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %y %{year} Any .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track} Pe\(,ca (p\&. ex\&., 01) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %t %{track\&.n} Pe\(,ca amb l\*(Aqamplada del camp \(Fon\(Fc (p\&. ex\&., 001 per a %{track\&.3}) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %T %{tracknumber} Pe\(,ca (sense zeros a l\*(Aqesquerra, p\&. ex\&., 1) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %g %{genre} G\(`enere .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %b %{browser} Ordre per iniciar el navegador web .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} %q %{qmlpath} Carpeta base dels fitxers QML proporcionats .RE .sp El codi especial \fB@separator\fR es pot establir com una ordre per inserir un separador al men\('u contextual de les accions de l\*(Aqusuari\&. Els elements de men\('u es poden posar en un submen\('u tancat amb les ordres \fB@beginmenu\fR i \fB@endmenu\fR\&. El nom del submen\('u est\(`a determinat per la columna Nom de l\*(Aqordre \fB@beginmenu\fR\&. .sp Per executar scripts QML, s\*(Aqutilitza \fB@qml\fR com a nom de l\*(Aqordre\&. El cam\('i cap a l\*(Aqscript QML es passa com un par\(`ametre\&. Els scripts proporcionats es troben a la carpeta %{qmlpath}/script/ (a Linux\(rg t\('ipicament /usr/share/kid3/qml/script/, a Windows qml/script/ dins de la carpeta d\*(Aqinstal\(mdlaci\('o i a macOS\(rg a la carpeta de l\*(Aqaplicaci\('o 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\*(Aqutilitzar\(`a \fB@qmlview\fR en lloc de \fB@qml\fR\&. Es passaran par\(`ametres addicionals a l\*(Aqscript QML i estaran disponibles mitjan\(,cant la funci\('o \fBgetArguments()\fR\&. Trobareu una descripci\('o general d\*(Aqalgunes funcions i propietats que hi ha disponibles al QML a la secci\('o Interf\('icie QML de l\*(Aqap\(`endix\&. .sp L\*(Aqordre que s\*(Aqinserir\(`a amb %{browser} es podr\(`a definir a l\*(Aqanterior l\('inia d\*(Aqedici\('o del Navegador web\&. Les ordres que comencin amb %{browser} es podran emprar per obtenir informaci\('o sobre els fitxers d\*(Aq\(`audio del web, per exemple .sp .if n \{\ .RS 4 .\} .nf \fB%{browser} http://lyricwiki\&.org/%u{artist}:%u{title}\fR .fi .if n \{\ .RE .\} .sp consultar\(`a la lletra per a la can\(,c\('o actual a \m[blue]\fBLyricWiki\fR\m[]\&\s-2\u[12]\d\s+2\&. La \(Fou\(Fc a %u{artist} i %u{title} s\*(Aqutilitza per a codificar a l\*(AqURL la informaci\('o de l\*(Aqartista %{artist} i la can\(,c\('o %{title}\&. \('Es f\(`acil definir les vostres pr\(`opies consultes de la mateixa manera, p\&. ex\&., una cerca d\*(Aqimatges amb \m[blue]\fBGoogle\fR\m[]\&\s-2\u[13]\d\s+2: .sp .if n \{\ .RS 4 .\} .nf \fB%{browser} http://images\&.google\&.com/images?q=%u{artist}%20%u{album}\fR .fi .if n \{\ .RE .\} .sp Per afegir la car\(`atula de l\*(Aq\(`album a l\*(Aqetiqueta 2, podreu cercar imatges amb Google o Amazon utilitzant les ordres descrites anteriorment\&. La imatge es podr\(`a afegir a l\*(Aqetiqueta arrossegant i deixant anar\&. Tamb\('e podreu afegir una imatge amb Afegeix, despr\('es seleccioneu el Marc de la imatge i importeu un fitxer d\*(Aqimatge o enganxeu\-lo des del porta\-retalls\&. Els marcs d\*(Aqimatge estan admesos per les etiquetes ID3 versi\('o 2, MP4, FLAC, Ogg i ASF\&. .sp Per afegir i suprimir entrades a la taula, es pot emprar un men\('u contextual\&. .sp La p\(`agina Xarxa nom\('es cont\('e un camp per a inserir l\*(Aqadre\(,ca de l\*(Aqintermediari i, de manera opcional, el port, separat per dos punts\&. El servidor intermediari s\*(Aqutilitzar\(`a en importar des d\*(Aqun servidor d\*(AqInternet quan la casella de selecci\('o estigui marcada\&. .sp A la p\(`agina Connectors, els connectors disponibles es podran habilitar o inhabilitar\&. Els connectors estan separats en dues seccions\&. La llista Connectors de metadades i prioritat cont\('e els connectors que admeten formats de fitxers d\*(Aq\(`audio\&. L\*(Aqordre dels connectors \('es important perqu\(`e es proven de dalt a baix\&. Alguns formats s\('on admesos per m\('ultiples connectors, de manera que els fitxers s\*(Aqobriran amb el primer connector que l\*(Aqadmeti\&. El TaglibMetadata admet la majoria dels formats, si es troba a la part superior de la llista, obrir\(`a la majoria dels fitxers\&. Si voleu utilitzar un connector diferent per a un format de fitxer, comproveu que aparegui abans d\*(Aqaquest\&. Els detalls sobre el connector de metadades i perqu\(`e \('es possible que vulgueu utilitzar\-los en lloc de la TagLib es llisten a continuaci\('o\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Id3libMetadata: utilitza la \m[blue]\fBid3lib\fR\m[]\&\s-2\u[14]\d\s+2 per a les etiquetes ID3 versi\('o 1\&.1 i 2\&.3 en els fitxers MP3, MP2 i AAC\&. Admet alguns tipus de marcs m\('es que la TagLib\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} OggFlacMetadata: utilitza les \m[blue]\fBlibogg\fR\m[]\&\s-2\u[15]\d\s+2, \m[blue]\fBlibvorbis i libvorbisfile\fR\m[]\&\s-2\u[16]\d\s+2 per als fitxers Ogg, i addicionalment les \m[blue]\fBlibFLAC++ i libFLAC\fR\m[]\&\s-2\u[17]\d\s+2 per als fitxers FLAC\&. Aquestes s\('on les biblioteques oficials per a aquests formats\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} TaglibMetadata: utilitza la \m[blue]\fBTagLib\fR\m[]\&\s-2\u[18]\d\s+2, la qual admet molts formats de fitxers d\*(Aq\(`audio\&. Es pot fer servir per a tots els fitxers d\*(Aq\(`audio admesos pel Kid3\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Mp4v2Metadata: la \m[blue]\fBmp4v2\fR\m[]\&\s-2\u[19]\d\s+2 va ser utilitzada originalment pel Kid3 per admetre els fitxers M4A\&. Es pot utilitzar en cas de problemes amb el suport M4A de la TagLib\&. .RE .sp La secci\('o Connectors disponibles llista els connectors restants\&. El seu ordre no \('es important, per\(`o es poden habilitar o inhabilitar mitjan\(,cant les caselles de selecci\('o\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} AmazonImport: utilitzat per a la funci\('o Importa des d\*(AqAmazon\&.\&.\&.\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} DiscogsImport: utilitzat per a la funci\('o Importa des de Discogs\&.\&.\&.\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} FreedbImport: emprat per a la funci\('o Importa des de gnudb\&.org\&.\&.\&.\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} MusicBrainzImport: utilitzat per a la funci\('o Importa des del Llan\(,cament de MusicBrainz\&.\&.\&.\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} AcoustidImport: utilitzat per a la funci\('o Importa des de l\*(AqEmpremta digital de MusicBrainz\&.\&.\&., la que dep\(`en de les biblioteques \m[blue]\fBChromaprint\fR\m[]\&\s-2\u[20]\d\s+2 i \m[blue]\fBlibav\fR\m[]\&\s-2\u[21]\d\s+2\&. .RE .sp Els connectors que estiguin inhabilitats no es carregaran\&. Aix\(`o es pot utilitzar per optimitzar l\*(Aq\('us dels recursos i el temps d\*(Aqinici\&. La configuraci\('o d\*(Aqaquesta p\(`agina nom\('es tindr\(`a efecte despr\('es de reiniciar el Kid3\&. .RE .SS "El men\('u Ajuda" .PP .PP Ajuda → Manual del Kid3 .RS 4 Obre aquest manual\&. .RE .PP Ajuda → Quant al Kid3 .RS 4 Mostra la informaci\('o curta sobre el Kid3\&. .RE .SH "KID3\-CLI" .SS "Ordres" .PP El \fBkid3\-cli\fR ofereix una interf\('icie de l\('inia d\*(Aqordres per al Kid3\&. Si s\*(Aqutilitza un cam\('i de carpeta, s\*(Aqobrir\(`a la carpeta\&. Si es proporcionen un o m\('es camins de fitxer, s\*(Aqobrir\(`a la carpeta comuna i se seleccionaran els fitxers\&. Les ordres posteriors treballaran sobre aquests fitxers\&. Les ordres s\*(Aqespecifiquen emprant les opcions \fB\-c\fR\&. Si es passen m\('ultiples ordres, s\*(Aqexecutaran en l\*(Aqordre indicat\&. Si les ordres modifiquen els fitxers, es desaran en finalitzar\&. Si no passen opcions d\*(Aqordre, el \fBkid3\-cli\fR s\*(Aqiniciar\(`a en el mode interactiu\&. Es poden introduir ordres i operaran sobre la selecci\('o actual\&. Les seg\(:uents seccions llisten totes les ordres disponibles\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAjuda\fR .RS 4 .HP \w'\fBhelp\fR\ 'u \fBhelp\fR [\fINOM_ORDRE\fR] .PP Mostrar\(`a l\*(Aqajuda sobre els par\(`ametres de \fINOM_ORDRE\fR o sobre totes les ordres si no es proporciona cap nom\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBTemps d'espera\fR .RS 4 .HP \w'\fBtimeout\fR\ 'u \fBtimeout\fR [default | off | \fITEMPS\fR] .PP Se sobreescriur\(`a el temps d\*(Aqespera predeterminat de l\*(Aqordre\&. Les ordres de la CLI s\*(Aqinterrompran despr\('es d\*(Aqun temps d\*(Aqespera espec\('ific en el qual expirar\(`a una ordre\&. Aquest temps d\*(Aqespera \('es de 10 segons per a \fBls\fR i \fBalbumart\fR, 60 segons per a \fBautoimport\fR i \fBfilter\fR, i 3 segons per a totes les altres ordres\&. Si s\*(Aqha de processar una gran quantitat de fitxers, aquests temps d\*(Aqespera podrien ser massa restrictius, per tant, el temps d\*(Aqespera per a totes les ordres es podr\(`a establir en \fITEMPS\fR ms, no pensar\-hi o deixar\-ho en els valors predeterminats\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSortir de l'aplicaci\('o\fR .RS 4 .HP \w'\fBexit\fR\ 'u \fBexit\fR [force] .PP Sortir\(`a de l\*(Aqaplicaci\('o\&. Si hi ha fitxers sense desar que han estat modificats, es requerir\(`a el par\(`ametre \fIforce\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCanviar de carpeta\fR .RS 4 .HP \w'\fBcd\fR\ 'u \fBcd\fR [\fICARPETA\fR] .PP Si no es proporciona la \fICARPETA\fR, es canviar\(`a a la carpeta d\*(Aqinici\&. Si es proporciona una carpeta, es canviar\(`a a dins de la carpeta\&. Si es proporcionen un o m\('es camins de fitxer, es canviar\(`a a la seva carpeta comuna i se seleccionaran els fitxers\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImprimir el nom de fitxer de la carpeta de treball actual\fR .RS 4 .HP \w'\fBpwd\fR\ 'u \fBpwd\fR .PP Imprimir\(`a el nom de fitxer de la carpeta de treball actual\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBLlistar les carpetes\fR .RS 4 .HP \w'\fBls\fR\ 'u \fBls\fR .PP Llistar\(`a el contingut de la carpeta actual\&. Aix\(`o correspon a la llista de fitxers a la IGU del Kid3\&. Cinc car\(`acters abans dels noms de fitxer es mostrar\(`a l\*(Aqestat del fitxer\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} > El fitxer est\(`a seleccionat\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} * El fitxer est\(`a modificat\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El fitxer 1 t\('e una etiqueta 1, en cas contrari es mostrar\(`a \(Fo\-\(Fc\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El fitxer 2 t\('e una etiqueta 2, en cas contrari es mostrar\(`a \(Fo\-\(Fc\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} El fitxer 3 t\('e una etiqueta 3, en cas contrari es mostrar\(`a \(Fo\-\(Fc\&. .RE .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBls\fR 1\-\- 01 Intro\&.mp3 > 12\- 02 We Only Got This One\&.mp3 *1\-\- 03 Outro\&.mp3 .fi .if n \{\ .RE .\} .PP En aquest exemple, tots els fitxers tenen una etiqueta 1, el segon fitxer tamb\('e t\('e una etiqueta 2 i est\(`a seleccionat\&. El tercer fitxer ser\(`a el modificat\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDesar els fitxers canviats\fR .RS 4 .HP \w'\fBsave\fR\ 'u \fBsave\fR .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar un fitxer\fR .RS 4 .HP \w'\fBselect\fR\ 'u \fBselect\fR [all | none | first | previous | next | \fIFITXER\fR...] .PP Per a seleccionar tots els fitxers, introdu\(:iu \fBselect all\fR, per a desseleccionar tots els fitxers, introdu\(:iu \fBselect none\fR\&. Per a rec\('orrer els fitxers a la carpeta actual comenceu amb \fBselect first\fR, despr\('es aneu endavant emprant \fBselect next\fR o cap enrere emprant \fBselect previous\fR\&. Es poden afegir fitxers espec\('ifics a la selecci\('o actual indicant els seus noms de fitxer\&. S\('on possibles els comodins, de manera que \fBselect *\&.mp3\fR seleccionar\(`a tots els fitxers MP3 a la carpeta actual\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBselect first\fR kid3\-cli> \fBls\fR > 1\-\- 01 Intro\&.mp3 12\- 02 We Only Got This One\&.mp3 *1\-\- 03 Outro\&.mp3 kid3\-cli> \fBselect next\fR kid3\-cli> \fBls\fR 1\-\- 01 Intro\&.mp3 > 12\- 02 We Only Got This One\&.mp3 *1\-\- 03 Outro\&.mp3 kid3\-cli> \fBselect *\&.mp3\fR kid3\-cli> \fBls\fR > 1\-\- 01 Intro\&.mp3 > 12\- 02 We Only Got This One\&.mp3 >*1\-\- 03 Outro\&.mp3 .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar una etiqueta\fR .RS 4 .HP \w'\fBtag\fR\ 'u \fBtag\fR [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Moltes ordres tenen un par\(`ametre opcional \fIN\('UMEROS_D\*(AqETIQUETA\fR, el qual especifica si l\*(Aqordre operar\(`a sobre l\*(Aqetiqueta 1, 2 o 3\&. Si s\*(Aqomet aquest par\(`ametre, s\*(Aqutilitzaran els n\('umeros d\*(Aqetiqueta predeterminats, els quals es poden establir mitjan\(,cant aquesta ordre\&. A l\*(Aqinici, s\*(Aqestableix a 12, el qual vol dir que la informaci\('o es llegir\(`a de l\*(Aqetiqueta 2, si est\(`a disponible, en cas contrari, de l\*(Aqetiqueta 1, les modificacions es realitzaran a l\*(Aqetiqueta 2\&. Els \fB\fIN\('UMEROS_D\*(AqETIQUETA\fR\fR es poden establir a \fB1\fR, \fB2\fR o \fB3\fR per a nom\('es operar sobre l\*(Aqetiqueta corresponent\&. Si s\*(Aqomet el par\(`ametre, es mostrar\(`a l\*(Aqopci\('o de configuraci\('o actual\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir un marc d'etiqueta\fR .RS 4 .HP \w'\fBget\fR\ 'u \fBget\fR [all | \fINOM_MARC\fR] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Aquesta ordre es pot emprar per a llegir el valor d\*(Aqun marc d\*(Aqetiqueta espec\('ific o obtenir informaci\('o sobre tots els marcs d\*(Aqetiqueta (si s\*(Aqomet l\*(Aqargument o s\*(Aqutilitza \fBall\fR)\&. Els marcs modificats seran marcats amb un \(Fo*\(Fc\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBget\fR File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo Name: 01 Intro\&.mp3 Tag 1: ID3v1\&.1 Title Intro Artist Llu\('is Llach Album I si canto trist Date 1974 Track Number 1 Genre Lied kid3\-cli> \fBget title\fR Intro .fi .if n \{\ .RE .\} .PP Per a desar a un fitxer el contingut d\*(Aqun marc d\*(Aqimatge, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBget picture:\*(Aq/cam\('i/a/carpeta\&.jpg\*(Aq\fR .fi .if n \{\ .RE .\} .PP Per a desar una lletra sincronitzada en un fitxer LRC, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBget SYLT:\*(Aq/cam\('i/a/lletra\&.lrc\*(Aq\fR .fi .if n \{\ .RE .\} .PP \('Es possible obtenir nom\('es un camp espec\('ific des d\*(Aqun marc, per exemple, \fBget POPM\&.Email\fR per al camp Correu electr\(`onic d\*(Aqun marc Mesurador de la popularitat\&. Si un fitxer t\('e m\('ultiples marcs del mateix tipus, els diferents marcs es podran indexar amb par\(`entesis, per exemple, el primer int\(`erpret d\*(Aqun comentari de Vorbis es pot recuperar emprant \fBget performer[0]\fR, el segon emprant \fBget performer[1]\fR\&. .PP El nom del pseudocamp \(Foseleccionada\(Fc es pot fer servir per a comprovar si s\*(Aqha seleccionat un marc, per exemple, \fBget artist\&.selected\fR retornar\(`a 1 si est\(`a seleccionat el marc de l\*(Aqartista, en cas contrari 0\&. .PP Es pot utilitzar el nom del pseudomarc \(Foratingstars\(Fc per a obtenir el valor del marc \(Forating\(Fc com a valor del format espec\('ific corresponent al nombre d\*(Aqestrelles (0 a 5)\&. En usar el \(Forating\(Fc, es retorna el valor intern\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir un marc d'etiqueta\fR .RS 4 .HP \w'\fBset\fR\ 'u \fBset\fR {\fINOM_MARC\fR} {\fIVALOR_MARC\fR} [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Aquesta ordre estableix el valor d\*(Aqun marc d\*(Aqetiqueta espec\('ific\&. Si \fIVALOR_MARC\fR est\(`a buit, se suprimir\(`a el marc\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBset remixer \*(AqI si canto trist\*(Aq\fR .fi .if n \{\ .RE .\} .PP Per establir des d\*(Aqun fitxer el contingut d\*(Aqun marc d\*(Aqimatge, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBset picture:\*(Aq/cam\('i/a/carpeta\&.jpg\*(Aq \*(AqDescripci\('o de la imatge\*(Aq\fR .fi .if n \{\ .RE .\} .PP Per establir una lletra sincronitzada en un fitxer LRC, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBset SYLT:\*(Aq/cam\('i/a/lletra\&.lrc\*(Aq \*(AqDescripci\('o de la lletra\*(Aq\fR .fi .if n \{\ .RE .\} .PP Per establir un camp espec\('ific d\*(Aqun marc, el nom del camp es podr\(`a indicar despr\('es d\*(Aqun punt, p\&. ex\&., per establir el camp Comptador d\*(Aqun marc Mesurador de la popularitat, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBset POPM\&.Counter 5\fR .fi .if n \{\ .RE .\} .PP Una aplicaci\('o per a especificacions de camp \('es el cas en el qual voldreu un marc TXXX personalitzat amb una descripci\('o de \(Forating\(Fc en lloc d\*(Aqun marc Mesurador de la popularitat est\(`andard (alguns connectors semblen utilitzar\-lo)\&. Podreu crear\-lo com un marc de puntuaci\('o TXXX amb el \fBkid3\-cli\fR, per\(`o, primer haureu de crear un marc TXXX amb la descripci\('o \(Forating\(Fc i despr\('es establir el valor d\*(Aqaquest marc al valor de la puntuaci\('o\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBset rating ""\fR kid3\-cli> \fBset TXXX\&.Description rating\fR kid3\-cli> \fBset rating 5\fR .fi .if n \{\ .RE .\} .sp La primera ordre suprimir\(`a un marc POPM existent, perqu\(`e si existeix, \fBset rating 5\fR establir\(`a el marc POPM i no el marc TXXX\&. Una altra possibilitat seria utilitzar \fBset TXXX\&.Text 5\fR, per\(`o aix\(`o nom\('es funcionar\(`a si no hi ha un altre marc TXXX present\&. .PP Per establir m\('ultiples marcs del mateix tipus, es pot indicar un \('index entre par\(`entesis, p\&. ex\&., per a establir m\('ultiples int\(`erprets en un comentari de Vorbis, utilitzeu .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBset performer[0] \*(AqLiza don Getti (soprano)\*(Aq\fR kid3\-cli> \fBset performer[1] \*(AqJoe Barr (piano)\*(Aq\fR .fi .if n \{\ .RE .\} .PP Per a seleccionar certs marcs abans d\*(Aquna acci\('o de copia, enganxa o elimina, es pot emprar el nom del pseudocamp \(Foseleccionada\(Fc\&. Normalment, se seleccionaran tots els marcs, per a desseleccionar\-los empreu \fBset \*(Aq*\&.selected\*(Aq 0\fR, despr\('es, per exemple, \fBset artist\&.selected 1\fR per a seleccionar el marc de l\*(Aqartista\&. .PP Es pot utilitzar el nom del pseudomarc \(Foratingstars\(Fc per a establir el valor del marc \(Forating\(Fc com a valor del format espec\('ific corresponent al nombre d\*(Aqestrelles (0 a 5)\&. Es pot usar el nom de marc \(Forating\(Fc per a establir el valor intern\&. .PP Establir \(Foratingstars\(Fc en diversos fitxers que tinguin formats diferents d\*(Aqetiqueta no funcionar\(`a perqu\(`e el marc amb el valor mapat del comptador d\*(Aqestrelles es crea en el primer fitxer i despr\('es s\*(Aqutilitza per a tots els fitxers\&. Aix\('i que en lloc de \fBkid3\-cli \-c "set ratingstars 2" *\fR cal usar \fBfor f in *; do kid3\-cli \-c "set ratingstars 2" "$f"; done\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBRevertir\fR .RS 4 .HP \w'\fBrevert\fR\ 'u \fBrevert\fR .PP Revertir totes les modificacions en els fitxers seleccionats (o tots els fitxers si no hi ha fitxers seleccionats)\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImportar des del fitxer\fR .RS 4 .HP \w'\fBimport\fR\ 'u \fBimport\fR {\fIFITXER\fR} {\fINOM_FORMAT\fR} [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Les etiquetes s\*(Aqimporten des del \fIFITXER\fR en el format amb el nom \fINOM_FORMAT\fR (p\&. ex\&., \fB"CSV unquoted"\fR, vegeu Importar)\&. .PP Si s\*(Aqindiquen etiquetes (\fBtags\fR) per a \fIFITXER\fR, les etiquetes seran importades des d\*(Aqaltres etiquetes\&. En lloc dels par\(`ametres \fINOM_FORMAT\fR, \fIFONT\fR i \fIEXTRACCI\('O\fR els quals s\('on obligatoris, vegeu Importar des de les etiquetes\&. Per aplicar la importaci\('o des de les etiquetes en els fitxers seleccionats, utilitzeu \fBtagsel\fR en lloc de \fBtags\fR\&. Aquesta funci\('o tamb\('e admet la sortida del valor extret mitjan\(,cant l\*(Aq\('us d\*(Aquna \fBEXTRACCI\('O\fR amb el valor \fB%{__return}(\&.+)\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImportar autom\(`aticament\fR .RS 4 .HP \w'\fBautoimport\fR\ 'u \fBautoimport\fR [\fINOM_PERFIL\fR] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Importar\(`a per lots utilitzant el \fINOM_PERFIL\fR (vegeu Importar autom\(`aticament, si s\*(Aqutilitza \fB"All"\fR ser\(`a om\(`es)\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDescarregar el treball art\('istic de la car\(`atula de l'\(`album\fR .RS 4 .HP \w'\fBalbumart\fR\ 'u \fBalbumart\fR {\fIURL\fR} [all] .PP Establir\(`a la car\(`atula de l\*(Aq\(`album descarregant una imatge des de l\*(Aq\fIURL\fR\&. Les regles definides al di\(`aleg Explora les car\(`atules\&.\&.\&. s\*(Aqutilitzen per a transformar els URL generals (p\&. ex\&., des d\*(AqAmazon) en un URL de la imatge\&. Per a establir la car\(`atula de l\*(Aq\(`album a partir d\*(Aqun fitxer d\*(Aqimatge local, utilitzeu l\*(Aqordre set\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBalbumart http://www\&.amazon\&.com/Versus\-World\-Amon\-Amarth/dp/B000078DOC\fR .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBExportar a un fitxer\fR .RS 4 .HP \w'\fBexport\fR\ 'u \fBexport\fR {\fIFITXER\fR} {\fINOM_FORMAT\fR} [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Les etiquetes s\*(Aqexportaran al \fIFITXER\fR en el format amb el nom \fINOM_FORMAT\fR (p\&. ex\&., \fB"CSV unquoted"\fR, vegeu Exportar)\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCrear una llista de reproducci\('o\fR .RS 4 .HP \w'\fBplaylist\fR\ 'u \fBplaylist\fR .PP Crear una llista de reproducci\('o en el format establert a la configuraci\('o, vegeu Crear una llista de reproducci\('o\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar el format per al nom de fitxer\fR .RS 4 .HP \w'\fBfilenameformat\fR\ 'u \fBfilenameformat\fR .PP Aplicar el format per al nom de fitxer establert a la configuraci\('o, vegeu Aplicar el format per al nom de fitxer\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar el format per a l'etiqueta\fR .RS 4 .HP \w'\fBtagformat\fR\ 'u \fBtagformat\fR .PP Aplicar el format per al nom de l\*(Aqetiqueta establert a la configuraci\('o, vegeu Aplicar el format per a l\*(Aqetiqueta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar la codificaci\('o del text\fR .RS 4 .HP \w'\fBtextencoding\fR\ 'u \fBtextencoding\fR .PP Aplica la codificaci\('o de text establert en la configuraci\('o, vegeu Aplicar la codificaci\('o de text\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBReanomenar una carpeta\fR .RS 4 .HP \w'\fBrenamedir\fR\ 'u \fBrenamedir\fR [\fIFORMAT\fR] [create | rename | dryrun] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Canviar\(`a el nom o crear\(`a carpetes a partir dels valors en les etiquetes d\*(Aqacord amb un \fIFORMAT\fR indicat (p\&. ex\&., \fB%{artist} \- %{album}\fR, vegeu Canviar el nom d\*(Aquna carpeta), si no s\*(Aqindica un format, s\*(Aqutilitzar\(`a el format definit al di\(`aleg Reanomena la carpeta\&. El mode predeterminat \('es \fBrename\fR (canvia el nom)\&. Per a crear carpetes, s\*(Aqhaur\(`a d\*(Aqindicar \fBcreate\fR expl\('icitament\&. Les accions de canvi de nom es realitzaran immediatament, per a veure qu\(`e es faria, utilitzeu l\*(Aqopci\('o \fBdryrun\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNombre de peces\fR .RS 4 .HP \w'\fBnumbertracks\fR\ 'u \fBnumbertracks\fR [\fIN\('UMERO_PE\(,CA\fR] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Numera les peces seleccionades comen\(,cant amb \fIN\('UMERO_PE\(,CA\fR (1 si s\*(Aqomet)\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBFiltrar\fR .RS 4 .HP \w'\fBfilter\fR\ 'u \fBfilter\fR [\fINOM_FILTRE\fR | \fIFORMAT_FILTRE\fR] .PP Filtrar\(`a els fitxers de manera que nom\('es siguin visibles els fitxers que coincideixin amb \fIFORMAT_FILTRE\fR\&. Es podr\(`a utilitzar el nom d\*(Aquna expressi\('o de filtre predefinit (p\&. ex\&., \fB"Filename Tag Mismatch"\fR) en lloc d\*(Aquna expressi\('o de filtre, consulteu Filtre\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fBfilter \*(Aq%{title} contains "tro"\*(Aq\fR Started /home/urs/One Hit Wonder \- Let\*(Aqs Tag + 01 Intro\&.mp3 \- 02 We Only Got This One\&.mp3 + 03 Outro\&.mp3 Finished kid3\-cli> \fBls\fR 1\-\- 01 Intro\&.mp3 1\-\- 03 Outro\&.mp3 kid3\-cli> \fBfilter All\fR Started /home/urs/One Hit Wonder \- Let\*(Aqs Tag + 01 Intro\&.mp3 + 02 We Only Got This One\&.mp3 + 03 Outro\&.mp3 Finished kid3\-cli> \fBls\fR 1\-\- 01 Intro\&.mp3 12\- 02 We Only Got This One\&.mp3 1\-\- 03 Outro\&.mp3 .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConvertir des d'ID3 versi\('o 2.3 a 2.4\fR .RS 4 .HP \w'\fBto24\fR\ 'u \fBto24\fR .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConvertir des d'ID3 versi\('o 2.4 a 2.3\fR .RS 4 .HP \w'\fBto23\fR\ 'u \fBto23\fR .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNom del fitxer des de l'etiqueta\fR .RS 4 .HP \w'\fBfromtag\fR\ 'u \fBfromtag\fR [\fIFORMAT\fR] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Estableix els noms dels fitxers seleccionats a partir dels valors trobats en les etiquetes, per exemple, \fBfromtag \*(Aq%{track} \- %{title}\*(Aq 1\fR\&. Si no s\*(Aqespecifica cap format, s\*(Aqutilitzar\(`a el format establert a la IGU\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEtiquetar des del nom de fitxer\fR .RS 4 .HP \w'\fBtotag\fR\ 'u \fBtotag\fR [\fIFORMAT\fR] [\fIN\('UMEROS_D\*(AqETIQUETA\fR] .PP Estableix els marcs d\*(Aqetiqueta a partir dels noms de fitxer, per exemple, \fBtotag \*(Aq%{albumartist} \- %{album}/%{track} %{title}\*(Aq 2\fR\&. Si no s\*(Aqespecifica cap format, s\*(Aqutilitzar\(`a el format establert a la IGU\&. Si el format per al nom de fitxer no coincideix amb aquest patr\('o, s\*(Aqintentaran alguns altres formats d\*(Aq\('us habitual\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEtiquetar a una altra etiqueta\fR .RS 4 .HP \w'\fBsyncto\fR\ 'u \fBsyncto\fR {\fIN\('UMERO_ETIQUETA\fR} .PP Copia els marcs d\*(Aqetiqueta des d\*(Aquna etiqueta a l\*(Aqaltra etiqueta, p\&. ex\&., per a establir l\*(Aqetiqueta ID3 versi\('o 2 a partir de l\*(Aqetiqueta ID3 versi\('o 1, utilitzeu \fBsyncto 2\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCopiar\fR .RS 4 .HP \w'\fBcopy\fR\ 'u \fBcopy\fR [\fIN\('UMERO_ETIQUETA\fR] .PP Copia els marcs d\*(Aqetiqueta des del fitxer seleccionat a la mem\(`oria interm\(`edia de copiar interna\&. Despr\('es es podran establir en un altre fitxer utilitzant l\*(Aqordre \fBpaste\fR (enganxa)\&. .PP Per a copiar nom\('es un subconjunt de marcs, utilitzeu el pseudocamp \(Foseleccionada\(Fc amb l\*(Aqordre \fBset\fR\&. Per exemple, per a copiar nom\('es els marcs n\('umero del disc i drets d\*(Aqautor, utilitzeu .sp .if n \{\ .RS 4 .\} .nf \fBset \*(Aq*\&.selected\*(Aq 0\fR \fBset discnumber\&.selected 1\fR \fBset copyright\&.selected 1\fR \fBcopy\fR .fi .if n \{\ .RE .\} .sp .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEnganxar\fR .RS 4 .HP \w'\fBpaste\fR\ 'u \fBpaste\fR [\fIN\('UMERO_ETIQUETA\fR] .PP Estableix els marcs d\*(Aqetiqueta a partir del contingut de la mem\(`oria interm\(`edia \fBcopy\fR en els fitxers seleccionats\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEliminar\fR .RS 4 .HP \w'\fBremove\fR\ 'u \fBremove\fR [\fIN\('UMERO_ETIQUETA\fR] .PP Elimina una etiqueta\&. .PP \('Es possible eliminar nom\('es un subconjunt de marcs seleccionant\-los com es descriu en l\*(Aqordre \fBcopy\fR\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConfigurar el Kid3\fR .RS 4 .HP \w'\fBconfig\fR\ 'u \fBconfig\fR [\fIOPCI\('O\fR] [\fIVALOR\fR] .PP Consulta o estableix una opci\('o de configuraci\('o\&. .PP L\*(Aq\fIOPCI\('O\fR consta d\*(Aqun nom de grup i un nom de propietat separats per un punt\&. Quan no es dona cap \fIOPCI\('O\fR, es mostraran tots els grups disponibles\&. Si nom\('es es proporciona un nom de grup, es mostraran totes les propietats disponibles del grup\&. Per a un grup i propietat determinats, es mostrar\(`a el valor configurat actualment\&. Per a canviar l\*(Aqopci\('o de configuraci\('o, el nou valor es pot passar com a un segon argument\&. .PP Si el valor d\*(Aquna opci\('o de configuraci\('o \('es una llista, tots els elements de la llista s\*(Aqhauran de proporcionar com a arguments\&. Aix\(`o vol dir que per a afegir un element a una llista existent d\*(Aqelements, tots els elements existents s\*(Aqhauran de passar seguits de l\*(Aqelement nou\&. En aquesta situaci\('o, \('es m\('es f\(`acil utilitzar el mode JSON, on la llista actual es pot copiar amb el nou element afegit\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBExecuta el programa o script en QML\fR .RS 4 .HP \w'\fBexecute\fR\ 'u \fBexecute\fR [@qml] {\fIFITXER\fR} [\fIARGUMENTS\fR] .PP Executa un script en QML o un executable\&. .PP Sense \fB@qml\fR un programa s\*(Aqexecuta amb arguments\&. Quan s\*(Aqindica \fB@qml\fR com a primer argument, els arguments seg\(:uents seran l\*(Aqscript en QML i els seus arguments\&. Per exemple, les etiquetes d\*(Aquna carpeta es poden exportar al fitxer exporta\&.csv amb l\*(Aqordre seg\(:uent\&. .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c "execute @qml /usr/share/kid3/qml/script/ExportCsv\&.qml exporta\&.csv" /cam\('i/a/la/carpeta/\fR .fi .if n \{\ .RE .\} .PP Aqu\('i, \fBexporta\&.csv\fR \('es l\*(Aqargument per a l\*(Aqscript ExportCsv\&.qml, mentre que \fB/cam\('i/a/la/carpeta/\fR \('es l\*(Aqargument \fB\fIFITXER\fR\fR per a \fBkid3\-cli\fR\&. .RE .SS "Exemples" .PP Establir el t\('itol que cont\('e un ap\(`ostrof\&. Les ordres passades al \fBkid3\-cli\fR amb \fI\-c\fR hauran d\*(Aqestar entre cometes si no consisteixen nom\('es d\*(Aquna sola paraula\&. Si aquesta ordre en si t\('e un argument que cont\('e espais, aquest argument tamb\('e ha d\*(Aqanar entre cometes\&. En els int\(`erprets d\*(Aqordres d\*(AqUNIX\(rg es poden utilitzar cometes simples o dobles, per\(`o a l\*(Aqindicatiu d\*(Aqordres de Windows, \('es important que les cometes externes es realitzin amb cometes dobles i dintre d\*(Aqaquestes cometes, s\*(Aqutilitzaran cometes simples\&. Si el text dins de les cometes simples cont\('e una cometa simple, s\*(Aqhaur\(`a d\*(Aqescapar utilitzant un car\(`acter de barra inversa, com es mostra en el seg\(:uent exemple: .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c "set title \*(AqI\e\*(Aqll be there for you\*(Aq" /cam\('i/a/carpeta\fR .fi .if n \{\ .RE .\} .PP Estableix la car\(`atula de l\*(Aq\(`album a tots els fitxers d\*(Aquna carpeta utilitzant la funci\('o d\*(Aqimportaci\('o per lots: .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c "autoimport \*(AqCover Art\*(Aq" /cam\('i/a/carpeta\fR .fi .if n \{\ .RE .\} .PP Elimina els marcs de comentari i aplica el format d\*(Aqetiqueta en ambdues etiquetes de tots els fitxers MP3 d\*(Aquna carpeta: .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c "set comment \*(Aq\*(Aq 1" \-c "set comment \*(Aq\*(Aq 2" \e \-c "tagformat 1" \-c "tagformat 2" /cam\('i/a/carpeta/*\&.mp3\fR .fi .if n \{\ .RE .\} .PP Importa autom\(`aticament l\*(Aqetiqueta 2, sincronitza amb l\*(Aqetiqueta 1, estableix els noms de fitxer a partir de l\*(Aqetiqueta 2 i finalment crea una llista de reproducci\('o: .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c autoimport \-c "syncto 1" \-c fromtag \-c playlist \e /cam\('i/a/carpeta/*\&.mp3\fR .fi .if n \{\ .RE .\} .PP Per a tots els fitxers amb una etiqueta ID3 versi\('o 2\&.4\&.0, converteix a ID3 versi\('o 2\&.3\&.0 i elimina el marc de l\*(Aqorganitzador: .sp .if n \{\ .RS 4 .\} .nf \fBkid3\-cli \-c "filter \*(AqID3 versi\('o2\&.4\&.0 Tag\*(Aq" \-c "select all" \-c to23 \e \-c "set arranger \*(Aq\*(Aq" /cam\('i/a/carpeta\fR .fi .if n \{\ .RE .\} .PP Aquest script de Python utilitza el \fBkid3\-cli\fR per a generar marcs d\*(AqiTunes Sound Check iTunNORM a partir de la informaci\('o del guany en la reproducci\('o\&. .sp .if n \{\ .RS 4 .\} .nf #!/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((\*(Aq\&.mp3\*(Aq, \*(Aq\&.m4a\*(Aq, \*(Aq\&.aiff\*(Aq, \*(Aq\&.aif\*(Aq)): fn = os\&.path\&.join(root, name) rg = subprocess\&.check_output([ \*(Aqkid3\-cli\*(Aq, \*(Aq\-c\*(Aq, \*(Aqget "replaygain_track_gain"\*(Aq, fn])\&.strip() if rg\&.endswith(b\*(Aq dB\*(Aq): rg = rg[:\-3] try: rg = float(rg) except ValueError: print(\*(AqValue %s of %s in not a float\*(Aq % (rg, fn)) continue sc = (\*(Aq \*(Aq + (\*(Aq%08X\*(Aq % int((10 ** (\-rg / 10)) * 1000) )) * 10 subprocess\&.call([ \*(Aqkid3\-cli\*(Aq, \*(Aq\-c\*(Aq, \*(Aqset iTunNORM "%s"\*(Aq % sc, fn]) if __name__ == \*(Aq__main__\*(Aq: rg2sc(sys\&.argv[1]) .fi .if n \{\ .RE .\} .SS "Format JSON" .PP Per a facilitar l\*(Aqan\(`alisi dels resultats del \fBkid3\-cli\fR, \('es possible obtenir la sortida en el format JSON\&. Quan la sol\(mdlicitud est\(`a en el format JSON, la resposta tamb\('e ser\(`a en JSON\&. Un format compacte de la sol\(mdlicitud tamb\('e donar\(`a una representaci\('o compacta de la resposta\&. Si la sol\(mdlicitud cont\('e un camp \(Foid\(Fc, se suposa que \('es una sol\(mdlicitud RPC de JSON i la resposta contindr\(`a un camp \(Fojsonrpc\(Fc i l\*(Aq\(Foid\(Fc de la sol\(mdlicitud\&. El format de la sol\(mdlicitud utilitzar\(`a les mateixes ordres que la CLI est\(`andard, el camp \(Fomethod\(Fc contindr\(`a l\*(Aqordre i els par\(`ametres (si n\*(Aqhi ha cap), i es troben a la llista \(Foparams\(Fc\&. La resposta contindr\(`a un objecte \(Foresult\(Fc, el qual tamb\('e pot ser nul si l\*(Aqordre \fBkid3\-cli\fR corresponent no retorna un resultat\&. En cas d\*(Aqerror, es tornar\(`a un objecte \(Foerror\(Fc amb els camps \(Focode\(Fc i \(Fomessage\(Fc com s\*(Aqutilitza en el RPC de JSON\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli> \fB{"method":"set","params":["artist","An Artist"]}\fR {"result":null} kid3\-cli> \fB{"method":"get","params":["artist",2]}\fR {"result":"An Artist"} kid3\-cli> \fB{"method": "get", "params": ["artist"]}\fR { "result": "An Artist" } kid3\-cli> \fB{"jsonrpc":"2\&.0","id":"123","method":"get","params":["artist"]}\fR {"id":"123","jsonrpc":"2\&.0","result":"An Artist"} .fi .if n \{\ .RE .\} .sp .SH "CR\(`EDITS I LLIC\(`ENCIA" .PP Kid3 .PP Programa escrit per en Urs Fleisch .PP Traductor de la documentaci\('o: Antoni Bella .PP \m[blue]\fBFDL\fR\m[]\&\s-2\u[22]\d\s+2 .PP \m[blue]\fBGPL\fR\m[]\&\s-2\u[23]\d\s+2 .SH "INSTAL\(mdLACI\('O" .SS "Com obtenir el Kid3" .PP El Kid3 es pot trobar a \m[blue]\fBhttps://kid3\&.kde\&.org\fR\m[]\&. .SS "Requisits" .PP El Kid3 necessita les \m[blue]\fBQt(TM)\fR\m[]\&\s-2\u[24]\d\s+2\&. Es recomana el \m[blue]\fBKDE\fR\m[]\&\s-2\u[25]\d\s+2 per\(`o no cal, ja que el Kid3 tamb\('e es pot compilar com una aplicaci\('o de les Qt(TM)\&. El Kid3 es pot compilar per a sistemes on aquestes biblioteques estiguin disponibles, p\&. ex\&., per a GNU/Linux\(rg, Windows\(rg i macOS\(rg\&. Per etiquetar els fitxers Ogg/Vorbis, es requereixen les \m[blue]\fBlibogg\fR\m[]\&\s-2\u[15]\d\s+2, \m[blue]\fBlibvorbis i libvorbisfile\fR\m[]\&\s-2\u[16]\d\s+2, per als fitxers FLAC, les \m[blue]\fBlibFLAC++ i libFLAC\fR\m[]\&\s-2\u[17]\d\s+2\&. La \m[blue]\fBid3lib\fR\m[]\&\s-2\u[14]\d\s+2 s\*(Aqutilitza per als fitxers MP3\&. Aquests quatre formats tamb\('e s\('on admesos per la \m[blue]\fBTagLib\fR\m[]\&\s-2\u[18]\d\s+2, la qual tamb\('e pot manejar els fitxers Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF i els m\(`oduls dels seguidors de peces\&. Per a importar a partir d\*(Aqempremtes digitals ac\('ustiques, s\*(Aqutilitzen les \m[blue]\fBChromaprint\fR\m[]\&\s-2\u[20]\d\s+2 i \m[blue]\fBlibav\fR\m[]\&\s-2\u[21]\d\s+2\&. .PP El Kid3 est\(`a disponible per a la majoria de les distribucions de Linux\(rg, Windows\(rg i macOS\(rg\&. Els enlla\(,cos es poden trobar a \m[blue]\fBhttps://kid3\&.kde\&.org\fR\m[]\&. .SS "Compilaci\('o i instal\(mdlaci\('o" .PP Podreu compilar el Kid3 amb el KDE o sense\&. Sense, el Kid3 ser\(`a una senzilla aplicaci\('o Qt(TM) i no tindr\(`a algunes caracter\('istiques de configuraci\('o i de sessi\('o\&. .PP Per a una versi\('o del KDE, aneu a la carpeta superior i escriviu .sp .if n \{\ .RS 4 .\} .nf % \fBcmake \&.\fR % \fBmake\fR % \fBmake install\fR .fi .if n \{\ .RE .\} .PP Per a compilar per a diferents versions de les Qt(TM) o del KDE, establiu les opcions de \fBcmake\fR corresponents\&. .PP Si no estan presents totes les biblioteques, el Kid3 es construir\(`a amb una funcionalitat redu\(:ida\&. Per tant, haureu de tenir cura de tenir instal\(mdlats tots els paquets de desenvolupament desitjats\&. D\*(Aqaltra banda, les opcions del \fBcmake\fR controlen quines biblioteques es compilaran\&. De manera predeterminada s\('on \fB\-DWITH_TAGLIB:BOOL=ON \-DWITH_MP4V2:BOOL=OFF \-DWITH_ID3LIB:BOOL=ON \-DWITH_CHROMAPRINT:BOOL=ON \-DWITH_VORBIS:BOOL=ON \-DWITH_FLAC:BOOL=ON \fR\&. Aquestes opcions es poden inhabilitar emprant \fBOFF\fR\&. .PP Per a construir el Kid3 com una aplicaci\('o Qt(TM) sense el KDE, utilitzeu l\*(Aqopci\('o \fB\-DWITH_APPS=Qt\fR del \fBcmake\fR\&. Per a construir una aplicaci\('o KDE i una de les Qt(TM), establiu \fB\-DWITH_APPS="Qt;KDE"\fR\&. .PP Per utilitzar una instal\(mdlaci\('o espec\('ifica de les Qt(TM), establiu \fB\-DQT_QMAKE_EXECUTABLE=/cam\('i/a/qmake\fR\&. .PP La generaci\('o dels paquets RPM est\(`a admesa pel fitxer kid3\&.spec, per als paquets de la Debian\(rg, executeu build\&.sh deb\&. .PP L\*(Aqaplicaci\('o Qt(TM) tamb\('e es pot compilar per a Windows\(rg i macOS\(rg\&. Es pot emprar l\*(Aqscript build\&.sh per a descarregar i compilar totes les biblioteques necess\(`aries i crear un paquet del Kid3\&. .SS "Configuraci\('o" .PP Amb el KDE, la configuraci\('o s\*(Aqemmagatzema a \&.config/kid3rc i l\*(Aqestat de l\*(Aqaplicaci\('o a \&.local/share/kid3/kid3staterc\&. Com una aplicaci\('o Qt(TM), aquest fitxer estar\(`a a \&.config/Kid3/Kid3\&.conf\&. Al Windows\(rg, la configuraci\('o s\*(Aqemmagatzemar\(`a en el registre\&. Al macOS\(rg en un fitxer \&.plist (llista de propietats)\&. .PP Es pot emprar la variable d\*(Aqentorn \fIKID3_CONFIG_FILE\fR per establir el cam\('i cap al fitxer de configuraci\('o\&. .SH "INTERF\('ICIE DE D\-BUS" .SS "Exemples de D\-Bus" .PP Al Linux\(rg, es pot utilitzar una interf\('icie de D\-Bus per a controlar el Kid3 mitjan\(,cant 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\*(Aqusuari per ampliar la funcionalitat del Kid3\&. .PP Es pot establir l\*(Aqartista a l\*(Aqetiqueta 2 del fitxer actual amb el valor \(FoOne Hit Wonder\(Fc amb el seg\(:uent codi: .PP Int\(`erpret d\*(Aqordres .RS 4 .sp .if n \{\ .RS 4 .\} .nf dbus\-send \-\-dest=org\&.kde\&.kid3 \-\-print\-reply=literal \e /Kid3 org\&.kde\&.Kid3\&.setFrame int32:2 string:\*(AqArtist\*(Aq \e string:\*(AqLlu\('is Llach\*(Aq .fi .if n \{\ .RE .\} .sp o m\('es f\(`acil amb el \fBqdbus\fR de les Qt(TM) (es pot utilitzar el \fBqdbusviewer\fR per explorar la interf\('icie en una IGU): .sp .if n \{\ .RS 4 .\} .nf qdbus org\&.kde\&.kid3 /Kid3 setFrame 2 Artist \e \*(AqLlu\('is Llach\*(Aq .fi .if n \{\ .RE .\} .RE .PP Python .RS 4 .sp .if n \{\ .RS 4 .\} .nf import dbus kid3 = dbus\&.SessionBus()\&.get_object( \*(Aqorg\&.kde\&.kid3\*(Aq, \*(Aq/Kid3\*(Aq) kid3\&.setFrame(2, \*(AqArtist\*(Aq, \*(AqLlu\('is Llach\*(Aq) .fi .if n \{\ .RE .\} .RE .PP Perl .RS 4 .sp .if n \{\ .RS 4 .\} .nf use Net::DBus; $kid3 = Net::DBus\->session\->get_service( "org\&.kde\&.kid3")\->get_object( "/Kid3", "org\&.kde\&.Kid3"); $kid3\->setFrame(2, "Artist", "Llu\('is Llach"); .fi .if n \{\ .RE .\} .RE .SS "API de D\-Bus" .PP L\*(AqAPI de D\-Bus s\*(Aqespecifica a org\&.kde\&.Kid3\&.xml\&. La interf\('icie del Kid3 disposa dels seg\(:uents m\(`etodes: .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObrir un fitxer o carpeta\fR .RS 4 .HP \w'boolean\ openDirectory('u .BI "boolean openDirectory(string\ " "cam\('i" ");" .PP \fIcam\('i\fR .RS 4 cam\('i cap al fitxer o carpeta .RE .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDescarregar les etiquetes de tots els fitxers que no han estat modificats o seleccionats\fR .RS 4 .HP \w'unloadAllTags('u .BI "unloadAllTags(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDesar tots els fitxers modificats\fR .RS 4 .HP \w'boolean\ save('u .BI "boolean save(void);" .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir un missatge d'error detallat proporcionat per alguns m\(`etodes\fR .RS 4 .HP \w'string\ getErrorMessage('u .BI "string getErrorMessage(void);" .PP Retornar\(`a un missatge d\*(Aqerror detallat\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBRevertir els canvis fets als fitxers seleccionats\fR .RS 4 .HP \w'revert('u .BI "revert(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBIniciar autom\(`aticament una importaci\('o per lots\fR .RS 4 .HP \w'boolean\ batchImport('u .BI "boolean batchImport(int32\ " "tagMask" ", string\ " "Nom_Perfil" ");" .PP \fItagMask\fR .RS 4 m\(`ascara de l\*(Aqetiqueta (bit 0 per a l\*(Aqetiqueta 1, bit 1 per a l\*(Aqetiqueta 2) .RE .PP \fINom_Perfil\fR .RS 4 el nom del perfil que s\*(Aqemprar\(`a per a la importaci\('o per lots .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImportar etiquetes des d'un fitxer\fR .RS 4 .HP \w'boolean\ importFromFile('u .BI "boolean importFromFile(int32\ " "tagMask" ", string\ " "cam\('i" ", int32\ " "fmtIdx" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fIcam\('i\fR .RS 4 cam\('i del fitxer .RE .PP \fIfmtIdx\fR .RS 4 \('index del format .RE .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImportar etiquetes des d'altres etiquetes\fR .RS 4 .HP \w'importFromTags('u .BI "importFromTags(int32\ " "tagMask" ", string\ " "source" ", string\ " "extraction" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fIfont\fR .RS 4 format per obtenir el text font a partir de les etiquetes .RE .PP \fIextracci\('o\fR .RS 4 expressi\('o regular amb els noms de marc i captures per extreure del text font .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBImportar etiquetes des d'altres etiquetes als fitxers seleccionats\fR .RS 4 .HP \w'array\ importFromTagsToSelection('u .BI "array importFromTagsToSelection(int32\ " "tagMask" ", string\ " "font" ", string\ " "extracci\('o" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fIfont\fR .RS 4 format per obtenir el text font a partir de les etiquetes .RE .PP \fIextracci\('o\fR .RS 4 expressi\('o regular amb els noms de marc i captures per extreure del text font .RE .PP \fIValors_Retornats\fR .RS 4 valor extret per \(Fo%{__return}(\&.+)\(Fc .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDescarregar una car\(`atula de l'\(`album\fR .RS 4 .HP \w'downloadAlbumArt('u .BI "downloadAlbumArt(string\ " "URL" ", boolean\ " "tots_els_fitxers_a_la_carpeta" ");" .PP \fIURL\fR .RS 4 URL del fitxer d\*(Aqimatge o recurs de car\(`atula .RE .PP \fItots_els_fitxers_a_la_carpeta\fR .RS 4 cert per afegir la imatge a tots els fitxers que hi ha a la carpeta .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBExportar les etiquetes a un fitxer\fR .RS 4 .HP \w'boolean\ exportToFile('u .BI "boolean exportToFile(int32\ " "tagMask" ", string\ " "cam\('i" ", int32\ " "fmtIdx" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fIcam\('i\fR .RS 4 cam\('i del fitxer .RE .PP \fIfmtIdx\fR .RS 4 \('index del format .RE .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCrear una llista de reproducci\('o\fR .RS 4 .HP \w'boolean\ createPlaylist('u .BI "boolean createPlaylist(void);" .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir els elements d'una llista de reproducci\('o\fR .RS 4 .HP \w'array\ getPlaylistItems('u .BI "array getPlaylistItems(string\ " "cam\('i" ");" .PP \fIcam\('i\fR .RS 4 cam\('i a la llista de reproducci\('o .RE .PP Retornar\(`a la llista dels camins absoluts als elements de la llista de reproducci\('o\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir els elements d'una llista de reproducci\('o\fR .RS 4 .HP \w'boolean\ setPlaylistItems('u .BI "boolean setPlaylistItems(string\ " "cam\('i" ", array\ " "elements" ");" .PP \fIcam\('i\fR .RS 4 cam\('i a la llista de reproducci\('o .RE .PP \fIelements\fR .RS 4 llista dels camins absoluts als elements de la llista de reproducci\('o .RE .PP Retornar\(`a cert si va b\('e i fals si no s\*(Aqhan trobat tots els elements, tamb\('e si s\*(Aqha fallat en afegir o desar\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSurt de l'aplicaci\('o\fR .RS 4 .HP \w'quit('u .BI "quit(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar tots els fitxers\fR .RS 4 .HP \w'selectAll('u .BI "selectAll(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBDesseleccionar tots els fitxers\fR .RS 4 .HP \w'deselectAll('u .BI "deselectAll(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el primer fitxer com a fitxer actual\fR .RS 4 .HP \w'boolean\ firstFile('u .BI "boolean firstFile(void);" .PP Retornar\(`a cert si hi ha un primer fitxer\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el fitxer anterior com a fitxer actual\fR .RS 4 .HP \w'boolean\ previousFile('u .BI "boolean previousFile(void);" .PP Retornar\(`a cert si hi ha un fitxer anterior\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el seg\(:uent fitxer com a fitxer actual\fR .RS 4 .HP \w'boolean\ nextFile('u .BI "boolean nextFile(void);" .PP Retornar\(`a cert si hi ha un fitxer seg\(:uent\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSelecciona el primer fitxer\fR .RS 4 .HP \w'boolean\ selectFirstFile('u .BI "boolean selectFirstFile(void);" .PP Retornar\(`a cert si hi ha un primer fitxer\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar el fitxer anterior\fR .RS 4 .HP \w'boolean\ selectPreviousFile('u .BI "boolean selectPreviousFile(void);" .PP Retornar\(`a cert si hi ha un fitxer anterior\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar el seg\(:uent fitxer\fR .RS 4 .HP \w'boolean\ selectNextFile('u .BI "boolean selectNextFile(void);" .PP Retornar\(`a cert si hi ha un fitxer seg\(:uent\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBSeleccionar el fitxer actual\fR .RS 4 .HP \w'boolean\ selectCurrentFile('u .BI "boolean selectCurrentFile(void);" .PP Retornar\(`a cert si hi ha un fitxer actual\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBExpandir o contraure l'element de fitxer actual si es tracta d'una carpeta\fR .RS 4 .HP \w'boolean\ expandDirectory('u .BI "boolean expandDirectory(void);" .PP Un element de la llista de fitxers ser\(`a una carpeta si \(FogetFileName()\(Fc retorna un nom amb \(Fo/\(Fc com a \('ultim car\(`acter\&. .PP Retornar\(`a cert si l\*(Aqelement de fitxer actual \('es una carpeta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar el format per al nom del fitxer\fR .RS 4 .HP \w'applyFilenameFormat('u .BI "applyFilenameFormat(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar el format per a les etiquetes\fR .RS 4 .HP \w'applyTagFormat('u .BI "applyTagFormat(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBAplicar la codificaci\('o del text\fR .RS 4 .HP \w'applyTextEncoding('u .BI "applyTextEncoding(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el nom de la carpeta a partir de les etiquetes\fR .RS 4 .HP \w'boolean\ setDirNameFromTag('u .BI "boolean setDirNameFromTag(int32\ " "tagMask" ", string\ " "format" ", boolean\ " "create" ");" .PP \fItagMask\fR .RS 4 m\(`ascara de l\*(Aqetiqueta (bit 0 per a l\*(Aqetiqueta 1, bit 1 per a l\*(Aqetiqueta 2) .RE .PP \fIformat\fR .RS 4 format per al nom de la carpeta .RE .PP \fIcreate\fR .RS 4 cert per a crear i fals per a reanomenar .RE .PP Retornar\(`a cert si va b\('e, en cas contrari, el missatge d\*(Aqerror estar\(`a disponible utilitzant \(FogetErrorMessage()\(Fc\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir els n\('umeros de pe\(,ca subseg\(:uents en els fitxers seleccionats\fR .RS 4 .HP \w'numberTracks('u .BI "numberTracks(int32\ " "tagMask" ", int32\ " "N\('umPrimeraPe\(,ca" ");" .PP \fItagMask\fR .RS 4 m\(`ascara de l\*(Aqetiqueta (bit 0 per a l\*(Aqetiqueta 1, bit 1 per a l\*(Aqetiqueta 2) .RE .PP \fIN\('umPrimeraPe\(,ca\fR .RS 4 n\('umero a utilitzar per al primer fitxer .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBFiltratge de fitxers\fR .RS 4 .HP \w'filter('u .BI "filter(string\ " "expressi\('o" ");" .PP \fIexpressi\('o\fR .RS 4 expressi\('o de filtre .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConvertir entre les etiquetes ID3 versi\('o 2.3 i 2.4\fR .RS 4 .HP \w'convertToId3v24('u .BI "convertToId3v24(void);" .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConvertir entre les etiquetes ID3 versi\('o 2.4 i 2.3\fR .RS 4 .HP \w'convertToId3v23('u .BI "convertToId3v23(void);" .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir el cam\('i de la carpeta\fR .RS 4 .HP \w'string\ getDirectoryName('u .BI "string getDirectoryName(void);" .PP Retornar\(`a el cam\('i absolut de la carpeta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir el nom del fitxer actual\fR .RS 4 .HP \w'string\ getFileName('u .BI "string getFileName(void);" .PP Retornar\(`a el nom de fitxer absolut veritable, finalitzar\(`a amb \(Fo/\(Fc si \('es una carpeta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el nom del fitxer seleccionat\fR .RS 4 .HP \w'setFileName('u .BI "setFileName(string\ " "nom" ");" .PP \fInom\fR .RS 4 nom del fitxer .RE .PP El fitxer ser\(`a reanomenat quan es desi la carpeta\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el format que s'utilitzar\(`a en establir el nom del fitxer a partir de les etiquetes\fR .RS 4 .HP \w'setFileNameFormat('u .BI "setFileNameFormat(string\ " "format" ");" .PP \fIformat\fR .RS 4 format per al nom del fitxer .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir els noms de fitxer a partir dels fitxers seleccionats des de les etiquetes\fR .RS 4 .HP \w'setFileNameFromTag('u .BI "setFileNameFromTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir el valor del marc\fR .RS 4 .HP \w'string\ getFrame('u .BI "string getFrame(int32\ " "tagMask" ", string\ " "nom" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fInom\fR .RS 4 nom del marc (p\&. ex\&., \(Foartista\(Fc) .RE .PP Per obtenir les dades bin\(`aries com una imatge, es podr\(`a afegir el nom d\*(Aqun fitxer per escriure despr\('es del \fInom\fR, p\&. ex\&., \(FoPicture:/cam\('i/al/fitxer\(Fc\&. De la mateixa manera, es pot exportar una lletra sincronitzada, p\&. ex\&., \(FoSYLT:/cam\('i/al/fitxer\(Fc\&. .PP Retornar\(`a el valor del marc\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir el valor del marc\fR .RS 4 .HP \w'boolean\ setFrame('u .BI "boolean setFrame(int32\ " "tagMask" ", string\ " "nom" ", string\ " "valor" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP \fInom\fR .RS 4 nom del marc (p\&. ex\&., \(Foartista\(Fc) .RE .PP \fIvalor\fR .RS 4 valor del marc .RE .PP Per a l\*(Aqetiqueta 2 (\fItagMask\fR 2), si no hi ha un marc amb \fInom\fR, s\*(Aqafegir\(`a un marc nou, si el \fIvalor\fR est\(`a buit, el marc se suprimir\(`a\&. Per afegir dades bin\(`aries com una imatge, es pot afegir un fitxer despr\('es del \fInom\fR, p\&. ex\&., es pot fer servir \(FoPicture:/cam\('i/a/fitxer\(Fc\&. "SYLT:/cam\('i/a/fitxer" per importar la lletra sincronitzada\&. .PP Retornar\(`a cert si va b\('e\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir tots els marcs d'una etiqueta\fR .RS 4 .HP \w'array\ of\ string\ getTag('u .BI "array of string getTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .PP Retornar\(`a una llista amb els noms i valors dels marcs de forma alterna\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBObtenir la informaci\('o t\(`ecnica sobre el fitxer\fR .RS 4 .HP \w'array\ of\ string\ getInformation('u .BI "array of string getInformation(void);" .PP Les propietats s\('on Format, Velocitat de bits, Velocitat de mostreig, Canals, Durada, Mode del canal, VBR, Etiqueta 1, Etiqueta 2\&. S\*(Aqometran les propietats que no estiguin disponibles\&. .PP Retornar\(`a una llista amb els noms i valors de les propietats de forma alterna\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir l'etiqueta a partir del nom de fitxer\fR .RS 4 .HP \w'setTagFromFileName('u .BI "setTagFromFileName(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEstablir l'etiqueta a partir d'una altra etiqueta\fR .RS 4 .HP \w'setTagFromOtherTag('u .BI "setTagFromOtherTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBCopiar una etiqueta\fR .RS 4 .HP \w'copyTag('u .BI "copyTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEnganxar una etiqueta\fR .RS 4 .HP \w'pasteTag('u .BI "pasteTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBEliminar una etiqueta\fR .RS 4 .HP \w'removeTag('u .BI "removeTag(int32\ " "tagMask" ");" .PP \fItagMask\fR .RS 4 bit de l\*(Aqetiqueta (1 per a l\*(Aqetiqueta 1, 2 per a l\*(Aqetiqueta 2) .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBTornar a analitzar la configuraci\('o\fR .RS 4 .HP \w'reparseConfiguration('u .BI "reparseConfiguration(void);" .PP \('Es possible fer canvis automatitzats de la configuraci\('o modificant el fitxer de configuraci\('o i despr\('es tornant a analitzar la configuraci\('o\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBReproduir els fitxers seleccionats\fR .RS 4 .HP \w'playAudio('u .BI "playAudio(void);" .RE .SH "INTERF\('ICIE QML" .SS "Exemples en QML" .PP Els scripts QML es poden invocar a trav\('es del men\('u contextual de la llista de fitxers i es poden configurar a la pestanya Accions de l\*(Aqusuari del di\(`aleg de configuraci\('o\&. Els scripts que s\*(Aqestableixen all\(`a es poden emprar com a exemples per a programar scripts personalitzats\&. El QML fa servir JavaScript, aqu\('i teniu l\*(Aqobligatori \(FoHola m\('on\(Fc: .sp .if n \{\ .RS 4 .\} .nf import Kid3 1\&.0 Kid3Script { onRun: { console\&.log("Hola m\('on, la carpeta \('es", app\&.dirName) Qt\&.quit() } } .fi .if n \{\ .RE .\} .PP Si aquest script es desa com /cam\('i/a/Exemple\&.qml, l\*(Aqordre d\*(Aqusuari es pot definir com a \fB@qml /cam\('i/a/Exemple\&.qml\fR amb el nom \fBProva de QML\fR i Sortida marcades\&. Despr\('es es podr\(`a iniciar emprant l\*(Aqelement Prova de QML al men\('u contextual de la llista de fitxers, i la sortida ser\(`a visible a la finestra\&. .PP Malauradament, iniciar els scripts en QML emprant \fBqml\fR (p\&. ex\&., \fBqml \-apptype widget \-I /usr/lib/kid3/plugins/imports /cam\('i/a/Exemple\&.qml\fR) est\(`a trencat en les versions recents de les Qt\&. Per\(`o el \fBkid3\-cli\fR ofereix una forma alternativa d\*(Aqexecutar un script en QML des de la l\('inia d\*(Aqordres utilitzant la seva ordre \fBexecute\fR\&. .sp .if n \{\ .RS 4 .\} .nf kid3\-cli \-c "execute @qml /cam\('i/a/Exemple\&.qml" .fi .if n \{\ .RE .\} .PP Per a llistar els t\('itols a les etiquetes 2 de tots els fitxers en la carpeta actual, es podria emprar el seg\(:uent script: .sp .if n \{\ .RS 4 .\} .nf 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()) } } .fi .if n \{\ .RE .\} .PP Si la carpeta cont\('e molts fitxers, aquest script podria bloquejar la interf\('icie d\*(Aqusuari durant algun temps\&. Per a operacions m\('es llargues, aquest hauria de disposar d\*(Aqun descans de tant en tant\&. La seg\(:uent implementaci\('o alternativa t\('e la feina per a un sol fitxer mogut a una funci\('o\&. Aquesta funci\('o s\*(Aqinvoca amb un temps d\*(Aqespera d\*(Aq1 ms al final, at\(`es que s\*(Aqhan de processar m\('es fitxers\&. Aix\(`o assegurar\(`a que la IGU segueixi responent mentre s\*(Aqexecuta l\*(Aqscript\&. .sp .if n \{\ .RS 4 .\} .nf 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() } } .fi .if n \{\ .RE .\} .PP En emprar \fBapp\&.firstFile()\fR amb \fBapp\&.nextFile()\fR, es processaran tots els fitxers de la carpeta actual\&. Si nom\('es es veuen afectats els fitxers seleccionats, utilitzeu \fBfirstFile()\fR i \fBNextFile()\fR en el seu lloc, aquestes s\('on funcions convenients del component Kid3Script\&. El seg\(:uent exemple \('es un script que nom\('es copia els marcs de n\('umero del disc i drets d\*(Aqautor del fitxer seleccionat\&. .sp .if n \{\ .RS 4 .\} .nf 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() } } .fi .if n \{\ .RE .\} .PP Amb el Kid3 venen m\('es scripts d\*(Aqexemple i ja estan registrats com a ordres d\*(Aqusuari\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} ReplayGain to SoundCheck (ReplayGain2SoundCheck\&.qml): crea la informaci\('o de comprovaci\('o del so d\*(AqiTunNORM a partir dels marcs de guany de la reproducci\('o\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Redimensiona la car\(`atula (ResizeAlbumArt\&.qml): canvia la mida de les imatges incrustades de car\(`atula que tinguin m\('es de 500x500 p\('ixels\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Extreu la car\(`atula (ExtractAlbumArt\&.qml): extreu totes les imatges incrustades de car\(`atula evitant duplicats\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Car\(`atula incrustada (EmbedAlbumArt\&.qml): incrusta la car\(`atula que es troba en els fitxers d\*(Aqimatge als fitxers d\*(Aq\(`audio, tot a la mateixa carpeta\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Lletra incrustada (EmbedLyrics\&.qml): obt\('e la lletra no sincronitzada des del servei web\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Codifica el text ID3 versi\('o 1 (ShowTextEncodingV1\&.qml): ajuda a trobar la codificaci\('o de les etiquetes ID3 versi\('o 1 mostrant les etiquetes del fitxer actual en totes les codificacions de car\(`acters disponibles\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} ID3 versi\('o 1 a ASCII (Tag1ToAscii\&.qml): translitera a ASCII els car\(`acters llatins estesos a l\*(Aqetiqueta ID3 versi\('o 1\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Posa en maj\('uscules el t\('itol en angl\(`es (ExportCsv\&.qml): dona format en maj\('uscules al text de les etiquetes en angl\(`es\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Reescriu les etiquetes (RewriteTags\&.qml): reescriu totes les etiquetes en els fitxers seleccionats\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Exporta CSV (ExportCsv\&.qml): exporta recursivament totes les etiquetes de tots els fitxers a un fitxer CSV\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Importa CSV (ImportCsv\&.qml): importa recursivament totes les etiquetes de tots els fitxers des d\*(Aqun fitxer CSV\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Exporta JSON (ExportJson\&.qml): exporta recursivament totes les etiquetes de tots els fitxers a un fitxer JSON\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Importa JSON (ImportJson\&.qml): importa recursivament totes les etiquetes de tots els fitxers des d\*(Aqun fitxer JSON\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Exporta a una carpeta de llista de reproducci\('o (ExportPlaylist\&.qml): copia tots els fitxers d\*(Aquna llista de reproducci\('o en una carpeta i en canvia el nom segons la seva posici\('o\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Consola QML (QmlConsole\&.qml): consola senzilla per a jugar amb l\*(AqAPI de QML del Kid3\&. .RE .sp .SS "API de QML" .PP L\*(AqAPI es pot explorar amb facilitat utilitzant la consola QML, la qual est\(`a disponible com un script d\*(Aqexemple amb una interf\('icie d\*(Aqusuari\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBKid3Script\fR .RS 4 .PP El Kid3Script \('es un component QML regular ubicat a dins de la carpeta del connector\&. Tamb\('e podria emprar un altre connector QML\&. L\*(Aq\('us del Kid3Script facilita l\*(Aqinici de la funci\('o de script utilitzant el controlador del senyal \fBonRun\fR\&. A m\('es ofereix algunes funcions: .sp .if n \{\ .RS 4 .\} .nf onRun: controlador del senyal que s\*(Aqinvoca quan s\*(Aqinicia l\*(Aqscript tagv1, tagv2, tagv2v1: constants per als par\(`ametres d\*(Aqetiqueta script: acc\('es a les funcions per a la creaci\('o de scripts configs: acc\('es als objectes de la configuraci\('o getArguments(): llista d\*(Aqarguments de l\*(Aqscript isStandalone(): cert si l\*(Aqscript no es va iniciar des del Kid3 setTimeout (crida de retorn, retard): inicia la crida de retorn despr\('es del retard en ms firstFile(): al primer fitxer seleccionat NextFile(): al seg\(:uent fitxer seleccionat .fi .if n \{\ .RE .\} .sp .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBFuncions de creaci\('o de scripts\fR .RS 4 .PP Com al JavaScript, el QML tamb\('e t\('e nom\('es un conjunt limitat de funcions per a la creaci\('o de scripts, l\*(Aqobjecte \fBscript\fR t\('e alguns m\(`etodes addicionals, per exemple: .sp .if n \{\ .RS 4 .\} .nf script\&.properties(obj): cadena amb les propietats de les Qt script\&.writeFile(filePath, dades): escriu les dades al fitxer, cert si va b\('e script\&.readFile(filePath): llegeix les dades del fitxer script\&.removeFile(filePath): elimina un fitxer, cert si va b\('e script\&.fileExists(filePath): cert si el fitxer existeix script\&.fileIsWritable(filePath): cert si el fitxer \('es d\*(Aqescriptura script\&.getFilePermissions(filePath): obt\('e els bits per al mode de perm\('is del fitxer script\&.setFilePermissions(filePath, modeBits): estableix els bits per al mode de perm\('is del fitxer script\&.classifyFile(filePath): obt\('e la classe de fitxer (carpeta \(Fo/\(Fc, enlla\(,c simb\(`olic \(Fo@\(Fc, executable \(Fo*\(Fc, fitxer \(Fo\(Fc) script\&.renameFile(oldname, NEWNAME): canvia el nom del fitxer, cert si va b\('e script\&.copyFile(font, dest): copia un fitxer, cert si va b\('e script\&.makeDir(cam\('i): crea una carpeta, cert si va b\('e script\&.removeDir(cam\('i): elimina una carpeta, cert si va b\('e script\&.tempPath(): cam\('i de la carpeta temporal script\&.musicPath(): cam\('i de la carpeta de m\('usica script\&.listDir(cam\('i, [nameFilters], [classify]): llista les entrades de la carpeta script\&.system(programa, [args], [msecs]): inicia de mode sincr\(`onic una ordre del sistema, [codi de sortida, sortida est\(`andard, error est\(`andard] si no \('es temps d\*(Aqespera script\&.systemAsync(programa, [args], [callback]): inicia una ordre del sistema en el mode as\('incron, la crida de retorn es cridar\(`a amb [codi de sortida, sortida est\(`andard, error est\(`andard] script\&.getEnv(varname): obt\('e el valor de la variable d\*(Aqentorn script\&.setEnv(varname, valor): estableix el valor a partir de la variable d\*(Aqentorn script\&.getQtVersion(): cadena de versi\('o de les Qt, p\&. ex\&., \(Fo5\&.4\&.1\(Fc script\&.getDataMd5(dades): obt\('e una cadena hexadecimal per a la suma MD5 de les dades script\&.getDataSize(data): obt\('e 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]): obt\('e els bytes de les dades de la imatge script\&.loadImage(filePath): carrega una imatge des d\*(Aqun fitxer script\&.saveImage(imatge, filePath, [format]): desa una imatge en un fitxer, cert si va b\('e script\&.imageProperties(imatge): obt\('e les propietats d\*(Aquna imatge, un mapa que contindr\(`a \(Foamplada\(Fc, \(Foal\(,cada\(Fc, \(Foprofunditat\(Fc i \(FocolorCount\(Fc, buit si la imatge no \('es v\(`alida script\&.scaleImage(imatge, amplada, [alt]): escala una imatge, retornar\(`a una imatge escalada\&. .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBContext de l'aplicaci\('o\fR .RS 4 .PP Emprant QML, es pot accedir a una gran part de les funcions del Kid3\&. L\*(AqAPI \('es similar a la utilitzada per al D\-Bus\&. Per a m\('es detalls, consulteu les respectives notes\&. .sp .if n \{\ .RS 4 .\} .nf app\&.openDirectory(cam\('i): obre la carpeta app\&.unloadAllTags(): descarrega totes les etiquetes app\&.saveDirectory(): desa la carpeta app\&.revertFileModifications(): reverteix app\&.importTags(etiqueta, cam\('i, fmtIdx): importa el fitxer app\&.importFromTags(etiqueta, font, extracci\('o): importa des de les etiquetes app\&.importFromTagsToSelection(etiqueta, font, extracci\('o): importa des de les etiquetes dels fitxers seleccionats app\&.downloadImage(url, allFilesInDir): descarrega la imatge app\&.exportTags(etiqueta, cam\('i, fmtIdx): fitxer d\*(Aqexportaci\('o app\&.writePlaylist(): escriu una llista de reproducci\('o app\&.getPlaylistItems(cam\('i): obt\('e els elements d\*(Aquna llista de reproducci\('o app\&.setPlaylistItems(cam\('i, elements): estableix els elements d\*(Aquna llista de reproducci\('o app\&.selectAllFiles(): ho selecciona tot app\&.deselectAllFiles(): desselecciona app\&.firstFile([select], [onlyTaggedFiles]): al primer fitxer app\&.nextFile([select], [onlyTaggedFiles]): al seg\(:uent fitxer app\&.previousFile([select], [onlyTaggedFiles]): al fitxer anterior app\&.selectCurrentFile([select]): selecciona el fitxer actual app\&.selectFile(cam\('i, [select]): selecciona un fitxer espec\('ific app\&.getSelectedFilePaths([onlyTaggedFiles]): obt\('e 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\*(Aqetiqueta app\&.applyTextEncoding(): aplica la codificaci\('o del text app\&.numberTracks(n\('um\&., total, etiqueta, [options]): n\('umeros de pe\(,ca app\&.applyFilter(expr): filtre app\&.convertToId3v23(): converteix ID3 versi\('o 2\&.4\&.0 a 2\&.3\&.0 app\&.convertToId3v24(): converteix ID3 versi\('o 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): obt\('e un objecte amb tots els marcs app\&.getFrame(etiqueta, nom): obt\('e un marc app\&.setFrame(etiqueta, nom, valor): estableix un marc app\&.getPictureData(): obt\('e 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 configuraci\('o app\&.applyChangedConfiguration(): aplica la configuraci\('o app\&.dirName: nom de la carpeta app\&.selectionInfo\&.fileName: nom del fitxer app\&.selectionInfo\&.filePath: cam\('i absolut cap al fitxer app\&.selectionInfo\&.detailInfo: detalls del format app\&.selectionInfo\&.tag(Frame\&.Tag_1)\&.tagFormat: format de l\*(Aqetiqueta 1 app\&.selectionInfo\&.tag(Frame\&.Tag_2)\&.tagFormat: format de l\*(Aqetiqueta 2 app\&.selectionInfo\&.formatString(etiqueta, format): substitueix els codis en una cadena de format app\&.selectFileName(subt\('itol, carpeta, filtre, desa el fitxer): obre el di\(`aleg de fitxers i en selecciona un app\&.selectDirName(t\('itol, carpeta): obre el di\(`aleg de fitxers per a seleccionar una carpeta .fi .if n \{\ .RE .\} .PP Per a operacions as\('incrones, les crides de retorn podran connectar\-se amb els senyals\&. .sp .if n \{\ .RS 4 .\} .nf 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) } .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBConfiguraci\('o dels objectes\fR .RS 4 .PP Es pot accedir a les diferents seccions de configuraci\('o a trav\('es de m\(`etodes de \fBconfigs\fR\&. Les seves propietats es poden llistar a la consola QML\&. .sp .if n \{\ .RS 4 .\} .nf script\&.properties(configs\&.networkConfig()) .fi .if n \{\ .RE .\} .sp Es poden establir les propietats: .sp .if n \{\ .RS 4 .\} .nf configs\&.networkConfig()\&.useProxy = false .fi .if n \{\ .RE .\} .sp .sp .if n \{\ .RS 4 .\} .nf 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() .fi .if n \{\ .RE .\} .RE .SH "AUTORS" .PP \fBFleisch, Urs\fR <\&ufleisch at users.sourceforge.net\&> .RS 4 Desenvolupament de programari .RE .PP \fBAntoni Bella\fR <\&antonibella5@yahoo.com\&> .RS 4 Traductor .RE .SH "DRET DE REPRODUCCI\('O" .br Dret de reproducci\('o \(co 2023 Urs Fleisch .br .PP \m[blue]\fBFDL\fR\m[] .sp .SH "NOTES" .IP " 1." 4 gnudb.org .RS 4 \%http://gnudb.org .RE .IP " 2." 4 MusicBrainz .RS 4 \%http://musicbrainz.org .RE .IP " 3." 4 Discogs .RS 4 \%http://discogs.com .RE .IP " 4." 4 Amazon .RS 4 \%http://www.amazon.com .RE .IP " 5." 4 especificaci\('o ID3 .RS 4 \%http://id3.org/id3v2.4.0-frames .RE .IP " 6." 4 editor SYLT .RS 4 \%http://www.compuphase.com/software_sylteditor.htm .RE .IP " 7." 4 www.gnudb.org .RS 4 \%http://www.gnudb.org .RE .IP " 8." 4 Discogs .RS 4 \%https://www.discogs.com/ .RE .IP " 9." 4 freedb.org .RS 4 \%http://freedb.org .RE .IP "10." 4 Etiqueta ID3 versi\('o 2.3.0 .RS 4 \%http://id3.org/id3v2.3.0 .RE .IP "11." 4 Etiqueta ID3 versi\('o 2.4.0: estructura principal .RS 4 \%http://id3.org/id3v2.4.0-structure .RE .IP "12." 4 LyricWiki .RS 4 \%http://www.lyricwiki.org .RE .IP "13." 4 Google .RS 4 \%http://www.google.com .RE .IP "14." 4 id3lib .RS 4 \%http://id3lib.sourceforge.net .RE .IP "15." 4 libogg .RS 4 \%http://xiph.org/ogg/ .RE .IP "16." 4 libvorbis i libvorbisfile .RS 4 \%http://xiph.org/vorbis/ .RE .IP "17." 4 libFLAC++ i libFLAC .RS 4 \%http://flac.sourceforge.net .RE .IP "18." 4 TagLib .RS 4 \%http://taglib.github.io/ .RE .IP "19." 4 mp4v2 .RS 4 \%https://mp4v2.org/ .RE .IP "20." 4 Chromaprint .RS 4 \%http://acoustid.org/chromaprint .RE .IP "21." 4 libav .RS 4 \%http://libav.org/ .RE .IP "22." 4 FDL .RS 4 \%http://www.gnu.org/licenses/licenses.html#FDL .RE .IP "23." 4 GPL .RS 4 \%http://www.gnu.org/licenses/licenses.html#GPL .RE .IP "24." 4 Qt(TM) .RS 4 \%https://www.qt.io .RE .IP "25." 4 KDE .RS 4 \%http://www.kde.org .RE