kid3-core - Online nel cloud

PROGRAMMA:

NOME

kid3, kid3-qt, kid3-cli - Tagger ID3 Kid3

SINOSSI

kid3 [--Aiuto | --aiuto-qt | --help-kde | --aiuto-tutti
|--autore | --versione | --licenza] [RISORSE...]

capretto3-qt [Qt-opzioni] [RISORSE...]

kid3-cli [-h | --Aiuto] [-c COMANDO1] [-c COMANDO2...] [RISORSE...]

VERSIONI

RISORSE
If RISORSE è il percorso di una directory, verrà aperta. Se uno o più percorsi di file sono
dato, viene aperta la loro directory comune e vengono selezionati i file.

kid3
--Aiuto
Mostra aiuto sulle opzioni.

--aiuto-qt
Mostra opzioni specifiche per Qt, vedi qtoptions(7).

--help-kde
Mostra le opzioni specifiche di KDE, vedi kdeoptions(7).

--aiuto-tutti
Mostra tutte le opzioni.

--autore
Mostra le informazioni sull'autore.

--versione
Mostra informazioni sulla versione.

--licenza
Mostra le informazioni sulla licenza.

capretto3-qt
Qt-opzioni
See qtoptions(7), tuttavia, le opzioni hanno "-" come prefisso, non "--".

kid3-cli
-c
Esegui un comando. multiplo -c opzioni sono possibili, vengono eseguite in sequenza.
Vedi la sezione su kid3-cli per una descrizione dei comandi disponibili.

-h|--Aiuto
Mostra aiuto su opzioni e comandi.

INTRODUZIONE

Kid3 è un'applicazione per modificare in modo efficiente i tag ID3v1 e ID3v2 nei file MP3.
Questi tag possono essere modificati dalla maggior parte dei lettori MP3, ma non in modo molto comodo ed efficiente
modo. Inoltre i tag in Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex,
I file TrueAudio, WavPack, WMA, WAV, AIFF e i moduli tracker (MOD, S3M, IT, XM) sono
supportato anche.

Kid3 non cattura né codifica i file MP3, ma è mirato a modificare i tag ID3 di tutti
file di un album in modo efficiente, cioè con pochi clic del mouse e tasti come
possibile. Laddove la maggior parte degli altri programmi può modificare i tag ID3v1 o ID3v2, Kid3 è pieno
controllo su entrambe le versioni, può convertire i tag tra i due formati e ha accesso a tutti
Tag ID3v2. I tag di più file possono essere impostati sullo stesso valore, ad esempio l'artista, l'album,
anno e genere di tutti i file di un album in genere hanno gli stessi valori e possono essere impostati
insieme. Se le informazioni per i tag sono contenute nel nome del file, i tag possono essere
impostato automaticamente dal nome del file. È anche possibile impostare il nome del file secondo
ai tag trovati nel file in formati arbitrari.

L'attività di modifica è ulteriormente supportata dalla sostituzione automatica dei caratteri o
sottostringhe, ad esempio per rimuovere caratteri non validi dai nomi dei file. Controllo automatico di
i caratteri maiuscoli e minuscoli facilitano l'uso di uno schema di denominazione coerente in tutto
tag.

Le informazioni sui tag per gli album completi possono essere prese da gnudb.org[1], TrackType.org[2],
MusicaBrainz[3], Discogs[4], Amazon[5] o altre fonti di elenchi di brani. Il formato di importazione
è liberamente configurabile tramite espressioni regolari.

Si prega di segnalare eventuali problemi o richieste di funzionalità all'autore.

UTILIZZO KID3

Kid3 Caratteristiche
· Modifica tag ID3v1.1

· Modifica tutti i frame ID3v2.3 e ID3v2.4

· Modifica tag di più file

· Converti tra tag ID3v1 e ID3v2

· Modifica MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio,
Tag WavPack, WMA, WAV e AIFF

· Genera tag dal nome del file

· Genera tag dal contenuto dei campi tag

· Genera nome file dai tag

· Genera e modifica i nomi delle directory dai tag

· Genera file playlist

· Conversione automatica di maiuscole e minuscole e traduzione di stringhe

· Importare da gnudb.org[1], TrackType.org[2], MusicaBrainz[3], Discogs[4], Amazon[5] e
altre fonti di dati

· Esporta come CSV, HTML, playlist, Kover XML e altri formati. I file CSV esportati possono essere
importato di nuovo.

Esempio Impiego
Questa sezione descrive una tipica sessione con Kid3. Supponiamo di avere una directory
contenente file MP3 con i brani dell'album "Let's Tag" della band "One Hit
Wonder". La directory è denominata nel formato "artista - album", nel nostro caso One Hit Wonder
- Tagghiamoci. La directory contiene le tracce nel formato "track title.mp3", che ho
penso sia utile perché i nomi dei file sono brevi (importante quando si usano lettori MP3 mobili
con piccoli display) e nell'ordine corretto se in ordine alfabetico (importante quando
utilizzando lettori MP3 hardware che riproducono i brani in ordine alfabetico o nell'ordine in
che vengono masterizzati su CD e che l'ordine è alfabetico quando si utilizza mkisofs). oltretutto
questo, le informazioni sull'artista e sull'album sono già nel nome della directory e non hanno
da ripetere nel nome del file. Ma tornando al nostro esempio, l'elenco delle directory è simile a
Questo:

01 Introduzione.mp3

02 Abbiamo solo questo.mp3

03 Outro.mp3

Questi file non hanno ancora tag e vogliamo generarli usando Kid3. Usiamo Open (File
menu o barra degli strumenti) e selezionare uno dei file in questa directory. Tutti i file saranno
visualizzato nella casella di riepilogo dei file. Per quanto pigri, vogliamo utilizzare le informazioni nel
directory e nomi di file per generare tag. Pertanto selezioniamo tutti i file, quindi facciamo clic su
A: pulsante Tag 1 nella sezione File. Questo imposterà il titolo, l'artista, l'album e la traccia
valori in tutti i file. Per impostare i valori dell'anno e del genere di tutti i file, conserviamo tutti i file
selezionato e digitare "2002" per l'anno e selezionare "Pop" dalla casella combinata Genere. Impostare
solo questi due valori, le loro caselle di controllo vengono selezionate automaticamente e tutte le altre caselle di controllo
vengono lasciati deselezionati. Ora cambiamo la selezione selezionando solo il primo file e
vedere che tutti i tag contengono i valori corretti. I tag degli altri file possono essere verificati
anche selezionandoli uno per uno. Quando siamo soddisfatti dei tag, usiamo Salva (File
menu o barra degli strumenti). Selezionando Crea playlist dal menu File verrà generato un file One
Hit Wonder - Let's Tag.m3u nella directory.

COMANDO RIFERIMENTO

I GUI Elementi
La GUI di Kid3 è divisa in cinque sezioni: A sinistra ci sono il file e la directory
listbox, il lato destro contiene le sezioni File, Tag 1 e Tag 2.

Compila il Lista
L'elenco dei file contiene i nomi di tutti i file nella directory aperta che corrispondono
il filtro del nome file selezionato (tipicamente *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Un singolo o
è possibile selezionare più file. Per non selezionare alcun file, fare clic nell'area vuota dopo il
voci della casella di riepilogo. La selezione determina i file che sono interessati dal
operazioni che sono disponibili utilizzando i pulsanti descritti di seguito.

Oltre a Nome, possono essere visualizzate anche altre colonne Dimensioni, Tipo, Data di modifica con i dettagli del file
visualizzato. Le colonne possono essere nascoste deselezionando il loro nome nel menu contestuale del
intestazione dell'elenco. L'ordine delle colonne può essere modificato tramite drag'n'drop. L'ordinamento
può essere attivato facendo clic sull'intestazione della colonna.

A sinistra dei nomi può essere visualizzata un'icona: un disco per mostrare che il file ha
stato modificato o informazioni su quali tag sono presenti (V1, V2, V1V2 o NO TAG, no
viene visualizzata l'icona se il file non è ancora stato letto).

Le directory vengono visualizzate con l'icona di una cartella. Se viene aperta una directory, i suoi file sono
visualizzato in un albero gerarchico. Selezionando file da sottodirectory, operazioni
può essere eseguito su file in directory diverse, il che è utile se la musica
raccolta è organizzata con una cartella per ogni artista contenente cartelle per gli album di
questo artista.

Facendo clic con il pulsante destro del mouse all'interno dell'elenco dei file si apre un menu di scelta rapida con il pulsante
seguenti comandi:

· Espandi tutto: espande tutti gli alberi delle cartelle (solo l'albero corrente se il tasto Maiusc è
premuto)

· Comprimi tutto: comprime tutti gli alberi delle cartelle

· Rinomina: cambia il nome di un file

· Sposta nel cestino: sposta un file nel cestino

· Riproduci: riproduce un file, vedere Riproduci

· Le voci successive sono comandi utente, che possono essere definiti nelle Azioni utente
scheda di Configura Kid3. La riproduzione su doppio clic può essere attivata anche lì.

elenco Lista
L'elenco delle directory contiene i nomi delle directory nella directory aperta, come
oltre alla directory corrente (.) e padre (..). Permette di cambiare rapidamente
la directory senza utilizzare il comando Apri... o trascinare e rilasciare.

Visibilità, ordine e ordinamento delle colonne possono essere configurati come descritto nella sezione
sull'elenco dei file.

Compila il
Mostra informazioni sulla codifica (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), bit rate, frequenza di campionamento, canali e
la lunghezza del file.

La modifica della riga Nome contiene il nome del file (se è selezionato un solo file).
Se questo nome viene modificato, il file verrà rinominato quando viene utilizzato il comando Salva.

La casella combinata Formato e la modifica della riga contengono il formato da utilizzare quando il nome del file è
generato dal primo o dal secondo tag. Il nome del file può contenere arbitrario
caratteri, anche una parte di directory separata da una barra dal nome del file, ma questo
la directory deve già esistere affinché la ridenominazione abbia esito positivo. I seguenti codici speciali
sono usati per inserire i valori dei tag nel nome del file:

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia (es 01)

· %t %{track.n} Traccia con larghezza di campo n (es. 001 per %{track.3})

· %T %{tracknumber} Traccia (senza zeri iniziali, ad es. 1)

· %g %{genere} Genere

· %{ignore} Ignorato durante la generazione di tag dal nome del file

I codici formato non sono limitati agli esempi forniti sopra. Qualsiasi nome di frame può essere
usato, ad esempio nomi di frame unificati come %{bpm} o formattare nomi specifici come
%{pop}.

Una seconda casella combinata Formato (con freccia in basso) viene utilizzata per generare i tag dal
nome del file. Se il formato del nome del file non corrisponde a questo modello, alcuni altri
vengono provati i formati comunemente usati.

Alcuni formati di nomi di file comunemente usati sono già disponibili nella casella combinata, ma lo è
anche possibile digitare in un formato speciale nella modifica della riga.

Da: Tag 1, Tag 2: Imposta il nome del file utilizzando il formato selezionato e il primo tag o
il secondo tag, rispettivamente.

A: Tag 1, Tag 2: I tag sono impostati dal nome del file. Innanzitutto, il formato specificato in
Viene utilizzato il formato. Se il nome del file esistente non corrisponde a questo formato, quanto segue
si provano i formati:

· Artista - Album/Brano brano

· Album/Traccia - Artista - Canzone

· /Artista - Album - Traccia - Canzone

· Album/Artista - Traccia - Canzone

· Album/Artista - Canzone

· Artista/album/brano brano

Se viene selezionato un singolo file, i controlli della GUI vengono riempiti con i valori estratti
dal nome del file. Se sono selezionati più file, i tag dei file sono direttamente
impostato in base ai nomi dei file.

Etichetta 1
I widget di modifica della linea per Titolo, Artista, Album, Commento, Anno, Traccia e Genere sono
utilizzato per modificare il valore corrispondente nel primo tag dei file selezionati. Il valore
verrà modificato quando la selezione del file viene modificata o prima di operazioni come Salva e
Esci e quando la casella di controllo corrispondente a sinistra del nome del campo è selezionata.
Questo è utile per modificare solo alcuni valori e lasciare invariati gli altri valori.

Se viene selezionato un singolo file, tutte le caselle di controllo sono selezionate e i widget di modifica della riga
contengono i valori trovati nei tag di questo file. Se un tag non viene trovato nel file,
viene visualizzato il valore vuoto corrispondente, che è una stringa vuota per il Titolo,
Modifiche della riga Artista, Album e Commento, 0 per le modifiche numeriche Anno e Traccia e an
valore selezionato vuoto per la casella combinata Genere. I valori possono essere modificati e se il
casella di controllo corrispondente è selezionata, saranno impostati per il file selezionato dopo il
la selezione viene modificata. Il file viene quindi contrassegnato come modificato da un simbolo del disco nel file
listbox ma rimane invariato fino a quando non viene utilizzato il comando Save.

Se sono selezionati più file, solo i valori che sono identici in tutti selezionati
vengono visualizzati i file. In tutti gli altri controlli, i valori vuoti descritti sopra sono
visualizzato. Tutte le caselle di controllo sono deselezionate per evitare modifiche indesiderate. Se un valore deve
essere impostato per tutti i file selezionati, può essere modificato e la casella di controllo deve essere impostata. Il
i valori verranno impostati per tutti i file selezionati quando la selezione viene modificata e possono essere
salvato utilizzando il comando Salva.

Le caselle di controllo controllano anche il funzionamento della maggior parte dei comandi che interessano i tag, come
come copia, incolla e trasferisci tra i tag 1 e 2. Per renderlo più facile da usare con
più file in cui tutte le caselle di controllo sono deselezionate, questi comandi si comportano allo stesso modo
modo quando tutte le caselle di controllo sono selezionate e quando tutte le caselle di controllo sono deselezionate.

Dal tag 2: i campi del tag 1 sono impostati dai valori corrispondenti nel tag 2. Se a
singolo file è selezionato, i controlli della GUI vengono riempiti con i valori del tag 2. Se
vengono selezionati più file, i tag dei file vengono impostati direttamente.

Copia: il buffer di copia viene riempito con i valori del Tag 1. Solo valori con spuntato
la casella di controllo verrà utilizzata nei successivi comandi Incolla.

Incolla: incolla i valori dal buffer di copia nei controlli della GUI.

Rimuovi: questo imposterà tutti i controlli della GUI sui loro valori vuoti che si tradurranno nella rimozione
tutti i valori. Il file salvato non conterrà quindi alcun tag 1.

Etichetta 2
I controlli della GUI funzionano nello stesso modo descritto per la sezione Tag 1, ma il
la dimensione delle stringhe non è limitata.

Per il tag 2 Genere puoi anche usare i tuoi nomi oltre ai generi elencati nel
casella combinata, basta digitare il nome nella modifica della riga.

Il tag 2 non può contenere solo gli stessi valori del tag 1, il formato è integrato in a
modo flessibile da più frame che sono a loro volta composti da più campi. Il
La tabella tag 2 mostra tutti i frame disponibili nel file selezionato.

Modifica: si aprirà una finestra che consente di modificare tutti i campi del selezionato
portafoto. Se sono selezionati più file, i campi modificati vengono applicati a tutti i selezionati
file che contengono tale frame.

Aggiungi: apparirà un richiedente per selezionare il tipo di frame e un frame del tipo selezionato
possono essere modificati e aggiunti al file. Funziona anche per aggiungere una cornice a più
file selezionati.

Elimina: elimina il fotogramma selezionato nei file selezionati.

Trascina qui la copertina dell'album se il file non contiene la copertina incorporata. UN
l'immagine può essere aggiunta utilizzando il trascinamento della selezione da un browser o un file manager e sarà
visualizzato qui. Le cornici delle immagini possono essere modificate o aggiunte facendo doppio clic su questo
controllare.

Sincronizzato Lyrics ed Evento Sincronizzazione Codici
Per le informazioni sincronizzate con i dati audio è disponibile un editor specifico.
Questi frame sono supportati per i tag ID3v2.3.0 e ID3v2.4.0. Per aggiungere una cornice del genere, il
deve essere selezionato il nome del frame specifico nell'elenco che appare quando il pulsante Aggiungi
è cliccato - Lyrics sincronizzati o Codici di temporizzazione evento, rispettivamente. L'editore è
lo stesso per entrambi i tipi, per i codici di temporizzazione degli eventi, solo un insieme predefinito di eventi
è disponibile mentre per i testi sincronizzati, il testo deve essere inserito. Nel
di seguito viene spiegato come modificare i testi sincronizzati.

Viene selezionato un file con un tag ID3v2, l'editor dei testi viene inserito utilizzando Aggiungi e
selezionando Testi sincronizzati. Per un frame di testi sincronizzati esistente, è
selezionato e si fa clic su Modifica. Il lettore si apre automaticamente con il file corrente
in modo che il file possa essere riprodotto e messo in pausa per sincronizzare i testi.

Le impostazioni nella parte superiore dell'editor SYLT normalmente non devono essere modificate. Se la
i testi contengono caratteri che non sono presenti nel set di caratteri Latin 1,
è consigliabile modificare la codifica del testo in UTF16 (o UTF8 per ID3v2.4.0). Per l'inglese
testi e massima compatibilità, si dovrebbe usare ISO-8859-1.

La sezione Testi ha cinque pulsanti in alto. Aggiungi aggiungerà un nuovo evento temporale nel
tavolo. Il tempo è preso dalla posizione del giocatore, aggiungendo così una voce mentre
la riproduzione del brano aggiungerà una riga per la posizione attualmente riprodotta. Gli eventi in
la tabella deve essere ordinata cronologicamente, quindi la riga verrà inserita
di conseguenza. Le voci con un'ora non valida vengono trattate in modo speciale: se attualmente
la riga selezionata ha un'ora non valida, il suo timestamp verrà sostituito dall'ora corrente
invece di aggiungere una nuova riga. Se l'ora corrente non è valida, la prima riga con an
se presente, verrà utilizzato un orario non valido. Questo comportamento dovrebbe facilitare l'aggiunta di tempo
timbri se il testo del testo è già nella tabella ma mancano i timbri orari
(come nel caso dell'importazione di testi non sincronizzati). Si noti che l'ora non valida
è rappresentato come 00:00.00, cioè uguale all'ora all'inizio assoluto del
traccia, che non è invalida. Per rendere non valido un orario, premere il tasto Canc o utilizzare
Cancella dal menu di scelta rapida. Nuove righe inserite utilizzando Inserisci riga dal menu di scelta rapida
o creato durante l'importazione di testi non sincronizzati con Dagli appunti o Importa anche
contengono timestamp non validi. Le righe nella tabella possono essere eliminate facendo clic sul pulsante Elimina
pulsante o utilizzando Elimina righe dal menu di scelta rapida.

I testi sincronizzati possono essere importati da un file utilizzando Import. Il formato previsto è
LRC semplice o potenziato. Se il file selezionato non contiene una parentesi quadra nel
prima riga, dovrebbe essere un semplice file di testo con testi non sincronizzati. Il
le righe di tale file vengono quindi importate con timestamp non validi. Il tempo
le informazioni possono essere aggiunte utilizzando il pulsante Aggiungi o tramite inserimento manuale. È anche possibile
per importare i testi tramite copia-incolla usando Dagli Appunti. I testi sincronizzati possono essere
scritto su file LRC utilizzando Export. Nota che solo le voci con data e ora valide lo faranno
essere esportati e che le voci verranno ordinate per tempo. Voci con orario non valido
non verrà memorizzato nemmeno nel frame SYLT, quindi assicurati di includere tutti i tempi
informazioni prima di uscire dalla finestra di dialogo.

I ID3 specificazione[6] suggerisce un timestamp per ogni sillaba. Tuttavia la maggior parte dei giocatori
supportano solo la granularità di una riga o di una frase. Per supportare entrambi i casi d'uso, Kid3
segue le stesse convenzioni di SYLT editore[7]. Testo che viene inserito nella tabella
si presume che inizi una nuova riga a meno che non inizi con uno spazio o un trattino. Eccezioni
a questa regola è possibile iniziare una riga con un carattere di sottolineatura ('_') per forzare
continuazione o un cancelletto ('#') per forzare una nuova riga. Questi caratteri di escape non lo sono
memorizzato all'interno del frame SYLT. All'interno del frame SYLT, le nuove linee iniziano con un avanzamento riga
carattere (esadecimale 0A) mentre le continuazioni no. Durante la lettura dei frame SYLT, Kid3 controlla
se la prima voce inizia con un avanzamento riga. Se questo non è il caso, si presume
che tutte le voci siano nuove righe e che non vengano utilizzate continuazioni di sillaba.

Durante la riproduzione del brano, la riga associata alla posizione di riproduzione corrente è
evidenziato, in modo che la correttezza delle informazioni di sincronizzazione possa essere
verificato. Se è necessario aggiungere un offset a uno o più timestamp, questo può essere
ottenuto con il menu contestuale Aggiungi offset. I valori negativi possono essere utilizzati per ridurre
il tempo. Utilizzando Cerca per posizionare nel menu contestuale, è possibile impostare il
posizione di riproduzione al tempo della riga selezionata.

I Compila il Menu
File → Apri... (Ctrl+O)
Apre una directory. Verranno visualizzati tutti i file che corrispondono al filtro del nome file selezionato
nella casella di riepilogo dei file e il file scelto è selezionato.

File → Apri recenti
Apre una directory aperta di recente.

File → Apri directory... (Ctrl+D)
Apre una directory. Verranno visualizzati tutti i file che corrispondono al filtro del nome file selezionato
nella casella di riepilogo dei file.

File → Salva (Ctrl+S)
Salva tutti i file modificati nella directory. I file modificati sono contrassegnati da un disco
simbolo nella casella di riepilogo dei file. Se dei nomi di file sono stati modificati, quei file saranno
rinominato.

File → Ripristina
Ripristina le modifiche di uno o più file. Se nessun file è selezionato nel file
listbox, le modifiche di tutti i file verranno annullate, altrimenti solo le modifiche del
i file selezionati vengono ripristinati.

File → Importa ...
La finestra di dialogo Importa può essere utilizzata per importare dati direttamente da un server freedb.org, da a
Server MusicBrainz, da Discogs, Amazon o altre fonti di elenchi di tracce di album in
formato testuale.

L'importazione da un server freedb.org è possibile utilizzando una finestra di dialogo che appare quando Da
È selezionato Server:gnudb.org o TrackType.org. L'artista e il nome dell'album da cercare
può essere inserito nei due campi più in alto, gli album che corrispondono alla query saranno
visualizzato quando si fa clic su Trova e i risultati da www.gnudb.org[8] sono ricevuti.
L'importazione dei dati della traccia per un album viene eseguita facendo doppio clic sull'album nel
elenco. Il server freedb.org da cui importare può essere selezionato così come il percorso CGI.
I dati importati vengono visualizzati nella tabella di anteprima della finestra di dialogo di importazione. quando
soddisfatti delle tracce visualizzate, possono essere importate terminando l'importazione
dialogo con OK.

Una ricerca sul server di Discogs può essere eseguita utilizzando Discogs. Come in gnudb.org
finestra di dialogo, è possibile inserire artista e album e quindi scegliere da un elenco di pubblicazioni. Se
I tag standard sono contrassegnati, le informazioni standard vengono importate, ad es. artista, album e
titolo. Se è contrassegnato Tag aggiuntivi, vengono importate ulteriori informazioni se disponibili, ad es
artisti, arrangiatori o editori. Se la copertina è contrassegnata, la copertina sarà
scaricato se disponibile.

Una ricerca su Amazon può essere eseguita utilizzando Amazon. Come nella finestra di dialogo gnudb.org, puoi
inserisci artista e album, quindi scegli da un elenco di pubblicazioni. Se i tag aggiuntivi sono
contrassegnato, vengono importate più informazioni se disponibili, ad es. esecutori, arrangiatori o
editore. Se la copertina è contrassegnata, la copertina verrà scaricata, se disponibile.

Puoi cercare allo stesso modo nel database delle versioni di MusicBrainz usando From
Rilascio di MusicBrainz. Il flusso di lavoro è lo stesso descritto per Da gnudb.org.

L'importazione da un server MusicBrainz è possibile utilizzando la finestra di dialogo che appare quando Da
L'impronta digitale di MusicBrainz è selezionata. Il Server può essere selezionato come nel freedb
finestra di dialogo di importazione. Di seguito è riportata una tabella che mostra i dati della traccia importati. La colonna di destra
mostra lo stato della query MusicBrainz, che inizia con "In attesa" quando la finestra di dialogo
è aperto. Quindi si cerca l'impronta digitale e se non dà un risultato,
viene tentata un'altra ricerca utilizzando i tag nel file. Quindi può essere utile per a
query MusicBrainz riuscita per memorizzare informazioni note (ad es. artista e album) nel
tag prima dell'importazione. Se viene trovato un risultato, la ricerca termina nello stato
"Riconosciuto", altrimenti non è stato trovato nulla o più risultati ambigui e uno dei
devono essere selezionati dall'utente. OK e Applica usa i dati importati, Annulla
chiude la finestra di dialogo. La chiusura può richiedere del tempo poiché l'intero macchinario MusicBrainz
deve essere spento.

Per l'importazione di dati testuali, Da File/Appunti apre una sottofinestra di dialogo, in cui diversi
sono disponibili formati di importazione preconfigurati. I primi due, "CSV non quotato" e "CSV
quoted" può essere utilizzato per importare i dati che sono stati esportati dalla finestra di dialogo Esporta. Il CSV
i dati possono essere modificati con un foglio di calcolo e devono essere scritti utilizzando le schede come delimitatori.
L'importazione dovrebbe quindi essere possibile utilizzando "CSV quotato", che è più flessibile di "CSV
senza virgolette". Tuttavia, i suoi campi non possono contenere virgolette doppie. Se esporti solo
da Kid3 e importare in seguito, "CSV senza virgolette" può essere utilizzato come formato semplice per questo
scopo. Nota che ci sono anche i comandi "Esporta CSV" e "Importa CSV" nel
menu di scelta rapida dell'elenco dei file, che utilizzano script per esportare e importare dati CSV in a
modo più completo, potente e flessibile.

Il formato successivo, "testo HTML freedb", può essere utilizzato per copiare informazioni da una pagina HTML
of freedb.org[9]. Cerca un album in freedb e se le informazioni desiderate sono
visualizzato nel browser web, copiare il contenuto negli appunti. Quindi fare clic su Da
Il pulsante Appunti e le tracce importate verranno visualizzate nella tabella di anteprima in corrispondenza di
superiore della finestra di dialogo. Se sei soddisfatto dei dati importati, chiudi la finestra di dialogo
con OK, che inserirà i dati nei tag della directory corrente. Il
la destinazione (Tag 1, Tag 2 o Tag 1 e Tag 2) può essere selezionata con una casella combinata. Il
i file nella directory corrente dovrebbero essere nell'ordine di traccia corretto per ottenere i loro tag
assegnato. Questo è il caso se sono numerati.

Il successivo formato di importazione preconfigurato, "fonte HTML freedb", può essere utilizzato, se i dati
è disponibile come documento HTML. L'importazione è possibile utilizzando il pulsante Da file, che
apre un selettore di file o copia il suo contenuto da un editor e quindi importa da
appunti. Questo formato può essere utile per l'importazione offline, sebbene il documento HTML
potrebbe anche essere aperto in un browser per poi essere importato nel primo formato tramite il
clipboard.

Sono disponibili più formati preconfigurati, ad es. "Track Title Time". Un'usanza vuota
il formato può essere creato con Aggiungi per essere impostato dall'utente. Due righe sotto il nome del formato
può essere impostato con un'espressione regolare per acquisire i campi dal testo di importazione. Il
la prima espressione regolare verrà analizzata una volta per documento per raccogliere dati per album
come artista, album, anno e genere. La seconda riga viene provata a corrispondere da
dall'inizio del documento alla fine per ottenere i dati della traccia, solitamente numero e titolo. Il
le espressioni regolari includono tutte le funzionalità offerte da Qt, che è la maggior parte delle cose
Offerte Perl. I costrutti di parentesi quadre "(..)" creano buffer di acquisizione per i campi da
import e sono preceduti da codici specifici Kid3 per specificare quale campo catturare. Il
i codici sono gli stessi utilizzati per il formato del nome file, oltre ai codici elencati di seguito,
qualsiasi nome di frame è possibile:

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia

· %g %{genere} Genere

· %d %{duration} Durata

Ad esempio, un'espressione regolare di traccia (seconda riga) da importare da una playlist .m3u
potrebbe essere "%{traccia}(\d+)\s+%{titolo}(\S[^\r\n]*)\.mp3[\r\n]". Tutti i formati possono essere modificati
modificando le espressioni regolari e il nome, quindi facendo clic su Salva impostazioni. Essi
verrà memorizzato nel file kid3rc nella directory di configurazione. Questo file può essere
modificato direttamente per avere più formati di importazione o può essere eliminato per tornare al
formati predefiniti. I formati possono essere eliminati utilizzando Rimuovi.

L'accuratezza mostra una stima di quanto le informazioni importate corrispondano a quelle date
brani. Utilizza le durate delle tracce o i nomi dei file per calcolare il livello di somiglianza in
per cento. Cover Art mostra l'URL dell'immagine di copertina dell'album che verrà scaricata.

Per verificare se le tracce importate corrispondono al set di file corrente, la durata di
le tracce importate possono essere confrontate con la durata dei file. Questa opzione può essere
abilitato con la casella di controllo Controlla la differenza di tempo massima consentita e il massimo
la differenza di tempo tollerata può essere impostata in secondi. Se una mancata corrispondenza in una lunghezza è
rilevata, la lunghezza viene visualizzata con uno sfondo rosso nella tabella di anteprima.

Se i file sono ordinati in modo diverso rispetto alle tracce importate, le loro tracce assegnate
devono essere cambiati. Questo compito può essere facilitato utilizzando la funzione Abbina con i pulsanti Lunghezza,
Traccia e Titolo, che riordineranno le tracce in base al campo corrispondente.
Per correggere le assegnazioni manualmente, è possibile trascinare una traccia con il tasto sinistro del mouse
e il tasto Ctrl tieni premuto, quindi rilasciati nella nuova posizione.

Quando viene aperta la finestra di dialogo di importazione, contiene il contenuto effettivo dei tag. il tag
il tipo (Tag 1, Tag 2, Tag 1 e Tag 2) può essere selezionato utilizzando la casella combinata Destinazione.
Il pulsante a destra di questa casella combinata può essere utilizzato per ripristinare la tabella al
contenuto corrente dei tag. Le caselle di controllo nella prima colonna della tabella possono essere utilizzate per
selezionare le tracce che vengono importate. Questo può essere utile se una cartella contiene il
tracce di entrambi i CD di un doppio CD e solo le tracce del secondo CD devono essere
importato.

Per identificare i brani che vengono importati, è possibile visualizzare i nomi dei file oppure
i percorsi completi dei file utilizzando il menu di scelta rapida dell'intestazione della tabella. I valori in
la tabella di importazione può essere modificata. Il pulsante di ripristino a destra della Destinazione
la casella combinata può essere utilizzata per ripristinare il contenuto dei tag, che può anche essere utile
dopo aver modificato la destinazione.

Quasi tutte le finestre di dialogo dispongono di un pulsante Salva impostazioni, che può essere utilizzato per memorizzare le
impostazioni specifiche della finestra di dialogo e la dimensione della finestra in modo persistente.

Da Tag conduce a una finestra di dialogo secondaria per impostare i frame dei tag dai contenuti di altri tag
cornici. Questo può essere usato per copiare semplicemente le informazioni tra i tag o estrarre una parte
da un frame e inserirlo in un altro.

Come nell'importazione da file/appunti, ci sono formati liberamente configurabili da eseguire
diverse operazioni. Sono già preconfigurati i formati in cui copiare il valore dell'album
Artista dell'album, compositore o direttore d'orchestra e per estrarre il numero di traccia dai campi del titolo
che contengono un numero. C'è anche un formato per estrarre un sottotitolo da un titolo
campo.

L'esempio seguente spiega come aggiungere un formato personalizzato, che imposta le informazioni
dal campo Sottotitolo anche nel campo Commento. Crea un nuovo formato usando Aggiungi e
impostare un nuovo nome, ad esempio "Sottotitoli a commento". Quindi inserisci "%{subtitle}" in Source e
"%{comment}(.*)" per Estrazione e fai clic su Salva impostazioni.

L'espressione in Source può contenere codici di formato per frame di tag arbitrari, multipli
i codici possono essere utilizzati per combinare i contenuti di diversi frame. Per ogni traccia, a
il testo viene generato dai suoi tag utilizzando il formato Source e l'espressione regolare
from Extraction viene applicato a questo testo per impostare nuovi valori per i tag. Codici formato
sono usati prima delle parentesi di cattura per specificare il tag frame in cui è stato catturato
il testo deve essere memorizzato. Funziona allo stesso modo dell'importazione da file/appunti.

File → Importa da gnudb.org...
Importa da un server freedb.org utilizzando la ricerca di album gnudb.org. Si apre questa voce di menu
la stessa finestra di importazione di Importa..., ma apre direttamente la finestra di dialogo gnudb.org.

File → Importa da TrackType.org...
Importa dal server TrackType.org. Questa voce di menu apre la stessa finestra di importazione di
Importa..., ma apre direttamente la finestra di dialogo TrackType.org.

File → Importa da Discogs...
Importa dal server Discogs. Questa voce di menu apre la stessa finestra di importazione di
Importa..., ma apre direttamente la finestra di dialogo Da Discogs.

File → Importa da Amazon...
Importa da Amazon. Questa voce di menu apre la stessa finestra di importazione di Importa..., ma
apre direttamente la finestra di dialogo Da Amazon.

File → Importa da MusicBrainz Release...
Importa dal database delle versioni di MusicBrainz. Questa voce di menu apre la stessa importazione
dialog come Import..., ma apre direttamente la finestra di dialogo From MusicBrainz Release.

File → Importa da MusicBrainz Fingerprint...
Importa da un server MusicBrainz. Questa voce di menu apre la stessa finestra di importazione di
Importa..., ma apre direttamente la finestra di dialogo Da impronte digitali di MusicBrainz.

File → Importazione automatica...
L'importazione automatica consente di importare informazioni per più album da vari siti web
Servizi. Se le directory sono selezionate nell'elenco dei file, tenere traccia dei dati per il selezionato
le directory verranno importate. Se non è selezionata nessuna directory, tutte le directory nel file
l'elenco verrà importato.

Il tipo di tag (Tag 1, Tag 2, Tag 1 e Tag 2) può essere selezionato utilizzando Destinazione
casella combinata.

I profili determinano quali server verranno contattati per recuperare le informazioni sull'album. Alcuni
i profili sono predefiniti (All, MusicBrainz, Discogs, Cover Art), i profili personalizzati possono essere
aggiunto utilizzando il pulsante Aggiungi a destra della casella combinata Profilo.

La tabella seguente mostra i server che verranno utilizzati durante l'importazione delle informazioni sull'album
utilizzando il profilo selezionato. Il processo di importazione di un album è terminato se tutto
sono state trovate le informazioni richieste, quindi l'ordine delle righe nella tabella è
importante. Può essere modificato utilizzando i pulsanti Sposta su e Sposta giù. La modifica può essere
utilizzato per modificare una voce esistente. La selezione Server offre gli stessi server di Can
essere utilizzato nelle funzioni di importazione. Tag standard, tag aggiuntivi, determinazione della copertina
le informazioni che devono essere recuperate dal server. Infine, la precisione è il
precisione minima che deve essere raggiunta per accettare i dati importati. Se la precisione
è insufficiente, verrà provato il server successivo nell'elenco. La stessa finestra di dialogo contenente
le proprietà del server vengono visualizzate quando si fa clic su Aggiungi per aggiungere una nuova voce del server. Esistente
le voci possono essere eliminate utilizzando Rimuovi.

Per avviare un'importazione batch automatica con il profilo selezionato, fare clic su Avvia. Particolari
sull'importazione in corso vengono visualizzati nella parte superiore della finestra di dialogo. Il processo può essere
interrotto con il pulsante Interrompi.

File → Sfoglia copertina...
La finestra di dialogo Sfoglia copertine aiuta a trovare le copertine degli album. Artista/album è pieno
dai tag, se possibile. Source offre una varietà di siti Web con copertine degli album.
L'URL con l'artista e l'album come parametri si trova sotto il nome. Con codifica URL
i valori per artista e album possono essere inseriti usando %u{artista} ed %u{album}, altro
sono possibili anche i valori dei tag, come descritto in Configura Kid3, Azioni utente.
È possibile inserire più fonti dopo la voce "Origine personalizzata" sostituendo "Personalizzato
Source" con il nome della fonte, premendo Invio, quindi inserendo l'URL e infine
premendo Salva impostazioni. Il comando del browser risultante viene visualizzato nella parte superiore del
finestra di dialogo e può essere avviato facendo clic su Sfoglia. Il browser, che può essere configurato in
le impostazioni, viene avviato con la sorgente selezionata. È quindi possibile trascinare un'immagine di copertina
dal browser nella finestra Kid3 e verrà impostato nella cornice dell'immagine del
file selezionati.

Perché non tutti i browser supportano il drag'n'drop di immagini e le immagini sui siti web
spesso hanno un URL, in questi casi Kid3 riceverà l'URL e non l'immagine. Se la
L'URL punta a un'immagine, verrà scaricata. Tuttavia, se l'URL fa riferimento ad alcuni
altra risorsa web, deve essere tradotto nell'immagine corrispondente. Tale
le mappature sono definite nell'estrazione dell'URL della tabella. La colonna di sinistra Match contiene a
espressione regolare che viene confrontata con l'URL. Se corrisponde, il catturato
le espressioni tra parentesi vengono inserite nel pattern dell'URL dell'immagine a destra
colonna (nelle posizioni contrassegnate con \1 ecc.). L'espressione regolare sostituita
contiene l'URL dell'immagine. In questo modo è possibile importare copertine da Amazon,
Google Immagini, ecc. utilizzando il drag'n'drop. È anche possibile definire il proprio
mappature.

File → Esporta ...
La finestra di dialogo Esporta viene utilizzata per memorizzare i dati dai tag in un file o negli appunti. Il
editor in alto mostra un'anteprima dei dati da esportare. Se i dati di esportazione contengono
caratteri tabulatori, l'esportazione viene visualizzata in una tabella. I dati verranno generati
dai tag nella directory corrente secondo il formato configurato.

Le impostazioni del formato sono simili a quelle della finestra di dialogo Importa: Il campo più in alto contiene
il titolo (es. "CSV senza virgolette"), seguito dall'intestazione, che verrà generata a
l'inizio del file. Seguono i dati della traccia; è usato per ogni traccia. Finalmente,
il trailer può essere utilizzato per generare del testo finale.

I campi formato non contengono espressioni regolari come nella finestra di dialogo Importa, ma solo
espressioni del formato di output con espressioni % speciali, che verranno sostituite da valori
dai tag. Il tutto funziona come il formato del nome del file e gli stessi codici sono
usato più alcuni codici aggiuntivi. Non solo i codici elencati di seguito ma tutti i tag frame
si possono usare nomi.

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia (es 01)

· %t %{track.n} Traccia con larghezza di campo n (es. 001 per %{track.3})

· %T %{tracknumber} Traccia (senza zeri iniziali, ad es. 1)

· %g %{genere} Genere

· %f %{file} Nome file

· Percorso %p %{filepath}

· %u %{url} URL

· %d %{duration} Durata in minuti:secondi

· %D %{seconds} Durata in secondi

· %n %{tracks} Numero di tracce dell'album

· %e %{extension} Estensione file

· %O %{tag1} Il formato del tag 1 (ID3v1.1 o vuoto se non esistente)

· %o %{tag2} Il formato del tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF o vuoto se non esistente)

· %b %{bitrate} Velocità in bit in kbit/s

· %v %{vbr} VBR o vuoto (solo per ID3v2.3 con id3lib)

· %r %{samplerate} Frequenza di campionamento in Hz

· %m %{mode} Modalità canale (Stereo o Joint Stereo)

· %h %{channels} Numero di canali (1 o 2)

· %k %{codec} Codec (es. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIF, WAV)

Alcuni formati sono predefiniti. "CSV senza virgolette" separa i campi per tab. Dati in
questo formato può essere importato di nuovo in Kid3 utilizzando il formato di importazione con lo stesso
nome. "CSV citato" racchiude inoltre i campi tra virgolette doppie, il che facilita il
importare in applicazioni per fogli di calcolo. Tuttavia, i campi non devono contenere alcun doppio
virgolette quando viene utilizzato questo formato. "Extended M3U" e "Extended PLS" generano playlist
con attributi estesi e nomi di percorso assoluti. "HTML" può essere usato per generare un
Pagina HTML con collegamenti ipertestuali alle tracce. "Kover XML" crea un file che può essere
importato dal programma di stampa di copertine Kover. "Dettagli tecnici" fornisce informazioni
su bit rate, frequenza di campionamento, canali, ecc. Infine, "Formato personalizzato" viene lasciato vuoto per
definizione di un formato personalizzato. Puoi definire più formati personali aggiungendo linee
nel file kid3rc nella directory di configurazione. Gli altri formati possono essere adattati a
I tuoi bisogni.

È possibile selezionare la sorgente dei tag per generare i dati di esportazione (Tag 1 o Tag 2)
con una casella combinata. Premendo su file o negli appunti si memorizzano i dati in un file o sul
appunti. OK e Annulla chiudono la finestra di dialogo, mentre OK accetta la finestra di dialogo corrente
e socievole.

File → Crea playlist
Crea una playlist. Il formato e il contenuto della playlist possono essere impostati da vari
opzioni.

Il nome della playlist può essere uguale al nome della directory o utilizzare un formato con valori
dai tag, ad esempio "%{artist} - %{album}" per avere l'artista e il nome dell'album nel
nome del file della playlist. I codici formato sono gli stessi di Export. L'estensione dipende
sul formato della playlist.

La posizione della playlist generata è determinata dalla selezione del pulsante Crea in
casella combinata.

Directory corrente
La playlist viene creata nella directory corrente e contiene solo i file del
directory corrente.

Ogni directory
Viene creata una playlist in ogni directory che contiene i file elencati e ciascuna
playlist contiene i file di quella directory.

Directory di primo livello
Viene creata una sola playlist nella directory di livello superiore (cioè la directory del
file list) e contiene i file elencati della directory di primo livello e tutti i
le sue sottodirectory.

Il formato della playlist può essere M3U, PLS o XSPF.

Se Includi solo i file selezionati è selezionato, verranno visualizzati solo i file selezionati
incluso nella playlist. Se viene selezionata una directory, vengono selezionati tutti i suoi file.
Se questa casella di controllo non è attivata, tutti i file audio sono inclusi nella playlist.

Ordina per nome file seleziona il solito caso in cui i file sono ordinati per nome file.
Con il campo Ordina per tag, è possibile ordinare in base a una stringa di formato con valori da tag
campi. Ad esempio, "%{track.3}" può essere utilizzato per ordinare per numero di traccia (il ".3" è
utilizzato per ottenere tre cifre con zeri iniziali perché le stringhe vengono utilizzate per l'ordinamento). Esso
è anche possibile utilizzare più campi, ad esempio "%{genre}%{year}" per ordinare utilizzando una stringa
composto da genere e anno.

Le voci della playlist avranno percorsi di file relativi o assoluti a seconda che
Usa percorso relativo per i file nella playlist o Usa percorso completo per i file nella playlist è impostato.

Quando l'elenco di file di sola scrittura è impostato, la playlist conterrà solo i percorsi del
File. Per generare una playlist estesa con informazioni aggiuntive, una stringa di formato
può essere impostato utilizzando Scrivi info utilizzando il controllo.

File → Esci (Ctrl+Q)
Chiude l'applicazione.

I Modifica Menu
Modifica → Seleziona tutto (Alt+A)
Seleziona tutti i file.

Modifica → Deseleziona (Ctrl+Maiusc+A)
Deseleziona tutti i file.

Modifica → Seleziona tutto nella directory
Seleziona tutti i file della directory corrente.

Modifica → File precedente (Alt+Su)
Seleziona il file precedente.

Modifica → File successivo (Alt+Giù)
Seleziona il file successivo.

Modifica → Trova... (Ctrl+F)
Trova le stringhe nei nomi dei file e nei tag. La finestra di dialogo Trova è un sottoinsieme di
Finestra di dialogo Sostituisci, descritta di seguito.

Modifica → Sostituisci... (Ctrl+R)
Questa funzione apre una finestra di dialogo per trovare e sostituire le stringhe nei nomi dei file e nel
tag. L'insieme di frame in cui viene eseguita la ricerca può essere limitato da
disattivando il checkbox Seleziona tutto e selezionando i frame da ricercare.
Sono disponibili anche opzioni di ricerca per cercare all'indietro, con distinzione tra maiuscole e minuscole e per
utilizzare espressioni regolari.

A seconda del numero di file, la ricerca potrebbe richiedere del tempo, quindi può essere
interrotto chiudendo la finestra di dialogo.

I Strumenti Menu
Strumenti → Applica formato nome file
Quando Formato durante la modifica è disattivato per il formato del nome file nella configurazione
finestra di dialogo, questa voce di menu può essere utilizzata per applicare il formato configurato ai nomi dei
file selezionati. Questo può essere usato anche per controllare se i nomi dei file sono conformi al
formato configurato applicando il formato a tutti i file salvati e quindi controllando se ce ne sono
i file sono stati modificati (e quindi contrassegnati con un simbolo del disco nella casella di riepilogo dei file).

Strumenti → Applica formato tag
Quando Formato durante la modifica è disattivato per il formato del tag nella configurazione
finestra di dialogo, questa voce di menu può essere utilizzata per applicare il formato configurato ai tag del
file selezionati. Questo può essere utilizzato anche per verificare se i tag sono conformi al
formato configurato applicando il formato a tutti i file salvati e quindi controllando se ce ne sono
i file sono stati modificati (e quindi contrassegnati con un simbolo del disco nella casella di riepilogo dei file).

Strumenti → Applica codifica testo
Imposta la codifica del testo selezionata in Impostazioni/Configura Kid3.../Tag/Tag 2 per tutti
file selezionati. Se è selezionato UTF8, UTF16 verrà utilizzato per i tag ID3v2.3.0 perché
UTF8 non è supportato per questo formato.

Strumenti → Rinomina directory...
Questa finestra di dialogo offre la possibilità di rinominare automaticamente il file attualmente aperto
directory in base ai tag nei file. Diversi formati sono preconfigurati per
includere informazioni su artista, album e anno nel nome della directory. È altresì
possibile impostare un formato personalizzato, i seguenti codici speciali vengono utilizzati per inserire tag
valori nel nome della directory:

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia (es 01)

· %t %{track.n} Traccia con larghezza di campo n (es. 001 per %{track.3})

· %T %{tracknumber} Traccia (senza zeri iniziali, ad es. 1)

· %g %{genere} Genere

Se nel formato viene trovato un separatore di directory "/", vengono create più directory.
Se vuoi creare una nuova directory invece di rinominare la directory corrente,
selezionare Crea directory invece di Rinomina directory. La fonte delle informazioni sui tag
può essere scelto tra Da Tag 1 e Tag 2, Da Tag 1 e Da Tag 2. Un'anteprima per
l'operazione di ridenominazione eseguita sul primo file è visibile nei Da e A
sezioni della finestra di dialogo.

È possibile rinominare più directory selezionandole.

Strumenti → Tracce numeriche...
Se i numeri di traccia nei tag non sono impostati o hanno valori errati, questa funzione
può numerare automaticamente le tracce in ordine crescente. Il numero di partenza può essere impostato in
il dialogo. Se solo una parte dei brani deve essere numerata, è necessario selezionarli.

Quando è selezionato Numero totale di tracce, il numero di tracce verrà impostato anche nel
tag.

È possibile numerare le tracce su più directory. Le cartelle devono essere
ampliato e selezionato.

Se l'opzione Reimposta contatore per ogni directory è selezionata, la numerazione dei brani viene riavviata con il tasto
dato il numero per ogni directory quando sono selezionate più cartelle.

La finestra di dialogo delle tracce numeriche può essere utilizzata anche per formattare i numeri delle tracce esistenti senza
modificando i valori quando la casella di controllo lasciata a Numero di partenza è disattivata. Il totale
numero di tracce verrà aggiunto se la casella di controllo corrispondente è attiva, che può essere
utilizzato per impostare il totale per tutte le tracce selezionate. Se solo la formattazione dell'esistente
numeri desiderati, anche questa casella di controllo deve essere disattivata.

Strumenti → Filtro...
Il filtro può essere utilizzato per visualizzare solo i file che corrispondono a determinati criteri. Questo
è utile se vuoi organizzare una grande raccolta e modificare solo quei file che
non sono nello schema desiderato. L'espressione che definisce quali file visualizzare usa il
stessi codici di formato utilizzati nel formato del nome del file, importazione ed esportazione.

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia (es 01)

· %t %{track.n} Traccia con larghezza di campo n (es. 001 per %{track.3})

· %T %{tracknumber} Traccia (senza zeri iniziali, ad es. 1)

· %g %{genere} Genere

· %f %{file} Nome file

· %p %{filepath} Percorso assoluto del file

· %e %{extension} Estensione file

· %O %{tag1} Il formato del tag 1 (ID3v1.1 o vuoto se non esistente)

· %o %{tag2} Il formato del tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF o vuoto se non esistente)

· %b %{bitrate} Velocità in bit in kbit/s

· %v %{vbr} VBR o vuoto (solo per ID3v2.3 con id3lib)

· %r %{samplerate} Frequenza di campionamento in Hz

· %m %{mode} Modalità canale (Stereo o Joint Stereo)

· %h %{channels} Numero di canali (1 o 2)

· %k %{codec} Codec (es. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIF, WAV)

· %1a %1{artista}, ... Usa il prefisso 1 per ottenere i valori del tag 1

· %2a %2{artista}, ... Usa il prefisso 2 per ottenere i valori del tag 2

Questi codici vengono sostituiti con i valori per il file e le stringhe risultanti possono
essere confrontato con le seguenti operazioni:

· s1 è uguale a s2: vero se s1 e s2 sono uguali.

· s1 contiene s2: vero se s1 contiene s2, ovvero s2 è una sottostringa di s1.

· s corrisponde a re: vero se s corrisponde all'espressione regolare re.

Le espressioni vere sono sostituite da 1, false da 0. I valori veri sono rappresentati da 1,
true, on e yes, false per 0, false, off e no. Le operazioni booleane non sono,
e, o (in questo ordine di precedenza) e possono essere raggruppati tra parentesi.

Alcune regole di filtro sono predefinite e possono servire come esempi per le tue espressioni:

Tutti
Quando l'elenco dei file è filtrato - questo è mostrato da "[filtrato]" nel titolo della finestra
- e tutti i file devono essere visualizzati di nuovo, il filtro può essere ripristinato usando questo
filtro. Usa un'espressione vuota, ma un valore vero avrebbe lo stesso effetto.

Mancata corrispondenza del tag del nome del file
non (%{percorso del file} contiene "%{artista} - %{album}/%{traccia} %{titolo}")

Verifica se il percorso del file è conforme al formato del nome del file. Questa regola è
adattato automaticamente se il formato del nome del file cambia.

Nessun tag 1
%{tag1} uguale ""

Visualizza solo i file che non hanno un tag 1.

Nessun tag 2
%{tag2} uguale ""

Visualizza solo i file che non hanno un tag 2.

Tag ID3v2.3.0
%{tag2} uguale "ID3v2.3.0"

Visualizza solo i file che hanno un tag ID3v2.3.0.

Tag ID3v2.4.0
%{tag2} uguale "ID3v2.4.0"

Visualizza solo i file che hanno un tag ID3v2.4.0.

Etichetta 1 != Etichetta 2
non (%1{titolo} uguale %2{titolo} ed %1{album} uguale %2{album} ed %1{artista}
uguale %2{artista} ed %1 Commento} uguale %2 Commento} ed %1 anno} uguale %2 anno}
ed %1{traccia} uguale %2{traccia} ed %1{genere} uguale %2{genere})

Visualizza i file con differenze tra tag 1 e tag2.

Etichetta 1 == Etichetta 2
%1{titolo} uguale %2{titolo} ed %1{album} uguale %2{album} ed %1{artista} uguale
%2{artista} ed %1 Commento} uguale %2 Commento} ed %1 anno} uguale %2 anno} ed
%1{traccia} uguale %2{traccia} ed %1{genere} uguale %2{genere}

Visualizza i file con tag 1 e tag 2 identici.

Incompleto
%{titolo} uguale "" or %{artista} uguale "" or %{album} uguale "" or %{anno} uguale
"" or %{numero di spedizione} uguale "" or %{genere} uguale ""

Visualizza i file con valori vuoti nei tag standard (titolo, artista, album, data,
numero di brano, genere).

Nessuna immagine
%{foto} uguale ""

Visualizza solo i file che non hanno un'immagine.

Filtro personalizzato
Per aggiungere il tuo filtro, seleziona questa voce. Ad esempio, se vuoi avere un
filtro per artisti che iniziano con "The", sostituire "Filtro personalizzato" con il nome "The
Bands" e premi Invio. Quindi inserisci la seguente espressione nella modifica della riga:

%{artista} fiammiferi "Il.*"

Quindi fare clic su Salva impostazioni. Fare clic su Applica per filtrare i file. Tutti i file elaborati sono
visualizzato nella visualizzazione testo, con un "+" per coloro che corrispondono al filtro e un "-"
per gli altri. Al termine, solo i file con un artista che iniziano con "The"
vengono visualizzati e il titolo della finestra è contrassegnato con "[filtrato]".

Strumenti → Converti ID3v2.3 in ID3v2.4
Se sono presenti tag ID3v2.3 nei file selezionati, verranno convertiti in ID3v2.4
tag. I frame che non sono supportati da TagLib verranno eliminati. Solo file senza
le modifiche non salvate verranno convertite.

Strumenti → Converti ID3v2.4 in ID3v2.3
Se sono presenti tag ID3v2.4 nei file selezionati, verranno convertiti in ID3v2.3
tag. Verranno convertiti solo i file senza modifiche non salvate.

Strumenti → Riproduci
Questo apre una semplice barra degli strumenti per riprodurre file audio. Contiene i pulsanti per la base
operazioni (Riproduzione/Pausa, Interrompi riproduzione, Traccia precedente, Traccia successiva, Chiudi), cursori per
posizione e volume e una visualizzazione della posizione corrente. Se sono presenti più file
selezionato, vengono riprodotti i brani selezionati, altrimenti verranno riprodotti tutti i file.

I Impostazioni profilo Menu
Impostazioni → Mostra barra degli strumenti
Alterna la visualizzazione della barra degli strumenti.

Impostazioni → Mostra barra di stato
Attiva/disattiva la visualizzazione della barra di stato, che mostra azioni più lunghe come l'apertura o
salvare una directory.

Impostazioni → Mostra immagine
Attiva/disattiva la visualizzazione dell'immagine di anteprima della copertina dell'album.

Impostazioni → Nascondi automaticamente i tag
I tag vuoti vengono nascosti automaticamente se questa opzione è attiva. Il file, tag 1 e tag
2 sezioni possono essere compresse ed espanse manualmente facendo clic sul corrispondente -/+
pulsanti.

Impostazioni → Configura Kid3...
Apre la finestra di configurazione, che consiste di pagine per tag, file, azioni utente,
e impostazioni di rete.

Le opzioni specifiche per i tag possono essere trovate nella pagina Tag, che è a sua volta separata in
tre schede per Tag 1, Tag 2 e Tag 1 e Tag 2.

Se Segna campi troncati è selezionato, i campi ID3v1.1 troncati verranno contrassegnati in rosso. Il
i campi di testo dei tag ID3v1.1 possono avere solo 30 caratteri, il commento solo 28
caratteri. Anche il genere e i numeri dei brani sono limitati, in modo che i campi possano essere
troncato quando importato o trasferito da ID3v2. Campi troncati e il file verrà
essere contrassegnato in rosso e il segno verrà rimosso dopo che il campo è stato modificato.

Con la codifica del testo per ID3v1 è possibile impostare il set di caratteri utilizzato in ID3v1
tag. Questa codifica dovrebbe essere ISO-8859-1, quindi si consiglia di mantenerla
valore predefinito. Tuttavia, ci sono tag in giro con una codifica diversa, quindi può essere
impostato qui e i tag ID3v1 possono quindi essere copiati su ID3v2 che supporta Unicode.

La casella di controllo Usa formato traccia/numero totale di tracce controlla se la traccia
il campo numero dei tag ID3v2 contiene semplicemente il numero della traccia o in aggiunta il totale
numero di tracce nella directory.

Quando Genere come testo anziché stringa numerica è selezionato, tutti i generi ID3v2 saranno
memorizzato come stringa di testo anche se esiste un codice corrispondente per i generi ID3v1. Se
questa opzione non è impostata, i generi per i quali esiste un codice ID3v1 sono memorizzati come numero
del codice del genere (tra parentesi per ID3v2.3). Così il genere Metal è memorizzato come
"Metallo" o "(9)" a seconda di questa opzione. Generi che non sono nella lista di ID3v1
i generi vengono sempre memorizzati come stringa di testo. Lo scopo di questa opzione è migliorato
compatibilità con dispositivi che non interpretano correttamente i codici di genere.

La codifica del testo definisce la codifica predefinita utilizzata per i frame ID3v2 e può essere impostata su
ISO-8859-1, UTF16 o UTF8. UTF8 non è valido per i frame ID3v2.3.0; se è impostato,
Verrà invece utilizzato UTF16. Per i frame ID3v2.4.0, sono possibili tutte e tre le codifiche.

La versione utilizzata per i nuovi tag determina se i nuovi tag ID3v2 vengono creati come versione
2.3.0 o 2.4.0. Nel primo caso, id3lib viene utilizzato come nelle versioni precedenti di
Kid3 e TagLib vengono applicati solo quando viene incontrato un tag ID3v2.4.0. Nel secondo
case, ID3v2.4.0 (TagLib), TagLib viene generalmente utilizzato per i file MP3; cambiato o di recente
i tag creati verranno quindi salvati nella versione 2.4.0. Quando è selezionato ID3v2.3.0 (TagLib),
TagLib viene utilizzato anche per i tag ID3v2.3.0.

Cifre del numero di traccia è il numero di cifre nei campi Numero di traccia. Gli zeri iniziali sono
usato per imbottire. Ad esempio, con un valore di 2 il numero di traccia 5 viene impostato come "05".

Il nome del campo Commento della casella combinata è rilevante solo per i file Ogg/Vorbis e FLAC e
imposta il nome del campo utilizzato per i commenti. Diverse applicazioni sembrano utilizzare
nomi diversi, "COMMENTO" per esempio è usato da xmms, mentre amaroK usa
"DESCRIZIONE".

Il formato delle immagini nei file Ogg/Vorbis è determinato dal nome del campo Immagine, che
può essere METADATA_BLOCK_PICTURE o COVERART. Il primo è lo standard ufficiale e utilizza
lo stesso formato delle immagini nei tag FLAC. COVERART è un precedente modo non ufficiale per
includere immagini nei commenti Vorbis. Può essere utilizzato per la compatibilità con legacy
giocatori.

Se la casella di controllo Segna se maggiore di è attivata, i file contenenti album incorporati
le copertine che superano la dimensione data in byte sono contrassegnate in rosso. Questo può essere usato per trovare
file contenenti immagini di grandi dimensioni che non sono accettate da alcune applicazioni e
Giocatori. Il valore predefinito è 131072 byte (128 KB).

I generi personalizzati possono essere utilizzati per definire i generi che non sono disponibili nello standard
elenco di generi, ad esempio "Gothic Metal". Tali generi personalizzati appariranno nella casella combinata Genere
di Tag 2. Per i tag ID3v1.1, possono essere utilizzati solo i generi predefiniti.

L'elenco dei generi personalizzati può essere utilizzato anche per ridurre il numero di generi disponibili in
la casella combinata Genere a quelle usate tipicamente. Se la tua raccolta contiene principalmente musica
nei generi Metal, Gothic Metal, Ancient e Hard Rock, puoi inserire quei generi
e seleziona Mostra solo generi personalizzati. La casella combinata Tag 2Genre conterrà quindi solo
quei quattro generi e non dovrai cercare nell'elenco completo dei generi per
loro. In questo esempio, solo Metal e Hard Rock saranno elencati nei generi tag 1
list, perché queste due voci di generi personalizzati sono generi standard. Se Mostra solo personalizzato
generi non è attivo, i generi personalizzati si trovano alla fine dell'elenco dei generi.

Quick Access Frames definisce quali tipi di frame sono sempre mostrati nella sezione Tag 2.
Tali frame possono quindi essere aggiunti senza prima utilizzare il pulsante Aggiungi. L'ordine di questi
i frame di accesso rapido possono essere modificati trascinando e rilasciando gli elementi.

Formato tag contiene opzioni per il formato dei tag. Quando Formatta durante la modifica è
selezionato, la configurazione del formato viene utilizzata automaticamente durante la modifica del testo nella riga
modifiche. La conversione delle maiuscole può essere impostata su Nessuna modifica, Tutto minuscolo, Tutto maiuscolo,
Prima lettera maiuscola o Tutte le prime lettere maiuscole. Per utilizzare la conversione in base alle impostazioni locali
tra caratteri minuscoli e maiuscoli, è possibile selezionare una lingua nella casella combinata
sotto. L'elenco di sostituzione delle stringhe può essere impostato su mappature di stringhe arbitrarie. Per aggiungere un
nuova mappatura, seleziona la cella Da di una riga e inserisci il testo da sostituire, quindi vai a
la colonna A e immettere il testo sostitutivo. Per rimuovere una mappatura, imposta la cella Da su
un valore vuoto (ad es. digitando prima spazio e poi backspace). Inserimento ed eliminazione
righe è anche possibile utilizzando un menu contestuale che appare quando si preme il tasto destro del mouse
viene cliccato. La sostituzione è attiva solo se la casella di controllo Sostituzione stringa è selezionata.

Nella pagina File la casella di controllo Carica gli ultimi file aperti può essere contrassegnata in modo che Kid3 lo farà
aprire e selezionare l'ultimo file selezionato al successivo avvio. Conserva
il timestamp del file può essere controllato per preservare il timestamp di modifica del file. Nome del file
for cover imposta il nome che viene suggerito quando un'immagine incorporata viene esportata in a
file.

Se Segna modifiche è attivo, i campi modificati sono contrassegnati da un'etichetta grigio chiaro
sfondo.

Filename Format contiene opzioni per il formato dei nomi dei file. Le stesse opzioni di
in formato tag sono disponibili.

La pagina Azioni utente contiene una tabella con i comandi disponibili nel
menu contestuale dell'elenco dei file. Per operazioni critiche come l'eliminazione di file, è
consigliabile contrassegnare Conferma per far apparire una finestra di dialogo di conferma prima di eseguire il
comando. L'output può essere contrassegnato per vedere l'output scritto dai comandi della console (standard
output ed errore standard). Nome è il nome visualizzato nel menu contestuale. Comando
è la riga di comando da eseguire. Gli argomenti possono essere passati utilizzando i seguenti codici:

· %F %{files} Percorsi file (un elenco se sono selezionati più file)

· %f %{file} Percorso del file per un singolo file

· %uF %{urls} URL (un elenco se sono stati selezionati più file)

· %uf %{url} URL di un singolo file

· %d %{directory} Directory

· %s %{title} Titolo (canzone)

· %a %{artista} Artista

· %l %{album} Album

· %c %{comment} Commento

· %y %{year} anno

· %t %{traccia} Traccia (es 01)

· %t %{track.n} Traccia con larghezza di campo n (es. 001 per %{track.3})

· %T %{tracknumber} Traccia (senza zeri iniziali, ad es. 1)

· %g %{genere} Genere

· %b %{browser} Comando per avviare il browser web

· %q %{qmlpath} Directory di base dei file QML forniti

Il codice speciale @separatore può essere impostato come comando per inserire un separatore nel
menu di scelta rapida delle azioni dell'utente. Le voci di menu possono essere inserite in un sottomenu racchiudendole con
@iniziomenu ed @endmenu comandi. Il nome del sottomenu è determinato dal Nome
colonna del @iniziomenu comando.

Per eseguire script QML, @qml viene utilizzato come nome di comando. Il percorso dello script QML è
passato come parametro. Gli script forniti possono essere trovati nella cartella
%{qmlpath}/script/ (su Linux in genere /usr/share/kid3/qml/script/, su Windows
qml/script/ all'interno della directory di installazione e su OS X nella cartella dell'app
kid3.app/Contents/Resources/qml/script/). Gli script personalizzati possono essere memorizzati in qualsiasi
directory. Se il codice QML utilizza componenti GUI, @qmlview deve essere utilizzato al posto di
@qml. Parametri aggiuntivi vengono passati allo script QML dove saranno disponibili
tramite getArgomenti() funzione. Una panoramica di alcune funzioni e proprietà che
sono disponibili in QML possono essere trovati nell'appendice Interfaccia QML.

Il comando che verrà inserito con %{browser} può essere definito nel browser Web
modifica della riga sopra. I comandi che iniziano con %{browser} possono essere usati per recuperare informazioni
sui file audio dal web, per esempio

%{browser} http://lyricwiki.org/%u{artista}:%u{titolo}

interrogherà il testo della canzone corrente in Lyricwiki[10]. La "u" in %u{artista} e
%u{title} viene utilizzato per codificare l'URL delle informazioni sull'artista %{artist} e sulla canzone %{title}. Esso
è facile definire le proprie query allo stesso modo, ad esempio una ricerca di immagini con
Google[11]:

%{browser} http://images.google.com/images?q=%u{artista}%20%u{album}

Per aggiungere la copertina dell'album al tag 2, puoi cercare immagini con Google o Amazon usando
i comandi sopra descritti. L'immagine può essere aggiunta al tag trascinandola.
Puoi anche aggiungere un'immagine con Aggiungi, quindi selezionare la Cornice immagine e importare un'immagine
file o incolla dagli appunti. Le cornici sono supportate per ID3v2, MP4, FLAC,
Tag Ogg e ASF.

Per aggiungere ed eliminare voci nella tabella, è possibile utilizzare un menu di scelta rapida.

La pagina Rete contiene solo un campo per inserire l'indirizzo proxy e facoltativamente il
porto, separato da due punti. Il proxy verrà utilizzato durante l'importazione da Internet
server quando la casella di controllo è selezionata.

Nella pagina Plugin, i plugin disponibili possono essere abilitati o disabilitati. I plugin sono
separato in due sezioni. L'elenco Metadati Plugin e priorità contiene plug-in
che supportano i formati di file audio. L'ordine dei plugin è importante perché
vengono provati dall'alto verso il basso. Alcuni formati sono supportati da più plugin, quindi file
verrà aperto con il primo plugin che li supporta. Il TaglibMetadata supporta la maggior parte
formati, se è in cima all'elenco, aprirà la maggior parte dei file. Se vuoi
per usare un plugin diverso per un formato di file, assicurati che sia elencato prima del
Plugin TaglibMetadata. Dettagli sul plug-in dei metadati e sul motivo per cui potresti volerlo utilizzare
loro invece di TagLib sono elencati di seguito.

· Id3libMetadata: usi id3lib[12] per i tag ID3v1.1 e ID3v2.3 in MP3, MP2, AAC
File. Supporta alcuni tipi di frame in più rispetto a TagLib. Un altro motivo per usarlo è
che TagLib supporta solo ID3v2.3 dalla versione 1.8.

· Metadati OggFlac: usi libogg[13], libvorbis, libvorbisfile[14] per i file Ogg, e
inoltre libFLAC++ ed libFLAC[15] per i file FLAC. I motivi per usarli sono
immagini nei file Ogg, che non sono supportati da TagLib e che questi sono i
librerie ufficiali per questi formati.

· TaglibMetadata: usi TagLib[16] che supporta molti formati di file audio. Da quando
versione 1.8, supporta anche ID3v2.3, quindi può essere utilizzato per tutti i file audio
supportato da Kid3.

· Mp4v2 Metadati: mp4v2[17] è stato originariamente utilizzato da Kid3 per supportare i file M4A.
Tuttavia, le versioni più recenti di TagLib forniscono un buon supporto M4A, quindi questo plugin non lo è
costruito per impostazione predefinita.

La sezione Plugin disponibili elenca i plugin rimanenti. Il loro ordine non è
importanti, ma possono essere abilitati o disabilitati utilizzando le caselle di controllo.

· AmazonImport: utilizzato per la funzione Importa da Amazon....

· DiscogsImport: utilizzato per la funzione Importa da Discogs....

· FreedbImport: utilizzato per l'importazione da gnudb.org... e l'importazione da
TrackType.org... funzioni.

· MusicBrainzImport: utilizzato per la funzione Importa da MusicBrainz Release....

· AcoustidImport: utilizzato per la funzione Import from MusicBrainz Fingerprint...,
che dipende dal stampa cromatica[18] e libava[19] biblioteche.

I plugin disabilitati non verranno caricati. Questo può essere usato per ottimizzare le risorse
utilizzo e tempo di avvio. Le impostazioni in questa pagina hanno effetto solo dopo un riavvio di
bambino3.

Impostazioni → Configura scorciatoie...
Apre una finestra di dialogo per assegnare le scorciatoie da tastiera per la maggior parte delle funzioni del programma. Là
sono anche funzioni senza menu o pulsante corrispondenti disponibili, ad esempio file successivo,
file precedente, seleziona tutto.

I Aiuto Menu
Aiuto → Manuale Kid3
Apre questo manuale.

Aiuto → Informazioni su Kid3
Visualizza una breve informazione su Kid3;.

KID3-CLI

Comandi
kid3-cli offre un'interfaccia a riga di comando per Kid3. Se viene utilizzato un percorso di directory, il
la directory è aperta. Se vengono forniti uno o più percorsi di file, viene aperta la directory comune
e i file sono selezionati. I comandi successivi funzioneranno quindi su questi file. Comandi
sono specificati usando -c opzioni. Se vengono passati più comandi, vengono eseguiti nel
dato ordine. Se i file vengono modificati dai comandi, verranno salvati alla fine. se no
le opzioni di comando sono passate, kid3-cli si avvia in modalità interattiva. I comandi possono essere inseriti
e opererà sulla selezione corrente. Le sezioni seguenti elencano tutte disponibili
comandi.

Aiuto
Aiuto [COMANDO-NOME]

Visualizza la guida sui parametri di COMANDO-NOME o su tutti i comandi se nessun comando
viene dato il nome.

timeout
timeout [predefinito | spento | ORARIO]

Sovrascrivi il timeout del comando predefinito. I comandi CLI si interrompono dopo un comando specifico
il timeout è scaduto. Questo timeout è di 10 secondi per ls ed copertina dell'album, 60 secondi per
importazione automatica ed filtroe 3 secondi per tutti gli altri comandi. Se un numero enorme di file
deve essere elaborato, questo timeout potrebbe essere troppo restrittivo, quindi il timeout per tutti
i comandi possono essere impostati su ORARIO ms, spento del tutto o lasciato all'impostazione predefinita
valori.

smettere applicazione
exit [forza]

Esci dall'applicazione. Se sono presenti file modificati non salvati, forza il parametro è
richiesto.

Cambiamento di elenco
cd [DIRECTORY]

Se no DIRECTORY è dato, passare alla directory home. Se viene fornita una directory,
cambiare nella directory. Se vengono forniti uno o più percorsi di file, passare al loro comune
directory e selezionare i file.

Stampa , il corrente lavoro elenco
pwd

Stampa il nome del file della directory di lavoro corrente.

elenco stratagemma
ls

Elenca il contenuto della directory corrente. Corrisponde all'elenco dei file in
Kid3 GUI. Quattro caratteri prima dei nomi dei file mostrano lo stato del file.

· > Il file è selezionato.

· * Il file è stato modificato.

· 1 Il file ha un tag 1, altrimenti viene visualizzato '-'.

· 2 Il file ha un tag 2, altrimenti viene visualizzato '-'.

kid3-cli> ls
1- 01 Introduzione.mp3
> 12 02 Abbiamo solo questo.mp3
*1- 03 Outro.mp3

In questo esempio, tutti i file hanno un tag 1, anche il secondo file ha un tag 2 ed è
selezionato. Il terzo file viene modificato.

Risparmi , il cambiato file
salvare

Seleziona filetto
select [tutti | nessuno | prima | precedente | successivo | RISORSE...]

Per selezionare tutti i file, inserisci select contro tutti i, per deselezionare tutti i file, invio select nessuna. A
attraversa i file nella directory corrente inizia con select prima di tutto, poi vai avanti
utilizzando select GENERAZIONE o indietro usando select precedente. È possibile aggiungere file specifici a
la selezione corrente dando i loro nomi di file. I caratteri jolly sono possibili, quindi select
* .mp3 selezionerà tutti i file MP3 nella directory corrente.

kid3-cli> select prima di tutto
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Abbiamo solo questo.mp3
*1- 03 Outro.mp3
kid3-cli> select GENERAZIONE
kid3-cli> ls
1- 01 Introduzione.mp3
> 12 02 Abbiamo solo questo.mp3
*1- 03 Outro.mp3
kid3-cli> select * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 Abbiamo solo questo.mp3
>*1- 03 Outro.mp3

Seleziona etichetta
etichetta [TAG-NUMERI]

Molti comandi hanno un optional TAG-NUMERI parametro, che specifica se il
il comando opera sul tag 1 o sul tag 2. Se questo parametro viene omesso, il tag predefinito
vengono utilizzati i numeri, che possono essere impostati con questo comando. All'avvio, è impostato su 12 che
significa che l'informazione viene letta dal tag 2 se disponibile, altrimenti dal tag 1; modifiche
sono fatti sul tag 2. Il TAG-NUMERI può essere impostato su 1 or 2 operare solo sul
etichetta corrispondente. Se il parametro viene omesso, viene visualizzata l'impostazione corrente.

Ottieni etichetta telaio
ottenere [tutti | NOME TELAIO] [TAG-NUMERI]

Questo comando può essere utilizzato per leggere il valore di un tag frame specifico o ottenere informazioni
su tutti i frame di tag (se l'argomentoèomesso o contro tutti i viene utilizzato). I frame modificati sono
contrassegnato con un '*'.

kid3-cli> ottenere
File: MPEG 1 Layer 3 192 kbps 44100 Hz Stereo congiunto
Nome: 01 Intro.mp3
Etichetta 1: ID3v1.1
Titolo Intro
Artista One Hit Wonder
Album Let's Tag
data 2013
Traccia numero 1
Genere Pop
kid3-cli> ottenere titolo
Intro

Per salvare il contenuto di una cornice in un file, utilizzare

ottenere immagine:"/percorso/della/cartella.jpg"

Per salvare i testi sincronizzati in un file LRC, utilizzare

ottenere SYLT:"/path/to/lyrics.lrc"

Impostato etichetta telaio
set {NOME TELAIO} {FRAME-VALORE} [TAG-NUMERI]

Questo comando imposta il valore di un tag frame specifico.

kid3-cli> set remixer "OH Meraviglia"

Per impostare il contenuto di una cornice da un file, utilizzare

set immagine:"/percorso/della/cartella.jpg" "Immagine Descrizione"

Per impostare i testi sincronizzati da un file LRC, usare

set SYLT:"/path/to/lyrics.lrc" "Testi Descrizione"

Ritornare
ritornare

Ripristina tutte le modifiche nei file selezionati (o tutti i file se non lo sono
selezionato).

Importare da filetto or Appunti
importare {RISORSE} {FORMATO-NOME} [TAG-NUMERI]

I tag vengono importati dal file RISORSE (o dagli appunti se Appunti è usato per
RISORSE) nel formato con il nome FORMATO-NOME (per esempio "CSV non quotato", vedere Importa).

Automatico importare
importazione automatica [NOME DEL PROFILO] [TAG-NUMERI]

Importazione batch utilizzando il profilo NOME DEL PROFILO (vedi Importazione automatica, "Tutto" è usato se
omesso).

Scaricare album coprire opere d'arte
copertina dell'album {URL} [Tutti]

Imposta la copertina dell'album scaricando un'immagine da URL. Le regole definite nel
La finestra di dialogo Sfoglia copertine viene utilizzata per trasformare URL generici (ad es. da Amazon) in a
URL dell'immagine. Per impostare la copertina dell'album da un file immagine locale, utilizzare il comando set.

kid3-cli> copertina dell'album
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Esportare a filetto or Appunti
export {RISORSE} {FORMATO-NOME} [TAG-NUMERI]

I tag vengono esportati su file RISORSE (o negli appunti se Appunti è usato per RISORSE) in
il formato con il nome FORMATO-NOME (per esempio "CSV non quotato", vedere Esporta).

Creare playlist
playlist

Crea playlist nel formato impostato nella configurazione, vedi Crea playlist.

APPLICA Nome del file formato
nomefileformat

Applicare il formato del nome file impostato nella configurazione, vedere Applicare il formato del nome file.

APPLICA etichetta formato
formato tag

Applicare il formato del nome del tag impostato nella configurazione, vedere Applicare il formato del tag.

APPLICA testo codifica
codifica del testo

Applicare il set di codifica del testo nella configurazione, vedere Applicare la codifica del testo.

Rinominare elenco
rinominare [FORMATO] [crea | rinomina | funzionamento a secco] [TAG-NUMERI]

Rinominare o creare directory dai valori nei tag in base a un dato FORMATO
(per esempio %{artista} - %{album}, vedere Rinomina directory), se non viene fornito alcun formato, il formato
definito nella finestra di dialogo Rinomina directory viene utilizzato. La modalità predefinita è rinominare; creare
directory, creare deve essere dato esplicitamente. Le azioni di ridenominazione verranno eseguite
immediatamente, per vedere cosa sarebbe stato fatto, usa il funzionamento a secco opzione.

Numero brani
tracce numeriche [NUMERO DI SPEDIZIONE] [TAG-NUMERI]

Numera le tracce selezionate iniziando con NUMERO DI SPEDIZIONE (1 se omesso).

Filtro
filtro [FILTRO-NOME | FILTRO-FORMATO]

Filtra i file in modo che solo i file che corrispondono a FILTRO-FORMATO sono visibili. Il
nome di un'espressione di filtro predefinita (es "Nome del file Etichetta Mancata corrispondenza") può essere utilizzato
invece di un'espressione di filtro, vedere Filtro.

kid3-cli> filtro '%{titolo} contiene "tro"'
Cominciato
/home/urs/One Hit Wonder - Taggati
+ 01 Introduzione.mp3
- 02 Abbiamo solo questo.mp3
+ 03 Outro.mp3
Finito
kid3-cli> ls
1- 01 Introduzione.mp3
1- 03 Outro.mp3
kid3-cli> filtro Tutti
Cominciato
/home/urs/One Hit Wonder - Taggati
+ 01 Introduzione.mp3
+ 02 Abbiamo solo questo.mp3
+ 03 Outro.mp3
Finito
kid3-cli> ls
1- 01 Introduzione.mp3
12 02 Abbiamo solo questo.mp3
1- 03 Outro.mp3

convertire ID3v2.3 a ID3v2.4
to24

convertire ID3v2.4 a ID3v2.3
to23

Nome del file da etichetta
da tag [FORMATO] [TAG-NUMERI]

Imposta i nomi dei file dei file selezionati dai valori nei tag, ad esempio da tag
"%{traccia} - %{titolo}" 1. Se non viene specificato alcun formato, viene utilizzato il formato impostato nella GUI.

Etichetta da Nome del file
taggare [FORMATO] [TAG-NUMERI]

Imposta i frame dei tag dai nomi dei file, ad esempio taggare "%{artista album} -
%{album}/%{traccia} %{titolo}" 2. Se non viene specificato alcun formato, il formato impostato nella GUI è
Usato. Se il formato del nome del file non corrisponde a questo modello, alcuni altri comunemente
vengono provati i formati utilizzati.

Etichetta a Altro etichetta
sincronizzato {NUMERO IDENTIFICATIVO}

Copia i frame dei tag da un tag all'altro, ad esempio per impostare il tag ID3v2 dal
Tag ID3v1, usa sincronizzato 2.

Copia
copia [NUMERO IDENTIFICATIVO]

Copia i frame tag del file selezionato nel buffer di copia interno. Possono quindi essere
impostare su un altro file utilizzando il incolla comando.

Incolla
incolla [NUMERO IDENTIFICATIVO]

Imposta i frame tag dal contenuto del copia buffer nei file selezionati.

Rimuovere
rimuovere [NUMERO IDENTIFICATIVO]

Rimuovere un'etichetta.

Giocare
PLAY [pausa | fermare | precedente | prossimo]

Avvia la riproduzione dell'audio. Una volta avviato, può essere comandato con il pausa
(per mettere in pausa e riprendere), Stop, precedente ed GENERAZIONE opzioni.

Esempi
Imposta la copertina dell'album in tutti i file di una directory utilizzando la funzione di importazione batch:

kid3-cli -c "importazione automatica" "Coperchio Arte"' /percorso/di/dir

Rimuovi i frame di commento e applica il formato del tag in entrambi i tag di tutti i file MP3 di a
directory:

kid3-cli -c 'set commento "" 1' -c 'set commento "" 2' \
-c 'formato tag' 1' -c 'formato tag' 2' /percorso/a/dir/*.mp3

Importa automaticamente il tag 2, sincronizza con il tag 1, imposta i nomi dei file dal tag 2 e infine
creare una playlist:

kid3-cli -c importazione automatica -c 'sincrono' 1' -c da tag -c playlist \
/percorso/a/dir/*.mp3

Per tutti i file con un tag ID3v2.4.0, converti in ID3v2.3.0 e rimuovi il frame arranger:

kid3-cli -c "filtro 'ID3v2.4.0 Etichetta'" -c "Selezionare Tutti" -c to23 \
-c "set organizzare ''" /percorso/di/dir

Questo script Python usa kid3-cli per generare i frame iTunes Sound Check iTunNORM da
riprodurre le informazioni di guadagno.

#!/usr/bin/env python
# Genera il controllo audio di iTunes da ReplayGain.
da __future__ import print_function
importa os, sys, sottoprocesso

def rg2sc(percorso):
per root, dirs, file in os.walk(dirpath):
per nome nei file:
if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join(radice, nome)
rg = sottoprocesso.check_output([
'kid3-cli', '-c', 'ottieni "replaygain_track_gain"',
fn]).striscia()
if rg.endswith(b' dB'):
RG = RG[:-3]
provare:
rg = float(rg)
tranne ValueError:
print('Valore %s di %s non in float' % (rg, fn))
continua
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
sottoprocesso.call([
'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

se __name__ == '__main__':
rg2sc(sys.argv[1])

CREDITS E LICENZA ILLIMITATA

Kid3

Programma scritto da Urs Fleisch

LDF,

GPL,

MONTAGGIO

Come a ottenere Kid3
Kid3 può essere trovato su http://kid3.sourceforge.net.

Requisiti
Kid3 ha bisogno Qt[22]. KDE[23] è consigliato ma non necessario, poiché anche Kid3 può essere compilato
come applicazione Qt. Kid3 può essere compilato per i sistemi in cui sono presenti queste librerie
disponibile, ad esempio per GNU/Linux, Windows e Mac OS X. Per contrassegnare i file Ogg/Vorbis, libogg[13],
libvorbis ed libvorbisfile[14] sono obbligatori, per i file FLAC libFLAC++ ed libFLAC[15].
id3lib[12] viene utilizzato per i file MP3. Questi quattro formati sono supportati anche da TagLib[16],
che può anche gestire file Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
e moduli di localizzazione. Per importare da impronte acustiche, stampa cromatica[18] e libava,
sono usati.

Kid3 è disponibile per la maggior parte delle distribuzioni Linux, Windows e Mac OS X. È possibile trovare collegamenti
on http://kid3.sourceforge.net.

compilazione ed Installazione
Puoi compilare Kid3 con o senza KDE. Senza KDE, Kid3 è una semplice applicazione Qt e
manca di alcune funzionalità di configurazione e sessione.

Per una versione di KDE, vai nella directory in alto e digita

% cMake .
% make
% make install

Per compilare per diverse versioni di Qt o KDE, imposta il corrispondente cMake opzioni.

Se non sono presenti tutte le librerie, Kid3 è costruito con funzionalità ridotte. Quindi dovresti
fare attenzione ad avere tutti i pacchetti di sviluppo desiderati installati. Dall'altro lato,
cMake-options controlla in quali librerie sono compilate. L'impostazione predefinita è -D
CON_TAGLIB:BOOL=ON -D CON_MP4V2:BOOL=OFF -D WITH_ID3LIB:BOOL=ON -D
WITH_CHROMAPRINT:BOOL=ON -D WITH_VORBIS:BOOL=ON -D CON_FLAC:BOOL=ON . Queste opzioni possono
essere disabilitato usando OFF.

Per compilare Kid3 come applicazione Qt senza KDE, usa il cMake opzione -DWITH_APPS=Qt. A
crea sia un'applicazione KDE che Qt, set -DWITH_APPS="Qt;KDE".

È possibile utilizzare Qt 4 o Qt 5. Per forzare l'uso di Qt 4, impostare -CON_QT4=ON, per forzare l'uso di
Qt 5, impostare -CON_QT5=ON, se entrambe queste opzioni sono OFF (predefinito), Qt 4 è preferito se
entrambe le versioni sono installate. Per utilizzare un'installazione Qt specifica, impostare
-DQT_QMAKE_EXECUTABLE=/percorso/a/qmake. Se la compilazione dell'applicazione KDE è abilitata, impostando
Qt 4 utilizzerà KDE 4, mentre l'impostazione Qt 5 utilizzerà KDE 5.

La generazione di pacchetti RPM è supportata dal file kid3.spec, per i pacchetti Debian, il
script build-deb.shi è disponibile.

L'applicazione Qt può essere compilata anche per Windows e Mac OS X. Gli script in
le cartelle win32 e macosx possono essere utilizzate per compilare e creare pacchetti. Le biblioteche possono essere
installato utilizzando buildlibs.sh.

Configurazione
Con KDE, il filtro e il formato del nome del file, i formati di importazione, il nome del file e l'ID3
formati, le impostazioni della barra degli strumenti e della barra di stato e le dimensioni della finestra verranno salvate in
la posizione standard nel file kid3rc. Come applicazione Qt, questo file è in
.config/Kid3/Kid3.conf. Su Windows, la configurazione è archiviata nel registro.

D-BUS INTERFACCIA

autobus D Esempi
Le versioni Qt 4 e KDE 4 su Linux offrono un'interfaccia D-Bus per controllare Kid3 tramite script.
Gli script possono essere scritti in qualsiasi linguaggio con collegamenti D-Bus (ad es. in Python) e possono essere
aggiunto alle Azioni utente per estendere le funzionalità di Kid3.

L'artista nel tag 2 del file corrente può essere impostato al valore "One Hit Wonder" con il
seguente codice:

Conchiglia

dbus-send --dest=net.sourceforge.kid3 --print-reply=letterale \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 string:'Artista' \
stringa:'One Hit Wonder'

o più facile con Qt's qdbus (visualizzatore di qdbus può essere utilizzato per esplorare l'interfaccia in una GUI):

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Artista \
'Un colpo fantastico'

Python

importa dbus
kid3 = dbus.SessionBus().get_object(
'net.sourceforge.kid3', '/Kid3')
kid3.setFrame(2, 'Artista', 'One Hit Wonder')

Perl

usa Net::DBus;
$kid3 = Net::DBus->session->get_service(
"net.sourceforge.kid3")->get_object(
"/Kid3", "net.sourceforge.Kid3");
$kid3->setFrame(2, "Artista", "One Hit Wonder");

autobus D API
L'API D-Bus è specificata in net.sourceforge.Kid3.xml. L'interfaccia Kid3 ha il
i seguenti metodi:

Apri filetto or elenco
booleano openDirectory(stringa) sentiero);

sentiero
percorso del file o della directory

Restituisce vero se OK.

Risparmi contro tutti i modificato file
booleano salva (vuoto);

Restituisce vero se OK.

Ottieni a dettagliati errore messaggio purché by alcuni metodi
stringa getErrorMessage(nullo);

Restituisce un messaggio di errore dettagliato.

Ritornare i cambiamenti in , il selezionato file
ripristinare (vuoto);

Inizio an automaticamente in Sistemi partita importare
booleano importazione batch(int32 tagMaschera, stringa nome del profilo);

tagMaschera
maschera tag (bit 0 per tag 1, bit 1 per tag 2)

nome del profilo
nome del profilo di importazione batch da utilizzare

Importare tag da a filetto
booleano importFromFile(int32 tagMaschera, stringa sentiero, int32 fmtIdx);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

sentiero
percorso del file

fmtIdx
indice del formato

Restituisce vero se OK.

Scaricare album coprire arte
scaricaAlbumArt(string URL, booleano tuttiFileInDir);

URL
URL del file immagine o della risorsa copertina dell'album

tuttiFileInDir
true per aggiungere l'immagine a tutti i file nella directory

Esportare tag a a filetto
booleano esportaSuFile(int32 tagMaschera, stringa sentiero, int32 fmtIdx);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

sentiero
percorso del file

fmtIdx
indice del formato

Restituisce vero se OK.

Creare a playlist
booleano createPlaylist(vuoto);

Restituisce vero se OK.

smettere , il applicazione
esci (vuoto);

Seleziona contro tutti i file
selezionaTutto(vuoto);

Deseleziona contro tutti i file
deselezionaTutto(vuoto);

Impostato , il prima di tutto filetto as , il corrente filetto
booleano primoFile(vuoto);

Restituisce vero se c'è un primo file.

Impostato , il precedente filetto as , il corrente filetto
booleano precedenteFile(void);

Restituisce true se è presente un file precedente.

Impostato , il GENERAZIONE filetto as , il corrente filetto
booleano nextFile(nullo);

Restituisce true se è presente un file successivo.

Seleziona , il prima di tutto filetto
booleano selectFirstFile(nullo);

Restituisce vero se c'è un primo file.

Seleziona , il precedente filetto
booleano selectFilePrecedente(nulla);

Restituisce true se è presente un file precedente.

Seleziona , il GENERAZIONE filetto
booleano selectNextFile(nullo);

Restituisce true se è presente un file successivo.

Seleziona , il corrente filetto
booleano selezionaFileCorrente(vuoto);

Restituisce true se è presente un file corrente.

Espandere or crollo , il corrente filetto articolo if it is a elenco
booleano expandDirectory(vuoto);

Un elemento dell'elenco file è una directory se getFileName() restituisce un nome con '/' come ultimo
carattere.

Restituisce vero se l'elemento del file corrente è una directory.

APPLICA , il filetto Nome formato
applyFilenameFormat(void);

APPLICA , il etichetta formato
applyTagFormat(void);

APPLICA testo codifica
applyTextEncoding(void);

Impostato , il elenco Nome da , il tag
booleano setDirNameFromTag(int32 tagMaschera, stringa formato, booleano creare);

tagMaschera
maschera tag (bit 0 per tag 1, bit 1 per tag 2)

formato
formato del nome della directory

creare
vero per creare, falso per rinominare

Restituisce true se OK, altrimenti il ​​messaggio di errore è disponibile utilizzando getErrorMessage().

Impostato successivo pista numeri in , il selezionato file
numeroTracce(int32 tagMaschera, int32 primoTracciaNr);

tagMaschera
maschera tag (bit 0 per tag 1, bit 1 per tag 2)

primoTracciaNr
numero da utilizzare per il primo file

Filtro , il file
filtro(stringa espressione);

espressione
espressione di filtro

convertire ID3v2.3 tag a ID3v2.4
convertToId3v24 (vuoto);

convertire ID3v2.4 tag a ID3v2.3
convertToId3v23 (vuoto);

Restituisce vero se OK.

Ottieni sentiero of elenco
stringa getNomeDirectory(void);

Restituisce il percorso assoluto della directory.

Ottieni Nome of corrente filetto
stringa getNomeFile(vuoto);

Restituisce il vero nome assoluto del file, termina con "/" se è una directory.

Impostato Nome of selezionato filetto
setFileName (stringa) Nome);

Nome
nome del file

Il file verrà rinominato quando la directory viene salvata.

Impostato formato a uso quando regolazione , il Nome del file da , il tag
setNomeFileFormato(stringa formato);

formato
formato del nome del file

Impostato , il filetto nomi of , il selezionato file da , il tag
setNomeFileDaTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Ottieni APPREZZIAMO of telaio
stringa getFrame(int32 tagMaschera, stringa Nome);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Nome
nome della cornice (es. "artista")

Per ottenere dati binari come un'immagine, il nome di un file da scrivere può essere aggiunto dopo il
Nome, ad esempio "Immagine:/percorso/a/file". Allo stesso modo, i testi sincronizzati possono essere
esportato, ad esempio "SYLT:/percorso/a/file".

Restituisce il valore di frame.

Impostato APPREZZIAMO of telaio
booleano setFrame(int32 tagMaschera, stringa Nome, stringa APPREZZIAMO);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Nome
nome della cornice (es. "artista")

APPREZZIAMO
valore del frame

Per l'etichetta 2 (tagMaschera 2), se nessuna cornice con Nome esiste, viene aggiunto un nuovo frame, se APPREZZIAMO is
vuoto, il frame viene eliminato. Per aggiungere dati binari come un'immagine, è possibile aggiungere un file
dopo l' Nome, ad esempio "Immagine:/percorso/a/file". "SYLT:/percorso/di/file" può essere usato per
importare testi sincronizzati.

Restituisce vero se OK.

Ottieni contro tutti i montatura of a etichetta
schieramento of stringa getTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Restituisce un elenco con nomi e valori di frame alternati.

Ottieni tecnico informazioni circa filetto
schieramento of stringa getInformation(vuoto);

Le proprietà sono Formato, Bitrate, Samplerate, Canali, Durata, Modalità canale, VBR, Tag
1, Tag 2. Le proprietà non disponibili vengono omesse.

Restituisce un elenco con nomi e valori di proprietà alternati.

Impostato etichetta da filetto Nome
setTagFromFileName(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Impostato etichetta da Altro etichetta
setTagFromOtherTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Copia etichetta
copiaTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Incolla etichetta
incollaTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

Rimuovere etichetta
rimuoviTag(int32 tagMaschera);

tagMaschera
bit tag (1 per tag 1, 2 per tag 2)

analisi , il configurazione
reparseConfigurazione(void);

Le modifiche automatizzate alla configurazione sono possibili modificando il file di configurazione e
quindi rielaborando la configurazione.

Riproduce , il selezionato file
playAudio (vuoto);

QML INTERFACCIA

QML Esempi
Gli script QML possono essere invocati tramite il menu contestuale dell'elenco dei file e possono essere impostati nella scheda
Azioni utente della finestra di dialogo delle impostazioni. Gli script che sono impostati possono essere usati come
esempi per programmare script personalizzati. QML utilizza JavaScript, ecco l'obbligatorio "Hello
Mondo":

importa Kid3 1.0

Kid3Script {
in esecuzione: {
console.log("Ciao mondo, la directory è", app.dirName)
Qt.quit()
}
}

Se questo script viene salvato come /path/to/Example.qml, il comando utente può essere definito come @qml
/percorso/per/Esempio.qml con il nome QML Test e Output selezionato. Può quindi essere avviato utilizzando
l'elemento QML Test nel menu contestuale dell'elenco dei file e l'output sarà visibile nel
finestra.

In alternativa, lo script potrebbe anche essere avviato indipendentemente da Kid3 utilizzando gli strumenti QML.

qmlviewer -I /usr/lib/kid3/plugins/imports /percorso/dell'esempio.qml

Per Qt 5, i comandi

qml -apptype widget -I /usr/lib/kid3/plugins/imports /percorso/dell'Esempio.qml

or

qmlscene -I /usr/lib/kid3/plugins/imports /percorso/dell'esempio.qml

può essere utilizzato. Su Windows e OS X, il percorso di importazione deve essere adattato alla cartella delle importazioni
all'interno della directory di installazione. Gli script avviati al di fuori di Kid3 utilizzeranno l'attuale
directory, quindi dovrebbe essere cambiato in anticipo.

Per elencare i titoli nei tag 2 di tutti i file nella directory corrente, quanto segue
script potrebbe essere utilizzato:

importa Kid3 1.0

Kid3Script {
in esecuzione: {
app.firstFile()
fare {
se (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2, "titolo"))
} mentre (app.nextFile())
}
}

Se la directory contiene molti file, uno script di questo tipo potrebbe bloccare l'interfaccia utente per
a volte. Per operazioni più lunghe, dovrebbe quindi fare una pausa di tanto in tanto. Il
l'implementazione alternativa di seguito ha il lavoro per un singolo file spostato in una funzione.
Questa funzione si richiama con un timeout di 1 ms alla fine, dato che hanno più file
essere processato. Ciò assicurerà che la GUI rimanga reattiva mentre lo script è
esecuzione.

importa Kid3 1.0

Kid3Script {
in esecuzione: {
funzione doWork() {
se (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2, "titolo"))
}
se (!app.nextFile()) {
Qt.quit()
} Else {
setTimeout(doWork, 1)
}
}

app.firstFile()
lavora()
}
}

Altri script di esempio vengono forniti con Kid3 e sono già registrati come comandi utente.

· Da ReplayGain a SoundCheck (ReplayGain2SoundCheck.qml): crea iTunNORM SoundCheck
informazioni dai frame di guadagno della riproduzione.

· Ridimensiona la copertina dell'album (ResizeAlbumArt.qml): ridimensiona le immagini di copertina incorporate che sono
maggiore di 500x500 pixel.

· Estrai la copertina dell'album (ExtractAlbumArt.qml): estrai tutte le immagini di copertina incorporate
evitando duplicati.

· Incorpora la copertina dell'album (EmbedAlbumArt.qml): incorpora la copertina trovata nei file di immagine nell'audio
file nella stessa cartella.

· Incorpora testi (EmbedLyrics.qml): recupera i testi non sincronizzati dal servizio web.

· Text Encoding ID3v1 (ShowTextEncodingV1.qml): aiuta a trovare la codifica dei tag ID3v1
mostrando i tag del file corrente in tutte le codifiche di caratteri disponibili.

· Esporta CSV (ExportCsv.qml): Esporta ricorsivamente tutti i tag di tutti i file in un file CSV.

· Console QML (QmlConsole.qml): console semplice per giocare con l'API QML di Kid3.

QML API
L'API può essere facilmente esplorata utilizzando la console QML, disponibile come esempio
script con un'interfaccia utente.

Kid3Script
Kid3Script è un normale componente QML situato all'interno della directory dei plugin. Potresti
usa anche un altro componente QML. L'uso di Kid3Script semplifica l'avvio del
funzione di script utilizzando il in esecuzione gestore del segnale Nasconde anche le differenze tra
le versioni QtQuick, così da rendere gli script compatibili sia con Qt 4 che con Qt 5.
Inoltre offre alcune funzioni:

onRun: gestore del segnale che viene invocato all'avvio dello script
tagv1, tagv2, tagv2v1: costanti per i parametri dei tag
script: accesso alle funzioni di scripting
configs: accesso agli oggetti di configurazione
getArguments(): elenco degli argomenti dello script
isStandalone(): true se lo script non è stato avviato da Kid3
setTimeout(callback, delay): avvia la richiamata dopo il ritardo ms

Scripting funzioni
Poiché JavaScript e quindi anche QML hanno solo un insieme limitato di funzioni per lo scripting,
, il copione oggetto ha alcuni metodi aggiuntivi, ad esempio:

script.properties(obj): Stringa con proprietà Qt
script.writeFile(filePath, data): scrivi dati su file, vero se OK
script.readFile(filePath): legge i dati dal file
script.removeFile(filePath): elimina il file, vero se OK
script.fileExists(filePath): vero se il file esiste
script.renameFile(oldName, newName): rinomina il file, vero se OK
script.tempPath(): percorso della directory temporanea
script.listDir(path, [nameFilters], [classify]): Elenca le voci della directory
script.system(program, [args], [msecs]): avvia in modo sincrono un comando di sistema,
[codice di uscita, output standard, errore standard] se non timeout
script.getEnv(varName): Ottieni il valore della variabile di ambiente
script.setEnv(varName, value): imposta il valore della variabile di ambiente
script.getQtVersion(): stringa della versione Qt, ad esempio "5.4.1"
script.getDataMd5(data): ottiene la stringa esadecimale dell'hash MD5 dei dati
script.getDataSize(data): ottieni la dimensione dell'array di byte
script.dataToImage(data, [format]): crea un'immagine dai byte di dati
script.dataFromImage(img, [format]): ottieni byte di dati dall'immagine
script.loadImage(filePath): carica un'immagine da un file
script.saveImage(img, filePath, [format]): salva un'immagine in un file, vero se OK
script.imageProperties(img): ottiene le proprietà di un'immagine, mappa contenente
"width", "height", "depth" e "colorCount", vuoto se immagine non valida
script.scaleImage(img, width, [height]): ridimensiona un'immagine, restituisce un'immagine ridimensionata
script.selectFileName(caption, dir, filter, saveFile): Apri la finestra di dialogo del file per
seleziona un file

Applicazioni Contesto
Usando QML, gran parte delle funzioni di Kid3 sono accessibili. L'API è simile a
quello utilizzato per D-Bus. Per i dettagli, fare riferimento alle rispettive note.

app.openDirectory(percorso): Apri directory
app.saveDirectory(): salva la directory
app.revertFileModifications(): Ripristina
app.importTags (tag, percorso, fmtIdx): importa file
app.downloadImage(url, allFilesInDir): Scarica immagine
app.exportTags(tag, percorso, fmtIdx): Esporta file
app.writePlaylist(): scrivi playlist
app.selectAllFiles(): Seleziona tutto
app.deselectAllFiles(): Deseleziona
app.firstFile([select]): Al primo file
app.nextFile([select]): al file successivo
app.previousFile([select]): al file precedente
app.selectCurrentFile([select]): Seleziona il file corrente
app.requestExpandFileList(): Espandi tutto
app.applyFilenameFormat(): applica il formato del nome del file
app.applyTagFormat(): applica il formato del tag
app.applyTextEncoding(): applica la codifica del testo
app.numberTracks(nr, total, tag, [options]): Numero tracce
app.applyFilter(espr): Filtro
app.convertToId3v23(): Converti ID3v2.4.0 in ID3v2.3.0
app.convertToId3v24(): Converti ID3v2.3.0 in ID3v2.4.0
app.getFilenameFromTags(tag): nome file dai tag
app.getTagsFromFilename(tag): nome file in tag
app.getAllFrames(tag): Ottieni oggetto con tutti i frame
app.getFrame (tag, nome): Ottieni frame
app.setFrame (tag, nome, valore): Imposta cornice
app.getPictureData(): ottieni dati dalla cornice
app.setPictureData(data): imposta i dati nella cornice
app.copyToOtherTag(tag): tag per altri tag
app.copyTags(tag): Copia
app.pasteTags(tag): Incolla
app.removeTags(tag): Rimuovi
app.playAudio(): Riproduci
app.readConfig(): leggi la configurazione
app.applyChangedConfiguration(): applica la configurazione
app.dirName: nome della directory
app.selectionInfo.fileName: nome file
app.selectionInfo.filePath: percorso file assoluto
app.selectionInfo.detailInfo: dettagli sul formato
app.selectionInfo.tagFormatV1: formato Tag 1
app.selectionInfo.tagFormatV2: formato Tag 2
app.selectionInfo.formatString(tag, format): Sostituisci i codici nella stringa di formato

Per le operazioni asincrone, i callback possono essere collegati ai segnali.

funzione importazione automatica (profilo) {
funzione suImportazioneAutomaticaFinita() {
app.batchImporter.finished.disconnect(onAutomaticImportFinish)
}
app.batchImporter.finished.connect(onAutomaticImportFinish)
app.batchImport(profilo, tagv2)
}

function renameDirectory(formato) {
funzione onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory(tagv2v1, formato, false)
}

Configurazione Oggetti
Le diverse sezioni di configurazione sono accessibili tramite metodi di configs. Loro
le proprietà possono essere elencate nella console QML.

script.properties(configs.networkConfig())

Le proprietà possono essere impostate:

configs.networkConfig().useProxy = falso

configs.batchImportConfig()
configs.exportConfig()
configs.fileConfig()
configs.nomefileFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
configs.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
configs.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()

Usa kid3-core online utilizzando i servizi onworks.net