<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY kid3 '<application
>Kid3</application
>'>
  <!ENTITY doublehyphen '--'>
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Italian "INCLUDE"
><!-- change language only here -->
]>
<book lang="&language;" id="kid3-handbook">

<bookinfo>
<title
>Manuale di &kid3;</title>

<authorgroup>
<author
><firstname
>Urs</firstname
> <surname
>Fleisch</surname
> <affiliation
> <address
><email
>ufleisch@users.sourceforge.net</email
></address>
</affiliation>
<contrib
>sviluppo software</contrib>
</author>

<othercredit role="translator"
><firstname
>Vincenzo</firstname
><surname
>Reale</surname
><affiliation
><address
><email
>smart2128vr@gmail.com</email
></address
></affiliation
><contrib
>Traduzione dell'interfaccia e della documentazione</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2024</year>
<holder
>Urs Fleisch</holder>
</copyright>
<legalnotice id="fdl-notice"
>&FDLNotice;</legalnotice>

<date
>24/2/2024</date>
<releaseinfo
>3.9.5</releaseinfo>

<abstract>
<para
>&kid3; è un'applicazione per modificare i tag ID3v1 e ID3v2 nei file MP3 in modo efficiente. Sono supportati anche i tag nei file Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF e nei moduli dei tracker (MOD, S3M, IT, XM). È semplice impostare i tag di più file allo stesso valore (cioè album, artista, anno e genere in tutti i file dello stesso album) e generare i tag dal nome dei file o viceversa. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>MP3</keyword>
<keyword
>ID3</keyword>
<keyword
>ID3v1</keyword>
<keyword
>ID3v2</keyword>
<keyword
>Ogg</keyword>
<keyword
>Vorbis</keyword>
<keyword
>FLAC</keyword>
<keyword
>MPC</keyword>
<keyword
>APE</keyword>
<keyword
>Musepack</keyword>
<keyword
>MP4</keyword>
<keyword
>M4A</keyword>
<keyword
>MP2</keyword>
<keyword
>Speex</keyword>
<keyword
>TrueAudio</keyword>
<keyword
>WavPack</keyword>
<keyword
>WMA</keyword>
<keyword
>WAV</keyword>
<keyword
>AIFF</keyword>
<keyword
>MOD</keyword>
<keyword
>S3M</keyword>
<keyword
>IT</keyword>
<keyword
>XM</keyword>
<keyword
>Opus</keyword>
<keyword
>DSF</keyword>
</keywordset>

</bookinfo>

<!--begin manpage include
<refmeta>
<refentrytitle
>kid3</refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
>kid3</refname>
<refname
>kid3-qt</refname>
<refname
>kid3-cli</refname>
<refpurpose
>Kid3 ID3 Tagger</refpurpose>
</refnamediv>
end manpage include-->

<!--change manpage<refsynopsisdiv
>--><preface id="synopsis"
><title
>Sinossi</title>
<cmdsynopsis
><command
>kid3</command
> <group
> <arg choice="plain"
><option
>&doublehyphen;help</option
></arg
> <arg choice="plain"
><option
>&doublehyphen;author</option
></arg
> <arg choice="plain"
><option
>&doublehyphen;version</option
></arg
> <arg choice="plain"
><option
>&doublehyphen;license</option
></arg
> <arg choice="plain"
><option
>&doublehyphen;desktopfile <filename
>FILE</filename
></option
></arg
> </group
> <arg rep="repeat"
><replaceable
>FILE</replaceable
></arg
> </cmdsynopsis>
<cmdsynopsis
><command
>kid3-qt</command
> <arg
><option
>&doublehyphen;portable</option
></arg
> <arg
><option
>Opzioni Qt</option
></arg
> <arg rep="repeat"
><replaceable
>FILE</replaceable
></arg
> </cmdsynopsis>
<cmdsynopsis
><command
>kid3-cli</command
> <arg
><option
>&doublehyphen;portable</option
></arg
> <arg
><option
>&doublehyphen;dbus</option
></arg
> <group
> <arg choice="plain"
><option
>-h</option
></arg
> <arg choice="plain"
><option
>&doublehyphen;help</option
></arg
> </group
> <arg
><option
>-c COMANDO1</option
></arg
> <arg rep="repeat"
><option
>-c COMANDO2</option
></arg
> <arg rep="repeat"
><replaceable
>FILE</replaceable
></arg
> </cmdsynopsis>
<!--change manpage</refsynopsisdiv
>--></preface>

<preface id="options"
><title
>Opzioni</title>

<variablelist>
<varlistentry>
<term
><option
>&doublehyphen;portable</option
></term>
<listitem
><para
>Archiviare la configurazione nel file <filename
>kid3.ini</filename
> nella cartella dell'applicazione.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><replaceable
>FILE</replaceable
></term>
<listitem
><para
>Se <filename
><replaceable
>FILE</replaceable
></filename
> è il percorso a una cartella, essa sarà aperta. Se sono specificati uno o più percorsi, la loro cartella comune è aperta e i file selezionati. </para
></listitem>
</varlistentry>
</variablelist>

<sect1 id="options-kid3"
><title
>kid3</title>
<variablelist>
<varlistentry>
<term
><option
>&doublehyphen;help</option
></term>
<listitem
><para
>Mostra la guida sulle opzioni.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>&doublehyphen;author</option
></term>
<listitem
><para
>Mostra le informazioni sull'autore.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>&doublehyphen;version</option
></term>
<listitem
><para
>Mostra le informazioni sulla versione.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>&doublehyphen;license</option
></term>
<listitem
><para
>Mostra le informazioni sulla licenza.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>&doublehyphen;desktopfile <filename
>FILE</filename
></option
></term>
<listitem
><para
>Il nome file della voce del desktop per questa applicazione.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="options-kid3-qt"
><title
>kid3-qt</title>
<variablelist>
<varlistentry>
<term
><option
>Opzioni Qt</option
></term>
<listitem
><para
>Vedere <citerefentry
><refentrytitle
>qt5options</refentrytitle
> <manvolnum
>7</manvolnum
></citerefentry
>.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="options-kid3-cli"
><title
>kid3-cli</title>
<variablelist>

<varlistentry>
<term
><option
>&doublehyphen;dbus</option
></term>
<listitem
><para
>Attivare l'interfaccia &DBus;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>-c</option
></term>
<listitem
><para
>Eseguire un comando. Più opzioni <option
>-c</option
> sono possibili, sono eseguite in sequenza. Vedere la sezione su <link linkend="kid3-cli"
>kid3-cli</link
> per una descrizione dei comandi disponibili.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>-h</option
>|<option
>&doublehyphen;help</option
></term>
<listitem
><para
>Mostra la guida sulle opzioni e sui comandi.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

</preface>

<chapter id="introduction">
<title
>Introduzione</title>

<para
>&kid3; è un'applicazione per modificare i tag ID3v1 e ID3v2 nei file MP3 in modo efficiente. Questi tag possono essere modificati dalla maggior parte dei lettori MP3, ma in modo non proprio comodo ed efficiente. Inoltre, sono supportati anche i tag nei file Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF e nei moduli dei tracker (MOD, S3M, IT, XM). </para>
<para
>&kid3; non acquisisce né codifica i file MP3, ma ha lo scopo di modificare i tag ID3 di tutti i file di un album in modo efficiente, cioè con il minor numero possibile di clic del mouse e di tasti. Dove la maggior parte degli altri programmi può modificare i tag ID3v1 o ID3v2, &kid3; ha il pieno controllo su entrambe le versioni, può convertire i tag tra i due formati e ha accesso a tutti i tag ID3v2. I tag di più file possono essere impostati sullo stesso valore, <abbrev
>ad es.</abbrev
> l'artista, l'album, l'anno e il genere di tutti i file di un album hanno generalmente gli stessi valori e possono essere impostati insieme. Se le informazioni per i tag sono contenute nel nome del file, i tag possono essere impostati automaticamente dal nome del file. È anche possibile impostare il nome del file in base ai tag trovati nel file in formati arbitrari. </para>
<para
>L'attività di modifica è ulteriormente supportata dalla sostituzione automatica di caratteri o sotto-stringhe, ad esempio per rimuovere caratteri illegali dai nomi dei file. Il controllo automatico dei caratteri maiuscoli e minuscoli semplifica l'utilizzo di uno schema di denominazione coerente in tutti i tag. </para>
<para
>Le informazioni dei tag per interi album possono essere recuperate da <ulink url="http://gnudb.org"
>gnudb.org</ulink
>, <ulink url="http://musicbrainz.org"
>MusicBrainz</ulink
>, <ulink url="http://discogs.com"
>Discogs</ulink
>, <ulink url="http://www.amazon.com"
>Amazon</ulink
> o altre fonti di elenchi di tracce. Il formato di importazione è liberamente configurabile tramite espressioni regolari. </para>
<para
>Segnalare qualsiasi problema o richiesta di funzionalità all'autore. </para>
</chapter>

<chapter id="using-kid3">
<title
>Utilizzare &kid3;</title>

<sect1 id="kid3-features">
<title
>Funzionalità di &kid3;</title>
<itemizedlist>
<listitem
><para
>Modificare i tag ID3v1.1</para
></listitem>
<listitem
><para
>Modificare tutti i frame ID3v2.3 e ID3v2.4</para
></listitem>
<listitem
><para
>Modificare i tag di più file</para
></listitem>
<listitem
><para
>Convertire tra tag ID3v1 e ID3v2</para
></listitem>
<listitem
><para
>Modificare i tag MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV and AIFF</para
></listitem>
<listitem
><para
>Generare i tag dal nome file</para
></listitem>
<listitem
><para
>Generare i tag dal contenuto dei campi dei tag</para
></listitem>
<listitem
><para
>Generare il nome file dai tag</para
></listitem>
<listitem
><para
>Generare e cambiare il nome delle cartelle dai tag</para
></listitem>
<listitem
><para
>Generare file della scaletta</para
></listitem>
<listitem
><para
>Conversione automatica delle maiuscole/minuscole e traduzione delle stringhe</para
></listitem>
<listitem
><para
>Importare da <ulink url="http://gnudb.org"
>gnudb.org</ulink
>, <ulink url="http://musicbrainz.org"
>MusicBrainz</ulink
>, <ulink url="http://discogs.com"
>Discogs</ulink
>, <ulink url="http://www.amazon.com"
>Amazon</ulink
> e altre fonti di dati</para
></listitem>
<listitem
><para
>Esportare come CSV, &HTML;, scaletta, Kover &XML; e altri formati. I file CSV esportati possono essere importati nuovamente.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="example-usage">
<title
>Esempio d'uso</title>
<para
>Questa sezione descrive una sessione tipica con &kid3;. Supponiamo di avere una cartella contenente file MP3 con i brani dell'album «Let's Tag» del gruppo «One Hit Wonder». La cartella è denominata nel formato «artista - album», nel nostro caso <filename
>One Hit Wonder - Let's Tag</filename
>. La cartella contiene le tracce nel formato «traccia titolo.mp3», che si pensa  sia utile perché i nomi dei file sono brevi (importante quando si usano lettori MP3 mobili con schermi piccoli) e nell'ordine corretto se ordinati alfabeticamente (importante quando si usano lettori MP3 hardware che riproducono i brani in ordine alfabetico o nell'ordine in cui vengono masterizzati su &CD; e quell'ordine è alfabetico quando si usa <command
>mkisofs</command
>). Oltre a ciò, le informazioni sull'artista e sull'album sono già nel nome della cartella e non devono essere ripetute nel nome file. Ma torniamo al nostro esempio, l'elenco delle cartelle è simile al seguente: </para>
<para
><filename
>01 Intro.mp3</filename
></para>
<para
><filename
>02 We Only Got This One.mp3</filename
></para>
<para
><filename
>03 Outro.mp3</filename
></para>
<para
>Questi file non hanno ancora tag e vogliamo generarli utilizzando &kid3;. Usiamo la voce di menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Apri</guimenuitem
></menuchoice
> (o il pulsante della barra degli strumenti) e selezioniamo uno dei file in questa cartella. Tutti i file saranno visualizzati nell'elenco dei file. Data la nostra pigrizia, vogliamo utilizzare le informazioni nella cartella e i nomi dei file per generare i tag. Pertanto selezioniamo tutti i file, quindi facciamo clic sul pulsante <guilabel
>A:</guilabel
> <guibutton
>Tag 1</guibutton
> nella sezione <guilabel
>File</guilabel
>. Questo imposterà i valori di titolo, artista, album e traccia in tutti i file. Per impostare i valori di anno e genere di tutti i file, manteniamo tutti i file selezionati e digitiamo «2002» per <guilabel
>Data</guilabel
> e selezioniamo «Pop» dalla casella combinata <guilabel
>Genere</guilabel
>. Per impostare solo questi due valori, le loro caselle di controllo vengono automaticamente selezionate e tutti le altre caselle rimangono deselezionate. Ora cambiamo la selezione selezionando solo il primo file e vediamo che tutti i tag contengono i valori corretti. I tag degli altri file possono essere verificati anche selezionandoli uno ad uno. Quando siamo soddisfatti dei tag, utilizziamo la voce di menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Salva</guimenuitem
></menuchoice
> (o il pulsante della barra degli strumenti). La selezione della voce di menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Crea scaletta</guimenuitem
></menuchoice
> (o il pulsante della barra degli strumenti) genererà un file <filename
>One Hit Wonder - Let's Tag.m3u</filename
> nella cartella. </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Guida ai comandi</title>

<sect1 id="gui-elements">
<title
>Gli elementi della &GUI;</title>
<para
>La &GUI; di &kid3; è separata in sei sezioni. A sinistra ci sono gli elenchi  dei file e delle cartelle, a destra le sezioni <guilabel
>File</guilabel
>, <guilabel
>Tag 1</guilabel
>, <guilabel
>Tag 2</guilabel
> e <guilabel
>Tag 3</guilabel
>. </para>

<para
>Per navigare tra le diverse sezioni utilizzando la tastiera, sono supportate diverse scorciatoie da tastiera. Nelle sezioni dei tag, le scorciatoie sono attive quando non si modifica il testo o quando si è nella prima colonna. <itemizedlist>
<listitem
><para
><keycombo
>&Alt;<keycap
>Sinistra</keycap
></keycombo
>: Vai alla sezione precedente (<keycombo
><keycap
>Command</keycap
><keycap
>[</keycap
></keycombo
> su &macOS;) </para
></listitem>
<listitem
><para
><keycombo
>&Alt;<keycap
>Destra</keycap
></keycombo
>: Vai alla sezione successiva (<keycombo
><keycap
>Command</keycap
><keycap
>]</keycap
></keycombo
> su &macOS;) </para
></listitem>
<listitem
><para
><keycombo
>&Ctrl;<keycap
>Maiusc</keycap
><keycap
>V</keycap
></keycombo
>: Da altro tag other tag </para
></listitem>
<listitem
><para
><keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>: Copiare </para
></listitem>
<listitem
><para
><keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
>: Incollare </para
></listitem>
<listitem
><para
><keycombo
><keycap
>Maiusc</keycap
><keycap
>Canc</keycap
></keycombo
>: Rimuovere </para
></listitem>
<listitem
><para
><keycombo
><keycap
>F2</keycap
></keycombo
>: Modificare </para
></listitem>
<listitem
><para
><keycombo
><keycap
>Insert</keycap
></keycombo
>: Aggiungere </para
></listitem>
<listitem
><para
><keycombo
><keycap
>Canc</keycap
></keycombo
>: Eliminare </para
></listitem>
</itemizedlist>
</para>

<sect2 id="file-list">
<title
>Elenco dei file</title>

<para
>L'elenco dei file contiene i nomi di tutti i file nella cartella aperta che corrispondono al filtro del nome file selezionato (in genere <filename class="extension"
>*.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac *.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape</filename
>). È possibile selezionare uno o più file. Per non selezionare alcun file, fare clic nell'area vuota dopo le voci dell'elenco. La selezione determina i file interessati dalle operazioni disponibili utilizzando i pulsanti descritti di seguito. </para>
<para
>Oltre a <guilabel
>Nome</guilabel
>, è possibile visualizzare anche altre colonne <guilabel
>Dimensioni</guilabel
>, <guilabel
>Tipo</guilabel
>, <guilabel
>Data modifica</guilabel
> con i dettagli del file. Le colonne possono essere nascoste deselezionandone il nome nel menu contestuale dell'intestazione dell'elenco. L'ordine delle colonne può essere modificato tramite trascinamento e rilascio. L'ordinamento può essere attivato facendo clic sull'intestazione della colonna. </para>
<para
>I valori dei tag standard possono essere visualizzati e modificati anche nelle colonne dell'elenco dei file. </para>
<para
>A sinistra dei nomi può essere visualizzata un'icona: un disco per mostrare che il file è stato modificato o informazioni su quali tag sono presenti (V1, V2, V1V2 o NO TAG, nessuna icona è visualizzata se il file non è ancora stato letto). </para>
<para
>Le cartelle sono visualizzate con un'icona a forma di cartella. Se si apre una cartella, i suoi file vengono visualizzati in un albero gerarchico. Selezionando i file dalle sottocartelle, le operazioni possono essere eseguite su file in cartelle diverse, il che è utile se la raccolta musicale è organizzata con una cartella per ciascun artista contenente cartelle per album di questo artista. </para>
<para
>Il clic del tasto <mousebutton
>destro</mousebutton
> del mouse all'interno dell'elenco dei file apre un menu contestuale con i seguenti comandi: <itemizedlist>
<listitem
><para
><guimenuitem
>Espandi tutto</guimenuitem
>: espande tutti gli alberi delle cartelle (solo l'albero attuale se il tasto <keycap
>Maiusc</keycap
> è premuto) </para
></listitem>
<listitem
><para
><guimenuitem
>Contrai tutto</guimenuitem
>: contrae l'albero tutti gli alberi delle cartelle </para
></listitem>
<listitem
><para
><guimenuitem
>Rinomina</guimenuitem
>: cambia il nome di un file </para
></listitem>
<listitem
><para
><guimenuitem
>Cestina</guimenuitem
>: sposta un file nel cestino </para
></listitem>
<listitem
><para
><guimenuitem
>Riproduci</guimenuitem
>: riproduce un file, vedere <link linkend="play"
>Riproduci</link
>. Se il file selezionato è una scaletta, i file della scaletta saranno riprodotti. </para
></listitem>
<listitem
><para
><guimenuitem
>Modifica</guimenuitem
>: modificare una scaletta, vedere <link linkend="edit-playlist"
>Modificare la scaletta</link
>. </para
></listitem>
<listitem
><para
>Le voci successive sono comandi utente, che possono essere definiti nella scheda <guilabel
>Azioni dell'utente</guilabel
> di <link linkend="configure-kid3"
>Configura &kid3;</link
>. Qui è anche possibile attivare la riproduzione con doppio clic. </para
><para
>Quando <guilabel
>Seleziona file in riproduzione</guilabel
> è attiva, il brano attualmente riprodotto viene selezionato automaticamente nell'elenco dei file. </para
></listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="edit-playlist">
<title
>Modificare la scaletta</title>

<para
>Una scaletta può essere creata vuota o contenente le tracce di una cartella, vedere <link linkend="create-playlist"
>Creare una scaletta</link
>. Il file della scaletta creato in questo modo può essere modificato facendo doppio clic o utilizzando <guilabel
>Modifica</guilabel
> dal menu contestuale dell'elenco dei file. Viene visualizzata una finestra con le voci della scaletta. È possibile aprire più scalette contemporaneamente. </para>
<para
>È possibile aggiungere nuove voci trascinandole dall'elenco dei file, da un gestore file o da un'altra scaletta. Se una voce viene trascinata da un'altra scaletta, sarà spostata o copiata in base al sistema. Per invocare l'altra operazione, rispettivamente, il tasto <keycap
>Maiusc</keycap
>, &Ctrl; o &Alt; (per copiare invece che spostare su &macOS;) deve essere premuto. Il riordino delle voci all'interno della scaletta è  possibile anche tramite il trascinamento della selezione. In alternativa, le voci possono essere spostate utilizzando le scorciatoie da tastiera <keycombo
>&Ctrl;<keycap
>Maiusc</keycap
><keycap
>Su</keycap
></keycombo
> e <keycombo
> &Ctrl; <keycap
>Maiusc</keycap
><keycap
>Giù</keycap
></keycombo
> (su &macOS; <keycap
> Command </keycap
> deve essere premuto invece di &Ctrl;). Una voce può essere rimossa utilizzando il tasto <keycap
>Elimina</keycap
>. </para>
<para
>Notare quanto segue: per trascinare le voci dall'elenco dei file, devono essere tenute sul lato sinistro (vicino alle icone), lo stesso gesto sul lato destro eseguirà una selezione multipla, tale azione è ancora facilmente possibile. </para>
<para
>Quando una scaletta è stata modificata, le modifiche possono essere archiviate utilizzando <guibutton
>Salva</guibutton
> o scartate utilizzando <guibutton
>Annulla</guibutton
>. Quando la finestra è chiusa, viene visualizzato un messaggio di conferma in caso di modifiche non salvate. </para>
<para
>Le tracce selezionate in una scaletta saranno selezionate automaticamente nell'elenco dei file, rendendo così possibile modificare i loro tag. </para>
<para
>Per eseguire azioni su una scaletta, è necessario selezionare il relativo file nell'elenco dei file. <guimenuitem
>Modifica</guimenuitem
> dal menu contestuale porta alla finestra descritta in questa sezione e <guimenuitem
>Riproduci</guimenuitem
> avvia il lettore multimediale con i brani della scaletta. Le azioni dell'utente possono agire sulle scalette, ad <link linkend="qml-examples"
>esempio</link
> <guilabel
>Esporta cartella della scaletta</guilabel
>, che copia i file da una scaletta in una cartella. </para>
</sect2>

<sect2 id="directory-list">
<title
>Elenco delle cartelle</title>

<para
>L'elenco delle cartelle contiene i nomi delle cartelle nella cartella aperta, nonché l'attuale (<filename class="directory"
>.</filename
>) e la cartella superiore (<filename class="directory"
>..</filename
>). Permette di cambiare rapidamente la cartella senza utilizzare il comando <guimenuitem
>Apri</guimenuitem
> o trascinare e rilasciare. </para>
<para
>La visibilità, l'ordine e l'ordinamento delle colonne possono essere configurati come descritto nella sezione relativa all'<link linkend="file-list"
>elenco dei file</link
>. </para>
</sect2>

<sect2 id="file">
<title
>File</title>

<para
>Mostra le 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 di il file. </para>
<para
>Il campo di testo <guilabel
>Nome</guilabel
> contiene il nome del file (se viene selezionato un solo file). Se questo nome viene modificato, il file sarà rinominato quando viene utilizzato il comando Salva. </para>
<para
>La casella combinata <guilabel
>Formato</guilabel
> e il campo di testo contengono il formato da utilizzare quando il nome file viene generato dal primo o dal secondo tag. Il nome file può contenere caratteri arbitrari, anche una parte di cartella separata da una barra dal nome del file, ma quella cartella deve già esistere affinché la rinomina abbia esito positivo. I seguenti codici speciali vengono utilizzati per inserire i valori dei tag nel nome file: </para>

<itemizedlist>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia (<abbrev
>ad es.</abbrev
> 01)</para
></listitem>
<listitem
><para
>%t %{track.n} Traccia con larghezza dei campi n (<abbrev
>ad es.</abbrev
> 001 per %{track.3})</para
></listitem>
<listitem
><para
>%T %{tracknumber} Traccia (senza zeri iniziali, <abbrev
>ad es.</abbrev
> 1)</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%{ignore} Ignorato durante la generazione di tag dal nome del file</para
></listitem>
</itemizedlist>

<para
>I codici di formato non sono limitati agli esempi sopra riportati. È possibile utilizzare qualsiasi nome di frame, ad esempio nomi di frame unificati come <userinput
>%{albumartist}</userinput
>, <userinput
>%{discnumber.1}</userinput
>, <userinput
>%{bpm}</userinput
> o formattare nomi specifici come <userinput
>%{popm}</userinput
>. </para>

<para
>È possibile anteporre e aggiungere stringhe alla sostituzione per un codice di formato aggiungendole tra virgolette doppie tra le parentesi graffe di un codice di formato. Queste stringhe saranno inserite nella stringa risultante solo se il codice del formato restituisce un valore non vuoto. Ad esempio, se il nome del file deve contenere sia il titolo che il sottotitolo, è possibile utilizzare <userinput
>%{title} [%{subtitle}]</userinput
> nella stringa di formato. Ciò produrrebbe una stringa che termina con <computeroutput
> []</computeroutput
> se non esiste un frame di sottotitoli per un file. Al fine di omettere le parentesi se non è presente alcun sottotitolo, al suo posto deve essere utilizzato <userinput
>%{title}%{"["subtitle"]"}</userinput
>. Questo ometterà le parentesi, lo spazio iniziale e il sottotitolo se non esistono i sottotitoli. </para>

<para
>L'elenco dei formati disponibili può essere modificato nella finestra di dialogo che appare quando si fa clic sul pulsante <guibutton
>Nome file dal tag</guibutton
> nella scheda <guilabel
>File</guilabel
> delle <link linkend="configure-kid3"
>impostazioni</link
>. </para>

<para
>Una seconda casella combinata <guilabel
>Formato</guilabel
> (con la freccia in giù) viene utilizzata per generare i tag dal nome file. Se il formato del nome file non corrisponde a questo modello, vengono provati alcuni altri formati comunemente utilizzati. </para>

<para
>Alcuni formati di file comunemente utilizzati sono già disponibili nella casella combinata, ma è anche possibile digitare un formato speciale nell campo di testo. </para>

<para
>L'elenco dei formati disponibili può essere modificato nella finestra che appare quando si fa clic sul pulsante <guibutton
>Tag dal nome file</guibutton
> nella scheda <guilabel
>File</guilabel
> delle <link linkend="configure-kid3"
>impostazioni</link
>. </para>

<para
>Internamente, un'espressione regolare viene creata dai codici di formato. Se sono richieste espressioni regolari avanzate, il formato per generare i tag dai nomi dei file può essere fornito come un'espressione regolare completa con catture precedute dai codici di formato, <abbrev
>ad es.</abbrev
> per estrarre i numeri di traccia senza rimuovere zeri iniziali, potrebbe essere utilizzato un formato come «<userinput
>/%{track}(\d+)%{title}(.*)</userinput
>» </para>
<para
><guilabel
>Da:</guilabel
> <guibutton
>Tag 1</guibutton
>, <guibutton
>Tag 2</guibutton
>: imposta il nome file utilizzando il formato selezionato e il primo tag o il secondo tag, rispettivamente. </para>
<para
><guilabel
>A:</guilabel
> <guibutton
>Tag 1</guibutton
>, <guibutton
>Tag 2</guibutton
>: i tag sono impostati dal nome file. Primo, è utilizzato il formato specificato in <guilabel
>Formato</guilabel
>. Se il nome file esistente non verifica questo formato, saranno provati i seguenti formati: </para>
<itemizedlist>
<listitem
><para
><filename
>Artista - Album/Traccia Brano</filename
></para
></listitem>
<listitem
><para
><filename
>Album/Traccia - Artista - Brano</filename
></para
></listitem>
<listitem
><para
><filename
>/Artista - Album - Traccia - Brano</filename
></para
></listitem>
<listitem
><para
><filename
>Album/Artista - Traccia - Brano</filename
></para
></listitem>
<listitem
><para
><filename
>Album/Artista - Brano</filename
></para
></listitem>
<listitem
><para
><filename
>Artista/Album/Traccia Brano</filename
></para
></listitem>
</itemizedlist>
<para
>Se viene selezionato un singolo file, i controlli della &GUI; sono riempiti con i valori estratti dal nome file. Se vengono selezionati più file, i tag dei file sono impostati direttamente in base ai nomi dei file. </para>
</sect2>

<sect2 id="tag1">
<title
>Tag 1</title>

<para
>I campi di testo per <guilabel
>Titolo</guilabel
>, <guilabel
>Artista</guilabel
>, <guilabel
>Album</guilabel
>, <guilabel
>Commento</guilabel
>, <guilabel
>Data</guilabel
>, <guilabel
>Numero traccia</guilabel
> e <guilabel
>Genere</guilabel
> sono utilizzati per modificare il valore corrispondente nel primo tag dei file selezionati. Il valore sarà modificato quando viene modificata la selezione del file o prima di operazioni come <guimenuitem
>Salva</guimenuitem
> ed <guimenuitem
>Esci</guimenuitem
> e quando viene selezionata la casella di controllo corrispondente a sinistra del nome del campo. Ciò è utile per modificare solo alcuni valori e lasciare invariati gli altri valori. </para>
<para
>Se si seleziona 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 non viene trovato un tag nel file, viene visualizzato il valore vuoto corrispondente, che è una stringa vuota per i campi di testo <guilabel
>Titolo</guilabel
>, <guilabel
>Artista</guilabel
>, <guilabel
>Album</guilabel
> e <guilabel
>Commento</guilabel
>, 0 per le modifiche numeriche <guilabel
>Data</guilabel
> e <guilabel
>Numero traccia</guilabel
> e un valore selezionato vuoto per la casella combinata <guilabel
>Genere</guilabel
>. I valori possono essere modificati e se la casella di controllo corrispondente è selezionata, saranno impostati per il file selezionato dopo la modifica della selezione. Il file viene quindi marcato come modificato dal simbolo di un disco nell'elenco, ma rimane invariato fino a quando non viene utilizzato il comando <guimenuitem
>Salva</guimenuitem
>. </para>
<para
>Se si selezionano più file, sono visualizzati solo i valori identici in tutti i file selezionati. In tutti gli altri controlli, sono visualizzati i valori vuoti come sopra descritto. 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. I valori saranno impostati per tutti i file selezionati quando la selezione viene modificata e possono essere salvati utilizzando il comando <guimenuitem
>Salva</guimenuitem
>. </para>
<para
>Le caselle di selezione controllano anche il funzionamento della maggior parte dei comandi che influiscono sui tag, come copia, incolla e trasferimento tra i tag 1 e 2. Per semplificare l'utilizzo con più file in cui tutte le caselle di controllo sono deselezionate, questi comandi si comportano allo stesso modo quando tutte le caselle di controllo sono selezionate e quando tutte le caselle di controllo sono deselezionate. </para>
<para
><guibutton
>Da tag 2</guibutton
>: i campi del tag 1 sono impostati dai valori corrispondenti nel tag 2. Se è selezionato un singolo file, i controlli della &GUI; sono riempiti con i valori del tag 2. Se sono selezionati più file, i tag dei file sono impostati direttamente. </para>
<para
><guibutton
>Copia</guibutton
>: il buffer di copia è riempito con i valori di Tag 1. Solo i valori con la casella marcata saranno utilizzati nei seguenti comandi Incolla. </para>
<para
><guibutton
>Incolla</guibutton
>. incolla i valori dal buffer di copia nei controlli della &GUI;. </para>
<para
><guibutton
>Rimuovi</guibutton
>: questo imposterà tutti i controlli della &GUI; a un valore vuoto che si traduce nella rimozione di tutti i valori. Il file salvato non conterrà tag 1. </para>
</sect2>

<sect2 id="tag2">
<title
>Tag 2</title>

<para
>I controlli della &GUI; funzionano nello stesso modo a quanto descritto per la sezione <guilabel
>Tag 1</guilabel
>, ma la dimensione delle stringhe non è limitata. </para>
<para
>Per il tag 2 <guilabel
>Genere</guilabel
> è possibile utilizzare anche i proprio nomi oltre ai generi elencati nella casella combinata, basta digitare il nome nella riga di modifica. </para>
<para
>Il tag 2 non può contenere solo gli stessi valori del tag 1, il formato è costruito in modo flessibile da più frame che sono essi stessi composti da più campi. La tabella tag 2 mostra tutti i frame disponibili nel file selezionato. </para>
<para
><guibutton
>Modifica</guibutton
>: questo aprirà una finestra che consente di modificare tutti i campi del frame selezionato. Se più file sono selezionati, i campi modificati sono applicati a tutti i file selezionati che contengono tale frame. </para>
<para
><guibutton
>Aggiungi</guibutton
>: apparirà un richiedente per selezionare il tipo di frame e un frame del tipo selezionato può essere modificato e aggiunto al file. Questo funziona anche per aggiungere un frame a più file selezionati. </para>
<para
><guibutton
>Elimina</guibutton
>: elimina il frame selezionato nei file selezionati. </para>
<para
><guilabel
>Trascina qui la copertina dell'album</guilabel
> viene visualizzato se il file non contiene una copertina incorporata. Un'immagine può essere aggiunta utilizzando il trascinamento della selezione da un browser o da un file manager e sarà visualizzata qui. Le cornici possono essere modificate o aggiunte facendo doppio clic su questo controllo. </para>

</sect2>

<sect2 id="tag3">
<title
>Tag 3</title>

<para
>Alcuni file possono avere più di due tag ed è visibile una terza sezione di tag. I seguenti tipi di file possono avere una sezione <guilabel
>Tag 3</guilabel
>: </para>
<itemizedlist>
<listitem
><para
>I file MP3 possono avere un tag ID3v1.1, un tag ID3v2 (2.3.0 o 2.4.0) e nella terza sezione un tag APE. Tali tag APE sono utilizzati per ottenere informazioni sul guadagno di riproduzione. Nella sezione <guilabel
>Tag 3</guilabel
>, queste informazioni sono visibili e il tag APE può essere rimosso con il pulsante <guibutton
>Rimuovi</guibutton
>. </para
></listitem>
<listitem
><para
>Il blocco RIFF INFO dei file WAV è disponibile nella sezione <guilabel
>Tag 3</guilabel
> perché la sezione <guilabel
>Tag 1</guilabel
> è dedicata ai tag ID3v1.1 e gestisce le loro restrizioni. Il <guilabel
>Tag 2</guilabel
> è ancora utilizzato per i tag ID3v2.4.0, che sono supportati anche per i file WAV, ma i blocchi RIFF INFO sembrano essere supportati meglio. </para
></listitem>
<listitem
><para
>I file FLAC normalmente utilizzano un commento Vorbis per i loro metadati. Tuttavia, ci sono file FLAC che hanno tag ID3v1 e ID3v2, che si trovano nelle sezioni <guilabel
>Tag 1</guilabel
> e <guilabel
>Tag 3</guilabel
>. I tag ID3 nei file FLAC sono supportati solo da TagLib, pertanto l'estensione OggFlacMetadata deve essere disabilitata nella scheda <guilabel
>Estensioni</guilabel
> delle <link linkend="configure-kid3"
>impostazioni</link
>. </para
></listitem>
</itemizedlist>
<para
>I controlli della &GUI; funzionano come nella sezione <guilabel
>Tag 2</guilabel
>. </para>

</sect2>

<!--begin manpage ignore-->
<sect2 id="frame-list">
<title
>Elenco frame</title>

<para
>&kid3; può modificare la maggior parte dei frame per tutti i tipi di file supportati. È possibile accedere ad alcuni frame utilizzando nomi unificati, in modo che possano essere scambiati tra file con formati diversi. I frame che non sono unificati sono accessibili come frame specifici del formato. </para>

<table id="table-frame-list">
  <title
>Associazione dei tipi di frame unificati a vari formati</title>
   <tgroup cols="7">
     <thead>
       <row
><entry
>Unificato</entry
>           <entry
>ID3v2.3</entry
> <entry
>ID3v2.4</entry
> <entry
>MP4</entry
>            <entry
>ASF</entry
>                        <entry
>Vorbis</entry
>                 <entry
>RIFF</entry
></row>
     </thead>
     <tbody>
       <row
><entry
>Titolo</entry
>             <entry
><literal
>TIT2</literal
></entry
>    <entry
><literal
>TIT2</literal
></entry
>    <entry
><literal
>©nam</literal
></entry
>           <entry
><literal
>Titolo</literal
></entry
>                      <entry
><literal
>TITLE</literal
></entry
>                  <entry
><literal
>INAM</literal
></entry
></row>
       <row
><entry
>Artista</entry
>            <entry
><literal
>TPE1</literal
></entry
>    <entry
><literal
>TPE1</literal
></entry
>    <entry
><literal
>©ART</literal
></entry
>           <entry
><literal
>Autore</literal
></entry
>                     <entry
><literal
>ARTIST</literal
></entry
>                 <entry
><literal
>IART</literal
></entry
></row>
       <row
><entry
>Album</entry
>             <entry
><literal
>TALB</literal
></entry
>    <entry
><literal
>TALB</literal
></entry
>    <entry
><literal
>©alb</literal
></entry
>           <entry
><literal
>WM/AlbumTitle</literal
></entry
>              <entry
><literal
>ALBUM</literal
></entry
>                  <entry
><literal
>IPRD</literal
></entry
></row>
       <row
><entry
>Commento</entry
>           <entry
><literal
>COMM</literal
></entry
>    <entry
><literal
>COMM</literal
></entry
>    <entry
><literal
>©cmt</literal
></entry
>           <entry
><literal
>Descrizione</literal
></entry
>                <entry
><literal
>COMMENT</literal
></entry
>                <entry
><literal
>ICMT</literal
></entry
></row>
       <row
><entry
>Data</entry
>              <entry
><literal
>TYER</literal
></entry
>    <entry
><literal
>TDRC</literal
></entry
>    <entry
><literal
>©day</literal
></entry
>           <entry
><literal
>WM/Year</literal
></entry
>                    <entry
><literal
>DATE</literal
></entry
>                   <entry
><literal
>ICRD</literal
></entry
></row>
       <row
><entry
>Numero traccia</entry
>      <entry
><literal
>TRCK</literal
></entry
>    <entry
><literal
>TRCK</literal
></entry
>    <entry
><literal
>trkn</literal
></entry
>           <entry
><literal
>WM/TrackNumber</literal
></entry
>             <entry
><literal
>TRACKNUMBER</literal
></entry
>            <entry
><literal
>IPRT</literal
> o <literal
>ITRK</literal
></entry
></row>
       <row
><entry
>Genere</entry
>             <entry
><literal
>TCON</literal
></entry
>    <entry
><literal
>TCON</literal
></entry
>    <entry
><literal
>©gen</literal
></entry
>           <entry
><literal
>WM/Genre</literal
></entry
>                   <entry
><literal
>GENRE</literal
></entry
>                  <entry
><literal
>IGNR</literal
></entry
></row>
       <row
><entry
>Artista dell'album</entry
>      <entry
><literal
>TPE2</literal
></entry
>    <entry
><literal
>TPE2</literal
></entry
>    <entry
><literal
>aART</literal
></entry
>           <entry
><literal
>WM/AlbumArtist</literal
></entry
>             <entry
><literal
>ALBUMARTIST</literal
></entry
>            <entry
></entry
></row>
       <row
><entry
>Arrangiatore</entry
>          <entry
><literal
>IPLS</literal
></entry
>    <entry
><literal
>TIPL</literal
></entry
>    <entry
><literal
>ARRANGER</literal
></entry
>       <entry
><literal
>WM/Producer</literal
></entry
>                <entry
><literal
>ARRANGER</literal
></entry
>               <entry
><literal
>IENG</literal
></entry
></row>
       <row
><entry
>Autore</entry
>            <entry
><literal
>TOLY</literal
></entry
>    <entry
><literal
>TOLY</literal
></entry
>    <entry
><literal
>AUTHOR</literal
></entry
>         <entry
></entry
>                                              <entry
><literal
>AUTHOR</literal
></entry
>                 <entry
></entry
></row>
       <row
><entry
>BPM</entry
>               <entry
><literal
>TBPM</literal
></entry
>    <entry
><literal
>TBPM</literal
></entry
>    <entry
><literal
>tmpo</literal
></entry
>           <entry
><literal
>WM/BeatsPerMinute</literal
></entry
>          <entry
><literal
>BPM</literal
></entry
>                    <entry
><literal
>IBPM</literal
></entry
></row>
       <row
><entry
>Numero di catalogo</entry
>    <entry
><literal
>TXXX:CATALOGNUMBER</literal
></entry
> <entry
><literal
>TXXX:CATALOGNUMBER</literal
></entry
>                            <entry
></entry
> <entry
></entry
>                              <entry
><literal
>CATALOGNUMBER</literal
></entry
>          <entry
></entry
></row>
       <row
><entry
>Compilation</entry
>       <entry
><literal
>TCMP</literal
></entry
>    <entry
><literal
>TCMP</literal
></entry
>    <entry
><literal
>cpil</literal
></entry
>           <entry
></entry
>                                              <entry
><literal
>COMPILATION</literal
></entry
>            <entry
></entry
></row>
       <row
><entry
>Compositore</entry
>          <entry
><literal
>TCOM</literal
></entry
>    <entry
><literal
>TCOM</literal
></entry
>    <entry
><literal
>©wrt</literal
></entry
>           <entry
><literal
>WM/Composer</literal
></entry
>                <entry
><literal
>COMPOSER</literal
></entry
>               <entry
><literal
>IMUS</literal
></entry
></row>
       <row
><entry
>Direttore</entry
>         <entry
><literal
>TPE3</literal
></entry
>    <entry
><literal
>TPE3</literal
></entry
>    <entry
><literal
>CONDUCTOR</literal
></entry
>      <entry
><literal
>WM/Conductor</literal
></entry
>               <entry
><literal
>CONDUCTOR</literal
></entry
>              <entry
></entry
></row>
       <row
><entry
>Copyright</entry
>         <entry
><literal
>TCOP</literal
></entry
>    <entry
><literal
>TCOP</literal
></entry
>    <entry
><literal
>cprt</literal
></entry
>           <entry
><literal
>Copyright</literal
></entry
>                  <entry
><literal
>COPYRIGHT</literal
></entry
>              <entry
><literal
>ICOP</literal
></entry
></row>
       <row
><entry
>Descrizione</entry
>       <entry
><literal
>TIT3</literal
></entry
>    <entry
><literal
>TIT3</literal
></entry
>    <entry
><literal
>desc</literal
></entry
>           <entry
><literal
>WM/SubTitleDescription</literal
></entry
>     <entry
><literal
>DESCRIPTION</literal
></entry
>            <entry
></entry
></row>
       <row
><entry
>Numero disco</entry
>       <entry
><literal
>TPOS</literal
></entry
>    <entry
><literal
>TPOS</literal
></entry
>    <entry
><literal
>disco</literal
></entry
>           <entry
><literal
>WM/PartOfSet</literal
></entry
>               <entry
><literal
>DISCNUMBER</literal
></entry
>             <entry
></entry
></row>
       <row
><entry
>Codificato da</entry
>        <entry
><literal
>TENC</literal
></entry
>    <entry
><literal
>TENC</literal
></entry
>    <entry
><literal
>©enc</literal
></entry
>           <entry
><literal
>WM/EncodedBy</literal
></entry
>               <entry
><literal
>ENCODED-BY</literal
></entry
>             <entry
><literal
>ITCH</literal
></entry
></row>
       <row
><entry
>Impostazioni codificatore</entry
>  <entry
><literal
>TSSE</literal
></entry
>    <entry
><literal
>TSSE</literal
></entry
>    <entry
><literal
>©too</literal
></entry
>           <entry
><literal
>WM/EncodingSettings</literal
></entry
>        <entry
><literal
>ENCODERSETTINGS</literal
></entry
>        <entry
><literal
>ISFT</literal
></entry
></row>
       <row
><entry
>Tempo di codifica</entry
>     <entry
></entry
>                           <entry
><literal
>TDEN</literal
></entry
>    <entry
></entry
>                                  <entry
><literal
>WM/EncodingTime</literal
></entry
>            <entry
><literal
>ENCODINGTIME</literal
></entry
>           <entry
><literal
>IDIT</literal
></entry
></row>
       <row
><entry
>Raggruppamento</entry
>          <entry
><literal
>GRP1</literal
></entry
>    <entry
><literal
>GRP1</literal
></entry
>    <entry
><literal
>©grp</literal
></entry
>           <entry
></entry
>                                              <entry
><literal
>GROUPING</literal
></entry
>               <entry
></entry
></row>
       <row
><entry
>Chiave iniziale</entry
>       <entry
><literal
>TKEY</literal
></entry
>    <entry
><literal
>TKEY</literal
></entry
>    <entry
></entry
>                                  <entry
><literal
>WM/InitialKey</literal
></entry
>              <entry
><literal
>INITIALKEY</literal
></entry
>             <entry
></entry
></row>
       <row
><entry
>ISRC</entry
>              <entry
><literal
>TSRC</literal
></entry
>    <entry
><literal
>TSRC</literal
></entry
>    <entry
><literal
>ISRC</literal
></entry
>           <entry
><literal
>WM/ISRC</literal
></entry
>                    <entry
><literal
>ISRC</literal
></entry
>                   <entry
><literal
>ISRC</literal
></entry
></row>
       <row
><entry
>Lingua</entry
>          <entry
><literal
>TLAN</literal
></entry
>    <entry
><literal
>TLAN</literal
></entry
>    <entry
><literal
>LANGUAGE</literal
></entry
>       <entry
><literal
>WM/Language</literal
></entry
>                <entry
><literal
>LANGUAGE</literal
></entry
>               <entry
><literal
>ILNG</literal
></entry
></row>
       <row
><entry
>Paroliere</entry
>          <entry
><literal
>TESTO</literal
></entry
>    <entry
><literal
>TESTO</literal
></entry
>    <entry
><literal
>LYRICIST</literal
></entry
>       <entry
><literal
>WM/Writer</literal
></entry
>                  <entry
><literal
>LYRICIST</literal
></entry
>               <entry
><literal
>IWRI</literal
></entry
></row>
       <row
><entry
>Testi</entry
>            <entry
><literal
>USLT</literal
></entry
>    <entry
><literal
>USLT</literal
></entry
>    <entry
><literal
>©lyr</literal
></entry
>           <entry
><literal
>WM/Lyrics</literal
></entry
>                  <entry
><literal
>TESTI</literal
></entry
>                 <entry
></entry
></row>
       <row
><entry
>Supporto</entry
>             <entry
><literal
>TMED</literal
></entry
>    <entry
><literal
>TMED</literal
></entry
>    <entry
><literal
>SOURCEMEDIA</literal
></entry
>    <entry
></entry
>                                              <entry
><literal
>SOURCEMEDIA</literal
></entry
>            <entry
><literal
>IMED</literal
></entry
></row>
       <row
><entry
>Atmosfera</entry
>              <entry
></entry
>                           <entry
><literal
>TMOO</literal
></entry
>    <entry
></entry
>                                  <entry
><literal
>WM/Mood</literal
></entry
>                    <entry
><literal
>MOOD</literal
></entry
>                   <entry
></entry
></row>
       <row
><entry
>Album originale</entry
>    <entry
><literal
>TOAL</literal
></entry
>    <entry
><literal
>TOAL</literal
></entry
>    <entry
><literal
>ORIGINALALBUM</literal
></entry
>  <entry
><literal
>WM/OriginalAlbumTitle</literal
></entry
>      <entry
><literal
>ORIGINALALBUM</literal
></entry
>          <entry
></entry
></row>
       <row
><entry
>Artista originale</entry
>   <entry
><literal
>TOPE</literal
></entry
>    <entry
><literal
>TOPE</literal
></entry
>    <entry
><literal
>ORIGINALARTIST</literal
></entry
> <entry
><literal
>WM/OriginalArtist</literal
></entry
>          <entry
><literal
>ORIGINALARTIST</literal
></entry
>         <entry
></entry
></row>
       <row
><entry
>Data originale</entry
>     <entry
><literal
>TORY</literal
></entry
>    <entry
><literal
>TDOR</literal
></entry
>    <entry
><literal
>ORIGINALDATE</literal
></entry
>   <entry
><literal
>WM/OriginalReleaseYear</literal
></entry
>     <entry
><literal
>ORIGINALDATE</literal
></entry
>           <entry
></entry
></row>
       <row
><entry
>Interprete</entry
>         <entry
><literal
>IPLS</literal
></entry
>    <entry
><literal
>TMCL</literal
></entry
>    <entry
><literal
>PERFORMER</literal
></entry
>      <entry
></entry
>                                              <entry
><literal
>PERFORMER</literal
></entry
>              <entry
><literal
>ISTR</literal
></entry
></row>
       <row
><entry
>Immagine</entry
>           <entry
><literal
>APIC</literal
></entry
>    <entry
><literal
>APIC</literal
></entry
>    <entry
><literal
>covr</literal
></entry
>           <entry
><literal
>WM/Picture</literal
></entry
>                 <entry
><literal
>METADATA_BLOCK_PICTURE</literal
></entry
> <entry
></entry
></row>
       <row
><entry
>Editore</entry
>         <entry
><literal
>TPUB</literal
></entry
>    <entry
><literal
>TPUB</literal
></entry
>    <entry
><literal
>PUBLISHER</literal
></entry
>      <entry
><literal
>WM/Publisher</literal
></entry
>               <entry
><literal
>PUBLISHER</literal
></entry
>              <entry
><literal
>IPUB</literal
></entry
></row>
       <row
><entry
>Valutazione</entry
>            <entry
><literal
>POPM</literal
></entry
>    <entry
><literal
>POPM</literal
></entry
>    <entry
><literal
>valutazione</literal
></entry
>           <entry
><literal
>WM/SharedUserRating</literal
></entry
>        <entry
><literal
>RATING</literal
></entry
>                 <entry
><literal
>IRTD</literal
></entry
></row>
       <row
><entry
>Paese di uscita</entry
>   <entry
><literal
>TXXX:RELEASECOUNTRY</literal
></entry
> <entry
><literal
>TXXX:RELEASECOUNTRY</literal
></entry
>       <entry
></entry
>    <entry
></entry
>                                              <entry
><literal
>RELEASECOUNTRY</literal
></entry
>         <entry
><literal
>ICNT</literal
></entry
></row>
       <row
><entry
>Data di uscita</entry
>      <entry
></entry
>                           <entry
><literal
>TDRL</literal
></entry
>    <entry
><literal
>RELEASEDATE</literal
></entry
>    <entry
></entry
>                                              <entry
><literal
>RELEASEDATE</literal
></entry
>            <entry
></entry
></row>
       <row
><entry
>Remixer</entry
>           <entry
><literal
>TPE4</literal
></entry
>    <entry
><literal
>TPE4</literal
></entry
>    <entry
><literal
>REMIXER</literal
></entry
>        <entry
><literal
>WM/ModifiedBy</literal
></entry
>              <entry
><literal
>REMIXER</literal
></entry
>                <entry
><literal
>IEDT</literal
></entry
></row>
       <row
><entry
>Ordinamento per album</entry
>        <entry
><literal
>TSOA</literal
></entry
>    <entry
><literal
>TSOA</literal
></entry
>    <entry
><literal
>soal</literal
></entry
>           <entry
><literal
>WM/AlbumSortOrder</literal
></entry
>          <entry
><literal
>ALBUMSORT</literal
></entry
>              <entry
></entry
></row>
       <row
><entry
>Ordinamento per artista dell'album</entry
> <entry
><literal
>TSO2</literal
></entry
>    <entry
><literal
>TSO2</literal
></entry
>    <entry
><literal
>soaa</literal
></entry
>           <entry
></entry
>                                              <entry
><literal
>ALBUMARTISTSORT</literal
></entry
>        <entry
></entry
></row>
       <row
><entry
>Ordinamento per artista</entry
>       <entry
><literal
>TSOP</literal
></entry
>    <entry
><literal
>TSOP</literal
></entry
>    <entry
><literal
>soar</literal
></entry
>           <entry
><literal
>WM/ArtistSortOrder</literal
></entry
>         <entry
><literal
>ARTISTSORT</literal
></entry
>             <entry
></entry
></row>
       <row
><entry
>Ordinamento per compositore</entry
>     <entry
><literal
>TSOC</literal
></entry
>    <entry
><literal
>TSOC</literal
></entry
>    <entry
><literal
>soco</literal
></entry
>           <entry
></entry
>                                              <entry
><literal
>COMPOSERSORT</literal
></entry
>           <entry
></entry
></row>
       <row
><entry
>Ordinamento per nome</entry
>         <entry
><literal
>TSOT</literal
></entry
>    <entry
><literal
>TSOT</literal
></entry
>    <entry
><literal
>sonm</literal
></entry
>           <entry
><literal
>WM/TitleSortOrder</literal
></entry
>          <entry
><literal
>TITLESORT</literal
></entry
>              <entry
></entry
></row>
       <row
><entry
>Sottotitolo</entry
>          <entry
></entry
>                           <entry
><literal
>TSST</literal
></entry
>    <entry
><literal
>SUBTITLE</literal
></entry
>       <entry
><literal
>WM/SubTitle</literal
></entry
>                <entry
><literal
>SUBTITLE</literal
></entry
>               <entry
><literal
>PRT1</literal
></entry
></row>
       <row
><entry
>Sito web</entry
>           <entry
><literal
>WOAR</literal
></entry
>    <entry
><literal
>WOAR</literal
></entry
>    <entry
><literal
>SITOWEB</literal
></entry
>        <entry
><literal
>WM/AuthorURL</literal
></entry
>               <entry
><literal
>SITOWEB</literal
></entry
>                <entry
><literal
>IBSU</literal
></entry
></row>
       <row
><entry
>Lavoro</entry
>              <entry
><literal
>TIT1</literal
></entry
>    <entry
><literal
>TIT1</literal
></entry
>    <entry
><literal
>©wrk</literal
></entry
>           <entry
><literal
>WM/ContentGroupDescription</literal
></entry
> <entry
><literal
>WORK</literal
></entry
>                   <entry
></entry
></row>
       <row
><entry
>File audio WWW</entry
>    <entry
><literal
>WOAF</literal
></entry
>    <entry
><literal
>WOAF</literal
></entry
>    <entry
></entry
>                                  <entry
><literal
>WM/AudioFileURL</literal
></entry
>            <entry
><literal
>WWWAUDIOFILE</literal
></entry
>           <entry
></entry
></row>
       <row
><entry
>Forni audio WWW</entry
>  <entry
><literal
>WOAS</literal
></entry
>    <entry
><literal
>WOAS</literal
></entry
>    <entry
></entry
>                                  <entry
><literal
>WM/AudioSourceURL</literal
></entry
>          <entry
><literal
>WWWAUDIOSOURCE</literal
></entry
>         <entry
></entry
></row>
     </tbody>
   </tgroup>
 </table>

<para
>Osservazioni relative all'associazione ai nomi di frame unificati: <itemizedlist>
<listitem
><para
>Il numero di nomi di frame unificati è limitato dal fatto che un'associazione ragionevole deve essere possibile per tutti i formati di file supportati. La maggior parte dei tag supporta frame con nomi arbitrari; questi saranno utilizzati se non è disponibile alcun frame specifico (<abbrev
>ad es.</abbrev
> i nomi in maiuscolo nella colonna MP4). Se non esiste tale possibilità, alcuni tipi di frame potrebbero non essere supportati per il formato, <abbrev
>ad es.</abbrev
> autore e interprete per ASF (WMA). </para
></listitem>
<listitem
><para
>Le associazioni non sono scelte in modo arbitrario, ma sono orientate all'utilizzo dei frame in altre applicazioni e dispositivi. Pertanto il frame ID3v2 "TPE2 - Band/orchestra/accompagnamento" non suggerisce il suo utilizzo come artista dell'album, ma questo è comunemente utilizzato. Il vero significato di ID3v2, d'altra parte, è il motivo per cui questo frame cornice viene utilizzato per l'orchestra durante l'importazione (<abbrev
>ad es.</abbrev
> da Discogs), sebbene ciò possa sembrare un po 'strano per altri formati di tag. </para
></listitem>
<listitem
><para
>Le associazioni non sono sempre biettive. Per cui, ID3v2.3 utilizza un frame IPLS sia per Arrangiatore che per Interprete. Durante la lettura, entrambi i frame sono visualizzati come «Arrangiatore». </para
></listitem>
<listitem
><para
>I frame Arrangiatore e Interprete usano un formato particolare per i loro contenuti: «partecipazione 1|partecipante 1|partecipazione 2|partecipante 2|...», ad esempio «Maestro del coro|Ernst Dunshirn|Voce soprano|Anna Netrebko». Ciò creerà i frame IPLS (ID3v2.3) o TIPL/TMCL (ID3v2.4) con un elenco di stringhe nel formato specificato ("|" è utilizzato come separatore tra le stringhe). I valori in questo formato sono impostati anche quando si importano dati da server che offrono queste informazioni. </para
></listitem>
<listitem
><para
>Per utilizzare esplicitamente un nome di frame specifico che è in conflitto con un nome di frame unificato, anteporre un punto esclamativo. Ad esempio, l'aggiunta di un frame di tipo «<replaceable
>Media</replaceable
>» a un commento di Vorbis creerà un frame con il nome «<literal
>SOURCEMEDIA</literal
>» a causa dell'associazione del tipo unificata. Per aggiungere un frame con il nome «<literal
>MEDIA</literal
>» e non «<literal
>SOURCEMEDIA</literal
>», utilizzare «<literal
>!MEDIA</literal
>» per forzare il nome esplicito. </para
></listitem>
<listitem
><para
>Se hai bisogno di frame che non è in questo elenco, hai ancora la possibilità di inserire nomi arbitrari utilizzando il pulsante <guibutton
>Aggiungi</guibutton
>. I nomi dei frame usati spesso possono essere aggiunti ai <guilabel
>Frame personalizzati</guilabel
> nella configurazione dei <guilabel
>Tag</guilabel
>, e saranno quindi disponibili nei <guilabel
>Frame di accesso rapido</guilabel
>. </para
></listitem>
</itemizedlist>
</para>

</sect2>
<!--end manpage ignore-->

<sect2 id="synchronized-lyrics">
<title
>Testi sincronizzati e codici di temporizzazione degli eventi</title>

<para
>Per sincronizzare le informazioni con i dati audio, è disponibile un editor specifico. Questi frame sono supportati per i tag ID3v2.3.0 e ID3v2.4.0. Per aggiungere un frame del genere, il nome specifico del frame deve essere selezionato nell'elenco che appare quando si fa clic sul pulsante <guibutton
>Aggiungi</guibutton
> - <guilabel
>Testi sincronizzati</guilabel
> o <guilabel
>Codici di temporizzazione evento</guilabel
>, rispettivamente. L'editor è lo stesso per entrambi i tipi, per i codici di temporizzazione degli eventi è disponibile solo un insieme predefinito di eventi mentre per i testi sincronizzati è necessario inserire del testo. Di seguito, viene spiegata la modifica dei testi sincronizzati. </para>
<para
>Viene selezionato un file con un tag ID3v2, si accede all'editor dei testi utilizzando <guibutton
>Aggiungi</guibutton
> e selezionando <guilabel
>Testi sincronizzati</guilabel
>. Per un frame di testi sincronizzati esistente, viene selezionato e si fa clic su <guibutton
>Modifica</guibutton
>. Il lettore viene aperto automaticamente con il file attuale in modo che il file possa essere riprodotto e messo in pausa per sincronizzare i testi. </para>
<para
>Le impostazioni nella parte superiore dell'editor SYLT normalmente non devono essere modificate. Se il testo contiene caratteri che non sono presenti nell'insieme di caratteri Latin 1, è consigliabile modificare la codifica del testo in UTF16 (o UTF8 per ID3v2.4.0). Per i testi in inglese e la massima compatibilità, utilizzare ISO-8859-1. </para>
<para
>La sezione <guilabel
>Testi</guilabel
> ha cinque pulsanti in alto. <guibutton
>Aggiungi</guibutton
> aggiungerà un nuovo evento temporale nella tabella. Il tempo è preso dalla posizione del lettore, quindi l'aggiunta di una voce durante la riproduzione della traccia aggiungerà una linea per la posizione attualmente riprodotta. Gli eventi nella tabella devono essere ordinati cronologicamente, pertanto la riga sarà inserita di conseguenza. Le voci con un orario non valido sono trattate in modo speciale: se la riga attualmente selezionata ha un orario non valido, la marca temporale relativa sarà sostituita dall'ora attuale invece di aggiungere una nuova riga. Se l'ora corrente non è valida, sarà utilizzata la prima riga con un'ora non valida. Questo comportamento dovrebbe facilitare l'aggiunta di marche temporali se il testo è già nella tabella, ma mancano le marche temporali (come nel caso dell'importazione di testi non sincronizzati). Si noti che il tempo non valido è rappresentato come 00:00.00, cioè uguale al tempo all'inizio assoluto della traccia, che non è valido. Per rendere un tempo non valido, premere il tasto <keycap
>Elimina</keycap
> o utilizzare <guimenu
>Cancella</guimenu
> dal menu contestuale. Le nuove righe inserite utilizzando <guimenu
>Inserisci riga</guimenu
> dal menu di scelta rapida o create durante l'importazione di testi non sincronizzati con <guibutton
>Dagli appunti</guibutton
> o <guibutton
>Importa</guibutton
> contengono anche marche temporali non valide. Le righe nella tabella possono essere eliminate facendo clic sul pulsante <guibutton
>Elimina</guibutton
> o utilizzando <guimenu
>Elimina righe</guimenu
> dal menu di scelta rapida. </para>
<para
>I testi sincronizzati possono essere importati da un file utilizzando <guibutton
>Importa</guibutton
>. Il formato previsto è LRC semplice o avanzato. Se il file selezionato non contiene una parentesi quadra nella prima riga, si suppone che sia un semplice file di testo con testi non sincronizzati. Le righe di tale file sono quindi importate con marche temporali non valide. Le informazioni sull'ora possono essere aggiunte utilizzando il pulsante <guibutton
>Aggiungi</guibutton
> o tramite inserimento manuale. È anche possibile importare testi tramite copia e incolla utilizzando <guilabel
>Dagli appunti</guilabel
>. I testi sincronizzati possono essere scritti in file LRC utilizzando <guibutton
>Esporta</guibutton
>. Si noti che saranno esportate solo le voci con marche temporali valide e che le voci saranno ordinate per ora. Le voci con tempo non valido non saranno memorizzate nemmeno nel frame SYLT,  assicurarsi quindi di includere tutte le informazioni di temporizzazione prima di uscire dalla finestra. </para>
<para
>La <ulink url="http://id3.org/id3v2.4.0-frames"
>specifica ID3</ulink
> suggerisce una marca temporale ogni sillaba. Tuttavia la maggior parte dei lettori supporta solo la granularità di una riga o frase. Per supportare entrambi i casi d'uso, &kid3; segue le stesse convenzioni dell'<ulink url="http://www.compuphase.com/software_sylteditor.htm"
>Editor SYLT</ulink
>. Si presume che il testo immesso nella tabella inizi una nuova riga a meno che non inizi con uno spazio o un trattino. Eccezioni a questa regola sono possibili iniziando una riga con un trattino basso ('_') per forzare la continuazione o un cancelletto ('#') per forzare una nuova linea. Questi caratteri di escape non sono memorizzati nel frame SYLT. All'interno del frame SYLT, le nuove righe iniziano con un carattere di avanzamento di riga (esadecimale 0A) mentre le continuazioni no. Durante la lettura di frame SYLT, &kid3; controlla se la prima voce inizia con un avanzamento di riga. In caso contrario, si presume che tutte le voci siano nuove righe e che non vengano utilizzate continuazioni di sillabe. </para>
<para
>Durante la riproduzione della traccia, viene evidenziata la riga associata alla posizione di riproduzione attuale, in modo da poter verificare la correttezza delle informazioni di sincronizzazione. Se è necessario aggiungere uno scostamento a uno o più marche temporali, questo può essere realizzato con il menu contestuale <guimenu
>Aggiungi scostamento</guimenu
>. I valori negativi possono essere utilizzati per ridurre il tempo. Utilizzando <guimenu
>Scorri alla posizione</guimenu
> nel menu contestuale, è possibile impostare la posizione di riproduzione sull'orario della riga selezionata. </para>
<para>
<emphasis
>Procedura consigliata per aggiungere i nuovi testi sincronizzati</emphasis>
<itemizedlist>
<listitem
><para
>Ottenere i testi non sincronizzati, <abbrev
>ad es.</abbrev
> utilizzando <menuchoice
><guimenu
>Testi</guimenu
><guimenuitem
>Integra testi</guimenuitem
></menuchoice
> dal menu contestuale dell'elenco dei file.</para
></listitem>
<listitem
><para
>Copiare i testi non sincronizzati negli appunti, basta portarsi alla riga <guilabel
>Testi</guilabel
> nella tabella dei frame premere <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>.</para
></listitem>
<listitem
><para
>Aggiungere un frame di testi sincronizzato (<guibutton
>Aggiungi...</guibutton
>, <guilabel
>Testi sincronizzati</guilabel
>, <guibutton
>OK</guibutton
>), fare clic su <guibutton
>Dagli appunti</guibutton
>.</para
></listitem>
<listitem
><para
>Ora tutte le righe dei testi non sincronizzati sono nella tabella, tutte le marche temporali non sono valide (0:0:0.00). È possibile eliminare in anticipo le voci vuote.</para
></listitem>
<listitem
><para
>Iniziare a riprodurre il brano facendo clic sul pulsante di riproduzione <guibutton
>&#9658;</guibutton
> nella barra degli strumenti di riproduzione nella parte inferiore della finestra principale.</para
></listitem>
<listitem
><para
>Quando viene visualizzata la riga del testo successiva con marca temporale non valida, fare clic su <guibutton
>Aggiungi</guibutton
> o premere <keycombo
>&Alt;<keycap
>A</keycap
></keycombo
>, la marca temporale sarà aggiornata.</para
></listitem>
<listitem
><para
>Continuare così fino a quando non sono impostate tutte le marche temporali. Se si è perso qualcosa, fermare la riproduzione e cancellare le marche temporali utilizzando il tasto <keycap
>Elimina</keycap
> o selezionandoli e utilizzando <guimenuitem
>Cancella</guimenuitem
> dal menu contestuale. Per riavviare la riproduzione da una determinata marca temporale, utilizzare <guimenuitem
>Scorri alla posizione</guimenuitem
> dal menu contestuale. </para
></listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="mp4-chapters">
<title
>Capitoli nei file MP4</title>

<para
>Gli audiolibri MP4 in genere hanno un'estensione <filename class="extension"
>.m4b</filename
> e sono piuttosto grandi perché contengono tutti i capitoli in un unico file. Per navigare in questi file, possono contenere contrassegni di capitolo, che possono essere modificati in &kid3; in uno pseudo-frame «Capitoli» utilizzando lo stesso editor utilizzato per <link linkend="synchronized-lyrics"
>testi sincronizzati</link
>. Nota, tuttavia, che questa funzione è disponibile solo con l'estensione <guilabel
>Mp4v2Metadata</guilabel
>, quindi assicurati che sia attivata e sopra l'estensione <guilabel
>TaglibMetadata</guilabel
> nella scheda <guilabel
>Estensioni</guilabel 
> delle impostazioni se devi modificare i capitoli MP4. </para>
</sect2>

</sect1>

<sect1 id="file-menu">
<title
>Il menu File</title>
<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Apri...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apre una cartella.</action
> Tutti i file corrispondenti al filtro del nome file selezionato saranno visualizzati nell'elenco dei file e il file scelto sarà selezionato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Apri recente</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apre una cartella aperta di recente.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>D</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Apri cartella...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apre una cartella.</action
> Tutti i file che corrispondono al nome del file selezionato saranno visualizzati nell'elenco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>F5</keycap
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Ricarica</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ricaricare la cartella.</action
> I file modificati devono essere salvati prima. Le sottocartelle espanse saranno contratte.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Salva</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Salvare tutti i file modificati nella cartella.</action
> I file modificati sono contrassegnati con un simbolo del disco nell'elenco dei file. Se sono stati modificati nomi di file, questi file saranno rinominati.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Scarta modifiche</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ripristina le modifiche di uno o più file.</action
> Se non viene selezionato alcun file nell'elenco dei file, le modifiche di tutti i file saranno ripristinate, altrimenti saranno ripristinate solo le modifiche dei file selezionati. </para
></listitem>
</varlistentry>

<varlistentry id="import">
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>La <action
>Finestra di importazione</action
> può essere utilizzata per importare i dati direttamente da un server freedb.org, da un server MusicBrainz, da Discogs, Amazon o altre fonti di elenchi di tracce di album in formato testuale. </para>
<para id="import-freedb"
>L'importazione da un server freedb.org è possibile utilizzando una finestra che appare quando è selezionato <guibutton
>Dal server:</guibutton
> <guibutton
>gnudb.org</guibutton
>. L'artista e il nome dell'album da cercare possono essere digitati nei due campi più in alto, gli album che corrispondono alla query saranno visualizzati quando si fa clic su <guibutton
>Trova</guibutton
> e i risultati da <ulink url="http: //www.gnudb.org"
>www.gnudb.org</ulink
> sono ricevuti. L'importazione dei dati delle tracce per un album viene eseguita facendo doppio clic sull'album nell'elenco. È possibile selezionare sia il server freedb.org da cui importare sia il percorso CGI. I dati importati sono visualizzati nella tabella di anteprima della finestra di importazione. Se soddisfatti delle tracce visualizzate, possono essere importati chiudendo la finestra di importazione con <guibutton
>OK</guibutton
>. </para>
<para
>Se hai già un risultato di ricerca aperto nel browser web, puoi inserire l'URL nel primo campo di ricerca. Il risultato apparirà quindi nell'elenco degli album e può essere importato direttamente in &kid3;. </para>
<para id="import-discogs"
>Una ricerca sul server di Discogs può essere eseguita utilizzando <guibutton
>Discogs</guibutton
>. Come nella finestra di <guibutton
>gnudb.org</guibutton
>, è possibile digitare artista e album e quindi scegliere da un elenco di versioni. Un <guilabel
>Token</guilabel
> può essere inserito per utilizzare l'API RESTful Discogs invece dell'interfaccia web, spesso modificata, impedendo così il funzionamento dell'analizzatore di importazione. È necessario registrare un account su <ulink url="https://www.discogs.com/"
>Discogs</ulink
> e poi generare un token sul sito web (Impostazioni/Programmatori, Genera token). Non dimenticare <guibutton
>Salva impostazioni</guibutton
> dopo aver inserito il token per utilizzarlo nelle successive richieste. Se <guilabel
>Tag standard</guilabel
> è marcata, le informazioni standard vengono importate, <abbrev
>ad es.</abbrev
> artista, album e titolo. Se <guilabel
>Tag aggiuntivi</guilabel
> è marcata, vengono importate ulteriori informazioni se disponibili, <abbrev
>ad es.</abbrev
> interpreti, arrangiatori o editore. Se <guilabel
>Copertina</guilabel
> è marcata, la copertina sarà scaricata se disponibile. </para>
<para id="import-amazon"
>Una ricerca su Amazon può essere eseguita utilizzando <guibutton
>Amazon</guibutton
>. Come nella finestra di <guibutton
>gnudb.org</guibutton
>, è possibile inserire artista e album e quindi scegliere da un elenco di versioni. Se <guilabel
>Tag aggiuntivi</guilabel
> è marcata, vengono importate ulteriori informazioni se disponibili, <abbrev
>ad es.</abbrev
> interpreti, arrangiatori o editore. Se <guilabel
>Copertina</guilabel
> è marcata, la copertina sarà scaricata se disponibile. </para>
<para id="import-musicbrainzrelease"
>È possibile cercare nello stesso modo nella banca dati delle uscite di MusicBrainz utilizzando <guibutton
>Da MusicBrainz Release</guibutton
>. Il flusso è lo stesso descritto per <guibutton
>Da gnudb.org</guibutton
>. </para>
<para id="import-musicbrainz"
>L'importazione da un server MusicBrainz è possibile utilizzando la finestra che appare quando è selezionato <guibutton
>Da MusicBrainz Fingerprint</guibutton
>. Il server può essere selezionato come nella finestra di importazione freedb. Segue una tabella che mostra i dati delle tracce importate. La colonna di destra mostra lo stato della query MusicBrainz, che inizia con «In sospeso» quando viene aperta la finestra. Quindi viene cercata l'impronta digitale e se non produce un risultato, viene tentata un'altra ricerca utilizzando i tag nel file. Pertanto, può essere utile che una query MusicBrainz riuscita memorizzi informazioni note (<abbrev
>ad es.</abbrev
> artista e album) nei tag prima dell'importazione. Se è stato trovato un risultato, la ricerca termina nello stato «Riconosciuto», altrimenti non è stato trovato nulla o più risultati ambigui e uno di essi deve essere selezionato dall'utente. <guibutton
>OK</guibutton
> e <guibutton
>Applica</guibutton
> utilizzano i dati importati, <guibutton
>Annulla</guibutton
> chiude la finestra. La chiusura può richiedere del tempo poiché tutto il meccanismo di MusicBrainz deve essere spento. </para>

<para id="import-text"
>Per l'importazione di dati testuali, <guibutton
>Da file/appunti</guibutton
> apre una sotto-finestra, in cui sono disponibili diversi formati di importazione preconfigurati. I primi due, «CSV non quotato» e «CSV quotato» possono essere utilizzati per importare dati esportati dalla finestra Esporta. I dati CSV possono essere modificati con un foglio di calcolo e devono essere scritti utilizzando le tabulazioni come delimitatori. L'importazione dovrebbe quindi essere possibile utilizzando «CSV quotato», che è più flessibile di «CSV non quotato». Tuttavia, i suoi campi non possono contenere virgolette doppie. Se si esporta solo da &kid3; e si importa in seguito, «CSV non quotato» può essere utilizzato come formato semplice per questo scopo. Si noti che ci sono anche i comandi «Esporta CSV» e «Importa CSV» nel menu contestuale dell'elenco dei file, che utilizzano gli script per esportare e importare i dati CSV in un modo più completo, potente e flessibile. </para>

<para
>Il formato successivo, «testo &HTML; di freedb», può essere usato per copiare informazioni da un pagina &HTML; di <ulink url="http://freedb.org"
>freedb.org</ulink
>. Cercare un album in freedb e se le informazioni desiderate sono visualizzate nel browser web, copiare il contenuto negli appunti. Quindi fare clic sul pulsante <guibutton
>Dagli appunti</guibutton
> e le tracce importate saranno visualizzate nella tabella di anteprima nella parte superiore della finestra. Se si è soddisfatti dei dati importati, chiudere la finestra con <guibutton
>OK</guibutton
>, che inserirà i dati nei tag della cartella attuale. La destinazione (<guilabel
>Tag 1</guilabel
>, <guilabel
>Tag 2</guilabel
> o <guilabel
>Tag 1 e tag 2</guilabel
>) può essere selezionata con una casella combinata. I file nella cartella attuale devono essere nell'ordine di traccia corretto per ottenere i tag assegnati. Questo è il caso se sono numerati. </para>
<para
>Il formato successivo di importazione preconfigurato, «codice &HTML; di freedb», può essere utilizzato, se i dati sono disponibili come documento &HTML;. L'importazione è possibile utilizzando il pulsante <guibutton
>Da file</guibutton
>, che apre un selettore di file o ne copia il contenuto da un editor e quindi importa dagli appunti. Questo formato può essere utile per l'importazione non in linea, sebbene il documento &HTML; può anche essere aperto in un browser e quindi importato nel primo formato tramite gli appunti. </para>
<para
>Sono disponibili altri formati preconfigurati, <abbrev
>ad es.</abbrev
> «Titolo traccia Tempo». Un formato personalizzato vuoto può essere creato con <guibutton
>Aggiungi</guibutton
> per essere impostato dall'utente. Due righe sotto il nome del formato possono essere impostate con un'espressione regolare per acquisire i campi dal testo di importazione. La prima espressione regolare sarà analizzata una volta per ogni documento per raccogliere dati per album come artista, album, anno e genere. Si tenta di far corrispondere la seconda riga dall'inizio del documento alla fine per ottenere i dati della traccia, generalmente numero e titolo. Le espressioni regolari includono tutte le funzionalità offerte da &Qt; che è la maggior parte di ciò che Perl offre. I costrutti con parentesi «(..)» creano buffer di acquisizione per i campi da importare e sono preceduti da  codici specifici di &kid3; per specificare quale campo acquisire. I codici sono gli stessi utilizzati per il formato del nome file, oltre ai codici elencati di seguito, è possibile qualsiasi nome di frame: </para>

<para id="format-codes">
<itemizedlist>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%d %{duration} Durata</para
></listitem>
</itemizedlist>
</para>

<para
>Ad esempio, un'espressione regolare della traccia (seconda riga) da importare da una scaletta <filename class="extension"
>.m3u</filename
> potrebbe essere «<literal
>%{track}(\d+) \s +%{title}(\S [^\r\n]*)\.mp3[\r\n]</literal
> ». Tutti i formati possono essere cambiati modificando le espressioni regolari e il nome e quindi facendo clic su <guibutton
>Salva impostazioni</guibutton
>. Saranno memorizzati nel file <filename
>kid3rc</filename
> nella cartella di configurazione. Questo file può essere direttamente modificato per avere più formati di importazione o può essere eliminato per ripristinare i formati predefiniti. I formati possono essere eliminati utilizzando <guibutton
>Rimuovi</guibutton
>. </para>
<para
><guilabel
>Precisione</guilabel
> mostra una stima della corrispondenza tra le informazioni importate e le tracce fornite. Utilizza la durata delle tracce o i nomi dei file per calcolare il livello di somiglianza in percentuale. <guilabel
> Copertina </guilabel
> mostra l'&URL; dell'immagine di copertina dell'album che sarà scaricata. </para>
<para
>Per verificare se le tracce importate corrispondono all'insieme attuale di file, è possibile confrontare la durata delle tracce importate con la durata dei file. Questa opzione può essere abilitata con la casella di selezione <guibutton
>Controlla la differenza di tempo massima consentita (sec):</guibutton
> e la differenza massima tollerata nel tempo può essere impostata in secondi. Se viene rilevata una mancata corrispondenza in una lunghezza, la lunghezza viene visualizzata con uno sfondo rosso nella tabella di anteprima. </para>
<para
>Se i file sono ordinati in modo diverso rispetto alle tracce importate, è necessario modificare le tracce assegnate. Questa attività può essere facilitata utilizzando l'opzione <guilabel
>Corrisponde a</guilabel
> con i pulsanti <guibutton
>Lunghezza</guibutton
>, <guibutton
>Traccia</guibutton
> e <guibutton
>Titolo</guibutton
>, che riordinare le tracce in base al campo corrispondente. Per correggere manualmente le assegnazioni, è possibile trascinare una traccia con il pulsante <mousebutton
>sinistro</mousebutton
> e il tasto &Ctrl; premuto, quindi rilasciare nella nuova posizione. </para>
<para
>Quando si apre la finestra di importazione, essa contiene il contenuto attuale dei tag. Il tipo di tag (Tag 1, Tag 2, Tag 1 e Tag 2) può essere selezionato utilizzando la casella combinata <guilabel
>Destinazione</guilabel
>. Il pulsante a destra di questa casella combinata può essere utilizzato per ripristinare la tabella al contenuto attuale 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 le tracce di entrambi i &CD; di un doppio &CD; e solo le tracce del secondo &CD; devono essere importate. </para>
<para
>Per identificare le tracce importate, è possibile visualizzare i nomi dei file o i percorsi completi dei file utilizzando il menu di contestuale dell'intestazione della tabella. I valori nella tabella di importazione possono essere modificati. Il pulsante Ripristina a destra della casella combinata <guilabel
>Destinazione</guilabel
> può essere utilizzato per ripristinare il contenuto dei tag, che può essere utile anche dopo aver modificato la <guilabel
>Destinazione</guilabel
>. </para>
<para
>Quasi tutte le finestre dispongono di un pulsante <guibutton
>Salva impostazioni</guibutton
>, che può essere utilizzato per memorizzare in modo persistente le impostazioni specifiche e le dimensioni della finestra. </para>

<para id="import-tags"
><guibutton
>Da tag</guibutton
> porta a una sotto-finestra per impostare i frame dei tag dal contenuto di altri frame dei tag. Questo può essere usato per copiare semplicemente informazioni tra tag o estrarre una parte da un frame e inserirla in un altro. </para>
<para
>Come nella finestra <link linkend="import-text"
>importa da file/appunti</link
>, ci sono formati liberamente configurabili per eseguire diverse operazioni. Sono già preconfigurati formati per copiare il valore dell'album in Artista dell'album, Compositore o Direttore ed estrarre il numero di traccia dai campi del titolo che contengono un numero. Esiste anche un formato per estrarre un sottotitolo da un campo Titolo. </para>
<para
>L'esempio seguente spiega come aggiungere un formato personalizzato, che imposta le informazioni dal campo Sottotitoli anche nel campo Commento. Crea un nuovo formato utilizzando il pulsante <guibutton
>Aggiungi</guibutton
> e imposta un nuovo nome, <abbrev
>ad es.</abbrev
> «Sottotitolo su commento». Quindi inserire «<userinput
>%{subtitle}</userinput
>» in <guilabel
>Fonte</guilabel
> e «<userinput
>%{comment}(.*)</userinput
>» per <guilabel
>Estrazione</guilabel 
> e fare clic su <guibutton
>Salva impostazioni</guibutton
>. </para>
<para
>L'espressione in <guilabel
>Fonte</guilabel
> può contenere <link linkend="format-codes"
>codici di formato</link
> per frame di tag arbitrari, è possibile utilizzare più codici per combinare i contenuti di frame diversi. Per ogni traccia, un testo viene generato dai suoi tag utilizzando il formato <guilabel
>Fonte</guilabel
> e l'espressione regolare da <guilabel
>Estrazione</guilabel
> viene applicata a questo testo per impostare nuovi valori per i tag. I codici di formato sono utilizzati prima delle parentesi di acquisizione per specificare il frame del tag in cui deve essere memorizzato il testo acquisito. Funziona come per <link linkend="import-text"
>importa da file/appunti</link
>. </para>
<para
><guimenuitem
> Importa da tag...</guimenuitem
> è anche disponibile direttamente dal menu <guimenu
>File</guimenu
>. La differenza tra queste due funzioni è che la finestra di importazione opera su tutti i file della cartella attuale mentre la funzione di menu opera sui file selezionati (che possono trovarsi in cartelle diverse). La funzione di menu supporta un codice aggiuntivo «<literal
>%{__return}</literal
>» per restituire il valore estratto, che può essere utile con le interfacce CLI e QML. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da gnudb.org...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importa da un server freedb.org utilizzando la ricerca degli album di gnudb.org.</action
> Questo elemento di menu apre la stessa finestra di importazione di <guimenuitem
>Importa...</guimenuitem
>, ma apre direttamente la sezione <guibutton
>gnudb.org</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da Discogs...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importa dal server Discogs.</action
> Questo elemento di menu apre la stessa finestra di importazione di <guimenuitem
>Importa...</guimenuitem
>, ma apre direttamente la sezione <guibutton
>Da Discogs</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da Amazon...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importa da Amazon.</action
> Questo elemento di menu apre la stessa finestra di importazione di <guimenuitem
>Importa...</guimenuitem
>, ma apre direttamente la sezione <guibutton
>Da Amazon</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da MusicBrainz Release...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importa dalla banca dati delle uscite di MusicBrainz.</action
> Questo elemento di menu apre la stessa finestra di importazione di <guimenuitem
>Importa...</guimenuitem
>, ma apre direttamente la sezione <guibutton
>Da MusicBrainz Release</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da MusicBrainz Fingerprint...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importa dal server di MusicBrainz.</action
> Questo elemento di menu apre la stessa finestra di importazione di <guimenuitem
>Importa...</guimenuitem
>, ma apre direttamente la sezione <guibutton
>Da MusicBrainz Fingerprint</guibutton
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importa da tag...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Come <link linkend="import-tags"
>Da tag</link
>, ma l'importazione è applicata ai file selezionati.</para
></listitem>
</varlistentry>

<varlistentry id="batch-import">
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Importazione automatica...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Importazione automatica</action
> consente di importare informazioni per più album da vari servizi Web. Se le cartelle sono selezionate nell'elenco dei file, saranno importati i dati di traccia per le cartelle selezionate. Se non è selezionata alcuna cartella, saranno importate tutte le cartelle nell'elenco dei file. </para>
<para
>Il tipo di tag (tag 1, tag 2, tag 1 e tag 2) può essere selezionato utilizzando la casella combinata <guilabel
>Destinazione</guilabel
>. </para>
<para
>I profili determinano quali server saranno contattati per recuperare le informazioni sull'album. Alcuni profili sono predefiniti (Tutti, MusicBrainz, Discogs, Copertina), i profili personalizzati possono essere aggiunti utilizzando il pulsante <guibutton
>Aggiungi</guibutton
> a destra della casella combinata <guilabel
>Profilo</guilabel
>. </para>
<para
>La tabella seguente mostra i server che saranno utilizzati durante l'importazione delle informazioni sull'album utilizzando il profilo selezionato. Il processo di importazione di un album è terminato se sono state trovate tutte le informazioni richieste, quindi l'ordine delle righe nella tabella è importante. Può essere modificato utilizzando i pulsanti <guibutton
>Sposta su</guibutton
> e <guibutton
>Sposta giù</guibutton
>. <guibutton
>Modifica</guibutton
> può essere utilizzato per modificare una voce esistente. La selezione <guibutton
>Server</guibutton
> offre gli stessi server che possono essere utilizzati nelle funzioni di importazione. <guilabel
>Tag standard</guilabel
>, <guilabel
>Tag aggiuntivi</guilabel
>, <guilabel
>Copertina</guilabel
> determinano le informazioni che devono essere recuperate dal server. Infine, <guilabel
>Precisione</guilabel
> è l'accuratezza minima che deve essere raggiunta per accettare i dati importati. Se la precisione non è sufficiente, sarà tentato il server successivo nell'elenco. La stessa finestra contenente le proprietà del server appare quando si fa clic su <guibutton
>Aggiungi</guibutton
> per aggiungere una nuova voce dei server. Le voci esistenti possono essere eliminate utilizzando <guibutton
>Rimuovi</guibutton
>. </para>
<para
>Per avviare un'importazione in serie automatica con il profilo selezionato, fare clic su <guibutton
>Avvia</guibutton
>. I dettagli sull'importazione in esecuzione sono visualizzati nella parte superiore della finestra. Il processo può essere interrotto con il pulsante <guibutton
>Interrompi</guibutton
>. </para>
 </listitem>
</varlistentry>

<varlistentry id="browse_pictures">
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Preleva copertina...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>La finestra <action
>Sfoglia copertina</action
> aiuta a trovare la copertina dell'album. <guilabel
>Artista/Album</guilabel
> viene riempito dai tag, se possibile. <guilabel
>Fonte</guilabel
> offre una varietà di siti web con copertine di album. L'&URL; con artista e album come parametri si trova sotto il nome. I valori codificati come &URL; per artista e album possono essere inseriti utilizzando «<userinput
>%u{artist}</userinput
>» e «<userinput
>% u{album}</userinput
>», sono possibili altri valori dai tag anche, come descritto in <link linkend="configure-kid3"
>Configura &kid3;</link
>, <guilabel
>Azioni dell'utente</guilabel
>. Altre fonti possono essere inserite dopo la voce «Fonte personalizzata» sostituendo «Fonte personalizzata» con il nome della fonte, premendo <keycap
>Invio</keycap
>, quindi inserendo &URL; e infine premendo <guibutton
>Salva impostazioni</guibutton
>. Il comando del browser risultante viene visualizzato nella parte superiore della finestra e può essere avviato facendo clic su <guibutton
>Sfoglia</guibutton
>. Il browser, che può essere configurato nelle impostazioni, viene avviato con la fonte selezionata. Un'immagine di copertina può quindi essere trascinata dal browser nella finestra di &kid3; e sarà impostato nella cornice dei file selezionati. </para>
<para
>Poiché non tutti i browser supportano il trascinamento della selezione delle immagini e le immagini sui siti web spesso hanno un &URL;, in questi casi &kid3; riceverà l'&URL; e non l'immagine. Se l'&URL; punta a un'immagine, essa sarà scaricata. Tuttavia, se l'&URL; si riferisce ad altre risorse web, deve essere tradotto nell'immagine corrispondente. Tali associazioni sono definite nella tabella <guilabel
>Estrazione &URL;</guilabel
>. La colonna di sinistra <guilabel
>Corrispondenza</guilabel
> contiene un'espressione regolare che viene confrontata con l'&URL;. Se corrisponde, le espressioni catturate tra parentesi sono inserite nel modello della colonna destra <guilabel
>Immagine e &URL;</guilabel
> (nelle posizioni marcate con \1 <abbrev
>ecc.</abbrev
>). L'espressione regolare sostituita contiene l'&URL; della foto. In questo modo la copertina può essere importata da Amazon, Google Immagini, <abbrev
>ecc.</abbrev
> utilizzando il trascinamento della selezione. È anche possibile definire le proprie associazioni. </para>
</listitem>
</varlistentry>

<varlistentry id="export">
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Esporta...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>La <action
>Finestra Esporta</action
> viene utilizzata per archiviare i dati dai tag in un file o negli appunti. L'editor in alto mostra un'anteprima dei dati da esportare. Se i dati di esportazione contengono caratteri di tabulazione, l'esportazione viene visualizzata in una tabella. I dati saranno generati dai tag nella cartella attuale in base al formato configurato. </para>
<para
>Le impostazioni del formato sono simili a quelle della finestra Importa: il campo più in alto contiene il titolo (<abbrev
>ad es.</abbrev
> «CSV non quotato»), seguito dall'intestazione, che sarà generata all'inizio del file. Di seguito sono riportati i dati della traccia; è usato per ogni traccia. Infine, il trailer può essere utilizzato per generare del testo finale. </para>
<para
>I campi del formato non contengono espressioni regolari come nella finestra Importa, ma solo espressioni di formato del risultato con speciali espressioni che iniziano con il carattere %, che saranno sostituite dai valori dei tag. Il tutto funziona come il formato del nome file e gli stessi codici sono utilizzati più alcuni codici aggiuntivi. È possibile utilizzare non solo i codici elencati di seguito, ma tutti i nomi dei frame dei tag. </para>

<itemizedlist>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia (<abbrev
>ad es.</abbrev
> 01)</para
></listitem>
<listitem
><para
>%t %{track.n} Traccia con larghezza dei campi n (<abbrev
>ad es.</abbrev
> 001 per %{track.3})</para
></listitem>
<listitem
><para
>%T %{tracknumber} Traccia (senza zeri iniziali, <abbrev
>ad es.</abbrev
> 1)</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%f %{file} Nome file</para
></listitem>
<listitem
><para
>%p %{filepath} Percorso</para
></listitem>
<listitem
><para
>%{modificationdate} Data di modifica</para
></listitem>
<listitem
><para
>%{creationdate} Data di creazione</para
></listitem>
<listitem
><para
>%u %{url} &URL;</para
></listitem>
<listitem
><para
>%{dirname} Nome della cartella</para
></listitem>
<listitem
><para
>%d %{duration} Durata in minuti:secondi</para
></listitem>
<listitem
><para
>%D %{seconds} Durata in secondi</para
></listitem>
<listitem
><para
>%n %{tracks} Numero di tracce dell'album</para
></listitem>
<listitem
><para
>%e %{extension} Estensione del file</para
></listitem>
<listitem
><para
>%O %{tag1} Il formato del tag 1 (ID3v1.1 o vuoto se non esistente)</para
></listitem>
<listitem
><para
>%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)</para
></listitem>
<listitem
><para
>%b %{bitrate} Bit rate in kbit/s</para
></listitem>
<listitem
><para
>%v %{vbr} VBR o vuoto (solo per ID3v2.3 con id3lib)</para
></listitem>
<listitem
><para
>%r %{samplerate} Campionamento in Hz</para
></listitem>
<listitem
><para
>%m %{mode} Modalità canale (stereo o stereo congiunto)</para
></listitem>
<listitem
><para
>%h %{channels} Numero di canali (1 o 2)</para
></listitem>
<listitem
><para
>%k %{codec} Codificatore (<abbrev
>ad es.</abbrev
> MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV)</para
></listitem>
</itemizedlist>

<para
>Alcuni formati sono predefiniti. «CSV non quotato» separa i campi in schede. I dati in questo formato possono essere nuovamente importati in &kid3; utilizzando il formato di importazione con lo stesso nome. «CSV quotato» racchiude inoltre i campi tra virgolette doppie, facilitando l'importazione in applicazioni per fogli di calcolo. Tuttavia, i campi non devono contenere virgolette doppie quando si utilizza questo formato. «M3U esteso» e «PLS esteso» generano scalette con attributi estesi e nomi di percorso assoluti. «HTML» può essere utilizzato per generare una 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, <abbrev
>ecc.</abbrev
> Infine, «Formato personalizzato» viene lasciato vuoto per la definizione di un formato personalizzato. È possibile definire più formati personalizzati aggiungendo righe nel file <filename
>kid3rc</filename
> nella cartella di configurazione. Gli altri formati possono essere adattati alle proprie esigenze. </para>
<para
>La <guilabel
>Fonte</guilabel
> dei tag per generare i dati dell'esportazione (<guilabel
>Tag 1</guilabel
> o <guilabel
>Tag 2</guilabel
>) può essere selezionata con una casella combinata. Premendo <guibutton
>Su file</guibutton
> o <guibutton
>Negli appunti</guibutton
> sono archiviati i dati in un file o negli appunti. <guibutton
>OK</guibutton
> e <guibutton
>Annulla</guibutton
> chiudono la finestra, mentre <guibutton
>OK</guibutton
> accetta le impostazioni della finestra attuale. </para
></listitem>
</varlistentry>

<varlistentry id="create-playlist">
<term
><menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Crea scaletta...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crea una scaletta.</action
> Il formato e il contenuto della scaletta possono essere impostati tramite diverse opzioni.</para>
<para
>Il nome della scaletta può essere <guibutton
>Come il nome della cartella</guibutton
> oppure utilizzare un <guibutton
>Formato</guibutton
> con i valori dei tag, <abbrev
>ad es.</abbrev
> «<userinput
>%{artist} - %{album}</userinput
>» per avere l'artista e il nome dell'album nel nome del file della scaletta. I codici di formato sono gli stessi di <link linkend="export"
>Esporta</link
>. L'elenco dei formati disponibili può essere modificato nella sezione <guilabel
>Formato</guilabel
> della scheda <guilabel
>File</guilabel
> nelle <link linkend="configure-kid3"
>impostazioni</link
>.<guibutton
>Crea nuova scaletta vuota</guibutton
> crea una scaletta vuota con il nome indicato. L'estensione dipende dal formato della scaletta. </para>
<para
>La posizione della scaletta generata è determinata dalla selezione della casella combinata <guilabel
>Crea in</guilabel
>. <variablelist>
<varlistentry
><term
>Cartella attuale</term>
<listitem
><para
>La scaletta viene creata nella cartella attuale e contiene solo i file della cartella attuale. La cartella attuale è la cartella in cui si trova il file attuale. Se sono selezionati più file, il file attuale è probabilmente l'ultimo file selezionato.</para
></listitem
></varlistentry>
<varlistentry
><term
>Tutte le cartelle</term>
<listitem
><para
>Una scaletta è creata in ogni cartella che contiene i file elencati, e ogni scaletta contiene i file di quella cartella. </para
></listitem
></varlistentry>
<varlistentry
><term
>Cartella principale</term>
<listitem
><para
>Viene creata una sola scaletta nella cartella di livello superiore (cioè la cartella dell'elenco file) e contiene i file elencati della cartella di livello superiore e tutte le sue sottocartelle. </para
></listitem
></varlistentry>
</variablelist>
</para>
<para
>Il <guilabel
>Formato</guilabel
> della scaletta può essere <guilabel
>M3U</guilabel
>, <guilabel
>PLS</guilabel
> o <guilabel
>XSPF</guilabel
>. </para>
<para
>Se è selezionato <guibutton
>Includi solo i file selezionati</guibutton
>, nella scaletta saranno inclusi solo i file selezionati. Se viene selezionata una cartella, saranno selezionati tutti i suoi file. Se questa casella di controllo non è attivata, tutti i file audio saranno inclusi nella scaletta. </para>
<para
><guibutton
>Ordina per nome file</guibutton
> seleziona il solito caso in cui i file sono ordinati per nome file. Con <guibutton
>Ordina per campo tag</guibutton
>, è possibile ordinare in base a una stringa di formato con valori dai campi tag. Ad esempio, «<userinput
>%{track.3}</userinput
>» può essere utilizzato per ordinare in base al numero di traccia («<userinput
>.3</userinput
>» viene utilizzato per ottenere tre cifre con zeri iniziali poiché le stringhe sono utilizzate per l'ordinamento). È anche possibile utilizzare più campi, <abbrev
>ad es.</abbrev
> «<userinput
>%{genre}%{year}</userinput
>» per ordinare utilizzando una stringa composta da genere e anno. </para>
<para
>Le voci della scaletta avranno percorsi di file relativi o assoluti a seconda che sia impostato <guibutton
>Usa percorso relativo per i file nella scaletta</guibutton
> o <guibutton
>Usa percorso completo per i file nella scaletta</guibutton
>. </para>
<para
>Quando è impostato <guibutton
>Scrivi solo un elenco di file</guibutton
>, la scaletta conterrà solo i percorsi dei file. Per generare una scaletta estesa con informazioni aggiuntive, è possibile impostare una stringa di formato utilizzando il controllo <guibutton
>Scrivi informazioni usando</guibutton
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Chiude l'applicazione.</action
></para
></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="edit-menu">
<title
>Il menu Modifica</title>
<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Alt;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Seleziona tutto</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Seleziona tutti i file.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Maiusc</keycap
><keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Deseleziona</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Deseleziona tutti i file.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Modifica</guimenu
> <guimenuitem
>Seleziona tutti i file nella cartella</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Seleziona tutti i file della cartella attuale.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Alt;<keycap
>Su</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>File precedente</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Seleziona il file precedente.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Alt;<keycap
>Giù</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>File successivo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Seleziona il file successivo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Trova...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Trova le stringhe nei nomi dei file e nei tag. La finestra <guilabel
>Trova</guilabel
> è un sottoinsieme della finestra <guilabel
>Sostituisci</guilabel
>, che è descritta di seguito. </para
></listitem>
</varlistentry>

<varlistentry id="find-replace">
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Modifica</guimenu
> <guimenuitem
>Sostituisci...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Questa funzione apre una finestra per trovare e sostituire le stringhe nei nomi dei file e nei tag. L'insieme di frame in cui viene eseguita la ricerca può essere limitato disattivando la casella di controllo <guilabel
>Seleziona tutto</guilabel
> e selezionando i frame da cercare. Ci sono anche opzioni di ricerca disponibili per cercare all'indietro, tenendo conto delle maiuscole e per usare espressioni regolari.</para>
<para
>In base al numero di file, la ricerca potrebbe richiedere del tempo, perciò può essere interrotta chiudendo la finestra.</para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect1>

<sect1 id="tools-menu">
<title
>Il menu Strumenti</title>
<para>
<variablelist>

<varlistentry id="apply-filename-format">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Applica formato nome file</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Quando <guilabel
>Applica automaticamente il formato</guilabel
> è disattivata per il formato del nome file nella finestra di configurazione, questa voce di menu può essere utilizzata per <action
>applicare il formato configurato ai nomi dei file selezionati</action
>. Questo può anche essere utilizzato per verificare se i nomi dei file sono conformi al formato configurato applicando il formato a tutti i file salvati e quindi controllando se alcuni file sono stati modificati (e quindi marcati con il simbolo di un disco nell'elenco dei file). </para
></listitem>
</varlistentry>

<varlistentry id="apply-tag-format">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Applica formato tag</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Quando <guilabel
>Applica automaticamente il formato</guilabel
> è disattivata per il formato di tag nella finestra di configurazione, questa voce di menu può essere utilizzata per <action
>applicare il formato configurato ai tag dei file selezionati</action
>. Questo può anche essere utilizzato per verificare se i tag sono conformi al formato configurato applicando il formato a tutti i file salvati e quindi controllando se alcuni file sono stati modificati (e quindi marcati con il simbolo di un disco nell'elenco dei file). </para
></listitem>
</varlistentry>

<varlistentry id="apply-text-encoding">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Applica codifica del testo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Imposta la <guilabel
>Codifica del testo</guilabel
> selezionata in <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kid3;...</guimenuitem
><guimenuitem
>Sezione tag</guimenuitem
> <guimenuitem
>Scheda Tag 2</guimenuitem
></menuchoice
> per tutti i file selezionati. Se UTF8 è selezionato, UTF16 sarà utilizzato per i tag ID3v2.3.0 poiché UTF8 non è supportato per questo formato.</para
></listitem>
</varlistentry>

<varlistentry id="rename-directory">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Rinomina cartella...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Questa finestra offre la possibilità di rinominare automaticamente la cartella attualmente aperta in base ai tag nei file. Diversi formati sono preconfigurati per includere informazioni sull'artista, sull'album e sull'anno nel nome della cartella. È anche possibile impostare un formato personalizzato e <guibutton
>Modifica</guibutton
> l'elenco dei formati disponibili. I seguenti codici speciali vengono utilizzati per inserire i valori dei tag nel nome della cartella: </para>

<itemizedlist>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia (<abbrev
>ad es.</abbrev
> 01)</para
></listitem>
<listitem
><para
>%t %{track.n} Traccia con larghezza dei campi n (<abbrev
>ad es.</abbrev
> 001 per %{track.3})</para
></listitem>
<listitem
><para
>%T %{tracknumber} Traccia (senza zeri iniziali, <abbrev
>ad es.</abbrev
> 1)</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%{dirname} Nome della cartella (<abbrev
>ad es.</abbrev
> %{year" "}%{dirname} anteporrà l'anno al nome attuale della cartella)</para
></listitem>
<listitem
><para
>%{max-year} Il valore massimo dell'anno trovato per questa cartella, può essere utilizzato per altri codici diversi da «year»</para
></listitem>
<listitem
><para
>%{min-year} Il valore minimo dell'anno trovato per questa cartella</para
></listitem>
<listitem
><para
>%{unq-year} Il valore unico dell'anno trovato per questa cartella o vuoto se non unico</para
></listitem>
</itemizedlist>

<para
>Se viene individuato un separatore di cartelle «/» nel formato, saranno create più cartelle. Se si desidera creare una nuova cartella anziché rinominare la cartella attuale, nella casella combinata <guilabel
>Azione</guilabel
> selezionare <guilabel
>Crea cartella</guilabel
> anziché <guilabel
>Rinomina cartella</guilabel
>. La <guilabel
>Fonte</guilabel
> delle informazioni sui tag può essere scelta tra <guilabel
>Tag 1 e tag 2</guilabel
>, <guilabel
>Tag 1</guilabel
> e <guilabel
>Tag 2</guilabel
>. Un'anteprima dell'operazione di rinomina eseguita sul primo file è disponibile nelle sezioni <guilabel
>Da</guilabel
> e <guilabel
>A</guilabel
> della finestra. </para>
<para
>Più cartelle possono essere rinominate selezionandole </para
></listitem>
</varlistentry>

<varlistentry id="number-tracks">
<term
><menuchoice
><guimenu
>Tools</guimenu
> <guimenuitem
>Numero tracce...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Se i numeri delle tracce nei tag non sono impostati o hanno valori errati, questa funzione può <action
>numerare automaticamente le tracce in ordine crescente</action
>. Il numero iniziale può essere impostato nella finestra. Se è necessario numerare solo una parte delle tracce, esse devono essere selezionate. </para
><para
>Quando si seleziona <guilabel
>Numero totale di tracce</guilabel
>, nei tag sarà impostato anche il numero di tracce. </para
><para
>È possibile numerare le tracce in più cartelle. Le cartelle devono essere espanse e selezionate. </para
><para
>Se è selezionato <guilabel
>Reimposta contatore per ciascuna cartella</guilabel
>, la numerazione delle tracce viene riavviata con il numero indicato per ciascuna cartella quando vengono selezionate più cartelle. </para
><para
>La finestra di numerazione delle tracce può anche essere utilizzata per formattare i numeri di traccia esistenti senza modificare i valori quando la casella di controllo lasciata su <guilabel
>Numero iniziale</guilabel
> è disattivata. Il numero totale di tracce sarà aggiunto se la casella di controllo corrispondente è attiva, che può essere utilizzata per impostare il totale per tutte le tracce selezionate. Se si desidera solo la formattazione dei numeri esistenti, anche questa casella di controllo deve essere disattivata. </para
></listitem>
</varlistentry>

<varlistentry id="filter">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Filtro...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Il filtro può essere utilizzato per visualizzare solo quei file che soddisfano determinati criteri. Ciò è utile se si desidera organizzare una raccolta di grandi dimensioni e modificare solo i file che non si trovano nello schema desiderato. L'espressione che definisce i file da visualizzare utilizza gli stessi codici di formato utilizzati nel formato del nome file, nell'importazione e nell'esportazione. </para>

<itemizedlist>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia (<abbrev
>ad es.</abbrev
> 01)</para
></listitem>
<listitem
><para
>%t %{track.n} Traccia con larghezza dei campi n (<abbrev
>ad es.</abbrev
> 001 per %{track.3})</para
></listitem>
<listitem
><para
>%T %{tracknumber} Traccia (senza zeri iniziali, <abbrev
>ad es.</abbrev
> 1)</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%f %{file} Nome file</para
></listitem>
<listitem
><para
>%p %{filepath} Percorso assoluto al file</para
></listitem>
<listitem
><para
>%e %{extension} Estensione del file</para
></listitem>
<listitem
><para
>%O %{tag1} Il formato del tag 1 (ID3v1.1 o vuoto se non esistente)</para
></listitem>
<listitem
><para
>%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)</para
></listitem>
<listitem
><para
>%b %{bitrate} Bit rate in kbit/s</para
></listitem>
<listitem
><para
>%v %{vbr} VBR o vuoto (solo per ID3v2.3 con id3lib)</para
></listitem>
<listitem
><para
>%r %{samplerate} Campionamento in Hz</para
></listitem>
<listitem
><para
>%m %{mode} Modalità canale (stereo o stereo congiunto)</para
></listitem>
<listitem
><para
>%h %{channels} Numero di canali (1 o 2)</para
></listitem>
<listitem
><para
>%k %{codec} Codificatore (<abbrev
>ad es.</abbrev
> MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV)</para
></listitem>
<listitem
><para
>%w %{marked} Marcato, è 1 se il file è marcato (<abbrev
>ad es.</abbrev
> a causa di troncamento o violazione dello standard), vuoto altrimenti</para
></listitem>
<listitem
><para
>%1a %1{artist}, ... Utilizzare il prefisso 1 per ottenere i valori di tag 1</para
></listitem>
<listitem
><para
>%2a %2{artist}, ... Utilizzare il prefisso 2 per ottenere i valori di tag 2</para
></listitem>
</itemizedlist>

<para
>Questi codici sono sostituiti con i valori per il file e le stringhe risultanti possono essere confrontate con le seguenti operazioni: </para>
<itemizedlist>
<listitem
><para
>s1 equals s2: vero se s1 e s2 sono uguali.</para
></listitem>
<listitem
><para
>s1 contains s2: vero se s1 contiene s2, cioè s2 è una sottostringa di s1.</para
></listitem>
<listitem
><para
>s matches re: vero se s verifica l'espressione regolare re.</para
></listitem>
</itemizedlist>
<para
>Le espressioni vere sono sostituite da 1, false da 0. I valori veri sono rappresentati da 1, true, on e yes, i valori falsi da 0, false, off e no. Le operazioni booleane sono not, and, or (in questo ordine di precedenza) e possono essere raggruppate tra parentesi. </para>
<para
>Alcune regole di filtro sono predefinite e possono servire da esempio per le proprie espressioni: </para>

<variablelist>
<varlistentry
><term
>Tutto</term
><listitem>
<para
>Quando l'elenco dei file viene filtrato - questo è indicato da «[filtrato]» nel titolo della finestra - e tutti i file devono essere nuovamente visualizzati, il filtro può essere ripristinato utilizzando questo filtro.Utilizza un'espressione vuota, ma un valore vero avrebbe lo stesso effetto. </para>
</listitem
></varlistentry>

<varlistentry
><term
>Mancata corrispondenza tra nome file e tag</term
><listitem>
<para
><userinput
>not (%{filepath} contains "%{artist} - %{album}/%{track} %{title}") </userinput
></para>
<para
>Verifica se il percorso del file è conforme al formato del nome file. Questa regola viene adattata automaticamente se cambia il formato del nome file. </para>
</listitem
></varlistentry>

<varlistentry
><term
>Nessun tag 1</term
><listitem>
<para
><userinput
>%{tag1} equals "" </userinput
></para>
<para
>Visualizza solo i file che non hanno un tag 1.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Nessun tag 2</term
><listitem>
<para
><userinput
>%{tag2} equals "" </userinput
></para>
<para
>Visualizza solo i file che non hanno un tag 2.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Tag ID3v2.3.0</term
><listitem>
<para
><userinput
>%{tag2} equals "ID3v2.3.0" </userinput
></para>
<para
>Visualizza solo i file che non hanno un tag ID3v2.3.0.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Tag ID3v2.4.0</term
><listitem>
<para
><userinput
>%{tag2} equals "ID3v2.4.0" </userinput
></para>
<para
>Visualizza solo i file che non hanno un tag ID3v2.4.0.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Tag 1 != Tag 2</term
><listitem>
<para
><userinput
>not (%1{title} equals %2{title} and %1{album} equals %2{album} and %1{artist} equals %2{artist} and %1{comment} equals %2{comment} and %1{year} equals %2{year} and %1{track} equals %2{track} and %1{genre} equals %2{genre}) </userinput
></para>
<para
>Visualizza i file con differenze tra tag 1 e tag 2.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Tag 1 == Tag 2</term
><listitem>
<para
><userinput
>%1{title} equals %2{title} and %1{album} equals %2{album} and %1{artist} equals %2{artist} and %1{comment} equals %2{comment} and %1{year} equals %2{year} and %1{track} equals %2{track} and %1{genre} equals %2{genre} </userinput
></para>
<para
>Visualizza i file con tag 1 e tag 2 identici.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Incompleto</term
><listitem>
<para
><userinput
>%{title} equals "" or %{artist} equals "" or %{album} equals "" or %{year} equals "" or %{tracknumber} equals "" or %{genre} equals "" </userinput
></para>
<para
>Visualizza i file con valori vuoti nei tag standard (titolo, artista, album, data, numero traccia, genere).</para>
</listitem
></varlistentry>

<varlistentry
><term
>Nessuna immagine</term
><listitem>
<para
><userinput
>%{picture} equals "" </userinput
></para>
<para
>Visualizza solo i file che non hanno un'immagine.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Marcato</term
><listitem>
<para
><userinput
>not (%{marked} equals "") </userinput
></para>
<para
>Visualizza solo i file che sono marcati perché violano lo standard ID3, sono troncati o l'immagine è troppo grande.</para>
</listitem
></varlistentry>

<varlistentry
><term
>Filtro personalizzato</term
><listitem>
<para
>Per aggiungere il proprio filtro, selezionare questa voce. Ad esempio, se si desidera avere un filtro per gli artisti che iniziano con «The», sostituire «Filtro personalizzato» con il nome «The Bands» e premere <keycap
>Invio</keycap
>. Quindi inserire la seguente espressione nel campo di testo: </para>
<para
><userinput
>%{artist} matches "The.*" </userinput
></para>
<para
>Quindi fare clic su <guibutton
>Salva impostazioni</guibutton
>. Fare clic su <guibutton
>Applica</guibutton
> per filtrare i file. Tutti i file elaborati sono visualizzati nella vista di testo, con un «+» per quelli che corrispondono al filtro e un «-» per gli altri. Al termine, sono visualizzati solo i file con un artista il cui nome inizia con «The» e il titolo della finestra è marcato con «[filtrato]». </para>
</listitem
></varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry id="convert-to-id3v24">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Converti ID3v2.3 in ID3v2.4</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Se ci sono tag ID3v2.3 nei file selezionati, saranno <action
>convertiti in tag ID3v2.4</action
>. I frame che non sono supportati da TagLib saranno eliminati. Saranno convertiti solo i file senza modifiche non salvate. </para
></listitem>
</varlistentry>

<varlistentry id="convert-to-id3v23">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Converti ID3v2.4 in ID3v2.3</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Se ci sono tag ID3v2.4 nei file selezionati, saranno <action
>convertiti in tag ID3v2.3</action
>. Saranno convertiti solo i file senza modifiche non salvate. </para
></listitem>
</varlistentry>

<varlistentry id="play">
<term
><menuchoice
><guimenu
>Strumenti</guimenu
> <guimenuitem
>Riproduci</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Si apre una semplice barra degli strumenti per riprodurre file audio. Contiene i pulsanti per le operazioni di base (<guibutton
>Riproduci/Pausa</guibutton
>, <guibutton
>Interrompi riproduzione</guibutton
>, <guibutton
>Traccia precedente</guibutton
>, <guibutton
>Traccia successiva</guibutton
>, <guibutton
>Chiudi</guibutton
>), cursori per posizione e volume e un indicatore della posizione attuale. Se si selezionati più file, le tracce selezionate sono riprodotte, altrimenti saranno riprodotti tutti i file. </para
><para
>Il tempo visualizzato può essere commutato tra tempo trascorso e tempo rimanente facendo clic sullo schermo. </para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect1>

<sect1 id="settings-menu">
<title
>Il menu Impostazioni</title>
<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra la barra degli strumenti</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Commuta la visualizzazione della barra degli strumenti.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra la barra di stato</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Commuta la visualizzazione della barra di stato</action
>, che visualizza azioni più lunghe come l'apertura o il salvataggio di una cartella.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra immagine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Commuta la visualizzazione dell'immagine di anteprima della copertina dell'album.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Nascondi automaticamente i tag</guimenuitem
> </menuchoice
></term>
<listitem
><para
>I tag vuoti sono automaticamente nascosti se questa opzione è attiva. Le sezioni <guilabel
>File</guilabel
>, <guilabel
>Tag 1</guilabel
> e <guilabel
>Tag 2</guilabel
> possono essere compresse manualmente ed espanse facendo clic sui pulsanti corrispondenti <guibutton
>-</guibutton
>/<guibutton
>+</guibutton
>. </para
></listitem>
</varlistentry>

<varlistentry id="configure-shortcuts">
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configurare scorciatoie da tastiera...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Apre una finestra per assegnare le scorciatoie da tastiera per la maggior parte delle funzioni del programma. Ci sono anche funzioni senza menu o pulsante corrispondente disponibili, <abbrev
>ad es.</abbrev
> file successivo, file precedente, selezionare tutto. </para>
 
</listitem>
</varlistentry>

<varlistentry id="configure-kid3">
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura &kid3;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Apre la <action
>finestra di configurazione</action
>, che consiste di pagine per tag, azioni dell'utente e impostazioni di rete. </para>
<para
>Le opzioni specifiche dei tag sono disponibili nella pagina <guilabel
>Tag</guilabel
>, che è essa stessa suddivisa in quattro schede per <guilabel
>Tag 1</guilabel
>, <guilabel
>Tag 2</guilabel
>, <guilabel
>Tag 3</guilabel
> e <guilabel
>Tutti i tag</guilabel
>. </para>
<para
>Se <guilabel
>Evidenzia i campi troncati</guilabel
> è selezionata, i campi troncati ID3v1.1 saranno marcati in rosso. I campi di testo dei tag ID3v1.1 possono contenere solo 30 caratteri, il commento solo 28 caratteri. Anche i numeri di genere e traccia sono limitati, in modo che i campi possano essere troncati quando importati o trasferiti da ID3v2. I campi troncati e il file saranno marcati in rosso e il segno sarà rimosso dopo la modifica del campo. </para>
<para
>Con <guilabel
>Codifica del testo</guilabel
> per <guilabel
>ID3v1</guilabel
> è possibile impostare l'insieme di caratteri utilizzato nei tag ID3v1. Questa codifica dovrebbe essere ISO-8859-1, quindi si consiglia di mantenere questo valore predefinito. Tuttavia, ci sono tag in giro con codifica diversa, quindi può essere impostato qui e i tag ID3v1 possono essere copiati in ID3v2 che supporta Unicode. </para>
<para
>La casella di selezione <guilabel
>Utilizza il formato traccia/numero totale delle tracce</guilabel
> controlla se il campo del numero di traccia dei tag ID3v2 contiene semplicemente il numero di traccia o in aggiunta il numero totale di tracce nella cartella. </para>
<para
>Quando si seleziona <guilabel
>Genere come testo anziché stringa numerica</guilabel
>, tutti i generi ID3v2 saranno archiviati 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 vengono memorizzati come numero del codice del genere (tra parentesi per ID3v2.3). Pertanto, il genere Metal viene memorizzato come «Metal» o «(9)» a seconda di questa opzione. I generi che non sono nell'elenco dei generi ID3v1 sono sempre memorizzati come stringa di testo. Lo scopo di questa opzione è una migliore compatibilità con i dispositivi che non interpretano correttamente i codici di genere. </para>
<para
>Quando si seleziona <guilabel
>File WAV con blocco ID3 minuscolo</guilabel
>, il blocco RIFF utilizzato per archiviare i tag ID3v2 nei file WAV sarà chiamato «id3» anziché «ID3». Per impostazione predefinita, &kid3; e altre applicazioni che utilizzano TagLib accettano sia la variante minuscola sia quella maiuscola durante la lettura di file WAV, ma utilizzano «ID3» quando scrivono tag ID3v2 su file WAV. Poiché esistono altre applicazioni che accettano solo «id3» (<abbrev
>ad es.</abbrev
> JRiver Media Center e foobar2000), questa opzione può essere utilizzata per creare tag che possono essere letti da tali applicazioni. </para>
<para
>Quando si seleziona <guilabel
>Evidenzia le violazioni dello standard</guilabel
>, i campi ID3v2 che violano lo standard saranno marcati in rosso. I dettagli sulla violazione sono mostrati in una descrizione: </para>
<itemizedlist>
<listitem
><para
>Deve essere unico</para
></listitem>
<listitem
><para
>Una nuova riga non è consentita</para
></listitem>
<listitem
><para
>Il ritorno a capo non è consentito</para
></listitem>
<listitem
><para
>Il proprietario non può essere vuoto</para
></listitem>
<listitem
><para
>Deve essere numerico</para
></listitem>
<listitem
><para
>Deve essere numerico o numero/totale</para
></listitem>
<listitem
><para
>Il formato è GGMM</para
></listitem>
<listitem
><para
>Il formato è HHMM</para
></listitem>
<listitem
><para
>Il formato è AAAA</para
></listitem>
<listitem
><para
>Deve iniziare con un anno e un carattere di spaziatura</para
></listitem>
<listitem
><para
>Deve essere una data/ora ISO 8601</para
></listitem>
<listitem
><para
>Deve essere una chiave musicale, 3 caratteri, A-G, b, #, m, o</para
></listitem>
<listitem
><para
>Deve avere un codice di lingua ISO 639-2, 3 caratteri minuscoli</para
></listitem>
<listitem
><para
>Deve essere un codice ISRC, 12 caratteri</para
></listitem>
<listitem
><para
>Deve essere un elenco di stringhe separate da «|»</para
></listitem>
<listitem
><para
>Ha uno spazio in eccesso</para
></listitem>
</itemizedlist>
<para
>I documenti degli standard ID3 sono disponibili in linea: </para>
<itemizedlist>
<listitem
><para
><ulink url="http://id3.org/id3v2.3.0"
>Tag ID3 versione 2.3.0</ulink
></para
></listitem>
<listitem
><para
><ulink url="http://id3.org/id3v2.4.0-structure"
>Tag ID3 versione 2.4.0 - Struttura principale</ulink
></para
></listitem>
<listitem
><para
><ulink url="http://id3.org/id3v2.4.0-frames"
>Tag ID3 versione 2.4.0 - Frame nativi</ulink
></para
></listitem>
</itemizedlist>
<para
><guilabel
>Codifica del testo</guilabel
> definisce la codifica predefinita utilizzata per i frame ID3v2 e può essere impostata su <guilabel
>ISO-8859-1</guilabel
>, <guilabel
>UTF16</guilabel
> o <guilabel
>UTF8</guilabel
>. <guilabel
>UTF8</guilabel
> non è valido per i frame ID3v2.3.0; se impostato, sarà utilizzato <guilabel
>UTF16</guilabel
>. Per i frame ID3v2.4.0, sono possibili tutte e tre le codifiche. </para>
<para
><guilabel
>Versione usata per i nuovi tag</guilabel
> determina se i nuovi tag ID3v2 sono creati come versione 2.3.0 o 2.4.0. </para>
<para
><guilabel
> Cifre del numero di traccia</guilabel
> è il numero di cifre nei campi Numero traccia. Gli zeri iniziali sono utilizzati per la spaziatura. Ad esempio, con un valore di 2 il numero di traccia 5 è impostato come «05». </para>
<para
>La casella combinata <guilabel
>Nome campo commento</guilabel
> è rilevante solo per i file Ogg/Vorbis e FLAC e imposta il nome del campo utilizzato per i commenti. Applicazioni diverse sembrano usare nomi diversi, «<literal
>COMMENT</literal
>» ad esempio è utilizzato da <application
>XMMS</application
>, mentre &amarok; utilizza «<literal
>DESCRIPTION</literal
>». </para>
<para
>Il formato delle immagini nei file Ogg/Vorbis è determinato da <guilabel
>Nome campo immagine</guilabel
>, che può essere «<literal
>METADATA_BLOCK_PICTURE</literal
>» o «<literal
>COVERART</literal
>». Il primo è lo standard ufficiale e utilizza lo stesso formato delle immagini nei tag FLAC. «<literal
>COVERART</literal
>» è un modo non ufficiale precedente di includere immagini nei commenti di Vorbis. Può essere utilizzato per la compatibilità con lettori datati. </para>
<para
>Se la casella di selezione <guilabel
>Se più grande di (byte)</guilabel
> è attivata, i file contenenti copertine degli album incorporate che superano la dimensione data in byte sono marcati in rosso. Questo può essere usato per trovare file contenenti immagini di grandi dimensioni che non sono accettate da alcune applicazioni e lettori. Il valore predefinito è 131072 byte (128 KB). </para>
<para
><guilabel
>Generi personalizzati</guilabel
> può essere utilizzato per definire i generi che non sono disponibili nell'elenco dei generi standard, <abbrev
>ad es.</abbrev
> «Gothic Metal». Tali generi personalizzati appariranno nella casella combinata <guilabel
>Genere</guilabel
> di <guilabel
>Tag 2</guilabel
>. Per i tag ID3v1.1, è possibile utilizzare solo i generi predefiniti. </para>
<para
>L'elenco di generi personalizzati può anche essere utilizzato per ridurre il numero di generi disponibili nella casella combinata <guilabel
>Genere</guilabel
> a quelli normalmente utilizzati. Se la propria raccolta contiene principalmente musica nei generi Metal, Gothic Metal, Ancient e Hard Rock, è possibile inserire quei generi e marcare <guilabel
>Mostra solo generi personalizzati</guilabel
>. La casella combinata <guilabel
>Tag 2</guilabel
> <guilabel
>Genere</guilabel
> conterrà quindi solo quei quattro generi e non sarà necessario cercarli nell'elenco completo dei generi. In questo esempio, solo Metal e Hard Rock saranno elencati nell'elenco dei generi di tag 1, poiché queste due voci di generi personalizzati sono generi standard. Se <guilabel
>Mostra solo generi personalizzati</guilabel
> non è attiva, i generi personalizzati possono essere trovati alla fine dell'elenco dei generi. </para>
<para
>In <guilabel
>Frame personalizzati</guilabel
>, è possibile definire fino a otto nomi di frame personalizzati, che possono quindi essere utilizzati come frame unificati, ad esempio come frame di accesso rapido. </para>
<para
><guilabel
>Frame di accesso rapido</guilabel
> definisce quali tipi di frame sono mostrati sempre nella sezione <link linkend="tag2"
>Tag 2</link
>. Tali frame possono quindi essere aggiunti senza prima utilizzare il pulsante <guibutton
>Aggiungi</guibutton
>. L'ordine di questi frame di accesso rapido può essere modificato trascinando gli elementi. </para>
<para
>La casella combinata <guilabel
>Nome campo numero traccia</guilabel
> è rilevante solo per RIFF INFO e imposta il nome del campo utilizzato per i numeri di traccia. I numeri di traccia non sono specificati nello standard RIFF originale, ci sono applicazioni che utilizzano «<literal
>ITRK</literal
>», altri utilizzano «<literal
>IPRT</literal
>». </para>
<para
><guilabel
>Formato tag</guilabel
> contiene opzioni per il formato dei tag. Quando è selezionato <guilabel
>Applica automaticamente il formato</guilabel
>, la configurazione del formato viene utilizzata automaticamente durante la modifica del testo nei campi di testo. <guilabel
>Convalida</guilabel
> abilita validatori nei controlli con i valori di traccia/totale e data/ora.  <guilabel
>Maiuscole/minuscole</guilabel
> può essere impostato su <guilabel
>Nessuna modifica</guilabel
>, <guilabel
>Tutte minuscole</guilabel
>, <guilabel
>Tutte maiuscole</guilabel
>, <guilabel
>Prima lettera maiuscola</guilabel
> o <guilabel
>Tutte le prime lettere maiuscole</guilabel
>. Per utilizzare una conversione basata sulla localizzazione tra caratteri minuscoli e maiuscoli, è possibile selezionare una localizzazione nella casella combinata di seguito. L'elenco di sostituzione delle stringhe può essere impostato su associazioni di stringhe arbitrarie. Per aggiungere una nuova associazione, selezionare la cella <guilabel
>Da</guilabel
> di una riga e inserire il testo da sostituire, quindi portarsi sulla colonna <guilabel
>A</guilabel
> e inserire il testo sostitutivo. Quando il testo da sostituire inizia e termina con una barra ("/"), viene utilizzata un'espressione regolare. Per le espressioni regolari contenenti gruppi di acquisizione, le occorrenze di \1, \2, ... in <guilabel
>A</guilabel
> vengono sostituite con la stringa acquisita dal gruppo di acquisizione corrispondente. Per rimuovere un'associazione impostare la cella <guilabel
>Da</guilabel
> su un valore vuoto (<abbrev
>ad es.</abbrev
> digitando prima lo spazio e poi il backspace). L'inserimento e l'eliminazione di righe è anche possibile utilizzando un menu di scelta rapida che viene visualizzato quando si fa clic sul pulsante <mousebutton
>destro</mousebutton
>. La sostituzione è attiva solo se la casella di selezione <guilabel
>Sostituzione stringa</guilabel
> è marcata. </para>

<para
>La tabella in <guilabel
>Valutazione</guilabel
> contiene l'associazione delle valutazioni in stelle ai valori effettivi memorizzati nel tag. I frame con informazioni di valutazione sono elencati nella riga Valutazione dell'<link linkend="table-frame-list"
>elenco dei frame</link
>. Per questi frame, la valutazione può essere impostata assegnando un numero di stelle su cinque. Diversi formati di tag e diverse applicazioni utilizzano valori diversi per associare la valutazione in stelle al valore memorizzato nel tag. Per visualizzare il numero corretto di stelle, &kid3; cercherà una mappa in questa tabella. La chiave per cercare l'associazione è il nome del frame, ad esempio «RATING» utilizzato per i commenti di Vorbis o «IRTD» per RIFF INFO. Per i tag ID3v2, viene utilizzata una chiave combinata costituita dal frame ID «POPM» del frame Popularimeter e dal suo campo «Email», separati da un punto. Pertanto, esistono diverse chiavi per ID3v2, <abbrev
>ad es.</abbrev
> «POPM.Windows Media Player 9 Series» per l'associazione utilizzata da Windows Media Player ed Explorer, e semplicemente «POPM» per i frame POPM con un campo «Email» vuoto. Poiché possono esistere più voci per «POPM», il loro ordine è importante. Quando &kid3; aggiunge un nuovo frame Popularimeter, utilizzerà la prima voce «POPM» per determinare il valore da scrivere nel campo «Email». Questo valore specificherà quindi l'associazione da utilizzare per le stelle. La prima voce viene utilizzata anche se non viene trovata alcuna chiave, pertanto è la voce predefinita. </para>
<para
>Oltre alla colonna <guilabel
>Nome</guilabel
> contenente le chiavi, la tabella ha le colonne da <guilabel
>1</guilabel
> a <guilabel
>5</guilabel
> per i valori da memorizzare quando viene dato il numero di stelle corrispondente . Al contrario, i valori determinano il numero di stelle visualizzate per il valore memorizzato nel frame. Ad esempio, la riga nella tabella seguente contiene i valori 1, 64, 128, 196, 255. Le soglie per il numero di stelle da visualizzare si trovano tra questi valori e sono compatibili con ciò che &Windows; Explorer utilizza. </para>

<table id="table-rating">
  <title
>Voce nella tabella di valutazione</title>
  <tgroup cols="6">
    <thead>
      <row
><entry
>Nome</entry
><entry
>1</entry
> <entry
>2</entry
>  <entry
>3</entry
>  <entry
>4</entry
>  <entry
>5</entry
></row>
    </thead>
    <tbody>
      <row
><entry
>POPM</entry
><entry
>1</entry
><entry
>64</entry
><entry
>128</entry
><entry
>196</entry
><entry
>255</entry
></row>
      <row
><entry
>Intervallo</entry
><entry
>1-31</entry
><entry
>32-95</entry
><entry
>96-159</entry
><entry
>160-223</entry
><entry
>224-255</entry
></row>
    </tbody>
  </tgroup>
</table>

<para
>Nella pagina <guilabel
>File</guilabel
> la casella di selezione <guilabel
>Carica gli ultimi file aperti</guilabel
> può essere contrassegnata in modo che &kid3; si aprirà e selezionerà l'ultimo file selezionato al successivo avvio. <guilabel
>Mantieni data/ora del file</guilabel
> può essere marcata per conservare la marca temporale di modifica del file. <guilabel
>Nome file per copertina</guilabel
> imposta il nome suggerito quando un'immagine incorporata viene esportata in un file. Con <guilabel
>Codifica del testo (esportazione, scaletta)</guilabel
> è possibile impostare la codifica utilizzata durante la scrittura dei file. Il <guilabel
>Sistema</guilabel
> predefinito può essere modificato, ad esempio, se le scalette devono essere utilizzate su un dispositivo diverso. </para>
<para
>Se <guilabel
>Marca le modifiche</guilabel
> è attiva, i campi modificati sono marcati con uno sfondo grigio chiaro. </para>
<para
>La sezione <guilabel
>Elenco file</guilabel
> determina quali file vengono visualizzati nell'elenco dei file. Un <guilabel
>Filtro</guilabel
> può essere utilizzato per limitare gli elementi in questo elenco ai file con estensioni supportate. Per specificare esplicitamente quali cartelle visualizzare nell'elenco dei file o escludere determinate cartelle, è possibile utilizzare le opzioni <guilabel
>Includi cartelle</guilabel
> e <guilabel
>Escludi cartelle</guilabel
>. Possono contenere espressioni con metacaratteri, ad esempio <filename
>*/Musica/*</filename
> per includere solo la cartella <filename
>Musica</filename
> o <filename
>*/iTunes/*</filename
> per escludere la cartella iTunes dall'elenco dei file. Se devono essere utilizzate più espressioni di questo tipo, possono essere separate da spazi o punti e virgola. </para>
<para
>I pulsanti <guibutton
>Nome file dal tag</guibutton
> e <guibutton
>Tag dal nome file</guibutton
> nella sezione <guilabel
>Formato</guilabel
> aprono le finestre per modificare i formati disponibili nelle caselle combinate <guilabel
>Formato</guilabel
> (con le frecce su e giù), che si trovano nella sezione <link linkend="file"
>File</link
> della finestra principale. </para>
<para
>Il pulsante <guibutton
>Scaletta</guibutton
> può essere utilizzato per modificare i formati dei nomi dei file disponibili nella finestra <link linkend="create-playlist"
>Crea scaletta</link
>. </para>
<para
><guilabel
>Formato nome file</guilabel
> contiene opzioni per il formato dei nomi dei file. Sono disponibili le stesse opzioni di <guilabel
>Formato tag</guilabel
>. </para>
<para
>Inoltre, è possibile impostare la <guilabel
>Lunghezza massima</guilabel
> consentita per i nomi dei file. La maggior parte dei file system moderni ha un limite di 255 caratteri, ma se vuoi masterizzare i file su CD, dovresti impostare il limite a 64. Se <guilabel
>Usa per i nomi di scalette e cartelle</guilabel
> è selezionata, il formato del nome del file viene utilizzato anche durante la creazione di scalette e la rinomina delle cartelle. </para>
<para
>La pagina <guilabel
>Azioni dell'utente</guilabel
> contiene una tabella con i comandi disponibili nel menu contestuale dell'elenco dei file. Per operazioni critiche come l'eliminazione di file, è consigliabile marcare <guilabel
>Conferma</guilabel
> per visualizzare una finestra di conferma prima di eseguire il comando. <guilabel
>Risultato</guilabel
> può essere contrassegnato per vedere il risultato scritto dei comandi della console (standard output e standard error). <guilabel
>Nome</guilabel
> è il nome visualizzato nel menu contestuale. <guilabel
>Comando</guilabel
> è la riga di comando da eseguire. Gli argomenti possono essere passati utilizzando i seguenti codici: </para>

<itemizedlist>
<listitem
><para
>%F %{files} Percorsi dei file (un elenco se sono selezionati più file)</para
></listitem>
<listitem
><para
>%f %{file} Percorso di un file singolo</para
></listitem>
<listitem
><para
>%uF %{urls} &URL; (un elenco se più file sono selezionati)</para
></listitem>
<listitem
><para
>%uf %{url} &URL; a un file singolo</para
></listitem>
<listitem
><para
>%d %{directory} Cartella</para
></listitem>
<listitem
><para
>%s %{title} Titolo (Brano)</para
></listitem>
<listitem
><para
>%a %{artist} Artista</para
></listitem>
<listitem
><para
>%l %{album} Album</para
></listitem>
<listitem
><para
>%c %{comment} Commento</para
></listitem>
<listitem
><para
>%y %{year} Anno</para
></listitem>
<listitem
><para
>%t %{track} Traccia (<abbrev
>ad es.</abbrev
> 01)</para
></listitem>
<listitem
><para
>%t %{track.n} Traccia con larghezza dei campi n (<abbrev
>ad es.</abbrev
> 001 per %{track.3})</para
></listitem>
<listitem
><para
>%T %{tracknumber} Traccia (senza zeri iniziali, <abbrev
>ad es.</abbrev
> 1)</para
></listitem>
<listitem
><para
>%g %{genre} Genere</para
></listitem>
<listitem
><para
>%b %{browser} Comando per avviare il browser web</para
></listitem>
<listitem
><para
>%q %{qmlpath} Cartella di base per i file QML forniti</para
></listitem>
</itemizedlist>

<para
>Il codice speciale <command
>@separator</command
> può essere impostato come comando per inserire un separatore nel menu contestuale delle azioni dell'utente. Le voci di menu possono essere inserite in un sottomenu racchiudendole con i comandi <command
>@beginmenu</command
> e <command
>@endmenu</command
>. Il nome del sottomenu è determinato dalla colonna <guilabel
>Nome</guilabel
> del comando <command
>@beginmenu</command
>. </para>

<para id="configure-user-actions-qml"
>Per eseguire gli script QML, <command
>@qml</command
> viene utilizzato come nome di comando. Il percorso dello script QML viene passato come parametro. Gli script forniti sono disponibili nella cartella <filename
>%{qmlpath}/script/</filename
> (su &Linux; in genere <filename
>/usr/share/kid3/qml/script/</filename
>, su Windows <filename
>qml/script/</filename
> all'interno della cartella di installazione e su &macOS; nella cartella dell'applicazione <filename
>kid3.app/Contents/Resources/qml/script/</filename
>). Gli script personalizzati possono essere archiviati in qualsiasi cartella. Se il codice QML utilizza componenti della &GUI;, <command
>@qmlview</command
> sarà utilizzato al posto di <command
>@qml</command
>. Ulteriori parametri vengono passati allo script QML dove saranno disponibili tramite la funzione <function
>getArguments()</function
>. Una panoramica di alcune funzioni e proprietà disponibili in QML è disponibile nell'appendice <link linkend="qml-interface"
>Interfaccia QML</link
>. </para>

<para
>Il comando che sarà inserito con %{browser} può essere definito nella riga <guilabel
>Browser web</guilabel
> sopra. I comandi che iniziano con %{browser} possono essere utilizzati per recuperare informazioni sui file audio dal web, ad esempio <screen width="40">
<userinput
>%{browser} http://lyricwiki.org/%u{artist}:%u{title}</userinput>
</screen
> interrogherà i testi del brano attuale in <ulink url="http://www.lyricwiki.org"
>LyricWiki</ulink
>. La «u» in %u{artist} e %u{title} viene utilizzata per la codifica come &URL; delle informazioni relative all'artista %{artist} e al brano %{title}. È facile definire le proprie query allo stesso modo, <abbrev
>ad es.</abbrev
> una ricerca di immagini con <ulink url="http://www.google.com"
>Google</ulink
>: <screen width="40"
><userinput
>%{browser} http://images.google.com/images?q=%u{artist}%20%u{album}</userinput
>
</screen>
</para>
<para
>Per aggiungere la copertina dell'album al tag 2, è possibile cercare immagini con Google o Amazon utilizzando i comandi descritti sopra. L'immagine può essere aggiunta al tag con il trascinamento della selezione. È possibile aggiungere un'immagine anche con <guibutton
>Aggiungi</guibutton
>, quindi selezionare il frame Immagine e importare un file di immagine o incollarlo dagli appunti. I frame sono supportati per i tag ID3v2, MP4, FLAC, Ogg e ASF. </para>
<para
>Per aggiungere ed eliminare voci nella tabella, può essere utilizzato un menu contestuale. </para>
<para
>La pagina <guilabel
>Rete</guilabel
> contiene solo un campo per inserire l'indirizzo proxy e facoltativamente la porta, separati da due punti. Il proxy sarà utilizzato durante l'importazione da un server Internet quando la casella di selezionate è marcata. </para>
<para
>Nella pagina <guilabel
>Estensioni</guilabel
>, le estensioni disponibili possono essere abilitate o disabilitate. Le estensioni sono divise in due sezioni. L'elenco <guilabel
>Estensioni metadati e priorità</guilabel
> contiene estensioni che supportano i formati di file audio. L'ordine delle estensioni è importante perché vengono provate dall'alto verso il basso. Alcuni formati sono supportati da più estensioni, quindi i file saranno aperti con la prima estensione che li supporta. <guilabel
>TaglibMetadata</guilabel
> supporta la maggior parte dei formati, se si trova in cima all'elenco, aprirà la maggior parte dei file. Se si desidera utilizzare un'estensione diversa per un formato di file, assicurarsi che sia elencata prima dell'estensione <guilabel
>TaglibMetadata</guilabel
>. I dettagli sull'estensione dei metadati e sul motivo per cui si potrebbe volerla utilizzare al posto di TagLib sono elencati di seguito. </para>
<itemizedlist>
<listitem
><para
><guilabel
>Id3libMetadata</guilabel
>: utilizza <ulink url="http://id3lib.sourceforge.net"
>id3lib</ulink
> per i tag ID3v1.1 e ID3v2.3 nei file MP3, MP2, AAC. Supporta alcuni tipi di frame in più rispetto a TagLib.</para
></listitem>
<listitem
><para
><guilabel
>OggFlacMetadata</guilabel
>: utilizza <ulink url="http://xiph.org/ogg/"
>libogg</ulink
>, <ulink url="http://xiph.org/vorbis/"
>libvorbis, libvorbisfile</ulink
> per i file Ogg e inoltre <ulink url="http://flac.sourceforge.net"
>libFLAC ++ e libFLAC</ulink
> per i file FLAC. Queste sono le librerie ufficiali per questi formati.</para
></listitem>
<listitem
><para
><guilabel
>TaglibMetadata</guilabel
>: utilizza <ulink url="http://taglib.github.io/"
>TagLib</ulink
> che supporta molti formati di file audio. Può essere usato per tutti i file audio supportati da &kid3;.</para
></listitem>
<listitem
><para
><guilabel
>Mp4v2Metadata</guilabel
>: <ulink url="https://mp4v2.org/"
>mp4v2</ulink
> è stato originariamente utilizzato da &kid3; per supportare i file M4A. Può essere utilizzato in caso di problemi con il supporto M4A di TagLib. </para
></listitem>
</itemizedlist>
<para
>La sezione <guilabel
>Estensioni disponibili</guilabel
> elenca le estensioni rimanenti. Il loro ordine non è importante, ma possono essere abilitate o disabilitate utilizzando le caselle di controllo. </para>
<itemizedlist>
<listitem
><para
><guilabel
>AmazonImport</guilabel
>: utilizzata per la funzione <guimenuitem
>Importa da Amazon...</guimenuitem
>. </para
></listitem>
<listitem
><para
><guilabel
>DiscogsImport</guilabel
>: utilizzata per la funzione <guimenuitem
>Importa da Discogs...</guimenuitem
>. </para
></listitem>
<listitem
><para
><guilabel
>FreedbImport</guilabel
>: utilizzata per la funzione <guimenuitem
>Importa da gnudb.org...</guimenuitem
>. </para
></listitem>
<listitem
><para
><guilabel
>MusicBrainzImport</guilabel
>: utilizzata per la funzione <guimenuitem
>Importa da MusicBrainz Release...</guimenuitem
>. </para
></listitem>
<listitem
><para
><guilabel
>AcoustidImport</guilabel
>: utilizzata per la funzione <guimenuitem
>Importa da MusicBrainz Fingerprint...</guimenuitem
>, che dipende dalle librerie <ulink url="http://acoustid.org/chromaprint"
>Chromaprint</ulink
> e <ulink url="http://libav.org/"
>libav</ulink
>. </para
></listitem>
</itemizedlist>
<para
>Le estensioni disabilitate non saranno caricate. Questo può essere utilizzato per ottimizzare l'utilizzo delle risorse e i tempi di avvio. Le impostazioni in questa pagina hanno effetto solo dopo il riavvio di &kid3;. </para>
</listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="help-menu">
<title
>Il menu Aiuto</title>
<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Aiuto</guimenu
> <guimenuitem
>Manuale di &kid3;</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apre questo manuale.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Aiuto</guimenu
> <guimenuitem
>Informazioni su &kid3;</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visualizza brevi informazioni su &kid3;. </action
></para
></listitem>
</varlistentry>


</variablelist>
</para>

</sect1>

</chapter>

<chapter id="kid3-cli">
<title
>kid3-cli</title>
<sect1 id="kid3-cli-commands">
<title
>Comandi</title>
<para
><command
>kid3-cli</command
> offre un'interfaccia a riga di comando per &kid3;. Se si utilizza il percorso di una cartella, la cartella viene aperta. Se si forniscono uno o più percorsi di file, sarà aperta la cartella comune e i file saranno selezionati. I comandi successivi funzioneranno quindi su questi file. I comandi sono specificati utilizzando le opzioni <option
>-c</option
>. Se vengono passati più comandi, saranno eseguiti nell'ordine indicato. Se i file vengono modificati dai comandi, saranno salvati alla fine. Se non vengono passate opzioni di comando, <command
>kid3-cli</command
> si avvia in modalità interattiva. I comandi possono essere inseriti e opereranno sulla selezione attuale. Le seguenti sezioni elencano tutti i comandi disponibili. </para>

<sect2 id="cli-help">
<title
>Aiuto</title>
<cmdsynopsis
><command
>help</command
> <arg
><replaceable
>NOME-COMANDO</replaceable
></arg
> </cmdsynopsis>
<para
>Visualizza un guida relativa ai parametri di <replaceable
>NOME-COMANDO</replaceable
> o su tutti i comandi, se nessun nome comando è specificato. </para>
</sect2>

<sect2 id="cli-timeout">
<title
>Tempo massimo</title>
<cmdsynopsis
><command
>timeout</command
> <group
> <arg choice="plain"
>default</arg
> <arg choice="plain"
>off</arg
> <arg choice="plain"
><replaceable
>TEMPO</replaceable
></arg
> </group
> </cmdsynopsis>
<para
>Sovrascrivere il tempo massimo del comando predefinito. I comandi CLI si interrompono dopo che è scaduto un tempo massimo specifico del comando. Questo tempo massimo è di 10 secondi per <command
>ls</command
> e <command
>albumart</command
>, 60 secondi per <command
>autoimport</command
> e <command
>filter</command
> e 3 secondi per tutti gli altri comandi. Se è necessario elaborare un numero enorme di file, questi tempi potrebbero essere troppo restrittivi, pertanto il tempo massimo per tutti i comandi può essere impostato su <replaceable
>TIME</replaceable
> ms, disattivato del tutto o lasciato ai valori predefiniti. </para>
</sect2>

<sect2 id="cli-exit">
<title
>Chiudere l'applicazione</title>
<cmdsynopsis
><command
>exit</command
> <arg
>force</arg
> </cmdsynopsis>
<para
>Chiudere l'applicazione. Se ci sono file modificati e non salvati, è richiesto il parametro <parameter class="command"
>force</parameter
>. </para>
</sect2>

<sect2 id="cli-cd">
<title
>Cambiare cartella</title>
<cmdsynopsis
><command
>cd</command
> <arg
><replaceable
>CARTELLA</replaceable
></arg
> </cmdsynopsis>
<para
>Se non viene specificato <replaceable
>FOLDER</replaceable
>, passare alla cartella principale. Se viene fornita una cartella, passare alla cartella. Se vengono forniti uno o più percorsi di file, passare alla loro cartella comune e selezionare i file. </para>
</sect2>

<sect2 id="cli-pwd">
<title
>Stampare il nome della cartella attuale</title>
<cmdsynopsis>
<command
>pwd</command>
</cmdsynopsis>
<para
>Stampa il nome della cartella di lavoro attuale.</para>
</sect2>

<sect2 id="cli-ls">
<title
>Elenco delle cartelle</title>
<cmdsynopsis>
<command
>ls</command>
</cmdsynopsis>
<para
>Elenca il contenuto della cartella attuale. Questo corrisponde all'elenco dei file nella &GUI; di &kid3;. Cinque caratteri prima dei nomi dei file mostrano lo stato del file. </para>

<itemizedlist>
<listitem
><para
><computeroutput
>&gt;</computeroutput
> Il file è selezionato. </para
></listitem>
<listitem
><para
><computeroutput
>*</computeroutput
> Il file è modificato. </para
></listitem>
<listitem
><para
><computeroutput
>1</computeroutput
> Il file ha un tag 1, altrimenti '<computeroutput
>-</computeroutput
>' è visualizzato.</para
></listitem>
<listitem
><para
><computeroutput
>2</computeroutput
> Il file ha un tag 2, altrimenti '<computeroutput
>-</computeroutput
>' è visualizzato.</para
></listitem>
<listitem
><para
><computeroutput
>3</computeroutput
> Il file ha un tag 3, altrimenti '<computeroutput
>-</computeroutput
>' è visualizzato.</para
></listitem>
</itemizedlist>

<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>
  1-- 01 Intro.mp3

> 12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3</computeroutput
></screen>

<para
>In questo esempio, tutti i file hanno un tag 1, il secondo file ha anche un tag 2 ed è selezionato. Il terzo file è modificato. </para>
</sect2>

<sect2 id="cli-save">
<title
>Salvare i file modificati</title>
<cmdsynopsis>
<command
>save</command>
</cmdsynopsis>
 
</sect2>

<sect2 id="cli-select">
<title
>Selezionare i file</title>
<cmdsynopsis
><command
>select</command
> <group
> <arg choice="plain"
>all</arg
> <arg choice="plain"
>none</arg
> <arg choice="plain"
>first</arg
> <arg choice="plain"
>previous</arg
> <arg choice="plain"
>next</arg
> <arg choice="plain" rep="repeat"
><replaceable
>FILE</replaceable
></arg
> </group
> </cmdsynopsis>
<para
>Per selezionare tutti i file, digitare <userinput
>select all</userinput
>, per deselezionare tutti i file, digitare <userinput
>select none</userinput
>. Per attraversare i file nella cartella attuale iniziare con <userinput
>select first</userinput
>, quindi andare avanti utilizzando <userinput
>select next</userinput
> o indietro utilizzando <userinput
>select previous</userinput
>. È possibile aggiungere file specifici alla selezione attuale assegnando i nomi ai file. I metacaratteri sono possibili, quindi <userinput
>select *.mp3 </userinput
> selezionerà tutti i file MP3 nella cartella attuale. </para>

<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>select first</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>

> 1-- 01 Intro.mp3
  12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>select next</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>
  1-- 01 Intro.mp3

> 12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>select *.mp3</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>

> 1-- 01 Intro.mp3

> 12- 02 We Only Got This One.mp3

>*1-- 03 Outro.mp3</computeroutput
></screen>
</sect2>

<sect2 id="cli-tag">
<title
>Selezionare i tag</title>
<cmdsynopsis
><command
>tag</command
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Molti comandi hanno un parametro <replaceable
>TAG-NUMBERS</replaceable
> facoltativo, che specifica se il comando opera sui tag 1, 2 o 3. Se questo parametro viene omesso, vengono utilizzati i numeri dei tag predefiniti, che possono essere impostati da questo comando. All'avvio, è impostato su <literal
>12</literal
>, il che significa che le informazioni vengono lette dal tag 2 se disponibili, altrimenti dal tag 1; le modifiche sono apportate al tag 2. <option
><replaceable
>TAG-NUMBERS</replaceable
></option
> può essere impostato su <userinput
>1</userinput
>, <userinput
>2</userinput
> o <userinput
>3</userinput
> per operare solo sul tag corrispondente. Se il parametro viene omesso, viene visualizzata l'impostazione attuale. </para>
</sect2>

<sect2 id="cli-get">
<title
>Ottenere il frame del tag</title>
<cmdsynopsis
><command
>get</command
> <group
> <arg choice="plain"
>all</arg
> <arg choice="plain"
><replaceable
>NOME-FRAME</replaceable
></arg
> </group
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Questo comando può essere utilizzato per leggere il valore del frame di un tag specifico o ottenere informazioni su tutti i frame di tag (se l'argomento viene omesso o viene utilizzato <option
>all</option
>). I frame modificati sono marcati con un '<computeroutput
>*</computeroutput
>'. </para>

<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>get</userinput
><computeroutput>
File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
  Name: 01 Intro.mp3
Tag 1: ID3v1.1
  Title         Intro
  Artist        One Hit Wonder
  Album         Let's Tag
  Date          2013
  Track Number  1
  Genre         Pop</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>get title</userinput
><computeroutput>
Intro</computeroutput
></screen>
<para
>Per salvare il contenuto del frame di un'immagine in un file, utilizzare <screen width="65"
><userinput
>get picture:'/percorso/a/folder.jpg'</userinput
></screen>
</para>
<para
>Per salvare i testi sincronizzati in un file LRC, utilizzare <screen width="65"
><userinput
>get SYLT:'/percorso/a/testo.lrc'</userinput
></screen>
</para>
<para
>È possibile ottenere solo un campo specifico da un frame, ad esempio <userinput
>get POPM.Email</userinput
> per il campo Email di un frame Popularimeter. Se un file ha più frame dello stesso tipo, i diversi frame possono essere indicizzati con parentesi, ad esempio il primo interprete da un commento di Vorbis può essere recuperato utilizzando <userinput
>get performer [0]</userinput
>, il secondo utilizzando <userinput
>get performer [1]</userinput
>. </para>
<para
>Il nome dello pseudo-campo «selected» può essere utilizzato per verificare se è selezionata un frame, ad esempio <userinput
>get artist.selected</userinput
> restituirà <computeroutput
>1</computeroutput
> se è selezionato il frame dell'artista, altrimenti <computeroutput
>0</computeroutput
>. </para>
<para
>Il nome dello pseudo-frame «ratingstars» può essere utilizzato per ottenere il valore del frame «rating» come valore specifico del formato corrispondente al numero di stelle (da 0 a 5). Quando si utilizza «rating», viene restituito il valore interno. </para>
</sect2>

<sect2 id="cli-set">
<title
>Impostare il frame del tag</title>
<cmdsynopsis
><command
>set</command
> <arg choice="req"
><replaceable
>NOME-FRAME</replaceable
></arg
> <arg choice="req"
><replaceable
>VALORE-FRAME</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Questo comando imposta il valore del frame di un tag specifico. Se <replaceable
>FRAME-VALUE</replaceable
> è vuoto, il frame viene eliminato. </para>
<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>set remixer 'O.H. Wonder'</userinput
></screen>
<para
>Per impostare il contenuto di un frame da un file, utilizzare <screen width="65"
><userinput
>set picture:'/percorso/a/folder.jpg' 'Descrizione immagine'</userinput
></screen>
</para>
<para
>Per impostare i testi sincronizzati da un file LRC, utilizzare <screen width="65"
><userinput
>set SYLT:'/percorso/a/testo.lrc' 'Descrizione del testo'</userinput
></screen>
</para>
<para
>Per impostare un campo specifico di un frame, il nome del campo può essere dato dopo un punto, <abbrev
>ad es.</abbrev
> per impostare il campo Contatore di un frame Popularimeter, utilizzare <screen width="65"
><userinput
>set POPM.Counter 5</userinput
></screen>
</para>
<para
>Un'applicazione per le specifiche del campo è il caso in cui si desidera un frame TXXX personalizzato con descrizione «rating» anziché un frame Popularimeter standard (questo sembra essere utilizzato da alcune estensioni). È possibile creare un frame di classificazione TXXX con <command
>kid3-cli</command
>, tuttavia è necessario prima creare un frame TXXX con la descrizione «rating» e quindi impostare il valore di questo frame sul valore di rating. <screen width="65">
<prompt
>kid3-cli&gt; </prompt
><userinput
>set rating ""</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>set TXXX.Description rating</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>set rating 5</userinput>
</screen
> Il primo comando eliminerà un frame POPM esistente, perché se esiste un frame del genere, <userinput
>set rating 5</userinput
> imposterà il frame POPM e non il frame TXXX. Un'altra possibilità sarebbe quella di utilizzare <userinput
>set TXXX.Text 5</userinput
>, ma funzionerebbe solo se non fosse presente nessun altro frame TXXX. </para>
<para
>Per impostare più frame dello stesso tipo, è possibile indicare un indice tra parentesi, <abbrev
>ad es.</abbrev
> per impostare più performer in un commento di Vorbis, utilizzare <screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>set performer[0] 'Liza don Getti (soprano)'</userinput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>set performer[1] 'Joe Barr (piano)'</userinput
>
</screen>
</para>
<para
>Per selezionare determinati frame prima di copiare, incollare o rimuovere un'azione, è possibile utilizzare il nome dello pseudo-campo «selected». Normalmente, tutti i frame sono selezionati, per deselezionare tutto, utilizzare <userinput
>set '*.selected' 0</userinput
>, quindi ad esempio <userinput
>set artist.selected 1</userinput
> per selezionare il frame dell'artista. </para>
<para
>Il nome dello pseudo-frame «ratingstars» può essere utilizzato per impostare il valore del frame «rating» sul valore specifico del formato corrispondente al numero di stelle (da 0 a 5). Il nome del frame «rating» può essere utilizzato per impostare il valore interno. </para>
<para
>L'impostazione di «ratingstars» su più file con formati di tag diversi non funzionerà perché il frame con il valore mappato dal conteggio delle stelle viene creato per il primo file e poi utilizzato per tutti i file. Quindi invece di <userinput
>kid3-cli -c "set ratingstars 2" *</userinput
> dovresti piuttosto usare <userinput
>for f in *; do kid3-cli -c "set ratingstars 2" "$f"; done</userinput
>. </para>
</sect2>

<sect2 id="cli-revert">
<title
>Ripristinare</title>
<cmdsynopsis>
<command
>revert</command>
</cmdsynopsis>
<para
>Annullare tutte le modifiche nei file selezionati (o tutti i file se non è selezionato alcun file). </para>
</sect2>

<sect2 id="cli-import">
<title
>Importare da file</title>
<cmdsynopsis
><command
>import</command
> <arg choice="req"
><replaceable
>FILE</replaceable
></arg
> <arg choice="req"
><replaceable
>NOME-FORMATO</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>I tag sono importati dal file <replaceable
>FILE</replaceable
> nel formato con il nome <replaceable
>FORMAT-NAME</replaceable
> (<abbrev
>ad es.</abbrev
> <userinput
>«CSV non quotato»</userinput
> , vedere <link linkend="import-text"
>Importa</link
>). </para>
<para
>Se <userinput
>tags</userinput
> viene fornito per <replaceable
>FILE</replaceable
>, i tag sono importati da altri tag. Invece di <replaceable
>FORMAT-NAME</replaceable
> sono richiesti i parametri <replaceable
>SOURCE</replaceable
> e <replaceable
>EXTRACTION</replaceable
>, vedere <link linkend="import-tags"
>Importa da tag</link 
>. Per applicare l'importazione dai tag sui file selezionati, utilizzare <userinput
>tagsel</userinput
> invece di <userinput
>tag</userinput
>. Questa funzione supporta anche il risultato del valore estratto utilizzando un <replaceable
>EXTRACTION</replaceable
> con il valore <userinput
>%{__return}(.+)</userinput
>. </para>
</sect2>

<sect2 id="cli-autoimport">
<title
>Importazione automatica</title>
<cmdsynopsis
><command
>autoimport</command
> <arg
><replaceable
>NOME-PROFILO</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Importazione in serie utilizzando il profilo <replaceable
>PROFILE-NAME</replaceable
> (vedere <link linkend="batch-import"
>Importazione automatica</link
>, <userinput
>"All"</userinput
> viene utilizzato se omesso). </para>
</sect2>

<sect2 id="cli-albumart">
<title
>Scaricare le copertine</title>
<cmdsynopsis
><command
>albumart</command
> <arg choice="req"
><replaceable
>URL</replaceable
></arg
> <arg
>all</arg
> </cmdsynopsis>
<para
>Impostare la copertina dell'album scaricando un'immagine da <replaceable
>URL</replaceable
>. Le regole definite nella finestra <link linkend="browse_pictures"
>Sfoglia copertina</link
> sono utilizzate per trasformare gli &URL; generici (<abbrev
>ad es.</abbrev
> da Amazon) in un &URL; di un'immagine. Per impostare la copertina dell'album da un file di immagine locale, utilizzare il comando <link linkend="cli-set"
>set</link
>. </para>
<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>albumart
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC</userinput
></screen>
</sect2>

<sect2 id="cli-export">
<title
>Esporta su file</title>
<cmdsynopsis
><command
>export</command
> <arg choice="req"
><replaceable
>FILE</replaceable
></arg
> <arg choice="req"
><replaceable
>NOME-FORMATO</replaceable
></arg
> <arg
><replaceable
>NUMERI -TAG</replaceable
></arg
> </cmdsynopsis>
<para
>I tag sono esportati nel file <replaceable
>FILE</replaceable
> nel formato con il nome <replaceable
>FORMAT-NAME</replaceable
> (<abbrev
>ad es.</abbrev
> <userinput
>«CSV non quotato»</userinput 
>, vedere <link linkend="export"
>Esportazione</link
>). </para>
</sect2>

<sect2 id="cli-playlist">
<title
>Creare una scaletta</title>
<cmdsynopsis>
<command
>playlist</command>
</cmdsynopsis>
<para
>Creare una scaletta nel formato impostato nella configurazione, vedere <link linkend="create-playlist"
>Creare una scaletta</link
>. </para>
</sect2>

<sect2 id="cli-filenameformat">
<title
>Applicare il formato al nome file</title>
<cmdsynopsis>
<command
>filenameformat</command>
</cmdsynopsis>
<para
>Applicare il formato al nome file impostato nella configurazione, vedere <link linkend="apply-filename-format"
>Applicare il formato al nome file</link
>. </para>
</sect2>

<sect2 id="cli-tagformat">
<title
>Applicare il formato al tag</title>
<cmdsynopsis>
<command
>tagformat</command>
</cmdsynopsis>
<para
>Applicare il formato del nome del tag impostato nella configurazione, vedere <link linkend="apply-tag-format"
>Applica il formato al tag</link
>. </para>
</sect2>

<sect2 id="cli-textencoding">
<title
>Applicare la codifica del testo</title>
<cmdsynopsis>
<command
>textencoding</command>
</cmdsynopsis>
<para
>Applicare la codifica del testo impostata nella configurazione, vedere <link linkend="apply-text-encoding"
>Applicare la codifica del testo</link
>. </para>
</sect2>

<sect2 id="cli-renamedir">
<title
>Rinominare una cartella</title>
<cmdsynopsis
><command
>renamedir</command
> <arg
><replaceable
>FORMATO</replaceable
></arg
> <group
> <arg choice="plain"
>create</arg
> <arg choice="plain"
>rename</arg
> <arg choice="plain"
>dryrun</arg
> </group
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Rinominare o creare cartelle dai valori nei tag in base a un determinato <replaceable
>FORMAT</replaceable
> (<abbrev
>ad es.</abbrev
> <userinput
>%{artist} - %{album}</userinput
>, vedere <link linkend="rename-directory"
>Rinomina cartella</link
>), se non viene fornito alcun formato, viene utilizzato il formato definito nella finestra <guilabel
>Rinomina cartella</guilabel
>. La modalità predefinita è <option
>rename</option
>; per creare cartelle, <option
>create</option
> deve essere esplicitamente indicata. Le azioni di rinomina saranno eseguite immediatamente, per verificare ciò che dovrebbe avvenire, utilizzare l'opzione <option
>dryrun</option
>. </para>
</sect2>

<sect2 id="cli-numbertracks">
<title
>Numera le tracce</title>
<cmdsynopsis
><command
>numbertracks</command
> <arg
><replaceable
>NUMERO-TRACCIA</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Numerare le tracce selezionate che iniziano con <replaceable
>TRACK-NUMBER</replaceable
> (<literal
>1</literal
> se omesso). </para>
</sect2>

<sect2 id="cli-filter">
<title
>Filtro</title>
<cmdsynopsis
><command
>filter</command
> <group
> <arg choice="plain"
><replaceable
>NOME-FILTRO</replaceable
></arg
> <arg choice="plain"
><replaceable
>FORMATO FILTRO</replaceable
></arg
> </group
> </cmdsynopsis>
<para
>Filtrare i file in modo che siano visibili solo i file corrispondenti a <replaceable
>FILTER-FORMAT</replaceable
>. È possibile utilizzare il nome di un'espressione di filtro predefinita (<abbrev
>ad es.</abbrev
> <userinput
>«Mancata corrispondenza tra nome file e tag»</userinput
>) anziché un'espressione di filtro, vedere <link linkend="filter"
>Filtro</link
>. </para>

<screen width="65"
><prompt
>kid3-cli&gt; </prompt
><userinput
>filter '%{title} contains "tro"'</userinput
><computeroutput>
Started
  /home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
- 02 We Only Got This One.mp3
+ 03 Outro.mp3
Finished</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>
  1-- 01 Intro.mp3
  1-- 03 Outro.mp3</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>filter All</userinput
><computeroutput>
Started
  /home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
+ 02 We Only Got This One.mp3
+ 03 Outro.mp3
Finished</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>ls</userinput
><computeroutput>
  1-- 01 Intro.mp3
  12- 02 We Only Got This One.mp3
  1-- 03 Outro.mp3</computeroutput
></screen>
</sect2>

<sect2 id="cli-to24">
<title
>Convertire ID3v2.3 in ID3v2.4</title>
<cmdsynopsis>
<command
>to24</command>
</cmdsynopsis>
</sect2>

<sect2 id="cli-to23">
<title
>Convertire ID3v2.4 in ID3v2.3</title>
<cmdsynopsis>
<command
>to23</command>
</cmdsynopsis>
</sect2>

<sect2 id="cli-fromtag">
<title
>Nome file da tag</title>
<cmdsynopsis
><command
>fromtag</command
> <arg
><replaceable
>FORMATO</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Impostare i nomi dei file selezionati dai valori nei tag, ad esempio <userinput
>fromtag '%{track} - %{title}' 1</userinput
>. Se non si specifica alcun formato, è utilizzato invece il formato impostato nella &GUI;. </para>
</sect2>

<sect2 id="cli-totag">
<title
>Tag da nome file</title>
<cmdsynopsis
><command
>totag</command
> <arg
><replaceable
>FORMATO</replaceable
></arg
> <arg
><replaceable
>NUMERI-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Impostare i frame dei tag dai nomi dei file, ad esempio <userinput
>totag '%{albumartist} - %{album}/%{track}%{title}' 2</userinput
>. Se non si specificato alcun formato, è utilizzato il formato impostato nella &GUI;. Se il formato del nome file non corrisponde a questo modello, vengono provati altri formati comunemente utilizzati. </para>
</sect2>

<sect2 id="cli-syncto">
<title
>Tag in altro tag</title>
<cmdsynopsis
><command
>syncto</command
> <arg choice="req"
><replaceable
>NUMERO-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Copiare i frame dei tag da un tag all'altro tag, <abbrev
>ad es.</abbrev
> per impostare il tag ID3v2 dal tag ID3v1, utilizzare <userinput
>syncto 2</userinput
>. </para>
</sect2>

<sect2 id="cli-copy">
<title
>Copia</title>
<cmdsynopsis
><command
>copy</command
> <arg
><replaceable
>NUMERO-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Copiare i frame dei tag dei file selezionati nel buffer interno di copia. Essi possono essere impostati su un altro file utilizzando il comando <command
>paste</command
>. </para>
<para
>Per copiare solo un sottoinsieme dei frame, utilizzare lo pseudo-campo «selected» con il comando <command
>set</command
>. Ad esempio, per copiare solo il numero del disco e i frame del copyright, utilizzare <screen width="65"
><userinput
>set '*.selected' 0</userinput>
<userinput
>set discnumber.selected 1</userinput>
<userinput
>set copyright.selected 1</userinput>
<userinput
>copy</userinput
>
</screen>
</para>
</sect2>

<sect2 id="cli-paste">
<title
>Incolla</title>
<cmdsynopsis
><command
>paste</command
> <arg
><replaceable
>NUMERO-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Impostare i frame dei tag dal contenuto del buffer <command
>copy</command
> nei file selezionati. </para>
</sect2>

<sect2 id="cli-remove">
<title
>Rimuovi</title>
<cmdsynopsis
><command
>remove</command
> <arg
><replaceable
>NUMERO-TAG</replaceable
></arg
> </cmdsynopsis>
<para
>Rimuovere un tag. </para>
<para
>È possibile rimuovere solo un sottoinsieme dei frame selezionandoli come descritto nel comando <link linkend="cli-copy"
><command
>copy</command
></link
>. </para>
</sect2>

<sect2 id="cli-config">
<title
>Configura Kid3</title>
<cmdsynopsis
><command
>config</command
> <arg
><replaceable
>OPZIONE</replaceable
></arg
> <arg
><replaceable
>VALORE</replaceable
></arg
> </cmdsynopsis>
<para
>Interroga o imposta un'opzione di configurazione. </para>
<para
>L'<replaceable
>OPZIONE</replaceable
> è composta da un nome di gruppo e un nome della proprietà separato da un punto. Quando nessuna <replaceable
>OPZIONE</replaceable
> viene fornito, vengono visualizzati tutti i gruppi disponibili. Se viene fornito solo un nome di gruppo, vengono visualizzate tutte le proprietà disponibili del gruppo. Per un dato gruppo e proprietà, viene visualizzato il valore attualmente configurato. Per modificare l'impostazione, il nuovo valore può essere passato come secondo argomento. </para>
<para
>Se il valore di un'impostazione è un elenco, tutti gli elementi dell'elenco devono essere forniti come argomenti. Ciò significa che per aggiungere un elemento a un elenco esistente di elementi, tutti gli elementi esistenti devono essere passati seguiti dal nuovo elemento. In una situazione del genere, è più facile utilizzare la modalità JSON, dove l'elenco attuale può essere copiato con il nuovo elemento aggiunto. </para>
</sect2>

<sect2 id="cli-execute">
<title
>Esegui programma o script QML</title>
<cmdsynopsis
><command
>execute</command
> <arg choice="opt"
>@qml</arg
> <arg choice="req"
><replaceable
>FILE</replaceable
></arg
> <arg choice="opt"
><replaceable
>ARGOMENTI</replaceable
></arg
> </cmdsynopsis>
<para
>Esegui uno script QML o un eseguibile. </para>
<para
>Senza <option
>@qml</option
> un programma è eseguito con argomenti. Quando <option
>@qml</option
> viene fornito come primo argomento, i seguenti argomenti sono lo script QML e i suoi argomenti. Ad esempio, le etichette di una cartella possono essere esportate nel file <filename
>export.csv</filename
> con il comando seguente. </para>
<screen width="65"
><userinput
>kid3-cli -c "execute @qml
/usr/share/kid3/qml/script/ExportCsv.qml export.csv"
/percorso/cartella/</userinput
></screen>
<para
>Qui <option
>export.csv</option
> è l'argomento per lo script <filename
>ExportCsv.qml</filename
>, mentre <option
>/percorso/a/cartella/</option
> è l'argomento <option
><replaceable
>FILE</replaceable
></option
> per <command
>kid3-cli</command
>. </para>
</sect2>

</sect1>

<sect1 id="kid3-cli-examples">
<title
>Esempi</title>
<para
>Imposta il titolo contenente un apostrofo. I comandi passati a <command
>kid3-cli</command
> con <parameter
>-c</parameter
> devono essere tra virgolette se non consistono in una sola parola. Se un comando di questo tipo ha un argomento contenente spazi, anche quell'argomento deve essere citato. Nelle shell &UNIX; possono essere utilizzate virgolette singole o doppie, ma nel prompt dei comandi di Windows è importante che le virgolette esterne vengano eseguite utilizzando virgolette doppie e all'interno di queste virgolette vengano utilizzate virgolette singole. Se il testo all'interno delle virgolette singole contiene una virgoletta singola, è necessario eseguirne l'escape utilizzando un carattere di barra rovesciata, come mostrato nell'esempio seguente:</para>
<screen width="65"
><userinput
>kid3-cli -c "set title 'I\'ll be there for you'" percorso/a/cartella</userinput
></screen>

<para
>Impostare la copertina dell'album in tutti i file di una cartella utilizzando la funzione di importazione in serie:</para>
<screen width="65"
><userinput
>kid3-cli -c "autoimport 'Cover Art'" /percorso/a/cartella</userinput
></screen>

<para
>Rimuovere i frame dei commenti e applicare il formato dei tag in entrambi i tag di tutti i file MP3 di una cartella:</para>
<screen width="65"
><userinput
>kid3-cli -c "set comment '' 1" -c "set comment '' 2" \
-c "tagformat 1" -c "tagformat 2" /percorso/a/cartella/*.mp3</userinput
></screen>

<para
>Importare automaticamente tag 2, sincronizzare con tag 1, impostare i nomi dei file da tag 2 e alla fine creare una scaletta:</para>
<screen width="65"
><userinput
>kid3-cli -c autoimport -c "syncto 1" -c fromtag -c playlist \
  /percorso/a/cartella/*.mp3</userinput
></screen>

<para
>Per tutti i file con un tag ID3v2.4.0, convertire in ID3v2.3.0 e rimuovere il frame dell'arrangiatore:</para>
<screen width="65"
><userinput
>kid3-cli -c "filter 'ID3v2.4.0 Tag'" -c "select all" -c to23 \
  -c "set arranger ''" /percorso/a/cartella</userinput
></screen>

<para
>Questo script Python utilizza <command
>kid3-cli</command
> per generare frame iTunes Sound Check iTunNORM dalle informazioni di guadagno di riproduzione.</para>
<programlisting
><![CDATA[
#!/usr/bin/env python3
# Genera iTunes Sound Check dal guadagno di riproduzione.
import os, sys, subprocess

def rg2sc(dirpath):
  for root, dirs, files in os.walk(dirpath):
    for name in files:
      if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
        fn = os.path.join(root, name)
        rg = subprocess.check_output([
          'kid3-cli', '-c', 'get "replaygain_track_gain"',
           fn]).strip()
        if rg.endswith(b' dB'):
          rg = rg[:-3]
        try:
          rg = float(rg)
        except ValueError:
          print('Value %s of %s in not a float' % (rg, fn))
          continue
        sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
        subprocess.call([
          'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

if __name__ == '__main__':
  rg2sc(sys.argv[1])
]]>
</programlisting>
</sect1>

<sect1 id="kid3-cli-json">
<title
>Formato &JSON;</title>
<para
>Per facilitare l'analisi dei risultati da <command
>kid3-cli</command
>, è possibile ottenere l'output in formato &JSON;. Quando la richiesta è in formato &JSON;, la risposta sarà anche &JSON;. Un formato compatto della richiesta fornirà anche una rappresentazione compatta della risposta. Se la richiesta contiene un campo «id», si presume che sia una richiesta &JSON;-RPC e la risposta conterrà un campo «jsonrpc» e «id» della richiesta. Il formato della richiesta utilizza gli stessi comandi della CLI standard, il campo «method» contiene il comando e i parametri (se presenti) sono indicati nell'elenco «params». La risposta contiene un oggetto «result», che può anche essere nullo se il comando <command
>kid3-cli</command
> non restituisce un risultato. In caso di errore, viene restituito un oggetto «error» con i campi «code» e «message» come usato in &JSON;-RPC. <screen width="80"
><prompt
>kid3-cli&gt; </prompt
><userinput
>{"method":"set","params":["artist","Un artista"]}</userinput>
<computeroutput
>{"result":null}</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>{"method":"get","params":["artist",2]}</userinput>
<computeroutput
>{"result":"An Artist"}</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>{"method": "get", "params": ["artist"]}</userinput>
<computeroutput
>{
    "result": "Un artista"
}
</computeroutput>
<prompt
>kid3-cli&gt; </prompt
><userinput
>{"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]}</userinput>
<computeroutput
>{"id":"123","jsonrpc":"2.0","result":"Un artista"}</computeroutput
>
</screen>

</para>
</sect1>

</chapter>

<chapter id="credits">

<title
>Riconoscimenti e licenza</title>

<para
>&kid3; </para>
<para
>Programma scritto da Urs Fleisch <email
>ufleisch@users.sourceforge.net</email
> </para>

<para
>Traduzione: Vincenzo Reale <email
>smart2128vr@gmail.com</email
></para
> &underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>

<sect1 id="getting-kid3">
<title
>Come ottenere &kid3;</title>

<para
>&kid3; è disponibile su <ulink url="https://kid3.kde.org"
>https://kid3.kde.org</ulink
>. </para>
</sect1>

<sect1 id="requirements">
<title
>Requisiti</title>

<para
>&kid3; necessita di <ulink url="https://www.qt.io"
>&Qt;</ulink
>. <ulink url="http://www.kde.org"
>&kde;</ulink
> è consigliato, ma non necessario, poiché &kid3; può anche essere compilato come applicazione &Qt;. &kid3; può essere compilato per sistemi in cui sono disponibili queste librerie, <abbrev
>ad es.</abbrev
> per GNU/&Linux;, &Windows; e &macOS;. Per applicare tag ai file Ogg/Vorbis, <ulink url="http://xiph.org/ogg/"
>libogg</ulink
>, <ulink url="http://xiph.org/vorbis/"
>libvorbis e libvorbisfile</ulink
> sono necessarie, per i file FLAC <ulink url="http://flac.sourceforge.net"
>libFLAC ++ e libFLAC</ulink
>. <ulink url="http://id3lib.sourceforge.net"
>id3lib</ulink
> è utilizzata per i file MP3. Questi quattro formati sono supportati anche da <ulink url="http://taglib.github.io/"
>TagLib</ulink
>, che può gestire anche Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, file AIFF e moduli tracker. Per importare da impronte digitali acustiche, sono utilizzate <ulink url="http://acoustid.org/chromaprint"
>Chromaprint</ulink
> e <ulink url="http://libav.org/"
>libav</ulink
> . </para>
<para
>&kid3; è disponibile per la maggior parte delle distribuzioni &Linux;, &Windows; e &macOS;. I collegamenti sono disponibili su <ulink url="https://kid3.kde.org"
> https://kid3.kde.org</ulink
>. </para>

</sect1>

<sect1 id="compilation">
<title
>Compilazione e installazione</title>

<para
>È possibile compilare &kid3; con o senza &kde;. Senza &kde;, &kid3; è una semplice applicazione &Qt; e manca di alcune funzionalità di configurazione e sessione. </para>
<para
>Per una versione di &kde;, spostarsi nella cartella principale e digitare <screen width="40"
><prompt
>%</prompt
> <userinput
>cmake .</userinput>
<prompt
>%</prompt
> <userinput
>make</userinput>
<prompt
>%</prompt
> <userinput
>make install</userinput
>
</screen>
</para>
<para
>Compilare per diverse versioni di &Qt; oppure &kde;, impostare le corrispondenti opzioni di <userinput
>cmake</userinput
>. </para>
<para
>Se non sono presenti tutte le librerie, &kid3; è compilato con funzionalità ridotta. Quindi è necessario aver cura di avere tutti i pacchetti di sviluppo desiderati installati. Dall'altro lato, le opzioni di <userinput
>cmake</userinput
> controllano quali librerie sono compilate. L'impostazione predefinita è <userinput
>-DWITH_TAGLIB:BOOL=ON -DWITH_MP4V2:BOOL=OFF -DWITH_ID3LIB:BOOL=ON -DWITH_CHROMAPRINT:BOOL=ON -DWITH_VORBIS:BOOL=ON -DWITH_FLAC:BOOL=ON</userinput
>. Queste opzioni possono essere disabilitate utilizzando <userinput
>OFF</userinput
>. </para>
<para
>Per compilare &kid3; come un'applicazione &Qt; senza &kde;, utilizzare l'opzione <userinput
>-DWITH_APPS=Qt</userinput
> di <userinput
>cmake</userinput
>. Per compilare sia un'applicazione &kde; che una &Qt;,impostare <userinput
>-DWITH_APPS="Qt;KDE"</userinput
>. </para>
<para
>Per utilizzare un'installazione specifica di &Qt;, impostare <userinput
>-DQT_QMAKE_EXECUTABLE=/percorso/a/qmake</userinput
>. </para>
<para
>La generazione di pacchetti RPM è supportata dal file <filename
>kid3.spec</filename
>, per i pacchetti &Debian;, eseguire <filename
>build.sh deb</filename
>. </para>

<para
>L'applicazione &Qt; può essere compilata anche per &Windows; e &macOS;. Lo script <filename
>build.sh</filename
> può essere utilizzato per scaricare e compilare tutte le librerie necessarie e crea un pacchetto di &kid3;. </para>

</sect1>

<sect1 id="configuration">
<title
>Configurazione</title>

<para
>Con &kde;, le impostazioni sono archiviate in <filename
>.config/kid3rc</filename
>, lo stato dell'applicazione in <filename
>.local/share/kid3/kid3staterc</filename
>. Come applicazione &Qt;, questo file è in <filename
>.config/Kid3/Kid3.conf</filename
>. Su &Windows;. la configurazione è archiviata nel registro, su &macOS; in un file plist. </para>
<para
>La variabile di ambiente <varname
>KID3_CONFIG_FILE</varname
> può essere utilizzata per impostare il percorso del file di configurazione.</para>

</sect1>

</appendix>

<appendix id="dbus-interface">
<title
>Interfaccia &DBus;</title>

<sect1 id="dbus-examples">
<title
>Esempi di &DBus;</title>

<para
>Su &Linux;. un'interfaccia &DBus; può essere utilizzata per controllare &kid3; tramite script. Gli script possono essere scritti in qualsiasi linguaggio con associazioni &DBus; (<abbrev
>ad es.</abbrev
> in Python) e possono essere aggiunti alle <guilabel
>Azioni dell'utente</guilabel
> per estendere le funzionalità di &kid3;. </para>

<para
>L'artista nel tag 2 del file attuale può essere impostato sul valore «One Hit Wonder» con il seguente codice: </para>

<variablelist>
<varlistentry
><term
>Shell</term>
<listitem>
<programlisting
>dbus-send --dest=org.kde.kid3 --print-reply=literal \
/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
string:'One Hit Wonder'
</programlisting>
<para
>o più semplicemente con <command
>qdbus</command
> di &Qt; (<command
>qdbusviewer</command
> può essere utilizzato per esplorare l'interfaccia in una &GUI;): </para>
<programlisting
>qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \
'One Hit Wonder'
</programlisting>
</listitem>
</varlistentry>
<varlistentry
><term
>Python</term>
<listitem>
<programlisting
>import dbus
kid3 = dbus.SessionBus().get_object(
  'org.kde.kid3', '/Kid3')
kid3.setFrame(2, 'Artist', 'One Hit Wonder')
</programlisting>
</listitem>
</varlistentry>
<varlistentry
><term
>Perl</term>
<listitem>
<programlisting
>use Net::DBus;
$kid3 = Net::DBus->session->get_service(
  "org.kde.kid3")->get_object(
  "/Kid3", "org.kde.Kid3");
$kid3->setFrame(2, "Artist", "One Hit Wonder");
</programlisting>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="dbus-api">
<title
>API &DBus;</title>

<para
>Le API &DBus; è specificata in <filename
>org.kde.Kid3.xml</filename
>. L'interfaccia di &kid3; ha i seguenti metodi: </para>

<sect2 id="dbus-openDirectory">
<title
>Aprire un file o una cartella</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>openDirectory</function
></funcdef
> <paramdef
>string <parameter
>percorso</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>percorso</replaceable
></term>
    <listitem
><para
>percorso a un file o a una cartella</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-unloadAllTags">
<title
>Scaricare i tag di tutti i file che non sono stati modificati o selezionati</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>unloadAllTags</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-save">
<title
>Salvare tutti i file modificati</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>save</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-getErrorMessage">
<title
>Ricevere un messaggio di errore dettagliato fornito da alcuni metodi</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>string <function
>getErrorMessage</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce il messaggio di errore dettagliato.</para>
</sect2>

<sect2 id="dbus-revert">
<title
>Ripristina le modifiche nei file selezionati</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>revert</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-batchImport">
<title
>Avvia un'importazione in serie automatica</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>batchImport</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>NomeProfilo</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>maschera del tag (bit 0 per tag 1, bit 1 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>profileName</replaceable
></term>
    <listitem
><para
>nome del profilo di importazione in serie da utilizzare</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-importFromFile">
<title
>Importare i tag da un file</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>importFromFile</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>percorso</parameter
></paramdef
> <paramdef
>int32 <parameter
>fmtIdx</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>percorso</replaceable
></term>
    <listitem
><para
>percorso del file</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>fmtIdx</replaceable
></term>
    <listitem
><para
>Indice di formato</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-importFromTags">
<title
>Importare i tag da altri tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>importFromTags</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>origine</parameter
></paramdef
> <paramdef
>string <parameter
>estrazione</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>origine</replaceable
></term>
    <listitem
><para
>formato per ottenere il testo originale dai tag</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>estrazione</replaceable
></term>
    <listitem
><para
>espressione regolare con i nomi dei frame e le catture per estrarre il testo originale</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-importFromTagsToSelection">
<title
>Importare i tag da altri tag sui file selezionati</title>
<funcsynopsis>
<funcprototype
><funcdef
>array <function
>importFromTagsToSelection</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>origine</parameter
></paramdef
> <paramdef
>string <parameter
>estrazione</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>origine</replaceable
></term>
    <listitem
><para
>formato per ottenere il testo originale dai tag</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>estrazione</replaceable
></term>
    <listitem
><para
>espressione regolare con i nomi dei frame e le catture per estrarre il testo originale</para
></listitem>
  </varlistentry>
</variablelist>
<variablelist>
  <varlistentry>
    <term
><replaceable
>returnValues</replaceable
></term>
    <listitem
><para
>valore estratto per «%{__return}(.+)»</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-downloadAlbumArt">
<title
>Scaricare la copertina dell'album</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>downloadAlbumArt</function
></funcdef
> <paramdef
>string <parameter
>url</parameter
></paramdef
> <paramdef
>boolean <parameter
>allFilesInDir</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>url</replaceable
></term>
    <listitem
><para
>&URL; di un'immagine o di una copertina</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>allFilesInDir</replaceable
></term>
    <listitem
><para
>vero per aggiungere l'immagine a tutti i file nella cartella</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-exportToFile">
<title
>Esportare tag in un file</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>exportToFile</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>percorso</parameter
></paramdef
> <paramdef
>int32 <parameter
>fmtIdx</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>percorso</replaceable
></term>
    <listitem
><para
>percorso del file</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>fmtIdx</replaceable
></term>
    <listitem
><para
>Indice di formato</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-createPlaylist">
<title
>Creare una scaletta</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>createPlaylist</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-getPlaylistItems">
<title
>Ottenere gli elementi di una scaletta</title>
<funcsynopsis>
<funcprototype
><funcdef
>array <function
>getPlaylistItems</function
></funcdef
> <paramdef
>string <parameter
>percorso</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>percorso</replaceable
></term>
    <listitem
><para
>percorso al file della scaletta</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce un elenco di percorsi assoluti agli elementi della scaletta.</para>
</sect2>

<sect2 id="dbus-setPlaylistItems">
<title
>Impostare gli elementi di una scaletta</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>setPlaylistItems</function
></funcdef
> <paramdef
>string <parameter
>percorso</parameter
></paramdef
> <paramdef
>array <parameter
>elementi</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>percorso</replaceable
></term>
    <listitem
><para
>percorso al file della scaletta</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>elementi</replaceable
></term>
    <listitem
><para
>elenco di percorsi assoluti agli elementi della scaletta</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce vero se OK, falso se non tutti gli elementi sono stati trovati e aggiunti o il salvataggio non è riuscito.</para>
</sect2>

<sect2 id="dbus-quit">
<title
>Uscire dall'applicazione</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>quit</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-selectAll">
<title
>Selezionare tutti i file</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>selectAll</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-deselectAll">
<title
>Deselezionare tutti i file</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>deselectAll</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-firstFile">
<title
>Impostare il primo file come file attuale</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>firstFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un primo file.</para>
</sect2>

<sect2 id="dbus-previousFile">
<title
>Impostare il file precedente come file attuale</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>previousFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un file precedente.</para>
</sect2>

<sect2 id="dbus-nextFile">
<title
>Impostare il file successivo come file attuale</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>nextFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un file successivo.</para>
</sect2>

<sect2 id="dbus-selectFirstFile">
<title
>Selezionare il primo file</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>selectFirstFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un primo file.</para>
</sect2>

<sect2 id="dbus-selectPreviousFile">
<title
>Selezionare il file precedente</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>selectPreviousFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un file precedente.</para>
</sect2>

<sect2 id="dbus-selectNextFile">
<title
>Selezionare il file successivo</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>selectNextFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un file successivo.</para>
</sect2>

<sect2 id="dbus-selectCurrentFile">
<title
>Selezionare il file attuale</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>selectCurrentFile</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se esiste un file attuale.</para>
</sect2>

<sect2 id="dbus-expandDirectory">
<title
>Espandere o contrarre l'elemento attuale se è una cartella</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>boolean <function
>expandDirectory</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Una voce dell'elenco dei file è una cartella se getFileName() restituisce un nome con «/» come ultimo carattere.</para>
<para
>Restituisce vero se l'elemento attuale è una cartella.</para>
</sect2>

<sect2 id="dbus-applyFilenameFormat">
<title
>Applicare il formato del nome del file</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>applyFilenameFormat</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-applyTagFormat">
<title
>Applicare il formato del tag</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>applyTagFormat</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-applyTextEncoding">
<title
>Applicare la codifica del testo</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>applyTextEncoding</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-setDirNameFromTag">
<title
>Impostare il nome della cartella dai tag</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>setDirNameFromTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>formato</parameter
></paramdef
> <paramdef
>boolean <parameter
>creare</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>maschera del tag (bit 0 per tag 1, bit 1 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>formato</replaceable
></term>
    <listitem
><para
>formato del nome della cartella</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>creare</replaceable
></term>
    <listitem
><para
>vero per creare, falso per rinominare</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce vero se OK, altrimenti il messaggio di errore è disponibile utilizzando getErrorMessage().</para>
</sect2>

<sect2 id="dbus-numberTracks">
<title
>Impostare i numeri di traccia successivi nei file selezionati</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>numberTracks</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>int32 <parameter
>firstTrackNr</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>maschera del tag (bit 0 per tag 1, bit 1 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>firstTrackNr</replaceable
></term>
    <listitem
><para
>numero da utilizzare per il primo file</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-filter">
<title
>Filtrare i file</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>filter</function
></funcdef
> <paramdef
>string <parameter
>espressione</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>espressione</replaceable
></term>
    <listitem
><para
>espressione di filtro</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-convertToId3v24">
<title
>Convertire i tag ID3v2.3 in ID3v2.4</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>convertToId3v24</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

<sect2 id="dbus-convertToId3v23">
<title
>Convertire i tag ID3v2.4 in ID3v2.3</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>convertToId3v23</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-getDirectoryName">
<title
>Ottenere il percorso della cartella</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>string <function
>getDirectoryName</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce il percorso assoluto a una cartella.</para>
</sect2>

<sect2 id="dbus-getFileName">
<title
>Ottenere il nome del file attuale</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>string <function
>getFileName</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Restituisce il vero nome file assoluto, termina con «/» se si tratta di una cartella.</para>
</sect2>

<sect2 id="dbus-setFileName">
<title
>Impostare il nome del file selezionato</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>setFileName</function
></funcdef
> <paramdef
>string <parameter
>nome</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>nome</replaceable
></term>
    <listitem
><para
>nome file</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Il file sarà rinominato al salvataggio della cartella.</para>
</sect2>

<sect2 id="dbus-setFileNameFormat">
<title
>Impostare il formato da utilizzare quando si imposta il nome file dai tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>setFileNameFormat</function
></funcdef
> <paramdef
>string <parameter
>formato</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>formato</replaceable
></term>
    <listitem
><para
>formato del nome file</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-setFileNameFromTag">
<title
>Impostare i nomi dei file selezionati dai tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>setFileNameFromTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-getFrame">
<title
>Ottenere il valore del frame</title>
<funcsynopsis>
<funcprototype
><funcdef
>string <function
>getFrame</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>nome</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>nome</replaceable
></term>
    <listitem
><para
>nome del frame (<abbrev
>ad es.</abbrev
> "artista")</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Per ottenere dati binari come un'immagine, il nome di un file da scrivere può essere aggiunto dopo il <parameter
>nome</parameter
>, <abbrev
>ad es.</abbrev
> «Picture:/percorso/a/file». Allo stesso modo, i testi sincronizzati possono essere esportati, <abbrev
>ad es.</abbrev
> «SYLT:/percorso/a/file». </para>
<para
>Restituisce il valore del frame.</para>
</sect2>

<sect2 id="dbus-setFrame">
<title
>Impostare il valore del frame</title>
<funcsynopsis>
<funcprototype
><funcdef
>boolean <function
>setFrame</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> <paramdef
>string <parameter
>nome</parameter
></paramdef
> <paramdef
>string <parameter
>valore</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>nome</replaceable
></term>
    <listitem
><para
>nome del frame (<abbrev
>ad es.</abbrev
> "artista")</para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><replaceable
>valore</replaceable
></term>
    <listitem
><para
>valore del frame</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Per il tag 2 (<parameter
>tagMask</parameter
> 2), se non esiste un frame con <parameter
>nome</parameter
>, viene aggiunto un nuovo frame, se il <parameter
>valore</parameter
> è vuoto, il frame è eliminato. Per aggiungere dati binari come un'immagine, è possibile aggiungere un file dopo il <parameter
>nome</parameter
>, <abbrev
>ad es.</abbrev
> «Picture:/percorso/a/file». «SYLT:/percorso/a/file» può essere usato per importare testi sincronizzati.</para>
<para
>Restituisce vero se OK.</para>
</sect2>

<sect2 id="dbus-getTag">
<title
>Ottenere tutti i frame da un tag</title>
<funcsynopsis>
<funcprototype
><funcdef
>array of string <function
>getTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
<para
>Restituisce un elenco con nomi e valori di frame alternati.</para>
</sect2>

<sect2 id="dbus-getInformation">
<title
>Ottenere informazioni tecniche sul file</title>
<funcsynopsis>
<funcprototype>
  <funcdef
>array di stringhe <function
>getInformation</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Le proprietà sono Formato, Bitrate, Campionamento, Canali, Durata, Modalità canale, VBR, Tag 1, Tag 2. Le proprietà non disponibili sono omesse.</para>
<para
>Restituisce un elenco con nomi e valori di proprietà alternati.</para>
</sect2>

<sect2 id="dbus-setTagFromFileName">
<title
>Impostare un tag dal nome del file</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>setTagFromFileName</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-setTagFromOtherTag">
<title
>Impostare un tag da un altro tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>setTagFromOtherTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-copyTag">
<title
>Copiare un tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>copyTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-pasteTag">
<title
>Incollare un tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>pasteTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-removeTag">
<title
>Rimuovere un tag</title>
<funcsynopsis>
<funcprototype
><funcdef
><function
>removeTag</function
></funcdef
> <paramdef
>int32 <parameter
>tagMask</parameter
></paramdef
> </funcprototype>
</funcsynopsis>
<variablelist>
  <varlistentry>
    <term
><replaceable
>tagMask</replaceable
></term>
    <listitem
><para
>bit del tag (1 per tag 1, 2 per tag 2)</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="dbus-reparseConfiguration">
<title
>Elaborare nuovamente la configurazione</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>reparseConfiguration</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
<para
>Le modifiche automatizzate alla configurazione sono possibili modificando il file di configurazione e quindi elaborando nuovamente la configurazione.</para>
</sect2>

<sect2 id="dbus-playAudio">
<title
>Riproduce i file selezionati</title>
<funcsynopsis>
<funcprototype>
  <funcdef
><function
>playAudio</function
></funcdef>
  <void/>
</funcprototype>
</funcsynopsis>
</sect2>

</sect1>

</appendix>

<appendix id="qml-interface">
<title
>Interfaccia QML</title>

<sect1 id="qml-examples">
<title
>Esempi di QML</title>

<para
>Gli script QML possono essere richiamati tramite il menu contestuale dell'elenco file e possono essere impostati nella scheda <link linkend="configure-user-actions-qml"
>Azioni dell'utente</link
> della finestra delle impostazioni. Gli script impostati lì possono essere utilizzati come esempi per programmare script personalizzati. QML utilizza &javascript; ecco il «Ciao mondo» obbligatorio: </para>

<programlisting
>import Kid3 1.0

Kid3Script {
  onRun: {
    console.log("Ciao mondo, la cartella è", app.dirName)
    Qt.quit()
  }
}
</programlisting>

<para
>Se questo script viene salvato come <filename
>/percorso/a/Esempio.qml</filename
>, il comando utente può essere definito come <command
>@qml/percorso/a/Esempio.qml</command
> con nome <userinput
>Test QML</userinput
> e <guilabel
>Risultato</guilabel
> selezionati. Può quindi essere avviato utilizzando l'elemento <guilabel
>Test QML</guilabel
> nel menu contestuale dell'elenco dei file e il risultato sarà visibile nella finestra. </para>

<para
>Sfortunatamente, avviando gli script QML utilizzando <command
>qml</command
> (ad es. <command
>qml -apptype widget -I /usr/lib/kid3/plugins/imports /percorso/a/Esempio.qml</command
>) non funziona correttamente nelle versioni recenti di Qt. <command
>kid3-cli</command
> offre un modo alternativo per eseguire uno script QML dalla riga di comando utilizzando il suo comando <link linkend="cli-execute"
><command
>execute</command
></link
>. <screen width="80"
>kid3-cli -c "execute @qml /percorso/a/Esempio.qml"
</screen>
</para>

<para
>Per elencare i titoli nei tag 2 di tutti i file nella cartella attuale, è possibile utilizzare il seguente script: </para>

<programlisting
>import Kid3 1.0

Kid3Script {
  onRun: {
    app.firstFile()
    do {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "titolo"))
      }
    } while (app.nextFile())
  }
}
</programlisting>

<para
>Se la cartella contiene molti file, uno script del genere potrebbe bloccare l'interfaccia utente per qualche tempo. Per operazioni più lunghe, dovrebbe quindi avere una pausa di tanto in tanto. L'implementazione alternativa di seguito ha il compito per un singolo file spostato in una funzione. Questa funzione si richiama alla fine con un timeout di 1 ms, dato che è necessario elaborare più file. Questo assicurerà che la &GUI; rimanga reattiva mentre lo script è in esecuzione. </para>

<programlisting
>import Kid3 1.0

Kid3Script {
  onRun: {
    function doWork() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "titolo"))
      }
      if (!app.nextFile()) {
        Qt.quit()
      } else {
        setTimeout(doWork, 1)
      }
    }

    app.firstFile()
    doWork()
  }
}
</programlisting>

<para
>Quando si utilizza <command
>app.firstFile()</command
> con <command
>app.nextFile()</command
>, saranno elaborati tutti i file della cartella attuale. Se sono interessati solo i file selezionati, utilizzare invece <command
>firstFile()</command
> e <command
>nextFile()</command
>, queste sono funzioni utili del componente <classname
>Kid3Script</classname
>. L'esempio seguente è uno script che copia solo il numero del disco e i frame del copyright del file selezionato. </para>

<programlisting
>import Kid3 1.1

Kid3Script {
  onRun: {
    function doWork() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        app.setFrame(tagv2, "*.selected", false)
        app.setFrame(tagv2, "discnumber.selected", true)
        app.setFrame(tagv2, "copyright.selected", true)
        app.copyTags(tagv2)
      }
      if (!nextFile()) {
        Qt.quit()
      } else {
        setTimeout(doWork, 1)
      }
    }

    firstFile()
    doWork()
  }
}
</programlisting>

<para
>Altri script di esempio sono forniti da &kid3; e sono già registrati come comandi dell'utente. <itemizedlist>
<listitem
><para
><guilabel
>ReplayGain in SoundCheck</guilabel
> (<filename
>ReplayGain2SoundCheck.qml</filename
>): creare informazioni iTunNORM SoundCheck dai frame del guadagno di riproduzione. </para
></listitem>
<listitem
><para
><guilabel
>Ridimensionare le copertine degli album</guilabel
> (<filename
>ResizeAlbumArt.qml</filename
>): ridimensionare le immagini di copertina integrate che sono più grandi di 500x500 pixel. </para
></listitem>
<listitem
><para
><guilabel
>Estrarre le copertine degli album</guilabel
> (<filename
>ExtractAlbumArt.qml</filename
>): estrarre le immagini di copertina integrate evitando i duplicati. </para
></listitem>
<listitem
><para
><guilabel
>Integrare le copertine degli album</guilabel
> (<filename
>EmbedAlbumArt.qml</filename
>): integrare le copertine trovate nei file di immagine trovati nei file audio nella stessa cartella. </para
></listitem>
<listitem
><para
><guilabel
>Integrare i testi</guilabel
> (<filename
>EmbedLyrics.qml</filename
>): recuperare i testi non sincronizzati da un servizio web. </para
></listitem>
<listitem
><para
><guilabel
>Codifica del testo ID3v1</guilabel
> (<filename
>ShowTextEncodingV1.qml</filename
>): aiuta a trovare la codifica dei tag ID3v1 mostrando i tag del file attuale in tutte le codifiche di caratteri disponibili. </para
></listitem>
<listitem
><para
><guilabel
>ID3v1 a ASCII</guilabel
> (<filename
>Tag1ToAscii.qml</filename
>): Traslitterare caratteri latini estesi nel tag ID3v1 in ASCII. </para
></listitem>
<listitem
><para
><guilabel
>Maiuscole dei titoli inglesi</guilabel
> (<filename
>TitleCase.qml</filename
>): Formatta il testo nei tag in con i criteri inglesi di utilizzo delle maiuscole nei titoli. </para
></listitem>
<listitem
><para
><guilabel
>Riscrivi tag</guilabel
> (<filename
>RewriteTags.qml</filename
>): Riscrivi tutti i tag dei file selezionati. </para
></listitem>
<listitem
><para
><guilabel
>Esporta CSV</guilabel
> (<filename
>ExportCsv.qml</filename
>): Esporta ricorsivamente tutti i tag di tutti i file in un file CSV. </para
></listitem>
<listitem
><para
><guilabel
>Import CSV</guilabel
> (<filename
>ImportCsv.qml</filename
>): Importa ricorsivamente tutti i tag di tutti i file da un file CSV. </para
></listitem>
<listitem
><para
><guilabel
>Esporta JSON</guilabel
> (<filename
>ExportJson.qml</filename
>): Esporta ricorsivamente tutti i tag di tutti i file in un file JSON. </para
></listitem>
<listitem
><para
><guilabel
>Importa JSON</guilabel
> (<filename
>ImportJson.qml</filename
>): Importa ricorsivamente tutti i tag di tutti i file in un file JSON. </para
></listitem>
<listitem
><para
><guilabel
>Esportare la cartella della scaletta</guilabel
> (<filename
>ExportPlaylist.qml</filename
>): copiare tutti i file di una scaletta in una cartella e rinominarli in base alla loro posizione. </para
></listitem>
<listitem
><para
><guilabel
>QML Console</guilabel
> (<filename
>QmlConsole.qml</filename
>): Semplice console per fare pratica con le API QML di &kid3;. </para
></listitem>
</itemizedlist>
</para>

</sect1>

<sect1 id="qml-api">
<title
>API QML</title>

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

<sect2 id="qml-kid3script">
<title
>Kid3Script</title>

<para
><classname
>Kid3Script</classname
> è un normale componente QML situato nella cartella delle estensioni. È possibile utilizzare anche un altro componente QML. L'uso di <classname
>Kid3Script</classname
> semplifica l'avvio della funzione di script utilizzando il gestore di segnali <function
>onRun</function
>. Inoltre offre alcune funzioni: <programlisting
>onRun: gestore dei segnali che è invocato quando lo script è avviato
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 degli script
isStandalone(): vero se lo script non era stato avviato dall'interno di Kid3
setTimeout(callback, ritardo): avvia callback dopo ms di ritardo
firstFile(): al primo file selezionato
nextFile(): al successivo file selezionato
</programlisting>

</para>
</sect2>

<sect2 id="qml-script">
<title
>Funzioni per creare script</title>

<para
>Come &javascript; e quindi anche QML ha solo un insieme limitato di funzioni per gli script, l'oggetto <function
>script</function
> ha alcuni metodi aggiuntivi, ad esempio: </para>

<programlisting
>script.properties (oggetto): stringa con proprietà Qt
script.writeFile (percorsoFile, dati): scrivere i dati nel file, vero se OK
script.readFile (percorsoFile): leggere i dati dal file
script.removeFile (percorsoFile): eliminare il file, vero se OK
script.fileExists (percorsoFile): vero se il file esiste
script.fileIsWritable (percorsoFile): vero se il file è scrivibile
script.getFilePermissions (percorsoFile): ottenere bit dei permessi del file
script.setFilePermissions (percorsoFile, bitModalità): impostare i bit dei permessi del file
script.classifyFile (percorsoFile): ottenere la classe del file (cartella "/", collegamento simbolico "@", exe "*",
  file " ")
script.renameFile (vecchioNome, nuovoNome): rinominare il file, vero se OK
script.copyFile (origine, destinazione): copiare il file, vero se OK
script.makeDir (percorso): creare la cartella, vero se OK
script.removeDir (percorso): rimuovere la cartella, vero se OK
script.tempPath (): percorso della cartella temporanea
script.musicPath (): percorso della cartella musicale
script.listDir (percorso, [filtriNome], [classificare]): elencare le voci della cartella
script.system (programma, [arg], [msec]): avviare un comando di sistema in modo sincrono,
  [codice di uscita, standard output, standard error] se non scade il tempo limite
script.systemAsync (programma, [arg], [callback]): avviare un comando di sistema in modo comando
asincrono, la callback sarà invocata con [codice di uscita, standard output, standard
error]
script.getEnv (nomeVar): ottenere il valore della variabile d'ambiente
script.setEnv (nomeVar, valore): impostare il valore della variabile d'ambiente
script.getQtVersion (): stringa versione Qt, <abbrev
>ad es.</abbrev
> "5.4.1"
script.getDataMd5 (dati): ottenere la stringa esadecimale dell'hash MD5 dei dati
script.getDataSize (dati): ottenere la dimensione dell'array di byte
script.dataToImage (dati, [formato]): creare un'immagine da byte di dati
script.dataFromImage (img, [formato]): ottenere byte di dati dall'immagine
script.loadImage (percorsoFile): caricare un'immagine da un file
script.saveImage (img, percorsoFile, [formato]): salvare un'immagine in un file, vero se OK
script.imageProperties (img): ottenere le proprietà di un'immagine, una mappa contenente
  "larghezza", "altezza", "profondità" e "colorCount", vuoto se l'immagini non è valida
script.scaleImage (img, larghezza, [altezza]): ridimensionare un'immagine, restituisce un'immagine ridimensionata
</programlisting>

</sect2>

<sect2 id="qml-app">
<title
>Contesto dell'applicazione</title>

<para
>Utilizzando QML, gran parte delle funzioni di &kid3; sono accessibili. L'API è simile a quella utilizzata per <link linkend="dbus-api"
>&DBus;</link
>. Per i dettagli, consultare le rispettive note. </para>

<programlisting
>app.openDirectory(percorso): aprire una cartella
app.unloadAllTags(): scaricare tutti i tag
app.saveDirectory(): salvare una cartella
app.revertFileModifications(): ripristinare
app.importTags(tag, percorso, fmtIdx): importare i file
app.importFromTags(tag, origine, estrazione): importare dai tag
app.importFromTagsToSelection(tag, origine, estrazione): importare dai tag dei file selezionati
app.downloadImage(url, allFilesInDir): scaricare un'immagine
app.exportTags(tag, percorso, fmtIdx): esportare i file
app.writePlaylist(): scaricare una scaletta
app.getPlaylistItems(percorso): ottenere gli elementi di una scaletta
app.setPlaylistItems(percorso, elementi): impostare gli elementi id una scaletta
app.selectAllFiles(): selezionare tutto
app.deselectAllFiles(): deselezionare
app.firstFile([selezione], [soloFileConTag]): al primo file
app.nextFile([selezione], [soloFileConTag]): al file successivo
app.previousFile([selezione], [soloFileConTag]): al file precedente
app.selectCurrentFile([selezione]): selezionare un file attuale
app.selectFile(path, [selezione]): selezionare un file specifico
app.getSelectedFilePaths([soloFileConTag]): ottenere i percorsi dei file selezionati
app.requestExpandFileList(): espandere tutto
app.applyFilenameFormat(): applicare il formato ai nomi dei file
app.applyTagFormat(): applicare il formato al tag
app.applyTextEncoding(): applicare la codifica del testo
app.numberTracks(nr, totale, tag, [opzioni]): Numerare le tracce
app.applyFilter(espressione): filtro
app.convertToId3v23(): convertire ID3v2.4.0 in ID3v2.3.0
app.convertToId3v24(): convertire ID3v2.3.0 in ID3v2.4.0
app.getFilenameFromTags(tag): nomi dei file dai tag
app.getTagsFromFilename(tag): nomi dei file ai tag
app.getAllFrames(tag): ottenere oggetti con tutti i frame
app.getFrame(tag, nome): ottenere un frame
app.setFrame(tag, nome, valore): impostare un frame
app.getPictureData(): ottenere i dati da un frame di immagine
app.setPictureData(dati): impostare i dati in un frame di immagine
app.copyToOtherTag(tag): tag ad altri tag
app.copyTags(tag): copiare
app.pasteTags(tag): incollare
app.removeTags(tag): Rimuovere
app.playAudio(): Riprodurre
app.readConfig(): Leggere la configurazione
app.applyChangedConfiguration(): Applicare la configurazione
app.dirName: Nome della cartella
app.selectionInfo.fileName: Nome del file
app.selectionInfo.filePath: Percorso assoluto del file
app.selectionInfo.detailInfo: Dettagli di formato
app.selectionInfo.tag(Frame.Tag_1).tagFormat: Formato tag 1
app.selectionInfo.tag(Frame.Tag_2).tagFormat: Formato tag 2
app.selectionInfo.formatString(tag, formato): Sostituire i codici nella stringa di formato
app.selectFileName(titolo, cartella, filtro, saveFile): Aprire la finestra per
selezionare un file
app.selectDirName(titolo, cartella): Aprire la finestra per selezionare una cartella
</programlisting>

<para
>Per operazioni asincrone, le callback possono essere collegate ai segnali. </para>

<programlisting
>function automaticImport(profile) {
  function onAutomaticImportFinished() {
    app.batchImporter.finished.disconnect(onAutomaticImportFinished)
  }
  app.batchImporter.finished.connect(onAutomaticImportFinished)
  app.batchImport(profile, tagv2)
}

function renameDirectory(format) {
  function onRenameActionsScheduled() {
    app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
    app.performRenameActions()
  }
  app.renameActionsScheduled.connect(onRenameActionsScheduled)
  app.renameDirectory(tagv2v1, format, false)
}
</programlisting>

</sect2>

<sect2 id="qml-configs">
<title
>Oggetti di configurazione</title>

<para
>Le diverse sezioni di configurazione sono accessibili tramite i metodi di <function
>configs</function
>. Le loro proprietà possono essere elencate nella console QML. <screen width="80">
script.properties (configs.networkConfig())
</screen
> È possibile impostare le proprietà: <screen width="80"
>configs.networkConfig().useProxy = false
</screen>
</para>

<programlisting
>configs.batchImportConfig()
configs.exportConfig()
configs.fileConfig()
configs.filenameFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
configs.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
configs.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()
</programlisting>

</sect2>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: nxml
End:
-->
