Capítol 4. kid3-cli

Ordres

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.

Ajuda

help [NOM_ORDRE]

Mostrarà l'ajuda sobre els paràmetres de NOM_ORDRE o sobre totes les ordres si no es proporciona cap nom.

Temps d'espera

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.

Sortir de l'aplicació

exit [force]

Sortirà de l'aplicació. Si hi ha fitxers sense desar que han estat modificats, es requerirà el paràmetre force.

Canviar de carpeta

cd [CARPETA]

Si no es proporciona la CARPETA, 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.

Imprimir el nom de fitxer de la carpeta de treball actual

pwd

Imprimirà el nom de fitxer de la carpeta de treball actual.

Llistar les carpetes

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.

Desar els fitxers canviats

save

Seleccionar un fitxer

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

Seleccionar una etiqueta

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 NÚMEROS_D'ETIQUETA es poden establir a 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.

Obtenir un marc d'etiqueta

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.

Establir un marc d'etiqueta

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.

Revertir

revert

Revertir totes les modificacions en els fitxers seleccionats (o tots els fitxers si no hi ha fitxers seleccionats).

Importar des del fitxer

import {FITXER} {NOM_FORMAT} [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}(.+).

Importar automàticament

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).

Descarregar el treball artístic de la caràtula de l'àlbum

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

Exportar a un fitxer

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).

Crear una llista de reproducció

playlist

Crear una llista de reproducció en el format establert a la configuració, vegeu Crear una llista de reproducció.

Aplicar el format per al nom de fitxer

filenameformat

Aplicar el format per al nom de fitxer establert a la configuració, vegeu Aplicar el format per al nom de fitxer.

Aplicar el format per a l'etiqueta

tagformat

Aplicar el format per al nom de l'etiqueta establert a la configuració, vegeu Aplicar el format per a l'etiqueta.

Aplicar la codificació del text

textencoding

Aplica la codificació de text establert en la configuració, vegeu Aplicar la codificació de text.

Reanomenar una carpeta

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.

Nombre de peces

numbertracks [NÚMERO_PEÇA] [NÚMEROS_D'ETIQUETA]

Numera les peces seleccionades començant amb NÚMERO_PEÇA (1 si s'omet).

Filtrar

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

Convertir des d'ID3 versió 2.3 a 2.4

to24

Convertir des d'ID3 versió 2.4 a 2.3

to23

Nom del fitxer des de l'etiqueta

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.

Etiquetar des del nom de fitxer

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.

Etiquetar a una altra etiqueta

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.

Copiar

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

Enganxar

paste [NÚMERO_ETIQUETA]

Estableix els marcs d'etiqueta a partir del contingut de la memòria intermèdia copy en els fitxers seleccionats.

Eliminar

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.

Configurar el Kid3

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.

Executa el programa o script en QML

execute [@qml] {FITXER} [ARGUMENTS]

Executa un script en QML o un executable.

Sense @qml un programa s'executa amb arguments. Quan s'indica @qml com a primer argument, els arguments 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 FITXER per a kid3-cli.