Sumari
- Ordres
- Ajuda
- Temps d'espera
- Sortir de l'aplicació
- Canviar de carpeta
- Imprimir el nom de fitxer de la carpeta de treball actual
- Llistar les carpetes
- Desar els fitxers canviats
- Seleccionar un fitxer
- Seleccionar una etiqueta
- Obtenir un marc d'etiqueta
- Establir un marc d'etiqueta
- Revertir
- Importar des del fitxer
- Importar automàticament
- Descarregar el treball artístic de la caràtula de l'àlbum
- Exportar a un fitxer
- Crear una llista de reproducció
- Aplicar el format per al nom de fitxer
- Aplicar el format per a l'etiqueta
- Aplicar la codificació del text
- Reanomenar una carpeta
- Nombre de peces
- Filtrar
- Convertir des d'ID3 versió 2.3 a 2.4
- Convertir des d'ID3 versió 2.4 a 2.3
- Nom del fitxer des de l'etiqueta
- Etiquetar des del nom de fitxer
- Etiquetar a una altra etiqueta
- Copiar
- Enganxar
- Eliminar
- Configurar el Kid3
- Executa el programa o script en QML
- Exemples
- Format JSON
El kid3-cli ofereix una interfície de línia d'ordres per al Kid3. Si s'utilitza un camí de carpeta, s'obrirà la carpeta. Si es proporcionen un o més camins de fitxer, s'obrirà la carpeta comuna i se seleccionaran els fitxers. Les ordres posteriors treballaran sobre aquests fitxers. Les ordres s'especifiquen emprant les opcions -c
. Si es passen múltiples ordres, s'executaran en l'ordre indicat. Si les ordres modifiquen els fitxers, es desaran en finalitzar. Si no passen opcions d'ordre, el kid3-cli s'iniciarà en el mode interactiu. Es poden introduir ordres i operaran sobre la selecció actual. Les següents seccions llisten totes les ordres disponibles.
help [NOM_ORDRE
]
Mostrarà l'ajuda sobre els paràmetres de NOM_ORDRE
o sobre totes les ordres si no es proporciona cap nom.
timeout [ default | off | TEMPS
]
Se sobreescriurà el temps d'espera predeterminat de l'ordre. Les ordres de la CLI s'interrompran després d'un temps d'espera específic en el qual expirarà una ordre. Aquest temps d'espera és de 10 segons per a ls i albumart, 60 segons per a autoimport i filter, i 3 segons per a totes les altres ordres. Si s'ha de processar una gran quantitat de fitxers, aquests temps d'espera podrien ser massa restrictius, per tant, el temps d'espera per a totes les ordres es podrà establir en TEMPS
ms, no pensar-hi o deixar-ho en els valors predeterminats.
exit [force]
Sortirà de l'aplicació. Si hi ha fitxers sense desar que han estat modificats, es requerirà el paràmetre force
.
cd [CARPETA
]
Si no es proporciona la
, es canviarà a la carpeta d'inici. Si es proporciona una carpeta, es canviarà a dins de la carpeta. Si es proporcionen un o més camins de fitxer, es canviarà a la seva carpeta comuna i se seleccionaran els fitxers. CARPETA
pwd
Imprimirà el nom de fitxer de la carpeta de treball actual.
ls
Llistarà el contingut de la carpeta actual. Això correspon a la llista de fitxers a la IGU del Kid3. Cinc caràcters abans dels noms de fitxer es mostrarà l'estat del fitxer.
>
El fitxer està seleccionat.*
El fitxer està modificat.El fitxer
1
té una etiqueta 1, en cas contrari es mostrarà «-
».El fitxer
2
té una etiqueta 2, en cas contrari es mostrarà «-
».El fitxer
3
té una etiqueta 3, en cas contrari es mostrarà «-
».
kid3-cli>
ls
1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3
En aquest exemple, tots els fitxers tenen una etiqueta 1, el segon fitxer també té una etiqueta 2 i està seleccionat. El tercer fitxer serà el modificat.
select [ all | none | first | previous | next | FITXER
... ]
Per a seleccionar tots els fitxers, introduïu select all
, per a desseleccionar tots els fitxers, introduïu select none
. Per a recórrer els fitxers a la carpeta actual comenceu amb select first
, després aneu endavant emprant select next
o cap enrere emprant select previous
. Es poden afegir fitxers específics a la selecció actual indicant els seus noms de fitxer. Són possibles els comodins, de manera que select *.mp3
seleccionarà tots els fitxers MP3 a la carpeta actual.
kid3-cli>
select first
kid3-cli>
ls
> 1-- 01 Intro.mp3 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3
kid3-cli>
select next
kid3-cli>
ls
1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 *1-- 03 Outro.mp3
kid3-cli>
select *.mp3
kid3-cli>
ls
> 1-- 01 Intro.mp3 > 12- 02 We Only Got This One.mp3 >*1-- 03 Outro.mp3
tag [NÚMEROS_D'ETIQUETA
]
Moltes ordres tenen un paràmetre opcional NÚMEROS_D'ETIQUETA
, el qual especifica si l'ordre operarà sobre l'etiqueta 1, 2 o 3. Si s'omet aquest paràmetre, s'utilitzaran els números d'etiqueta predeterminats, els quals es poden establir mitjançant aquesta ordre. A l'inici, s'estableix a 12
, el qual vol dir que la informació es llegirà de l'etiqueta 2, si està disponible, en cas contrari, de l'etiqueta 1, les modificacions es realitzaran a l'etiqueta 2. Els
es poden establir a NÚMEROS_D'ETIQUETA
1
, 2
o 3
per a només operar sobre l'etiqueta corresponent. Si s'omet el paràmetre, es mostrarà l'opció de configuració actual.
get [ all | NOM_MARC
] [NÚMEROS_D'ETIQUETA
]
Aquesta ordre es pot emprar per a llegir el valor d'un marc d'etiqueta específic o obtenir informació sobre tots els marcs d'etiqueta (si s'omet l'argument o s'utilitza all
). Els marcs modificats seran marcats amb un «*
».
kid3-cli>
get
File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo Name: 01 Intro.mp3 Tag 1: ID3v1.1 Title Intro Artist Lluís Llach Album I si canto trist Date 1974 Track Number 1 Genre Lied
kid3-cli>
get title
Intro
Per a desar a un fitxer el contingut d'un marc d'imatge, utilitzeu
get picture:'/camí/a/carpeta.jpg'
Per a desar una lletra sincronitzada en un fitxer LRC, utilitzeu
get SYLT:'/camí/a/lletra.lrc'
És possible obtenir només un camp específic des d'un marc, per exemple, get POPM.Email
per al camp Correu electrònic d'un marc Mesurador de la popularitat. Si un fitxer té múltiples marcs del mateix tipus, els diferents marcs es podran indexar amb parèntesis, per exemple, el primer intèrpret d'un comentari de Vorbis es pot recuperar emprant get performer[0]
, el segon emprant get performer[1]
.
El nom del pseudocamp «seleccionada» es pot fer servir per a comprovar si s'ha seleccionat un marc, per exemple, get artist.selected
retornarà 1
si està seleccionat el marc de l'artista, en cas contrari 0
.
Es pot utilitzar el nom del pseudomarc «ratingstars» per a obtenir el valor del marc «rating» com a valor del format específic corresponent al nombre d'estrelles (0 a 5). En usar el «rating», es retorna el valor intern.
set {NOM_MARC
} {VALOR_MARC
} [NÚMEROS_D'ETIQUETA
]
Aquesta ordre estableix el valor d'un marc d'etiqueta específic. Si VALOR_MARC
està buit, se suprimirà el marc.
kid3-cli>
set remixer 'I si canto trist'
Per a establir des d'un fitxer el contingut d'un marc d'imatge, utilitzeu
set picture:'/camí/a/carpeta.jpg' 'Descripció de la imatge'
Per a establir una lletra sincronitzada en un fitxer LRC, utilitzeu
set SYLT:'/camí/a/lletra.lrc' 'Descripció de la lletra'
Per a establir un camp específic d'un marc, el nom del camp es podrà indicar després d'un punt, p. ex., per a establir el camp Comptador d'un marc Mesurador de la popularitat, utilitzeu
set POPM.Counter 5
Una aplicació per a especificacions de camp és el cas en el qual voldreu un marc TXXX personalitzat amb una descripció de «rating» en lloc d'un marc Mesurador de la popularitat estàndard (alguns connectors semblen utilitzar-lo). Podreu crear-lo com un marc de puntuació TXXX amb el kid3-cli, però, primer haureu de crear un marc TXXX amb la descripció «rating» i després establir el valor d'aquest marc al valor de la puntuació.
kid3-cli>
set rating ""
kid3-cli>
set TXXX.Description rating
kid3-cli>
set rating 5
La primera ordre suprimirà un marc POPM existent, perquè si existeix, set rating 5
establirà el marc POPM i no el marc TXXX. Una altra possibilitat seria utilitzar set TXXX.Text 5
, però això només funcionarà si no hi ha un altre marc TXXX present.
Per a establir múltiples marcs del mateix tipus, es pot indicar un índex entre parèntesis, p. ex., per a establir múltiples intèrprets en un comentari de Vorbis, utilitzeu
kid3-cli>
set performer[0] 'Liza don Getti (soprano)'
kid3-cli>
set performer[1] 'Joe Barr (piano)'
Per a seleccionar certs marcs abans d'una acció de còpia, enganxat o eliminació, es pot emprar el nom del pseudocamp «seleccionada». Normalment, se seleccionaran tots els marcs, per a desseleccionar-los empreu set '*.selected' 0
, després, per exemple, set artist.selected 1
per a seleccionar el marc de l'artista.
Es pot utilitzar el nom del pseudomarc «ratingstars» per a establir el valor del marc «rating» com a valor del format específic corresponent al nombre d'estrelles (0 a 5). Es pot usar el nom de marc «rating» per a establir el valor intern.
Establir «ratingstars» en diversos fitxers que tinguin formats diferents d'etiqueta no funcionarà perquè el marc amb el valor mapat del comptador d'estrelles es crea en el primer fitxer i després s'utilitza per a tots els fitxers. Així que en lloc de kid3-cli -c "set ratingstars 2" *
cal usar for f in *; do kid3-cli -c "set ratingstars 2" "$f"; done
.
revert
Revertir totes les modificacions en els fitxers seleccionats (o tots els fitxers si no hi ha fitxers seleccionats).
import {FITXER
} {NOM_FORMAT
} [NÚMEROS_D'ETIQUETA
]
Les etiquetes s'importen des del FITXER
en el format amb el nom NOM_FORMAT
(p. ex., "CSV unquoted"
, vegeu Importar).
Si s'indiquen etiquetes (tags
) per a FITXER
, les etiquetes seran importades des d'altres etiquetes. En lloc dels paràmetres NOM_FORMAT
, FONT
i EXTRACCIÓ
els quals són obligatoris, vegeu Importar des de les etiquetes. Per a aplicar la importació des de les etiquetes en els fitxers seleccionats, utilitzeu tagsel
en lloc de tags
. Aquesta funció també admet la sortida del valor extret mitjançant l'ús d'una EXTRACCIÓ
amb el valor %{__return}(.+)
.
autoimport [NOM_PERFIL
] [NÚMEROS_D'ETIQUETA
]
Importarà per lots utilitzant el NOM_PERFIL
(vegeu Importar automàticament, si s'utilitza "All"
serà omès).
albumart {URL
} [all]
Establirà la caràtula de l'àlbum descarregant una imatge des de l'URL
. Les regles definides al diàleg Explora les caràtules... s'utilitzen per a transformar els URL generals (p. ex., des d'Amazon) en un URL de la imatge. Per a establir la caràtula de l'àlbum a partir d'un fitxer d'imatge local, utilitzeu l'ordre set.
kid3-cli>
albumart http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC
export {FITXER
} {NOM_FORMAT
} [NÚMEROS_D'ETIQUETA
]
Les etiquetes s'exportaran al FITXER
en el format amb el nom NOM_FORMAT
(p. ex., "CSV unquoted"
, vegeu Exportar).
playlist
Crear una llista de reproducció en el format establert a la configuració, vegeu Crear una llista de reproducció.
filenameformat
Aplicar el format per al nom de fitxer establert a la configuració, vegeu Aplicar el format per al nom de fitxer.
tagformat
Aplicar el format per al nom de l'etiqueta establert a la configuració, vegeu Aplicar el format per a l'etiqueta.
textencoding
Aplica la codificació de text establert en la configuració, vegeu Aplicar la codificació de text.
renamedir [FORMAT
] [ create | rename | dryrun ] [NÚMEROS_D'ETIQUETA
]
Canviarà el nom o crearà carpetes a partir dels valors en les etiquetes d'acord amb un FORMAT
indicat (p. ex., %{artist} - %{album}
, vegeu Canviar el nom d'una carpeta), si no s'indica un format, s'utilitzarà el format definit al diàleg Reanomena la carpeta. El mode predeterminat és rename
(canvia el nom). Per a crear carpetes, s'haurà d'indicar create
explícitament. Les accions de canvi de nom es realitzaran immediatament, per a veure què es faria, utilitzeu l'opció dryrun
.
numbertracks [NÚMERO_PEÇA
] [NÚMEROS_D'ETIQUETA
]
Numera les peces seleccionades començant amb NÚMERO_PEÇA
(1
si s'omet).
filter [ NOM_FILTRE
| FORMAT_FILTRE
]
Filtrarà els fitxers de manera que només siguin visibles els fitxers que coincideixin amb FORMAT_FILTRE
. Es podrà utilitzar el nom d'una expressió de filtre predefinit (p. ex., "Filename Tag Mismatch"
) en lloc d'una expressió de filtre, consulteu Filtre.
kid3-cli>
filter '%{title} contains "tro"'
Started /home/urs/One Hit Wonder - Let's Tag + 01 Intro.mp3 - 02 We Only Got This One.mp3 + 03 Outro.mp3 Finished
kid3-cli>
ls
1-- 01 Intro.mp3 1-- 03 Outro.mp3
kid3-cli>
filter All
Started /home/urs/One Hit Wonder - Let's Tag + 01 Intro.mp3 + 02 We Only Got This One.mp3 + 03 Outro.mp3 Finished
kid3-cli>
ls
1-- 01 Intro.mp3 12- 02 We Only Got This One.mp3 1-- 03 Outro.mp3
fromtag [FORMAT
] [NÚMEROS_D'ETIQUETA
]
Estableix els noms dels fitxers seleccionats a partir dels valors trobats en les etiquetes, per exemple, fromtag '%{track} - %{title}' 1
. Si no s'especifica cap format, s'utilitzarà el format establert a la IGU.
totag [FORMAT
] [NÚMEROS_D'ETIQUETA
]
Estableix els marcs d'etiqueta a partir dels noms de fitxer, per exemple, totag '%{albumartist} - %{album}/%{track} %{title}' 2
. Si no s'especifica cap format, s'utilitzarà el format establert a la IGU. Si el format per al nom de fitxer no coincideix amb aquest patró, s'intentaran alguns altres formats d'ús habitual.
syncto {NÚMERO_ETIQUETA
}
Copia els marcs d'etiqueta des d'una etiqueta a l'altra etiqueta, p. ex., per a establir l'etiqueta ID3 versió 2 a partir de l'etiqueta ID3 versió 1, utilitzeu syncto 2
.
copy [NÚMERO_ETIQUETA
]
Copia els marcs d'etiqueta des del fitxer seleccionat a la memòria intermèdia de copiar interna. Després es podran establir en un altre fitxer utilitzant l'ordre paste (enganxa).
Per a copiar només un subconjunt de marcs, utilitzeu el pseudocamp «seleccionada» amb l'ordre set. Per exemple, per a copiar només els marcs número del disc i drets d'autor, utilitzeu
set '*.selected' 0
set discnumber.selected 1
set copyright.selected 1
copy
paste [NÚMERO_ETIQUETA
]
Estableix els marcs d'etiqueta a partir del contingut de la memòria intermèdia copy en els fitxers seleccionats.
remove [NÚMERO_ETIQUETA
]
Elimina una etiqueta.
És possible eliminar només un subconjunt de marcs seleccionant-los com es descriu en l'ordre copy.
config [OPCIÓ
] [VALOR
]
Consulta o estableix una opció de configuració.
L'OPCIÓ
consta d'un nom de grup i un nom de propietat separats per un punt. Quan no es dona cap OPCIÓ
, es mostraran tots els grups disponibles. Si només es proporciona un nom de grup, es mostraran totes les propietats disponibles del grup. Per a un grup i propietat determinats, es mostrarà el valor configurat actualment. Per a canviar l'opció de configuració, el nou valor es pot passar com a un segon argument.
Si el valor d'una opció de configuració és una llista, tots els elements de la llista s'hauran de proporcionar com a arguments. Això vol dir que per a afegir un element a una llista existent d'elements, tots els elements existents s'hauran de passar seguits de l'element nou. En aquesta situació, és més fàcil utilitzar el mode JSON, on la llista actual es pot copiar amb el nou element afegit.
execute [@qml] {FITXER
} [ARGUMENTS
]
Executa un script en QML o un executable.
Sense @qml
un programa s'executa amb arguments. Quan s'indica @qml
com a primer argument, els arguments següents seran l'script en QML i els seus arguments. Per exemple, les etiquetes d'una carpeta es poden exportar al fitxer exporta.csv
amb l'ordre següent.
kid3-cli -c "execute @qml
/usr/share/kid3/qml/script/ExportCsv.qml exporta.csv"
/camí/a/la/carpeta/
Aquí, exporta.csv
és l'argument per a l'script ExportCsv.qml
, mentre que /camí/a/la/carpeta/
és l'argument
per a kid3-cli. FITXER