# &kid3; Priročnik

## Povzetek

    kid3  &doublehyphen;help &doublehyphen;author &doublehyphen;version &doublehyphen;license &doublehyphen;desktopfile DATOTEKA  DATOTEKA

    kid3-qt &doublehyphen;portable Qt-options DATOTEKA

    kid3-cli &doublehyphen;portable &doublehyphen;dbus  -h &doublehyphen;help   -c COMMAND1 -c COMMAND2 DATOTEKA

## Možnosti

`&doublehyphen;portable`

- Shranite konfiguracijo v datoteko `kid3.ini` znotraj mape aplikacije.

`DATOTEKA`

- Če je ``DATOTEKA`` pot do mape, se bo odprla. Če je podana ena ali več poti do datoteke, se odpre njihova skupna mapa in se izberejo datoteke.

### kid3

`&doublehyphen;help`

- Pokaži pomoč o možnostih.

`&doublehyphen;author`

- Pokaži podatke o avtorju.

`&doublehyphen;version`

- Prikaži informacije o različici.

`&doublehyphen;license`

- Pokaži informacije o licenci.

`&doublehyphen;desktopfile `DATOTEKA``

- Osnovno ime datoteke vnosa namizja za to aplikacijo.

### kid3-qt

`Qt-options`

- Glejte

  qt5options

  7.

### kid3-cli

`&doublehyphen;dbus`

- Aktivirajte &DBus; vmesnik.

`-c`

- Izvedi ukaz. Možnih je več možnosti `-c`, ki se izvajajo v zaporedju. Glejte razdelek o kid3-cli za opis razpoložljivih ukazov.

`-h`|`&doublehyphen;help`

- Pokaži pomoč o možnostih in ukazih.

## Uvod

&kid3; je aplikacija za učinkovito urejanje oznak ID3v1 in ID3v2 v datotekah MP3. Te oznake lahko ureja večina predvajalnikov MP3, vendar ne na zelo udoben in učinkovit način. Poleg tega so podprte oznake v datotekah Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF in tudi sledilnih modulih (MOD, S3M, IT, XM).

&kid3; ne zajema in ne kodira datotek MP3, ampak je namenjen urejanju oznak ID3 vseh datotek v albumu na učinkovit način, tj. s čim manj kliki miške in pritiski tipk. Kjer lahko večina drugih programov ureja oznake ID3v1 ali ID3v2, &kid3; ima popoln nadzor nad obema različicama, lahko pretvori oznake med obema formatoma in ima dostop do vseh oznak ID3v2. Oznake več datotek lahko nastavite na isto vrednost, npr. izvajalec, album, leto in zvrst vseh datotek albuma imajo običajno enake vrednosti in jih je mogoče nastaviti skupaj. Če so informacije za oznake vsebovane v imenu datoteke, se lahko oznake samodejno nastavijo iz imena datoteke. Možno je tudi nastaviti ime datoteke glede na oznake, ki jih najdemo v datoteki v poljubnih formatih.

Naloga urejanja je dodatno podprta s samodejno zamenjavo znakov ali podnizov, na primer za odstranitev nedovoljenih znakov iz imen datotek. Samodejni nadzor velikih in malih črk olajša uporabo dosledne sheme poimenovanja v vseh oznakah.

Podatke o oznakah za celotne albume lahko vzamete iz gnudb.org, MusicBrainz, Discogs, Amazon ali drugih virih seznamov skladb. Format uvoza je prosto nastavljiv z regularnimi izrazi.

Avtorju sporočite vse težave ali zahteve po funkcijah.

## Uporaba &kid3;

### &kid3; zmožnosti

- Uredite oznake ID3v1.1

- Uredite vse okvirje ID3v2.3 in ID3v2.4

- Urejanje oznak več datotek

- Pretvarjanje med oznakami ID3v1 in ID3v2

- Urejanje oznak MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV in AIFF

- Ustvari oznake iz imena datoteke

- Ustvari oznake iz vsebine polj oznak

- Ustvari ime datoteke iz oznak

- Ustvari in spremeni imena map iz oznak

- Ustvari datoteko seznama predvajanja

- Samodejna pretvorba velikih in malih črk in prevajanje nizov

- Uvoz iz gnudb.org, MusicBrainz, Discogs, Amazon in drugih virov podatkov

- Izvozi kot CSV, &HTML;, seznam predvajanja, Kover &XML; in drugih formatih. Izvožene datoteke CSV je mogoče znova uvoziti.

### Primer uporabe

Ta razdelek opisuje tipično sejo z &kid3;. Predpostavimo, da imamo mapo, ki vsebuje datoteke MP3 s skladbami z albuma "Let's Tag" skupine "One Hit Wonder". Mapa je poimenovana v formatu "izvajalec - album", v našem primeru `One Hit Wonder - Let's Tag`. Mapa vsebuje skladbe v formatu "naslov skladbe.mp3", kar je po mojem mnenju uporabno, saj so imena datotek kratka (pomembno pri uporabi mobilnih predvajalnikov MP3 z majhnimi zasloni) in v pravilnem vrstnem redu, če so razvrščeni po abecedi (pomembno pri uporabi strojnih predvajalnikov MP3, ki predvajajo skladbe po abecednem vrstnem redu ali v vrstnem redu, v katerem so zapisane na &CD; in ta vrstni red je abecedni pri uporabi `mkisofs`). Poleg tega so podatki o izvajalcu in albumu že v imenu mape in jih ni treba ponoviti v imenu datoteke. Toda nazaj k našemu primeru, seznam map je videti takole:

`01 Intro.mp3`

`02 We Only Got This One.mp3`

`03 Outro.mp3`

Te datoteke še nimajo oznak in želimo jih ustvariti z &kid3;. Uporabimo element menija Datoteka Odpri (ali gumb orodne vrstice) in izberemo eno od datotek v tej mapi. Vse datoteke bodo prikazane v seznamu datotek. Ker smo leni, želimo uporabiti informacije v imenih map in datotek za ustvarjanje oznak. Zato izberemo vse datoteke, nato kliknemo gumb Za: Oznaka 1 v razdelku Datoteka. To bo nastavilo vrednosti naslova, izvajalca, albuma in skladbe v vseh datotekah. Za nastavitev vrednosti leta in zvrsti vseh datotek pustimo izbrane vse datoteke in vnesemo »2002« za Datum in izberemo »Pop« v kombiniranem polju Zvrst. Če želite nastaviti samo ti dve vrednosti, sta njuni potrditveni polji samodejno označeni, vsa druga potrditvena polja pa ostanejo nepotrjena. Zdaj spremenimo izbiro tako, da izberemo samo prvo datoteko in vidimo, da vse oznake vsebujejo pravilne vrednosti. Oznake drugih datotek lahko preverite tudi tako, da jih izberete eno za drugo. Ko smo z oznakami zadovoljni, uporabimo menijski element Datoteka Shrani (ali gumb v orodni vrstici). Če izberete element menija Datoteka Ustvari seznam predvajanja (ali gumb v orodni vrstici), se ustvari datoteka `One Hit Wonder - Let's Tag.m3u` v mapi.

## Referenca ukazov

### &GUI; Elementi

&kid3; &GUI; je razdeljen na šest razdelkov: na levi strani so polja s seznami datotek in map, desna stran vsebuje razdelke Datoteka, Tag 1, Tag 2 and Tag 3 .

Za krmarjenje med različnimi razdelki s tipkovnico je podprtih več bližnjic na tipkovnici. V razdelkih z oznakami so bližnjice aktivne, ko ne urejate besedila ali ko ste v prvem stolpcu.

- &Alt;Levo: Pojdi na prejšnji razdelek (Ukaz[ v &macOS;)

- &Alt;Desno: Pojdi na naslednji razdelek (Ukaz] v &macOS;)

- &Ctrl;Shift V: iz druge oznake

- &Ctrl;C: Kopiraj

- &Ctrl;V: Prilepi

- Shift Izbriši: Odstrani

- F2: Uredi

- Vstavi: Dodaj

- Izbriši: Izbriši

#### Seznam datotek

Seznam datotek vsebuje imena vseh datotek v odprti mapi, ki se ujemajo z izbranim filtrom imen datotek (običajno `*.mp3 *.ogg *.opus *.dsf *.flac *.mpc * .aac *.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape`). Izberete lahko eno ali več datotek. Če ne želite izbrati nobene datoteke, kliknite na prazno območje za vnosi seznama. Izbira določa datoteke, na katere vplivajo operacije, ki so na voljo z uporabo spodaj opisanih gumbov.

Poleg Imena so lahko prikazani tudi drugi stolpci Velikost, Vrsta, Datum spremembe s podrobnostmi o datoteki. Stolpce lahko skrijete tako, da počistite njihovo ime v kontekstnem meniju glave seznama. Vrstni red stolpcev lahko spremenite z vlečenjem in spuščanjem. Vrstni red razvrščanja lahko preklopite s klikom na glavo stolpca.

Vrednosti standardnih oznak je mogoče prikazati in urediti tudi v stolpcih seznama datotek.

Na levi strani imen je lahko prikazana ikona: disk, ki prikazuje, da je bila datoteka spremenjena, ali informacije o tem, katere oznake so prisotne (V1, V2, V1V2 ali BREZ OZNAKE, ikona ni prikazana, če datoteka še ni bila prebrana).

Mape so prikazane z ikono mape. Če je mapa odprta, so njene datoteke prikazane v hierarhičnem drevesu. Z izbiro datotek iz podmap je mogoče izvajati operacije na datotekah v različnih mapah, kar je uporabno, če je glasbena zbirka organizirana z mapo za vsakega izvajalca, ki vsebuje mape za albume tega izvajalca.

Klik na desni gumb miške znotraj seznama datotek odpre kontekstni meni z naslednjimi ukazi:

- Razširi vse: Razširi vsa drevesa map (samo trenutno drevo, če je pritisnjena tipka Shift)

- Strni vse: Strni vsa drevesa map

- Preimenuj: Spremeni ime datoteke

- Premakni v koš: premakne datoteko v koš

- Predvajaj: Predvaja datoteko, glejte Predvajaj. Če je izbrana datoteka seznam predvajanja, bodo predvajane datoteke seznama predvajanja.

- Uredi: Uredi seznam predvajanja, glejte Urejanje seznama predvajanja.

- Naslednji vnosi so uporabniški ukazi, ki jih lahko definirate na zavihku Uporabniška dejanja v Konfiguriraj &kid3;. Tam lahko aktivirate tudi predvajanje z dvojnim klikom.

  Ko je aktivirana možnost Izberi datoteko ob predvajanju, je trenutno predvajana skladba samodejno izbrana na seznamu datotek.

#### Uredi seznam predvajanja

Seznam predvajanja lahko ustvarite prazen ali pa vsebuje skladbe v mapi, glejte Ustvari seznam predvajanja. Tako ustvarjeno datoteko seznama predvajanja lahko urejate z dvoklikom ali z Uredi v kontekstnem meniju seznama datotek. Prikaže se pogovorno okno z vnosi seznama predvajanja. Možno je odpreti več seznamov predvajanja hkrati.

Nove vnose lahko dodate tako, da povlečete in spustite s seznama datotek, upravitelja datotek ali drugega seznama predvajanja. Če vnos povlečete z drugega seznama predvajanja, bo premaknjen ali kopiran, odvisno od sistema. Za priklic druge operacije uporabite Shift, &Ctrl; ali &Alt; (za kopiranje namesto premikanja v &macOS;) je treba pritisniti tipko. Prerazvrščanje vnosov na seznamu predvajanja je možno tudi s tehniko povleci in spusti. Vnose lahko premikate tudi z tipkami bližnjic &Ctrl;Shift Gor in &Ctrl;Shift Dol (v &macOS; Command je treba pritisniti namesto &Ctrl;). Vnos lahko odstranite s tipko Delete.

Prosimo, upoštevajte naslednje: Če želite povleči vnose s seznama datotek, jih morate držati na levi strani (blizu ikon), ista poteza na desni strani bo izvedla večkratno izbiro, tako dejanje je zdaj še vedno enostavno možno.

Ko je seznam predvajanja spremenjen, lahko spremembe shranite z Shrani ali zavržete z Prekliči. Ko je okno zaprto, se prikaže poziv za potrditev, če obstajajo neshranjene spremembe.

Skladbe, izbrane na seznamu predvajanja, bodo samodejno izbrane na seznamu datotek, kar omogoča urejanje njihovih oznak.

Za izvedbo dejanj na seznamu predvajanja mora biti njegova datoteka izbrana na seznamu datotek. Urejanje iz priročnega menija bo pripeljalo do pogovornega okna, opisanega v tem razdelku, Predvajaj pa bo zagnalo predstavnostni predvajalnik s skladbami s seznama predvajanja. Uporabniška dejanja lahko delujejo na seznamih predvajanja, na primer na primer Izvozi mapo seznama predvajanja, ki kopira datoteke s seznama predvajanja v mapo.

#### Seznam map

Seznam map vsebuje imena map v odprti mapi ter trenutno (`.`) in nadrejeno (`..`). Omogoča hitro spreminjanje mape brez uporabe ukaza Odpri ali povleci in spusti.

Vidnost, vrstni red in razvrščanje stolpcev je mogoče konfigurirati, kot je opisano v razdelku o seznamu datotek.

#### Datoteka

Prikazuje informacije o kodiranju (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), bitni hitrosti, hitrosti vzorčenja, kanalih in dolžini datoteke.

Urejanje vrstice Ime vsebuje ime datoteke (če je izbrana samo ena datoteka). Če to ime spremenite, bo datoteka preimenovana, ko uporabite ukaz Shrani.

Kombinirano polje Oblika in urejanje vrstice vsebuje obliko, ki bo uporabljena, ko je ime datoteke ustvarjeno iz prve ali druge oznake. Ime datoteke lahko vsebuje poljubne znake, celo del mape, ločen s poševnico od imena datoteke, vendar mora ta mapa že obstajati, da preimenovanje uspe. Za vstavljanje vrednosti oznak v ime datoteke se uporabljajo naslednje posebne kode:

- %s %{title} Naslov (Pesem)

- %a %{artist} Umetnik

- %l %{album} Album

- %c %{comment} Komentar

- %y %{year} Leto

- %t %{track} Sled (npr. 01)

- %t %{track.n} Sled s širino polja n (npr. 001 za %{track.3})

- %T %{tracknumber} Sled (brez začetnih ničel, npr. 1)

- %g %{genre} Žanr

- %{ignore} Prezrto pri generiranju oznak iz imena datoteke

Kode formatov niso omejene na zgoraj navedene primere. Uporabite lahko katero koli ime okvirja, na primer poenotena imena okvirjev, kot so `%{albumartist}`, `%{discnumber.1}`, `%{bpm}` ali oblikujte posebna imena, kot je `%{popm}`.

Nadomestku za kodo formata je mogoče dodati nize in jih dodati tako, da jih dodate v dvojnih narekovajih znotraj zavitih oklepajev kode formata. Ti nizi bodo vstavljeni v nastali niz le, če koda zapisa vrne neprazno vrednost. Na primer, če mora ime datoteke vsebovati naslov in podnaslov, lahko uporabite `%{title} [%{subtitle}]` v formatnem nizu. Toda to bi povzročilo niz, ki se konča z `[]`, če za datoteko ne obstaja okvir podnapisov. Če želite izpustiti oklepaje, če podnapis ni prisoten, se namesto tega uporabi `%{title}%{" ["subtitle"]"}`. To bo izpustilo oklepaje, začetni presledek in podnapis, če podnapis ne obstaja.

Seznam razpoložljivih formatov lahko uredite v pogovornem oknu, ki se prikaže, ko kliknete gumb Ime datoteke iz oznake na zavihku Datoteka v nastavitve.

Drugo kombinirano polje Oblika (s puščico navzdol) se uporablja za ustvarjanje oznak iz imena datoteke. Če se oblika imena datoteke ne ujema s tem vzorcem, se poskusi nekaj drugih pogosto uporabljenih oblik.

Nekateri pogosto uporabljeni formati imen datotek so že na voljo v kombiniranem polju, možno pa je tudi vnesti kakšen poseben format v vrstico za urejanje.

Seznam razpoložljivih formatov lahko uredite v pogovornem oknu, ki se prikaže, ko kliknete gumb Oznaka iz imena datoteke na zavihku Datoteka v nastavitve.

Interno je regularni izraz zgrajen iz kod formata. Če so potrebni napredni regularni izrazi, se lahko format za ustvarjanje oznak iz imen datotek poda kot celoten regularni izraz z zajemi, pred katerimi so kode formata, npr. za ekstrahiranje številk skladb brez odstranitve začetnih ničel, bi lahko uporabili obliko, kot je "`/%{track}(\d+) %{title}(.*)`".

Od: Oznaka 1, Oznaka 2: Nastavi ime datoteke z uporabo izbrane oblike in prve oznake oziroma druge oznake.

Za: Oznaka 1, Oznaka 2: Oznake so nastavljene iz imena datoteke. Najprej se uporabi format, določen v Oblika. Če se obstoječe ime datoteke ne ujema s to obliko, se poskusijo naslednje oblike:

- `Izvajalec - Album/Sled skladbe`

- `Album/Sled - Izvajalec - Pesem`

- `/Izvajalec - Album - Sled - Pesem`

- `Album/Izvajalec - Sled - Pesem`

- `Album/Izvajalec - Pesem`

- `Izvajalec/Album/Sled skladbe`

Če je izbrana ena datoteka, &GUI; kontrolniki so napolnjeni z vrednostmi, ekstrahiranimi iz imena datoteke. Če je izbranih več datotek, se oznake datotek neposredno nastavijo glede na imena datotek.

#### Oznaka 1

Gradniki za urejanje vrstic za Naslov, Izvajalec, Album, Komentar, Datum, Številka sledi in Zvrst se uporabljata za urejanje ustrezne vrednosti v prvi oznaki izbranih datotek. Vrednost bo spremenjena, ko je izbrana datoteka spremenjena ali pred operacijami, kot sta Shrani in Zapri, in ko je označeno ustrezno potrditveno polje na levi strani imena polja. To je uporabno, če želite spremeniti samo nekatere vrednosti in pustiti druge nespremenjene.

Če je izbrana ena datoteka, so potrjena vsa potrditvena polja in gradniki za urejanje vrstic vsebujejo vrednosti, ki jih najdete v oznakah te datoteke. Če oznake ni mogoče najti v datoteki, se prikaže ustrezna prazna vrednost, ki je prazen niz za Naslov, Izvajalec, Album in urejanje vrstice Komentar, 0 za urejanje numeričnega Datuma in Številke sledi ter prazna izbrana vrednost za Žanr kombinirano polje. Vrednosti je mogoče spremeniti in če je ustrezno potrditveno polje označeno, bodo nastavljene za izbrano datoteko po spremembi izbora. Datoteka je nato označena kot spremenjena s simbolom diska v polju s seznamom datotek, vendar ostane nespremenjena, dokler ne uporabite ukaza Shrani.

Če je izbranih več datotek, se prikažejo le vrednosti, ki so enake v vseh izbranih datotekah. V vseh drugih kontrolnikih so prikazane prazne vrednosti, kot je opisano zgoraj. Vsa potrditvena polja niso potrjena, da se izognete neželenim spremembam. Če je treba nastaviti vrednost za vse izbrane datoteke, jo lahko uredite in potrdite polje. Vrednosti bodo nastavljene za vse izbrane datoteke, ko bo izbor spremenjen, in jih lahko shranite z ukazom Shrani.

Potrditvena polja prav tako nadzirajo delovanje večine ukazov, ki vplivajo na oznake, kot so kopiranje, lepljenje in prenos med oznakama 1 in 2. Za lažjo uporabo z več datotekami, kjer vsa potrditvena polja niso potrjena, se ti ukazi obnašajo na enak način ko so vsa potrditvena polja potrjena in ko vsa potrditvena polja niso potrjena.

Iz oznake 2: Polja oznake 1 so nastavljena iz ustreznih vrednosti v oznaki 2. Če je izbrana ena datoteka, so &GUI; kontrolniki napolnjeni z vrednostmi iz oznake 2. Če je izbranih več datotek, se oznake datotek neposredno nastavijo.

Kopiraj: Medpomnilnik kopiranja je napolnjen z vrednostmi oznake 1. Samo vrednosti s potrjenim potrditvenim poljem bodo uporabljene v naslednjih ukazih Prilepi.

Prilepi: prilepi vrednosti iz medpomnilnika za kopiranje v &GUI; kontrole.

Odstrani: To bo nastavilo vse &GUI; kontrolnike na njihove prazne vrednosti, kar povzroči odstranitev vseh vrednosti. Shranjena datoteka potem ne bo vsebovala oznake 1.

#### Oznaka 2

&GUI; kontrolniki delujejo na enak način, kot je opisano za razdelek Oznaka 1, vendar velikost nizov ni omejena.

Za oznako 2 Žanr lahko uporabite tudi svoja imena poleg žanrov, navedenih v kombiniranem polju, samo vnesite ime v vrstico za urejanje.

Oznaka 2 ne more vsebovati samo istih vrednosti kot oznaka 1, format je zgrajen na prilagodljiv način iz več okvirjev, ki so sami sestavljeni iz več polj. Tabela oznake 2 prikazuje vse okvirje, ki so na voljo v izbrani datoteki.

Uredi: S tem se odpre okno, ki omogoča urejanje vseh polj izbranega okvira. Če je izbranih več datotek, se urejena polja uporabijo za vse izbrane datoteke, ki vsebujejo tak okvir.

Dodaj: Pojavil se bo zahtevnik za izbiro vrste okvirja in okvir izbrane vrste lahko uredite in dodate v datoteko. To deluje tudi za dodajanje okvirja več izbranim datotekam.

Izbriši: Izbriše izbran okvir v izbranih datotekah.

Povleci sliko albuma sem je prikazano, če datoteka ne vsebuje vdelane naslovnice. Sliko lahko dodate s funkcijo povleci in spusti iz brskalnika ali upravitelja datotek in bo prikazana tukaj. Okvirje slik lahko urejate ali dodajate z dvojnim klikom na ta kontrolnik.

#### Oznaka 3

Nekatere datoteke imajo lahko več kot dve oznaki, tretji del oznake pa je viden. Naslednje vrste datotek imajo lahko tak razdelek Oznaka 3:

- Datoteke MP3 imajo lahko oznako ID3v1.1, oznako ID3v2 (2.3.0 ali 2.4.0) in v tretjem delu oznako APE. Takšne oznake APE se uporabljajo za informacije o pridobivanju ponovnega predvajanja. V razdelku Oznaka 3 so te informacije vidne, oznako APE pa lahko odstranite z gumbom Odstrani.

- Kos RIFF INFO datotek WAV je na voljo v razdelku Oznaka 3 , ker je razdelek Oznaka 1 namenjen oznakam ID3v1.1 in obravnava njihove omejitve. Oznaka 2 se še vedno uporablja za oznake ID3v2.4.0, ki so podprte tudi za datoteke WAV, vendar se zdi, da so kosi RIFF INFO bolje podprti.

- Datoteke FLAC običajno uporabljajo komentar Vorbis za svoje meta podatke. Vendar pa obstajajo datoteke FLAC z oznakama ID3v1 in ID3v2, ki jih najdete v razdelkih Oznaka 1 in Oznaka 3. Oznake ID3 v datotekah FLAC podpira samo TagLib, zato je treba vtičnik OggFlacMetadata onemogočiti na zavihku Vtičniki v nastavitvah.

&GUI; kontrolniki delujejo na enak način kot v razdelku Oznaka 2.

#### Seznam okvirjev

&kid3; lahko ureja večino okvirjev za vse podprte vrste datotek. Do nekaterih okvirjev se dostopa s poenotenimi imeni, tako da jih je mogoče izmenjati med datotekami različnih formatov. Do okvirjev, ki niso poenoteni, je mogoče dostopati kot do okvirjev, specifičnih za format.

#### Preslikava poenotenih vrst okvirjev v različne formate

Poenoteno | ID3v2.3 | ID3v2.4 | MP4 | ASF | Vorbis | RIFF
Naslov | `TIT2` | `TIT2` | `©nam` | `Naslov` | `NASLOV` | `INAM`
Umetnik | `TPE1` | `TPE1` | `©ART` | `Avtor` | `UMETNIK` | `IART`
Album | `TALB` | `TALB` | `©alb` | `WM/Naslov albuma` | `ALBUM` | `IPRD`
Komentar | `COMM` | `COMM` | `©cmt` | `Opis` | `KOMENTAR` | `ICMT`
Datum | `TYER` | `TDRC` | `©day` | `WM/Leto` | `DATUM` | `ICRD`
Številka sledi | `TRCK` | `TRCK` | `trkn` | `WM/ŠtevilkaSledi` | `ŠTEVILKA SLEDI` | `IPRT` ali `ITRK`
Žanr | `TCON` | `TCON` | `©gen` | `WM/Zvrst` | `ŽANR` | `IGNR`
Izvajalec albuma | `TPE2` | `TPE2` | `aART` | `WM/Izvajalec albuma` | `ALBUMARTIST` |
Aranžer | `IPLS` | `TIPL` | `ARANŽER` | `WM/Producent` | `ARANŽER` | `IENG`
Avtor | `TOLY` | `TOLY` | `AVTOR` |  | `AVTOR` |
BPM | `TBPM` | `TBPM` | `tmpo` | `WM/TaktovNaMinuto` | `BPM` | `IBPM`
Kataloška številka | `TXXX: ŠTEVILKA KATALOGA` | `TXXX: ŠTEVILKA KATALOGA` |  |  | `KATALOŠKAŠTEVILKA` |
Kompilacija | `TCMP` | `TCMP` | `cpil` |  | `KOMPILACIJA` |
Skladatelj | `TCOM` | `TCOM` | `©wrt` | `WM/Skladatelj` | `SKLADATELJ` | `IMUS`
Dirigent | `TPE3` | `TPE3` | `DIRIGENT` | `WM/Dirigent` | `DIRIGENT` |
Avtorske pravice | `TCOP` | `TCOP` | `cprt` | `Avtorske pravice` | `AVTORSKE PRAVICE` | `ICOP`
Opis | `TIT3` | `TIT3` | `desc` | `WM/Opis podnaslova` | `OPIS` |
Številka diska | `TPOS` | `TPOS` | `disk` | `WM/PartOfSet` | `ŠTEVILKA DISKA` |
Kodirano | `TENC` | `TENC` | `©enc` | `WM/EncodedBy` | `KODIRANO` | `ITCH`
Nastavitve kodirnika | `TSSE` | `TSSE` | `©too` | `WM/Nastavitve kodiranja` | `NASTAVITVE KODIRNIKA` | `ISFT`
Čas kodiranja |  | `TDEN` |  | `WM/ČasKodiranja` | `ČAS KODIRANJA` | `IDIT`
Združevanje v skupine | `GRP1` | `GRP1` | `©grp` |  | `ZDRUŽEVANJE` |
Začetni ključ | `TKEY` | `TKEY` |  | `WM/ZačetniKljuč` | `INITIALKEY` |
ISRC | `TSRC` | `TSRC` | `ISRC` | `WM/ISRC` | `ISRC` | `ISRC`
Jezik | `TLAN` | `TLAN` | `JEZIK` | `WM/Jezik` | `JEZIK` | `ILNG`
Pisec besedil | `BESEDILO` | `BESEDILO` | `BESEDNIK` | `WM/Pisatelj` | `BESEDNIK` | `IWRI`
Besedila | `USLT` | `USLT` | `©lyr` | `WM/Besedilo` | `BESEDILO` |
Mediji | `TMED` | `TMED` | `SOURCEMEDIA` |  | `SOURCEMEDIA` | `IMED`
Razpoloženje |  | `TMOO` |  | `WM/Razpoloženje` | `RAZPOLOŽENJE` |
Originalni album | `TOAL` | `TOAL` | `ORIGINALALBUM` | `WM/OriginalAlbumTitle` | `ORIGINALALBUM` |
Izvirni umetnik | `TOPE` | `TOPE` | `IZVIRNI UMETNIK` | `WM/OriginalArtist` | `IZVIRNI UMETNIK` |
Prvotni datum | `TORY` | `TDOR` | `ORIGINALNI DATUM` | `WM/OriginalReleaseYear` | `ORIGINALNI DATUM` |
Izvajalec | `IPLS` | `TMCL` | `IZVAJALEC` |  | `IZVAJALEC` | `ISTRA`
Slika | `APIC` | `APIC` | `covr` | `WM/Slika` | `METADATA_BLOCK_PICTURE` |
Založnik | `TPUB` | `TPUB` | `ZALOŽNIK` | `WM/založnik` | `ZALOŽNIK` | `IPUB`
Ocena | `POPM` | `POPM` | `ocena` | `WM/SharedUserRating` | `OCENA` | `IRTD`
Država izdaje | `TXXX:RELEASECOUNTRY` | `TXXX:RELEASECOUNTRY` |  |  | `RELEASECOUNTRY` | `ICNT`
Datum izdaje |  | `TDRL` | `DATUM IZDAJE` |  | `DATUM IZDAJE` |
Remixer | `TPE4` | `TPE4` | `REMIXER` | `WM/ModifiedBy` | `REMIXER` | `IEDT`
Razvrsti album | `TSOA` | `TSOA` | `soal` | `WM/AlbumSortOrder` | `ALBUMSORT` |
Razvrsti izvajalca albuma | `TSO2` | `TSO2` | `soaa` |  | `ALBUMARTISTSORT` |
Razvrsti umetnika | `TSOP` | `TSOP` | `soar` | `WM/ArtistSortOrder` | `ARTISTSORT` |
Razvrsti Skladatelja | `TSOC` | `TSOC` | `soco` |  | `COMPOSERSORT` |
Razvrsti ime | `TSOT` | `TSOT` | `sonm` | `WM/TitleSortOrder` | `TITLESORT` |
Podnaslov |  | `TSST` | `PODNASLOV` | `WM/Podnaslov` | `PODNASLOV` | `PRT1`
Spletna stran | `WOW` | `WOW` | `SPLETNA STRAN` | `WM/AuthorURL` | `SPLETNA STRAN` | `IBSU`
Delo | `TIT1` | `TIT1` | `©wrk` | `WM/ContentGroupDescription` | `DELO` |
Zvočna datoteka WWW | `WOAF` | `WOAF` |  | `WM/URL zvočne datoteke` | `WWWAUDIOFILE` |
Zvočni vir WWW | `WOAS` | `WOAS` |  | `WM/AudioSourceURL` | `​WWWAUDIOSOURCE` |

Opombe glede preslikav v poenotena imena okvirjev:

- Število poenotenih imen okvirjev je omejeno z dejstvom, da mora biti smiselna preslikava možna za vse podprte formate datotek. Večina oznak podpira okvirje s poljubnimi imeni; ti bodo uporabljeni, če ni na voljo noben poseben okvir (npr. imena z velikimi črkami v stolpcu MP4). Če taka možnost ne obstaja, nekatere vrste okvirjev morda ne bodo podprte za format, npr. Avtor in izvajalec za ASF (WMA).

- Preslikave niso izbrane poljubno, ampak so prilagojene uporabi okvirjev v drugih aplikacijah in napravah. Tako okvir ID3v2 "TPE2 - Band/orkester/spremljava" ne nakazuje njegove uporabe kot izvajalca albuma, vendar se to pogosto uporablja. Dejanski pomen za ID3v2 je po drugi strani razlog, zakaj se ta okvir uporablja za orkester pri uvozu (npr. iz Discogs), čeprav se to morda zdi nekoliko nenavadno za druge formate oznak.

- Preslikave niso vedno bijektivne. Torej ID3v2.3 uporablja okvir IPLS za aranžerja in izvajalca. Pri branju nazaj sta oba okvirja prikazana kot "Aranžer".

- Okvirja Aranžer in Izvajalec uporabljata določeno obliko za svojo vsebino: "udeležba 1|udeleženec 1|udeležba 2|udeleženec 2|...", na primer "zborovodja|Ernst Dunshirn|sopran vokal|Anna Netrebko". To bo ustvarilo okvire IPLS (ID3v2.3) ali TIPL/TMCL (ID3v2.4) s seznamom nizov v podani obliki ("|" se uporablja kot ločilo med nizi). Vrednosti v tej obliki so nastavljene tudi pri uvozu podatkov s strežnikov, ki ponujajo te informacije.

- Če želite eksplicitno uporabiti določeno ime okvira, ki je v nasprotju z imenom poenotenega okvira, pred okvir dodajte klicaj. Če na primer dodate okvir vrste »`Media`« v komentar Vorbis, bo zaradi poenotenega preslikave tipa ustvarjen okvir z imenom »`SOURCEMEDIA`«. Če želite dodati okvir z imenom »`MEDIA`« in ne »`SOURCEMEDIA`«, uporabite »`!MEDIA`«, da vsilite izrecno ime.

- Če potrebujete okvir, ki ga ni na tem seznamu, lahko še vedno vnesete poljubna imena z gumbom Dodaj. Pogosto uporabljena imena okvirjev lahko dodate v Okvirje po meri v konfiguraciji Oznake in bodo nato na voljo v Okvirih za hitri dostop.

#### Sinhronizirana besedila in časovne kode dogodkov

Za informacije, sinhronizirane z zvočnimi podatki, je na voljo poseben urejevalnik. Ti okvirji so podprti za oznake ID3v2.3.0 in ID3v2.4.0. Če želite dodati takšen okvir, morate na seznamu, ki se prikaže, ko kliknete gumb Dodaj, izbrati določeno ime okvirja - Sinhronizirana besedila ali Časovne kode dogodkov oziroma. Urejevalnik je za oba tipa enak, za časovne kode dogodkov je na voljo le vnaprej določen nabor dogodkov, za sinhronizirana besedila pa je treba vnesti besedilo. V nadaljevanju je razloženo urejanje sinhroniziranih besedil.

Izbrana je datoteka z oznako ID3v2, urejevalnik besedil se vnese z Dodaj in izbiro Sinhronizirana besedila. Za obstoječi okvir sinhroniziranega besedila je izbran in kliknite Uredi. Predvajalnik se samodejno odpre s trenutno datoteko, tako da je datoteko mogoče predvajati in začasno ustaviti za sinhronizacijo besedil.

Nastavitve na vrhu urejevalnika SYLT običajno ni treba spreminjati. Če besedilo vsebuje znake, ki jih ni v naboru znakov Latin 1, je priporočljivo spremeniti kodiranje besedila v UTF16 (ali UTF8 za ID3v2.4.0). Za angleška besedila in največjo združljivost je treba uporabiti ISO-8859-1.

Razdelek Besedilo ima na vrhu pet gumbov. Dodaj doda nov časovni dogodek v tabelo. Čas se vzame od položaja predvajalnika, zato bo dodajanje vnosa med predvajanjem skladbe dodalo vrstico za trenutno predvajano pozicijo. Dogodki v tabeli morajo biti razvrščeni kronološko, zato bo vrstica ustrezno vstavljena. Vnosi z neveljavnim časom se obravnavajo posebej: če ima trenutno izbrana vrstica neveljaven čas, bo njen časovni žig zamenjan s trenutnim časom, namesto dodajanja nove vrstice. Če trenutni čas ni neveljaven, bo uporabljena prva vrstica z neveljavnim časom, če je na voljo. To vedenje bi moralo olajšati dodajanje časovnih žigov, če je besedilo besedila že v tabeli, vendar časovni žigi manjkajo (kar se zgodi pri uvozu nesinhroniziranih besedil). Upoštevajte, da je neveljaven čas predstavljen kot 00:00.00, tj. enako kot čas na absolutnem začetku skladbe, ki ni neveljaven. Če želite, da je čas neveljaven, pritisnite tipko Izbriši ali uporabite Počisti v priročnem meniju. Nove vrstice, vstavljene z Vstavi vrstico iz priročnega menija ali ustvarjene pri uvažanju nesinhroniziranih besedil z Iz odložišča ali Uvozi, prav tako vsebujejo neveljavne časovne žige. Vrstice v tabeli lahko izbrišete s klikom na gumb Izbriši ali z uporabo Izbriši vrstice v priročnem meniju.

Sinhronizirana besedila lahko uvozite iz datoteke z Uvozi. Pričakovani format je preprost ali izboljšan LRC. Če izbrana datoteka v prvi vrstici ne vsebuje oglatega oklepaja, naj bi šlo za preprosto besedilno datoteko z nesinhroniziranimi besedili. Vrstice iz takšne datoteke se nato uvozijo z neveljavnimi časovnimi žigi. Informacije o času lahko dodate z gumbom Dodaj ali z ročnim vnosom. Možno je tudi uvoziti besedila s kopiranjem in lepljenjem z uporabo Iz odložišča. Sinhronizirana besedila lahko zapišete v datoteke LRC z Izvozi. Upoštevajte, da bodo izvoženi samo vnosi z veljavnimi časovnimi žigi in da bodo vnosi razvrščeni po času. Vnosi z neveljavnim časom prav tako ne bodo shranjeni v okvir SYLT, zato se prepričajte, da ste vključili vse informacije o času, preden zapustite pogovorno okno.

Specifikacija ID3 predlaga časovni žig za vsak zlog. Vendar večina igralcev podpira samo razdrobljenost vrstice ali stavka. Za podporo obeh primerov uporabe je &kid3; upošteva enake konvencije kot urejevalnik SYLT. Predvideva se, da se besedilo, vneseno v tabelo, začne v novi vrstici, razen če se začne s presledkom ali vezajem. Izjeme od tega pravila so možne tako, da začnete vrstico s podčrtajem ('_'), da vsilite nadaljevanje, ali z oznako ('#'), da vsilite novo vrstico. Ti ubežni znaki niso shranjeni znotraj okvira SYLT. Znotraj okvirja SYLT se nove vrstice začnejo z znakom za pomik vrstice (hex 0A), medtem ko se nadaljevanja ne. Ko bere okvirje SYLT, &kid3; preveri, ali se prvi vnos začne s pomikom vrstice. Če temu ni tako, se predpostavlja, da so vsi vnosi nove vrstice in da niso uporabljena nobena nadaljevanja zlogov.

Med predvajanjem skladbe je vrstica, povezana s trenutnim položajem predvajanja, označena, tako da je mogoče preveriti pravilnost informacij o sinhronizaciji. Če je treba enemu ali več časovnim žigom dodati odmik, lahko to storite s kontekstnim menijem Dodaj odmik. Negativne vrednosti se lahko uporabijo za skrajšanje časa. Z uporabo Poišči do položaja v kontekstnem meniju je možno nastaviti položaj predvajanja na čas izbrane vrstice.

Priporočeni postopek za dodajanje novih sinhroniziranih besedil

- Pridobite nesinhronizirana besedila, npr. z uporabo Besedila Vdelaj besedila iz kontekstnega menija seznama datotek.

- Kopirajte nesinhronizirana besedila v odložišče, pojdite v vrstico Besedila v tabeli z okvirji in pritisnite &Ctrl;C.

- Dodajte okvir za sinhronizirano besedilo (Dodaj ..., Sinhronizirano besedilo, V redu), kliknite Iz odložišča.

- Zdaj so vse vrstice iz nesinhroniziranih besedil v tabeli, vsi časovni žigi so neveljavni (0:0:0.00). Prazne vnose lahko predhodno izbrišete.

- Začnite predvajati skladbo s klikom na gumb za predvajanje ► v orodni vrstici za predvajanje na dnu glavnega okna.

- Ko pride naslednja vrstica besedila z neveljavnim časovnim žigom, kliknite Dodaj ali pritisnite &Alt;A, časovni žig bo posodobljen.

- Nadaljujte tako, dokler niso nastavljeni vsi časovni žigi. Če ste kaj zamudili, ustavite predvajanje in počistite časovne žige s tipko Izbriši ali tako, da jih izberete in uporabite Počisti v priročnem meniju. Če želite ponovno zagnati predvajanje od danega časovnega žiga, uporabite Poišči do položaja v priročnem meniju.

#### Poglavja v datotekah MP4

Zvočne knjige MP4 imajo običajno pripono `.m4b` in so precej velike, ker vsebujejo vsa poglavja v eni sami datoteki. Za krmarjenje po takih datotekah lahko vsebujejo oznake poglavij, ki jih je mogoče urejati v &kid3; v okvirju psevdo "poglavja" z istim urejevalnikom, ki se uporablja za sinhronizirana besedila. Upoštevajte pa, da je ta funkcija na voljo samo z vtičnikom Mp4v2Metadata, zato se prepričajte, da je aktivirana in nad vtičnikom TaglibMetadata v Vtičnikih zavihek nastavitev, če morate urejati poglavja MP4.

Informacije o poglavjih v zvočnih knjigah MP3 so shranjene v več okvirjih "Poglavje" (CHAP), na katere se sklicuje okvir "Kazalo vsebine" (CTOC), ti okvirji pa imajo vdelane podokvirje. Za urejanje teh informacij na enem mestu se lahko za oznake ID3v2 uporabi tudi psevdo okvir "Poglavja". Njegova vsebina se uporablja za ustvarjanje dejanskega poglavja, kazala vsebine in vdelanih okvirjev: stolpec Opis se uporablja kot naslov kazala vsebine, stolpec Besedilo vsebuje naslove poglavij, ustrezna vrednost Čas pa bo začetni in končni čas poglavja prejšnjega poglavja. Končni čas zadnjega poglavja je določen z Časom zadnje vrstice, če je njeno Besedilo prazno.

### Meni Datoteka

&Ctrl;O Datoteka Odpri...

- Odpre mapo. Vse datoteke, ki se ujemajo z izbranim filtrom imena datoteke, bodo prikazane na seznamu datotek in izbrana datoteka bo izbrana.

Datoteka Odpri nedavno

- Odpre nedavno odprto mapo.

&Ctrl;D Datoteka Odpri mapo...

- Odpre mapo. Vse datoteke, ki se ujemajo z izbranim filtrom imena datoteke, bodo prikazane na seznamu datotek.

F5 Datoteka Znova naloži

- Znova naloži mapo. Spremenjene datoteke je treba prej shraniti. Razširjene podmape bodo strnjene.

&Ctrl;S Datoteka Shrani

- Shrani vse spremenjene datoteke v mapo. Spremenjene datoteke so označene s simbolom diska na seznamu datotek. Če so bila imena datotek spremenjena, bodo te datoteke preimenovane.

Datoteka Razveljavi

- Razveljavi spremembe ene ali več datotek. Če na seznamu datotek ni izbrana nobena datoteka, bodo razveljavljene spremembe vseh datotek, drugače pa samo spremembe izbranih datotek.

Datoteka Uvoz...

- Pogovorno okno za uvoz lahko uporabite za uvoz podatkov neposredno s strežnika freedb.org, s strežnika MusicBrainz, iz Discogs, Amazon ali drugih virov seznamov skladb albuma v besedilni obliki.

  Uvoz s strežnika freedb.org je možen s pogovornim oknom, ki se prikaže, ko izberete Iz strežnika: gnudb.org. Izvajalca in ime albuma za iskanje lahko vnesete v obe zgornji polji, albumi, ki se ujemajo s poizvedbo, bodo prikazani, ko kliknete Najdi, in rezultati iz www.gnudb.org so prejeti. Podatke o skladbi za album uvozite tako, da dvokliknete album na seznamu. Izberete lahko strežnik freedb.org za uvoz, kot tudi pot CGI. Uvoženi podatki so prikazani v tabeli predogleda pogovornega okna za uvoz. Ko ste zadovoljni s prikazanimi skladbami, jih lahko uvozite tako, da končate uvozno pogovorno okno z V redu.

  Če imate v spletnem brskalniku že odprt rezultat iskanja, lahko URL vnesete v prvo iskalno polje. Rezultat se bo nato pojavil na seznamu albumov in ga je mogoče neposredno uvoziti v &kid3;.

  E-poštni naslov, registriran na gnudb.org, lahko vnesete v polje Žeton.

  Iskanje na strežniku Discogs lahko izvedete z Discogs. Kot v pogovornem oknu gnudb.org lahko vnesete izvajalca in album ter nato izberete s seznama izdaj. Žeton lahko vnesete za uporabo API-ja RESTful Discogs namesto njihovega spletnega vmesnika, ki se pogosto spreminja in s tem prekine razčlenjevalec uvoza. Registrirati se morate na račun na Discogs in nato ustvariti žeton na njihovi spletni strani (Nastavitve/Razvijalci, Ustvari nov žeton). Po vnosu žetona ne pozabite Shrani nastavitve, da ga boste lahko uporabili tudi v naslednjih zahtevah. Če so Standardne oznake označene, so uvožene standardne informacije, npr. izvajalec, album in naslov. Če so označene Dodatne oznake, je uvoženih več informacij, če so na voljo, npr. izvajalci, aranžerji ali založniki. Če je označena Cover Art, bo prenesena naslovnica, če je na voljo.

  Iskanje na Amazonu lahko izvedete z Amazon. Kot v pogovornem oknu gnudb.org lahko vnesete izvajalca in album ter nato izberete s seznama izdaj. Če so označene Dodatne oznake, je uvoženih več informacij, če so na voljo, npr. izvajalci, aranžerji ali založniki. Če je označena Cover Art, bo prenesena naslovnica, če je na voljo.

  Na enak način lahko iščete v zbirki podatkov o izdajah MusicBrainz z uporabo Iz izdaje MusicBrainz. Potek dela je enak opisanemu za Iz gnudb.org.

  Uvoz iz strežnika MusicBrainz je možen s pogovornim oknom, ki se prikaže, ko izberete Iz prstnega odtisa MusicBrainz. Strežnik lahko izberete kot v pogovornem oknu za uvoz freedb. Spodaj je tabela, ki prikazuje uvožene podatke o skladbah. Desni stolpec prikazuje stanje poizvedbe MusicBrainz, ki se začne z "V čakanju", ko se odpre pogovorno okno. Nato se prstni odtis poišče in če ne prinese rezultata, se poskusi z drugim iskanjem z uporabo oznak v datoteki. Tako je lahko za uspešno poizvedbo MusicBrainz v pomoč shranjevanje znanih informacij (npr. izvajalec in album) v oznake pred uvozom. Če je bil najden rezultat, se iskanje konča v stanju "Prepoznano", sicer ni bilo najdeno nič ali pa je več dvoumnih rezultatov in mora uporabnik izbrati enega od njih. V redu in Uporabi uporabita uvožene podatke, Prekliči zapre pogovorno okno. Zapiranje lahko traja nekaj časa, saj je treba zapreti celoten postroj MusicBrainz.

  Za uvoz besedilnih podatkov Iz datoteke/odložišča odpre podpogovorno okno, kjer je na voljo več vnaprej nastavljenih formatov za uvoz. Prva dva, »CSV brez navedb« in »CSV naveden«, lahko uporabite za uvoz podatkov, ki so bili izvoženi v pogovornem oknu Izvozi. Podatke CSV je mogoče urejati s preglednico in morajo biti zapisani z uporabo tabulatorjev kot ločil. Uvoz naj bi bil nato mogoč z uporabo "CSV naveden", ki je bolj prilagodljiv kot "CSV brez navedb". Vendar njegova polja ne smejo vsebovati dvojnih narekovajev. Če izvozite samo iz &kid3; in uvozite pozneje, lahko za ta namen kot preprosto obliko uporabite »CSV brez navedb«. Upoštevajte, da sta v kontekstnem meniju seznama datotek tudi ukaza »Izvozi CSV« in »Uvozi CSV«, ki uporabljata skripte za izvoz in uvoz podatkov CSV na popolnejši, zmogljivejši in prilagodljivejši način.

  Naslednjo obliko, "freedb &HTML; besedilo", lahko uporabite za kopiranje informacij iz &HTML; strani freedb.org. Poiščite album v freedb in če so želene informacije prikazane v spletnem brskalniku, kopirajte vsebino v odložišče. Nato kliknite gumb Iz odložišča in uvožene skladbe bodo prikazane v tabeli predogleda na vrhu pogovornega okna. Če ste zadovoljni z uvoženimi podatki, zaključite pogovorno okno z V redu, ki bo vstavila podatke v oznake trenutne mape. Cilj (Oznaka 1, Oznaka 2 ali Oznaka 1 in Oznaka 2) lahko izberete s kombiniranim poljem. Datoteke v trenutni mapi morajo biti v pravilnem vrstnem redu sledi, da se jim dodelijo oznake. To velja, če so oštevilčene.

  Uporabite lahko naslednji vnaprej konfigurirani format uvoza, "freedb &HTML; vir", če so podatki na voljo kot &HTML; dokument. Uvoz je možen z gumbom Iz datoteke, ki odpre izbirnik datotek, ali kopiranjem njene vsebine iz urejevalnika in nato uvozom iz odložišča. Ta oblika je lahko uporabna za uvoz brez povezave, čeprav &HTML; dokument lahko odprete tudi v brskalniku in ga nato uvozite v prvi obliki prek odložišča.

  Na voljo je več vnaprej konfiguriranih formatov, npr. »Track Title Time«. Prazen format po meri lahko ustvarite z Dodaj, ki ga nastavi uporabnik. Dve vrstici pod imenom formata lahko nastavite z regularnim izrazom za zajem polj iz uvoženega besedila. Prvi regularni izraz bo razčlenjen enkrat na dokument, da se zberejo podatki za album, kot so izvajalec, album, leto in žanr. Druga vrstica se poskuša ujemati od začetka dokumenta do konca, da se pridobijo podatki o skladbi, običajno številka in naslov. Regularni izrazi vključujejo vse funkcije, ki jih ponuja &Qt;, kar je večina tega, kar ponuja Perl. Konstrukti v oklepajih "(..)" ustvarijo medpomnilnike za zajemanje za polja za uvoz in pred njimi je &kid3; posebne kode za določitev polja za zajem. Kode so enake, kot se uporabljajo za format imena datoteke, poleg kod, navedenih spodaj, je možno poljubno ime okvira:

  - %s %{title} Naslov (Pesem)

  - %a %{artist} Umetnik

  - %l %{album} Album

  - %c %{comment} Komentar

  - %y %{year} Leto

  - %t %{track} Sled

  - %g %{genre} Žanr

  - %d %{duration} Trajanje

  Na primer, regularni izraz skladbe (druga vrstica) za uvoz s seznama predvajanja `.m3u` bi lahko bil "`%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]`". Vse formate lahko spremenite tako, da uredite regularne izraze in ime ter nato kliknete Shrani nastavitve. Shranjeni bodo v datoteki `kid3rc` v konfiguracijski mapi. To datoteko je mogoče neposredno urejati, da bo imela več uvoznih formatov, ali pa jo lahko izbrišete, da se povrnete na privzete formate. Formate lahko izbrišete z Odstrani.

  Natančnost prikazuje oceno, kako dobro se uvožene informacije ujemajo z danimi skladbami. Za izračun stopnje podobnosti v odstotkih uporablja trajanje skladb ali imena datotek. Naslovnica prikazuje &URL; slike naslovnice albuma, ki bo prenesena.

  Če želite preveriti, ali se uvožene skladbe ujemajo s trenutnim naborom datotek, lahko trajanje uvoženih skladb primerjate s trajanjem datotek. To možnost lahko omogočite s potrditvenim poljem Preveri največjo dovoljeno časovno razliko (sek): in največjo dovoljeno časovno razliko lahko nastavite v sekundah. Če se zazna neujemanje v dolžini, je dolžina prikazana z rdečim ozadjem v tabeli predogleda.

  Če so datoteke urejene drugače kot uvožene skladbe, je treba njihove dodeljene skladbe spremeniti. To opravilo lahko olajšate z možnostjo Uskladi z z gumbi Dolžina, Sled in Naslov, ki bo preuredite skladbe v skladu z ustreznim poljem. Če želite ročno popraviti dodelitve, lahko skladbo povlečete z levo tipko miške in &Ctrl; tipko držite pritisnjeno in nato spustite na novo mesto.

  Če je več uvoženih skladb kot datotek, kot v primeru, da trenutna mapa vsebuje samo drugo ploščo albuma z dvema ploščama, uvožene pa so skladbe obeh plošč, je možno izbrisati skladbe prve plošče tako, da jih izberete s klikom na na oznako vrstice prve skladbe, nato kliknite na oznako vrstice zadnje skladbe prvega diska, medtem ko držite tipko Shift in na koncu odstranite skladbe s pritiskom tipke Delete.

  Ko se odpre pogovorno okno za uvoz, vsebuje dejansko vsebino oznak. Vrsto oznake (Oznaka 1, Oznaka 2, Oznaka 1 in Oznaka 2) lahko izberete s kombiniranim poljem Cilj. Gumb na desni strani tega kombiniranega polja lahko uporabite za povrnitev tabele na trenutno vsebino oznak. Potrditvena polja v prvem stolpcu tabele lahko uporabite za izbiro skladb, ki se uvozijo. To je lahko uporabno, če mapa vsebuje skladbe obeh &CD;-jev dvojnega &CD; in samo skladbe drugega &CD; je treba uvoziti.

  Za identifikacijo uvoženih skladb je mogoče prikazati imena datotek ali celotne poti do datotek z uporabo kontekstnega menija glave tabele. Vrednosti v uvozni tabeli je mogoče urejati. Gumb za povrnitev na desni strani kombiniranega polja Cilj lahko uporabite za obnovitev vsebine oznak, kar je lahko koristno tudi po spremembi Cilja.

  Skoraj vsa pogovorna okna imajo gumb Shrani nastavitve, ki ga lahko uporabite za stalno shranjevanje specifičnih nastavitev pogovornega okna in velikosti okna.

  Iz oznak vodi do podpogovornega okna za nastavitev okvirjev oznak iz vsebine drugih okvirjev oznak. To lahko uporabite za preprosto kopiranje informacij med oznakami ali ekstrahiranje dela iz enega okvira in vstavljanje v drugega.

  Tako kot v pogovornem oknu uvozi iz datoteke/odložišča obstajajo prosto nastavljivi formati za izvajanje različnih operacij. Že vnaprej konfigurirani so formati za kopiranje vrednosti albuma v izvajalca albuma, skladatelja ali dirigenta in za ekstrahiranje številke skladbe iz polj naslova, ki vsebujejo številko. Obstaja tudi oblika za ekstrahiranje podnapisov iz polja naslova.

  Naslednji primer pojasnjuje, kako dodati obliko po meri, ki nastavi informacije iz polja Podnapisi tudi v polje Komentar. Z gumbom Dodaj ustvarite novo obliko in nastavite novo ime, npr. »Podnaslov za komentar«. Nato vnesite »`%{subtitle}`« v Vir in »`%{comment}(.*)`« za Izvleček in kliknite Shrani nastavitve.

  Izraz v Viru lahko vsebuje kode oblike za poljubne okvirje oznak, več kod je mogoče uporabiti za kombiniranje vsebine iz različnih okvirjev. Za vsako skladbo je besedilo ustvarjeno iz njenih oznak z uporabo formata Vir , regularni izraz iz Izvleček pa se uporabi za to besedilo, da nastavi nove vrednosti za oznake. Kode formata se uporabljajo pred oklepaji za zajemanje, da se določi okvir oznake, kamor bo shranjeno zajeto besedilo. Deluje na enak način kot uvoz iz datoteke/odložišča.

  Uvoz iz oznak... je prav tako na voljo neposredno iz menija Datoteka. Razlika med tema dvema funkcijama je v tem, da podpogovorno okno za uvoz deluje na vseh datotekah trenutne mape, medtem ko funkcija menija deluje na izbranih datotekah (ki so lahko v različnih mapah). Menijska funkcija podpira dodatno kodo »`%{__return}`« za vrnitev ekstrahirane vrednosti, kar je lahko uporabno pri vmesnikih CLI in QML.

Datoteka Uvoz iz gnudb.org...

- Uvozi s strežnika freedb.org z iskanjem albumov gnudb.org. Ta menijski element odpre isto pogovorno okno za uvoz kot Uvozi..., vendar neposredno odpre gnudb .org pogovorno okno.

Datoteka Uvoz iz Discogs...

- Uvozi iz strežnika Discogs. Ta menijski element odpre isto pogovorno okno za uvoz kot Uvozi..., vendar neposredno odpre pogovorno okno Iz Discogs.

Datoteka Uvoz iz Amazona...

- Uvoz iz Amazona. Ta menijski element odpre isto pogovorno okno za uvoz kot Uvoz ..., vendar odpre neposredno pogovorno okno Iz Amazona.

Datoteka Uvoz iz MusicBrainz Release...

- Uvozi iz zbirke podatkov o izdaji MusicBrainz. Ta element menija odpre isto pogovorno okno za uvoz kot Uvoz..., vendar odpre neposredno pogovorno okno Iz izdaje MusicBrainz.

Datoteka Uvoz iz prstnega odtisa MusicBrainz...

- Uvoz iz strežnika MusicBrainz. Ta menijska postavka odpre isto pogovorno okno za uvoz kot Uvoz..., vendar odpre neposredno pogovorno okno Iz prstnega odtisa MusicBrainz.

Datoteka Uvoz iz oznak...

- Kot Iz oznak, vendar se uvoz uporabi za izbrane datoteke.

Datoteka Samodejni uvoz...

- Samodejni uvoz omogoča uvoz informacij za več albumov iz različnih spletnih storitev. Če so na seznamu datotek izbrane mape, bodo uvoženi podatki o skladbah za izbrane mape. Če ni izbrana nobena mapa, bodo uvožene vse mape na seznamu datotek.

  Vrsto oznake (Oznaka 1, Oznaka 2, Oznaka 1 in Oznaka 2) lahko izberete s kombiniranim poljem Cilj.

  Profili določajo, kateri strežniki bodo vzpostavljeni v stik za pridobivanje informacij o albumu. Nekateri profili so vnaprej določeni (Vsi, MusicBrainz, Discogs, Cover Art), profile po meri lahko dodate z gumbom Dodaj na desni strani kombiniranega polja Profil.

  Spodnja tabela prikazuje strežnike, ki bodo uporabljeni pri uvozu informacij o albumu z izbranim profilom. Postopek uvoza za album je končan, če so bili najdeni vsi zahtevani podatki, zato je vrstni red vrstic v tabeli pomemben. Spremenite ga lahko z gumboma Premakni gor in Premakni dol. Uredi lahko uporabite za spreminjanje obstoječega vnosa. Izbira Strežnik ponuja iste strežnike, kot jih je mogoče uporabiti v funkcijah uvoza. Standardne oznake, Dodatne oznake, Cover Art določajo informacije, ki jih je treba pridobiti s strežnika. Končno je Natančnost minimalna natančnost, ki mora biti dosežena za sprejem uvoženih podatkov. Če natančnost ni zadostna, bo poskusil naslednji strežnik na seznamu. Isto pogovorno okno z lastnostmi strežnika se prikaže, ko kliknete Dodaj, da dodate nov vnos strežnika. Obstoječe vnose lahko izbrišete z Odstrani.

  Za zagon samodejnega paketnega uvoza z izbranim profilom kliknite Začni. Podrobnosti o tekočem uvozu so prikazane na vrhu pogovornega okna. Postopek lahko prekinete z gumbom Prekini.

Datoteka Prebrskaj naslovnico...

- Pogovorno okno Prebrskaj naslovnico pomaga najti naslovnico albuma. Izvajalec/album se izpolni z oznakami, če je to mogoče. Vir ponuja različne spletne strani z naslovnico albuma. &URL; z izvajalcem in albumom kot parametroma najdete pod imenom. &URL;-kodirane vrednosti za izvajalca in album je mogoče vstaviti z uporabo "`%u{artist}`" in "`%u{album}`", možne so tudi druge vrednosti iz oznak prav tako, kot je opisano v Konfiguriraj &kid3;, Uporabniška dejanja. Za vnosom »Vir po meri« lahko vnesete več virov tako, da zamenjate »Vir po meri« z imenom vira, pritisnete Enter in nato vstavite &URL; in končno pritisnite Shrani nastavitve. Nastali ukaz brskalnika je prikazan na vrhu pogovornega okna in ga lahko zaženete s klikom na Prebrskaj. Brskalnik, ki ga lahko konfiguriramo v nastavitvah, se zažene z izbranim virom. Naslovno sliko lahko nato povlečete iz brskalnika v &kid3; okno in bo nastavljen v slikovni okvir izbranih datotek.

  Ker vsi brskalniki ne podpirajo tehnike povleci in spusti slik in imajo slike na spletnih mestih pogosto kot &URL;, v takih primerih bo &kid3; prejel &URL; in ne sliko. Če &URL; pokaže na sliko, bo prenesena. Vendar, če se &URL; nanaša na drug spletni vir, ga je treba prevesti na ustrezno sliko. Takšne preslikave so definirane v tabeli &URL; ekstrakcija. Levi stolpec Ujemanje vsebuje regularni izraz, ki se primerja z &URL;. Če se ujema, se zajeti izrazi v oklepajih vstavijo v vzorec desnega stolpca Slika &URL; (na položajih, označenih z \1 itd.). Zamenjani regularni izraz vsebuje &URL; slike. Na ta način je mogoče naslovnico uvoziti iz Amazona, Google Images, itd. z uporabo povleci in spusti. Prav tako je mogoče definirati lastne preslikave.

Datoteka Izvoz...

- Pogovorno okno za izvoz se uporablja za shranjevanje podatkov iz oznak v datoteko ali odložišče. Urejevalnik na vrhu prikazuje predogled podatkov za izvoz. Če izvozni podatki vsebujejo tabulatorske znake, je izvoz prikazan v tabeli. Podatki bodo ustvarjeni iz oznak v trenutni mapi v skladu s konfigurirano obliko.

  Nastavitve formata so podobne kot v pogovornem oknu za uvoz: Najvišje polje vsebuje naslov (npr. "CSV brez narekovajev"), ki mu sledi glava, ki bo ustvarjena na začetku datoteke. Sledijo podatki o stezi; uporablja se za vsako skladbo. Končno lahko napovednik uporabite za ustvarjanje končnega besedila.

  Polja formata ne vsebujejo regularnih izrazov kot v pogovornem oknu Uvozi, ampak le izraze izhodnega formata s posebnimi %-izrazi, ki bodo nadomeščeni z vrednostmi iz oznak. Celotna stvar deluje kot oblika imena datoteke in uporabljene so iste kode ter nekaj dodatnih kod. Uporabiti je mogoče ne le spodaj navedene kode, ampak vsa imena okvirjev oznak.

  - %s %{title} Naslov (Pesem)

  - %a %{artist} Umetnik

  - %l %{album} Album

  - %c %{comment} Komentar

  - %y %{year} Leto

  - %t %{track} Sled (npr. 01)

  - %t %{track.n} Sled s širino polja n (npr. 001 za %{track.3})

  - %T %{tracknumber} Sled (brez začetnih ničel, npr. 1)

  - %g %{genre} Žanr

  - %f %{file} Ime datoteke

  - %p %{filepath} Pot

  - %{modificationdate} Datum spremembe

  - %{creationdate} Datum ustvarjanja

  - %u %{url} &URL;

  - %{dirname} Ime mape

  - %d %{duration} Trajanje v minutah:sekundah

  - %D %{seconds} Trajanje v sekundah

  - %n %{tracks} Število skladb v albumu

  - %e %{extension} Končnica datoteke

  - %O %{tag1} Oblika oznake 1 (ID3v1.1 ali prazna, če ne obstaja)

  - %o %{tag2} Oblika oznake 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1, Vorbis, APE, MP4, ASF ali prazno, če ne obstaja)

  - %b %{bitrate} Bitna hitrost v kbit/s

  - %v %{vbr} VBR ali prazno (samo za ID3v2.3 z id3lib)

  - %r %{samplerate} Hitrost vzorčenja v Hz

  - %m %{mode} Kanalni način (Stereo ali Joint Stereo)

  - %h %{channels} Število kanalov (1 ali 2)

  - %k %{codec} kodek (npr. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV)

  Nekaj formatov je vnaprej določenih. "CSV brez narekovajev" ločuje polja z zavihki. Podatke v tej obliki je mogoče znova uvoziti v &kid3; z istoimensko obliko uvoza. »CSV naveden dodatno zapre polja z dvojnimi narekovaji, kar olajša uvoz v aplikacije za preglednice. Vendar polja ne smejo vsebovati dvojnih narekovajev, če je uporabljena ta oblika. »Extended M3U« in »Extended PLS« ustvarita sezname predvajanja z razširjenimi atributi in absolutnimi imeni poti. "HTML" lahko uporabite za ustvarjanje &HTML; stran s hiperpovezavami do skladb. "Kover &XML;" ustvari datoteko, ki jo lahko uvozi program za tiskanje naslovnic Kover. »Tehnične podrobnosti« zagotavljajo informacije o bitni hitrosti, hitrosti vzorčenja, kanalih, itd. Končno je »Oblika po meri« prazna za definicijo oblike po meri. Določite lahko več lastnih formatov z dodajanjem vrstic v datoteko `kid3rc` v konfiguracijski mapi. Ostale formate lahko prilagodimo vašim potrebam.

  Vir oznak za generiranje izvoznih podatkov (Oznaka 1 ali Oznaka 2) lahko izberete s kombiniranim poljem. Če pritisnete V datoteko ali V odložišče, se podatki shranijo v datoteko ali na odložišče. V redu in Prekliči zapreta pogovorno okno, V redu pa sprejme trenutne nastavitve pogovornega okna.

Datoteka Ustvari seznam predvajanja...

- Ustvari seznam predvajanja. Format in vsebino seznama predvajanja lahko nastavite z različnimi možnostmi.

  Ime seznama predvajanja je lahko Enako kot ime mape ali uporabite Obliko z vrednostmi iz oznak, npr. "`%{artist} - %{album}`", če želite ime izvajalca in albuma v imenu datoteke seznama predvajanja. Kode formata so enake kot za Izvoz. Seznam razpoložljivih formatov lahko urejate v razdelku Oblika na zavihku Datoteke v nastavitvah. Ustvari nov prazen seznam predvajanja ustvari prazen seznam predvajanja z danim imenom. Razširitev je odvisna od oblike seznama predvajanja.

  Lokacija ustvarjenega seznama predvajanja je določena z izbiro kombiniranega polja Ustvari v.

  Trenutna mapa

- Seznam predvajanja je ustvarjen v trenutni mapi in vsebuje samo datoteke trenutne mape. Trenutna mapa je mapa, v kateri se nahaja trenutna datoteka. Če je izbranih več datotek, je trenutna datoteka verjetno zadnja izbrana datoteka.

Vsaka mapa

- Seznam predvajanja je ustvarjen v vsaki mapi, ki vsebuje navedene datoteke, vsak seznam predvajanja pa vsebuje datoteke te mape.

Mapa najvišje ravni

- Samo en seznam predvajanja je ustvarjen v mapi na najvišji ravni (tj. mapa seznama datotek) in vsebuje navedene datoteke v mapi na najvišji ravni in vseh njenih podmapah.

Oblika seznama predvajanja je lahko M3U, PLS ali XSPF.

Če je označeno Vključi samo izbrane datoteke, bodo na seznam predvajanja vključene samo izbrane datoteke. Če je mapa izbrana, so izbrane vse njene datoteke. Če to potrditveno polje ni aktivirano, so vse zvočne datoteke vključene v seznam predvajanja.

Razvrsti po imenu datoteke izbere običajen primer, ko so datoteke razvrščene po imenu datoteke. Z Razvrsti po polju oznake je mogoče razvrstiti po nizu oblike z vrednostmi iz polj oznake. Na primer, »`%{track.3}`« lahko uporabite za razvrščanje po številki skladbe (»`.3`« se uporablja za pridobitev treh števk z začetnimi ničlami, ker nizi se uporabljajo za sortiranje). Možna je tudi uporaba več polj, npr. »`%{genre}%{year}`« za razvrščanje z uporabo niza, sestavljenega iz žanra in leta.

Vnosi v seznam predvajanja bodo imeli relativne ali absolutne poti datotek, odvisno od tega, ali je nastavljeno Uporabi relativno pot za datoteke na seznamu predvajanja ali Uporabi celotno pot za datoteke na seznamu predvajanja.

Ko je nastavljen Seznam datotek samo za pisanje, bo seznam predvajanja vseboval samo poti do datotek. Če želite ustvariti razširjen seznam predvajanja z dodatnimi informacijami, lahko nastavite formatni niz s kontrolnikom Zapiši informacije z uporabo.

&Ctrl;Q Datoteka Zapri

- Zapusti aplikacijo.

### Meni Urejanje

&Alt;A Uredi Izberi vse

- Izbere vse datoteke.

&Ctrl;Shift A Uredi Prekliči izbiro

- Prekliče izbiro vseh datotek.

Uredi Izberi vse v mapi

- Izbere vse datoteke trenutne mape.

&Alt;Gor Uredi Prejšnja datoteka

- Izbere prejšnjo datoteko.

&Alt;Dol Uredi Naslednja datoteka

- Izbere naslednjo datoteko.

&Ctrl;F Uredi Najdi...

- Poiščite nize v imenih datotek in oznakah. Pogovorno okno Najdi je podnabor pogovornega okna Zamenjaj, ki je opisano spodaj.

&Ctrl;R Uredi Zamenjaj...

- Ta funkcija odpre pogovorno okno za iskanje in zamenjavo nizov v imenih datotek in oznakah. Nabor okvirjev, kjer se izvaja iskanje, lahko omejite tako, da deaktivirate potrditveno polje Izberi vse in izberete okvire, po katerih se bo iskalo. Na voljo so tudi možnosti iskanja za iskanje nazaj, upoštevanje velikih in malih črk ter uporaba regularnih izrazov.

  Odvisno od števila datotek lahko iskanje traja nekaj časa, zato ga lahko prekinete tako, da zaprete pogovorno okno.

### Meni Orodja

Orodja Uporabi obliko imena datoteke

- Ko je Samodejno uporabi format izklopljen za format imena datoteke v konfiguracijskem pogovornem oknu, lahko ta menijski element uporabite za uporabo konfiguriranega formata za imena izbranih datotek. To lahko uporabite tudi za preverjanje, ali so imena datotek skladna s konfiguriranim formatom, tako da format uporabite za vse shranjene datoteke in nato preverite, ali so bile katere koli datoteke spremenjene (in zato označene s simbolom diska v seznamu datotek).

Orodja Uporabi obliko oznake

- Ko je Samodejno uporabi obliko izklopljena za obliko oznake v konfiguracijskem pogovornem oknu, lahko ta menijski element uporabite za uporabo konfigurirane oblike za oznake izbranih datotek. To lahko uporabite tudi za preverjanje, ali se oznake ujemajo s konfiguriranim formatom, tako da format uporabite za vse shranjene datoteke in nato preverite, ali so bile katere koli datoteke spremenjene (in zato označene s simbolom diska na seznamu datotek).

Orodja Uporabi kodiranje besedila

- Nastavi Kodiranje besedila, izbrano v Nastavitve Konfiguriraj &kid3;... Razdelek z oznakami Oznaka 2 zavihka za vse izbrane datoteke. Če je izbran UTF8, bo UTF16 uporabljen za oznake ID3v2.3.0, ker UTF8 ni podprt za ta format.

Orodja Preimenuj mapo...

- To pogovorno okno ponuja možnost samodejnega preimenovanja trenutno odprte mape glede na oznake v datotekah. Več formatov je vnaprej konfiguriranih za vključitev informacij o izvajalcu, albumu in letu v imenu mape. Prav tako je mogoče nastaviti obliko po meri in Urediti seznam razpoložljivih oblik. Za vstavljanje vrednosti oznak v ime mape se uporabljajo naslednje posebne kode:

  - %s %{title} Naslov (Pesem)

  - %a %{artist} Umetnik

  - %l %{album} Album

  - %c %{comment} Komentar

  - %y %{year} Leto

  - %t %{track} Sled (npr. 01)

  - %t %{track.n} Sled s širino polja n (npr. 001 za %{track.3})

  - %T %{tracknumber} Sled (brez začetnih ničel, npr. 1)

  - %g %{genre} Žanr

  - %{dirname} Ime mape (npr. %{year" "}%{dirname} bo dodal leto pred trenutno ime mape)

  - %{max-year} Največja letna vrednost, najdena za to mapo, se lahko uporablja tudi z drugimi kodami kot "year"

  - %{min-year} Najmanjša letna vrednost, najdena za to mapo

  - %{unq-year} Edinstvena letna vrednost, najdena za to mapo, ali prazna, če ni edinstvena

  Če je v formatu najdeno ločilo map »/«, se ustvari več map. Če želite ustvariti novo mapo namesto preimenovanja trenutne mape, v kombiniranem polju Dejanje izberite Ustvari mapo namesto Preimenuj mapo. Vir informacij o oznaki lahko izbirate med Oznako 1 in Oznako 2, Oznako 1 in Oznako 2. Predogled operacije preimenovanja, izvedene na prvi datoteki, si lahko ogledate v razdelkih Od in V pogovornega okna.

  Več map lahko preimenujete tako, da jih izberete.

Orodja Število sledi...

- Če številke sledi v oznakah niso nastavljene ali imajo napačne vrednosti, lahko ta funkcija samodejno oštevilči skladbe v naraščajočem vrstnem redu. Začetno število lahko nastavite v pogovornem oknu. Če je treba oštevilčiti le del skladb, jih je treba izbrati.

  Ko je označeno Skupno število skladb, bo število skladb nastavljeno tudi v oznakah.

  Skladbe je mogoče oštevilčiti v več mapah. Mape je treba razširiti in izbrati.

  Če je označeno Ponastavi števec za vsako mapo, se številčenje skladb znova začne z dano številko za vsako mapo, ko je izbranih več map.

  Pogovorno okno oštevilčenih sledi lahko uporabite tudi za oblikovanje obstoječih številk skladb brez spreminjanja vrednosti, ko je potrditveno polje levo na Začetna številka deaktivirano. Skupno število skladb bo dodano, če je aktivno potrditveno polje, ki ga lahko uporabite za nastavitev skupnega števila za vse izbrane skladbe. Če želite samo formatirati obstoječa števila, morate tudi to potrditveno polje deaktivirati.

Orodja Filter...

- Filter lahko uporabite za prikaz samo tistih datotek, ki ustrezajo določenim kriterijem. To je koristno, če želite organizirati veliko zbirko in urejati samo tiste datoteke, ki niso v želeni shemi. Izraz, ki določa, katere datoteke naj se prikažejo, uporablja iste kode formata, ki se uporabljajo v formatu imena datoteke, uvozu in izvozu.

  - %s %{title} Naslov (Pesem)

  - %a %{artist} Umetnik

  - %l %{album} Album

  - %c %{comment} Komentar

  - %y %{year} Leto

  - %t %{track} Sled (npr. 01)

  - %t %{track.n} Sled s širino polja n (npr. 001 za %{track.3})

  - %T %{tracknumber} Sled (brez začetnih ničel, npr. 1)

  - %g %{genre} Žanr

  - %f %{file} Ime datoteke

  - %p %{filepath} Absolutna pot do datoteke

  - %e %{extension} Končnica datoteke

  - %O %{tag1} Oblika oznake 1 (ID3v1.1 ali prazna, če ne obstaja)

  - %o %{tag2} Oblika oznake 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1, Vorbis, APE, MP4, ASF ali prazno, če ne obstaja)

  - %b %{bitrate} Bitna hitrost v kbit/s

  - %v %{vbr} VBR ali prazno (samo za ID3v2.3 z id3lib)

  - %r %{samplerate} Hitrost vzorčenja v Hz

  - %m %{mode} Kanalni način (Stereo ali Joint Stereo)

  - %h %{channels} Število kanalov (1 ali 2)

  - %k %{codec} kodek (npr. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV)

  - %w %{marked} Označeno, je 1, če je datoteka označena (npr. zaradi obrezovanja ali kršitve standarda), sicer je prazna

  - %1a %1{artist}, ... Za pridobitev vrednosti oznake 1 uporabite predpono 1

  - %2a %2{artist}, ... Za pridobitev vrednosti oznake 2 uporabite predpono 2

  Te kode se nadomestijo z vrednostmi za datoteko, nastale nize pa je mogoče primerjati z naslednjimi operacijami:

  - s1 je enako s2: res, če sta s1 in s2 enaka.

  - s1 vsebuje s2: res, če s1 vsebuje s2, tj. s2 je podniz s1.

  - s se ujema z re: true, če se s ujema z regularnim izrazom re.

  Resnični izrazi so nadomeščeni z 1, false z 0. True vrednosti so predstavljene z 1, true, on in yes, false vrednosti z 0, false, off in no. Logične operacije niso in ali (v tem prednostnem vrstnem redu) in jih je mogoče združiti v oklepaje.

  Nekatera pravila filtra so vnaprej določena in lahko služijo kot primeri za vaše lastne izraze:

  Vse

- Ko je seznam datotek filtriran - to je prikazano z "[filtered]" v naslovu okna - in bodo vse datoteke ponovno prikazane, je mogoče filtriranje razveljaviti s tem filtrom. Uporablja prazen izraz, vendar bi imela prava vrednost enak učinek.

Neujemanje oznake imena datoteke

- `not (%{filepath} contains "%{artist} - %{album}/%{track} %{title}")`

  Preveri, ali se pot datoteke ujema z obliko imena datoteke. To pravilo se samodejno prilagodi, če se spremeni format imena datoteke.

Brez oznake 1

- `%{tag1} equals ""`

  Prikaže samo datoteke, ki nimajo oznake 1.

Brez oznake 2

- `%{tag2} equals ""`

  Prikaže samo datoteke, ki nimajo oznake 2.

Oznaka ID3v2.3.0

- `%{tag2} equals "ID3v2.3.0"`

  Prikaže samo datoteke, ki imajo oznako ID3v2.3.0.

Oznaka ID3v2.4.0

- `%{tag2} equals "ID3v2.4.0"`

  Prikaže samo datoteke, ki imajo oznako ID3v2.4.0.

Tag 1 != Tag 2

- `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})`

  Prikaže datoteke z razlikami med tag 1 in tag 2.

Tag 1 == Tag 2

- `%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}`

  Prikaže datoteke z enako oznako tag 1 in tag 2.

Incomplete

- `%{title} equals "" or %{artist} equals "" or %{album} equals "" or %{year} equals "" or %{tracknumber} equals "" or %{genre} equals ""`

  Prikaže datoteke s praznimi vrednostmi v standardnih oznakah (naslov, izvajalec, album, datum, številka skladbe, žanr).

Brez slike

- `%{picture} equals ""`

  Prikaže samo datoteke, ki nimajo slike.

Označeno

- `not (%{marked} equals "")`

  Prikaže samo datoteke, ki so označene, ker kršijo standard ID3, so prirezane ali je slika prevelika.

Filter po meri

- Če želite dodati svoj filter, izberite ta vnos. Na primer, če želite imeti filter za izvajalce, ki se začnejo z "The", zamenjajte "Custom Filter" z imenom "The Bands" in pritisnite Enter. Nato vnesite naslednji izraz v urejanje vrstice:

  `%{artist} matches "The.*"`

  Nato kliknite Shrani nastavitve. Kliknite Uporabi, da filtrirate datoteke. Vse obdelane datoteke so prikazane v besedilnem pogledu, z "+" za tiste, ki ustrezajo filtru, in "-" za druge. Ko končate, so prikazane samo datoteke z izvajalcem, ki se začnejo z "The", naslov okna pa je označen z "[filtered]".

Orodja Pretvori ID3v2.3 v ID3v2.4

- Če so v izbranih datotekah oznake ID3v2.3, bodo te pretvorjene v oznake ID3v2.4. Okvirji, ki jih TagLib ne podpira, bodo zavrženi. Pretvorjene bodo samo datoteke brez neshranjenih sprememb.

Orodja Pretvori ID3v2.4 v ID3v2.3

- Če so v izbranih datotekah oznake ID3v2.4, bodo te pretvorjene v oznake ID3v2.3. Pretvorjene bodo samo datoteke brez neshranjenih sprememb.

Orodja Predvajaj

- To odpre preprosto orodno vrstico za predvajanje zvočnih datotek. Vsebuje gumbe za osnovne operacije (Predvajaj/Premor, Ustavi predvajanje, Prejšnja skladba, Naslednja skladba, Zapri), drsnike za položaj in glasnost ter prikaz trenutnega položaja. Če je izbranih več datotek, se predvajajo izbrane skladbe, sicer se predvajajo vse datoteke.

  Prikazani čas lahko preklapljate med pretečenim in preostalim časom s klikom na prikaz.

### Meni z nastavitvami

Nastavitve Pokaži orodno vrstico

- Preklopi prikaz orodne vrstice.

Nastavitve Pokaži vrstico stanja

- Preklopi prikaz vrstice stanja, ki prikazuje daljša dejanja, kot je odpiranje ali shranjevanje mape.

Nastavitve Pokaži sliko

- Preklopi prikaz predogleda slike naslovnice albuma.

Nastavitve Samodejno skrij oznake

- Če je ta možnost aktivna, se prazne oznake samodejno skrijejo. Razdelke Datoteka, Oznaka 1 in Oznaka 2 lahko ročno strnete in razširite s klikom na ustrezen -/ gumb +.

Nastavitve Konfiguriraj bližnjične tipke...

- Odpre pogovorno okno za dodelitev bližnjic na tipkovnici za večino funkcij programa. Obstajajo celo funkcije brez ustreznega menija ali gumba, npr. naslednja datoteka, prejšnja datoteka, izberi vse.

Nastavitve Konfiguriraj &kid3;...

- Odpre konfiguracijsko pogovorno okno, ki je sestavljeno iz strani za oznake, datoteke, uporabniška dejanja in omrežne nastavitve.

  Možnosti za posamezne oznake najdete na strani Oznake, ki je sama ločena na štiri zavihke za Oznako 1, Oznako 2, Oznako 3 in Vse oznake.

  Če je označeno Označi okrnjena polja, bodo okrnjena polja ID3v1.1 označena rdeče. Besedilna polja oznak ID3v1.1 imajo lahko le 30 znakov, komentar pa le 28 znakov. Tudi zvrst in številke skladb so omejene, tako da je mogoče polja pri uvozu ali prenosu iz ID3v2 skrajšati. Prirezana polja in datoteka bodo označeni rdeče, oznaka pa bo odstranjena, ko bo polje urejeno.

  Z Kodiranjem besedila za ID3v1 je mogoče nastaviti nabor znakov, uporabljen v oznakah ID3v1. To kodiranje naj bi bilo ISO-8859-1, zato je priporočljivo ohraniti to privzeto vrednost. Vendar pa obstajajo oznake z drugačnim kodiranjem, zato jih je mogoče nastaviti tukaj in oznake ID3v1 nato kopirati v ID3v2, ki podpira Unicode.

  Potrditveno polje Uporabi obliko skladbe/skupno število skladb nadzira, ali polje številke skladbe oznak ID3v2 vsebuje samo številko skladbe ali dodatno skupno število skladb v mapi.

  Ko je Žanr kot besedilo namesto številskega niza označen, bodo vse zvrsti ID3v2 shranjene kot besedilni niz, tudi če obstaja ustrezna koda za zvrsti ID3v1. Če ta možnost ni nastavljena, so žanri, za katere obstaja koda ID3v1, shranjeni kot številka kode žanra (v oklepaju za ID3v2.3). Tako je žanr Metal shranjen kot "Metal" ali "(9)", odvisno od te možnosti. Zvrsti, ki niso na seznamu zvrsti ID3v1, so vedno shranjene kot besedilni niz. Namen te možnosti je izboljšana združljivost z napravami, ki ne interpretirajo pravilno žanrskih kod.

  Ko je datoteke WAV z malimi črkami id3 chunk odkljukano, bo kos RIFF, ki se uporablja za shranjevanje oznak ID3v2 v datotekah WAV, imenovan "id3 " namesto "ID3 ". Privzeto &kid3; in druge aplikacije, ki uporabljajo TagLib, sprejemajo različico z malimi in velikimi črkami pri branju datotek WAV, vendar uporabljajo "ID3 " pri zapisovanju oznak ID3v2 v datoteke WAV. Ker obstajajo druge aplikacije, ki sprejemajo samo "id3 " (npr. JRiver Media Center in foobar2000), lahko to možnost uporabite za ustvarjanje oznak, ki jih lahko preberejo takšne aplikacije.

  Ko je označeno Označi kršitve standarda, bodo polja ID3v2, ki kršijo standard, označena rdeče. Podrobnosti o kršitvi so prikazane v opisu orodja:

  - Mora biti edinstven

  - New line je prepovedan

  - Carriage return je prepovedan

  - Lastnik ne sme biti prazen

  - Mora biti številsko

  - Biti mora številsko ali število/skupaj

  - Format je DDMM

  - Format je HHMM

  - Format je YYYY

  - Začeti se mora z letnico in presledkom

  - Datum/čas mora biti ISO 8601

  - Mora biti glasbeni ključ, 3 znaki, A-G, b, #, m, o

  - Imeti mora kodo jezika ISO 639-2, 3 male črke

  - Mora biti koda ISRC, 12 znakov

  - Biti mora seznam nizov, ločenih z '|'

  - Ima presežek belega prostora

  Standardni dokumenti ID3 so na voljo na spletu:

  - Oznaka ID3 različica 2.3.0

  - Oznaka ID3 različica 2.4.0 - Glavna struktura

  - Oznaka ID3 različica 2.4.0 – Native Frames

  Kodiranje besedila določa privzeto kodiranje za okvire ID3v2 in ga je mogoče nastaviti na ISO-8859-1, UTF16 ali UTF8. UTF8 ni veljaven za okvirje ID3v2.3.0; če je nastavljen, bo namesto tega uporabljen UTF16. Za okvirje ID3v2.4.0 so možna vsa tri kodiranja.

  Različica, uporabljena za nove oznake določa, ali bodo nove oznake ID3v2 ustvarjene kot različica 2.3.0 ali 2.4.0.

  Številke številke skladbe je število števk v poljih številke skladbe. Vodilne ničle se uporabljajo za vstavljanje. Na primer, z vrednostjo 2 je številka skladbe 5 nastavljena kot "05".

  Kombinirano polje Ime polja komentarja je relevantno le za datoteke Ogg/Vorbis in FLAC ter nastavi ime polja, ki se uporablja za komentarje. Zdi se, da različne aplikacije uporabljajo različna imena, "`COMMENT`" na primer uporablja XMMS, medtem ko &amarok; uporablja "`DESCRIPTION`".

  Format slik v datotekah Ogg/Vorbis je določen z ime polja slike, ki je lahko "`METADATA_BLOCK_PICTURE`" ali "`COVERART`". Prvi je uradni standard in uporablja enako obliko kot slike v oznakah FLAC. "`COVERART`" je prejšnji neuradni način za vključitev slik v komentarje Vorbis. Uporablja se lahko za združljivost s podedovanimi predvajalniki.

  Če je potrditveno polje Označi, če je večje od (bajtov) aktivirano, so datoteke z vdelano naslovnico albuma, ki presega podano velikost v bajtih, označene rdeče. To lahko uporabite za iskanje datotek, ki vsebujejo prevelike slike, ki jih nekatere aplikacije in predvajalniki ne sprejemajo. Privzeta vrednost je 131072 bajtov (128 KB).

  Žanri po meri lahko uporabite za definiranje žanrov, ki niso na voljo na standardnem seznamu žanrov, npr. "Gothic Metal". Takšni žanri po meri bodo prikazani v kombiniranem polju Žanr Oznake 2. Za oznake ID3v1.1 je mogoče uporabiti samo vnaprej določene žanre.

  Seznam zvrsti po meri lahko uporabite tudi za zmanjšanje števila zvrsti, ki so na voljo v kombiniranem polju Žanr, na tiste, ki se običajno uporabljajo. Če vaša zbirka večinoma vsebuje glasbo v zvrsteh Metal, Gothic Metal, Ancient in Hard Rock, lahko vnesete te zvrsti in označite Prikaži samo zvrsti po meri. Kombinirano polje Oznaka 2 Zvrst bo vsebovalo samo te štiri zvrsti in vam jih ne bo treba iskati po celotnem seznamu zvrsti. V tem primeru bosta na seznamu zvrsti oznake 1 navedena samo Metal in Hard Rock, ker sta ta dva vnosa zvrsti po meri standardna zvrsti. Če Pokaži samo zvrsti po meri ni aktiven, lahko zvrsti po meri najdete na koncu seznama zvrsti.

  V Okvirih po meri je mogoče definirati do osem imen okvirjev po meri, ki jih lahko nato uporabite kot poenotene okvirje, na primer kot okvirje za hiter dostop.

  Okvirji za hitri dostop določajo, katere vrste okvirjev so vedno prikazane v razdelku Oznaka 2. Takšne okvirje lahko nato dodate brez predhodne uporabe gumba Dodaj. Vrstni red teh okvirjev za hitri dostop lahko spremenite tako, da povlečete in spustite elemente.

  Kombinirano polje Ime polja številke skladbe je relevantno samo za RIFF INFO in nastavi ime polja, uporabljenega za številke skladbe. Številke skladb niso določene v izvirnem standardu RIFF, obstajajo aplikacije, ki uporabljajo "`ITRK`", druge uporabljajo "`IPRT`".

  Oblika oznake vsebuje možnosti za obliko oznak. Ko je označeno Samodejno uporabi obliko, se konfiguracija oblike samodejno uporablja med urejanjem besedila v vrsticah. Preverjanje omogoča validatorje v kontrolnikih z vrednostmi skladbe/skupnega zneska in datuma/časa. Pretvorbo velikih črk lahko nastavite na Brez sprememb, Vse male črke, Vse velike črke, Prva velika črka ali Vse prve črke so velike. Če želite uporabiti pretvorbo med malimi in velikimi črkami glede na jezik, lahko v spodnjem kombiniranem polju izberete jezik. Seznam zamenjav nizov je mogoče nastaviti na poljubne preslikave nizov. Če želite dodati novo preslikavo, izberite celico Od v vrstici in vstavite besedilo, ki ga želite zamenjati, nato pa pojdite v stolpec Do in vnesite nadomestno besedilo. Ko se besedilo, ki ga želite zamenjati, začne in konča s poševnico ("/"), je uporabljen regularni izraz. Pri regularnih izrazih, ki vsebujejo skupine za prestrezanje, so pojavitve \1, \2, ... v Za nadomeščene z nizom, ki ga je zajela ustrezna skupina za prestrezanje. Če želite odstraniti preslikavo, nastavite celico Od na prazno vrednost (npr. tako, da najprej vnesete preslednico in nato vračalko). Vstavljanje in brisanje vrstic je možno tudi z uporabo kontekstnega menija, ki se prikaže, ko kliknete desni gumb miške. Zamenjava je aktivna le, če je potrjeno polje Zamenjava niza.

  Tabela v Ocena vsebuje preslikavo ocen z zvezdicami v efektivne vrednosti, shranjene v oznaki. Okvirji z informacijami o oceni so navedeni v vrstici Ocena na seznamu okvirjev. Za te okvirje lahko oceno določite tako, da dodelite število zvezdic od petih. Različni formati oznak in različne aplikacije uporabljajo različne vrednosti za preslikavo ocene zvezdic v vrednost, shranjeno v oznaki. Za prikaz pravilnega števila zvezdic &kid3; bo poiskal zemljevid v tej tabeli. Ključno za iskanje preslikave je ime okvirja, na primer "RATING", kot se uporablja za komentarje Vorbis, ali "IRTD" za RIFF INFO. Za oznake ID3v2 se uporablja kombinirani ključ, sestavljen iz ID-ja okvira »POPM« okvira Popularimeter in njegovega polja »Email«, ločenih s piko. Zato obstajajo različni ključi za ID3v2, npr. »POPM.Windows Media Player 9 Series« za preslikavo, ki jo uporabljata Windows Media Player in Explorer, in preprosto »POPM« za okvirje POPM s praznim poljem »Email«. Ker lahko obstaja več vnosov za "POPM", je njihov vrstni red pomemben. Ko &kid3; doda nov okvir Popularimeter, bo uporabil prvi vnos "POPM" za določitev vrednosti, ki bo zapisana v polje "Email". Ta vrednost bo nato določila preslikavo, ki bo uporabljena za ocene z zvezdicami. Prvi vnos se uporabi tudi, če ključ ni bil najden, zato je privzeti vnos.

  Poleg stolpca Ime, ki vsebuje ključe, ima tabela stolpce 1 do 5 za vrednosti, ki se shranijo, ko je podano ustrezno število zvezdic . Nasprotno pa vrednosti določajo število zvezdic, ki so prikazane za vrednost, shranjeno v okvirju. Na primer, vrstica v spodnji tabeli vsebuje vrednosti 1, 64, 128, 196, 255. Mejne vrednosti za število zvezdic, ki bodo prikazane, ležijo med tema vrednostma in so združljive s tem, kar uporablja &Windows; Explorer.

  ### Vpis v tabelo ocen

  Ime | 1 | 2 | 3 | 4 | 5
  POPM | 1 | 64 | 128 | 196 | 255
  Obseg | 1-31 | 32-95 | 96-159 | 160-223 | 224-255

  Na strani Datoteke lahko označite potrditveno polje Naloži nazadnje odprte datoteke, tako da &kid3; se odpre in ob naslednjem zagonu izbere zadnjo izbrano datoteko. Ohrani časovni žig datoteke lahko označite, da ohranite časovni žig spremembe datoteke. Ime datoteke za naslovnico nastavi ime, ki je predlagano, ko je vdelana slika izvožena v datoteko. Z Kodiranje besedila (izvoz, seznam predvajanja) lahko nastavite kodiranje, ki se uporablja pri pisanju datotek. Privzeti Sistem je mogoče spremeniti, na primer, če je treba sezname predvajanja uporabiti v drugi napravi.

  Če je Označi spremembe aktivno, so spremenjena polja označena s svetlo sivim ozadjem oznake.

  Razdelek Seznam datotek določa, katere datoteke so prikazane na seznamu datotek. Filter lahko uporabite za omejitev elementov na tem seznamu na datoteke s podprtimi končnicami. Če želite izrecno določiti, katere mape želite prikazati na seznamu datotek ali izključiti določene mape, lahko uporabite možnosti Vključi mape in Izključi mape. Vsebujejo lahko izraze z nadomestnimi znaki, na primer `*/Music/*`, da vključite samo mapo `Music`, ali `*/iTunes/*`, da izključite mapo iTunes s seznama datotek. Če je treba uporabiti več takih izrazov, so lahko ločeni s presledki ali podpičji.

  Gumba Ime datoteke iz oznake in Oznaka iz imena datoteke v razdelku Oblika odpreta pogovorna okna za urejanje formatov, ki so na voljo v Oblika kombinirana polja (s puščicama gor in dol), ki jih najdete v razdelku Datoteka glavnega okna.

  Gumb Seznam predvajanja lahko uporabite za urejanje formatov imen datotek, ki so na voljo v pogovornem oknu Ustvari seznam predvajanja.

  Oblika imena datoteke vsebuje možnosti za obliko zapisa imen datotek. Na voljo so enake možnosti kot v Oblika oznake.

  Poleg tega je mogoče nastaviti Največjo dovoljeno dolžino za imena datotek. Večina sodobnih datotečnih sistemov ima omejitev 255 znakov, če pa želite datoteke zapisati na CD, morate omejitev nastaviti na 64. Če je označeno Uporabi za imena seznamov predvajanja in map, ime datoteke se uporablja tudi pri ustvarjanju seznamov predvajanja in preimenovanju map.

  Stran Uporabniška dejanja vsebuje tabelo z ukazi, ki so na voljo v kontekstnem meniju seznama datotek. Pri kritičnih operacijah, kot je brisanje datotek, je priporočljivo označiti Potrdi, da se prikaže potrditveno pogovorno okno pred izvedbo ukaza. Izhod lahko označite za ogled izpisa, ki ga napišejo ukazi konzole (standardni izhod in standardna napaka). Ime je ime, prikazano v priročnem meniju. Ukaz je ukazna vrstica, ki jo je treba izvesti. Argumente je mogoče posredovati z uporabo naslednjih kod:

  - %F %{files} Poti datotek (seznam, če je izbranih več datotek)

  - %f %{file} Pot datoteke do posamezne datoteke

  - %uF %{urls} &URL;s (seznam, če je izbranih več datotek)

  - %uf %{url} &URL; v eno datoteko

  - %d %{directory} Mapa

  - %s %{title} Naslov (Pesem)

  - %a %{artist} Umetnik

  - %l %{album} Album

  - %c %{comment} Komentar

  - %y %{year} Leto

  - %t %{track} Sled (npr. 01)

  - %t %{track.n} Sled s širino polja n (npr. 001 za %{track.3})

  - %T %{tracknumber} Sled (brez začetnih ničel, npr. 1)

  - %g %{genre} Žanr

  - %b %{browser} Ukaz za zagon spletnega brskalnika

  - %q %{qmlpath} Osnovna mapa navedenih datotek QML

  Posebno kodo `@separator` lahko nastavite kot ukaz za vstavljanje ločila v kontekstni meni uporabniških dejanj. Elemente menija lahko postavite v podmeni tako, da jih obdate z ukazoma `@beginmenu` in `@endmenu`. Ime podmenija je določeno s stolpcem Name ukaza `@beginmenu`.

  Za izvajanje skriptov QML se kot ime ukaza uporablja `@qml`. Pot do skripta QML se posreduje kot parameter. Ponujene skripte lahko najdete v mapi `%{qmlpath}/script/` (v &Linux;u običajno `/usr/share/kid3/qml/script/`, v sistemu Windows `qml/script/` v namestitveni mapi in v &macOS; v mapi aplikacije `kid3.app/Contents/Resources/qml/script/`). Skripte po meri lahko shranite v katero koli mapo. Če koda QML uporablja &GUI; komponente, je treba namesto `@qml` uporabiti `@qmlview`. Dodatni parametri se posredujejo skriptu QML, kjer bodo na voljo prek funkcije `getArguments()`. Pregled nekaterih funkcij in lastnosti, ki so na voljo v QML, je na voljo v dodatku Vmesnik QML.

  Ukaz, ki bo vstavljen z %{browser}, lahko definirate v zgornjem urejanju vrstice Spletni brskalnik. Ukaze, ki se začnejo z %{browser}, lahko uporabite za pridobivanje informacij o zvočnih datotekah iz spleta, na primer

       %{browser} http://lyricwiki.org/%u{artist }:%u{title}

  bo poizvedoval po besedilu trenutne pesmi v LyricWiki. "U" v %u{artist} in %u{title} se uporablja za &URL; kodiranje podatkov o izvajalcu %{artist} in pesmi %{title}. Svoje lastne poizvedbe je enostavno določiti na enak način, npr. iskanje slik z Googlom:

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

  Če želite oznaki 2 dodati naslovnico albuma, lahko poiščete slike z Googlom ali Amazonom z zgoraj opisanimi ukazi. Sliko lahko dodate oznaki s funkcijo povleci in spusti. Sliko lahko dodate tudi z Dodaj, nato izberete okvir slike in uvozite slikovno datoteko ali jo prilepite iz odložišča. Okvirji slik so podprti za oznake ID3v2, MP4, FLAC, Ogg in ASF.

  Za dodajanje in brisanje vnosov v tabeli lahko uporabite kontekstni meni.

  Stran Omrežje vsebuje samo polje za vnos naslova posrednika in po izbiri vrat, ločenih z dvopičjem. Posrednik bo uporabljen pri uvozu iz internetnega strežnika, ko je potrditveno polje potrjeno.

  Na strani Vtičniki lahko omogočite ali onemogočite razpoložljive vtičnike. Vtičniki so razdeljeni na dva dela. Vtičniki za metapodatke & Priority seznam vsebuje vtičnike, ki podpirajo formate zvočnih datotek. Vrstni red vtičnikov je pomemben, ker se preizkušajo od zgoraj navzdol. Nekatere formate podpira več vtičnikov, zato bodo datoteke odprte s prvim vtičnikom, ki jih podpira. TaglibMetadata podpira večino formatov; če je na vrhu seznama, bo odprl večino datotek. Če želite za format datoteke uporabiti drug vtičnik, se prepričajte, da je naveden pred vtičnikom TaglibMetadata. Spodaj so navedene podrobnosti o vtičniku za metapodatke in zakaj bi jih morda želeli uporabiti namesto TagLib.

  - Id3libMetadata: uporablja id3lib za oznake ID3v1.1 in ID3v2.3 v datotekah MP3, MP2, AAC. Podpira nekaj več vrst okvirjev kot TagLib.

  - OggFlacMetadata: uporablja libogg, libvorbis, libvorbisfile za datoteke Ogg in dodatno libFLAC++ in libFLAC za datoteke FLAC. To so uradne knjižnice za te formate.

  - TaglibMetadata: uporablja TagLib, ki podpira veliko formatov zvočnih datotek. Uporablja se lahko za vse zvočne datoteke, ki jih podpira &kid3;.

  - Metapodatki Mp4v2: mp4v2 je prvotno uporabljal &kid3; za podporo datotek M4A. Lahko se uporablja v primeru težav s podporo M4A za TagLib.

  V razdelku Razpoložljivi vtičniki so navedeni preostali vtičniki. Njihov vrstni red ni pomemben, lahko pa jih omogočite ali onemogočite s potrditvenimi polji.

  - AmazonImport: Uporablja se za funkcijo Uvoz iz Amazona....

  - DiscogsImport: Uporablja se za funkcijo Uvoz iz Discogs....

  - FreedbImport: Uporablja se za funkcijo Uvoz iz gnudb.org....

  - MusicBrainzImport: Uporablja se za funkcijo Uvozi iz izdaje MusicBrainz....

  - AcoustidImport: Uporablja se za funkcijo Import from MusicBrainz Fingerprint..., ki je odvisna od Chromaprint in libav knjižnici.

  Vtičniki, ki so onemogočeni, se ne bodo naložili. To lahko uporabite za optimizacijo uporabe virov in zagonskega časa. Nastavitve na tej strani začnejo veljati šele po ponovnem zagonu &kid3;.

### Meni Pomoč

Pomoč &kid3; Priročnik

- Odpre ta priročnik.

Pomoč O &kid3;

- Prikaže kratke informacije o &kid3;.

## kid3-cli

### Ukazi

`kid3-cli` ponuja vmesnik ukazne vrstice za &kid3;. Če je uporabljena pot do mape, se mapa odpre. Če je podana ena ali več poti do datoteke, se odpre skupna mapa in izberejo se datoteke. Naslednji ukazi bodo nato delovali na teh datotekah. Ukazi so podani z možnostmi `-c`. Če je podanih več ukazov, se izvedejo v danem vrstnem redu. Če so datoteke spremenjene z ukazi, bodo na koncu shranjene. Če ni podana nobena ukazna možnost, se `kid3-cli` zažene v interaktivnem načinu. Ukaze je mogoče vnesti in bodo delovali na trenutnem izboru. V naslednjih razdelkih so navedeni vsi razpoložljivi ukazi.

#### Pomoč

    Pomoč COMMAND-NAME

Prikaže pomoč o parametrih `COMMAND-NAME` ali o vseh ukazih, če ime ukaza ni navedeno.

#### Odmor

    timeout  default off TIME

Prepiši privzeto časovno omejitev ukaza. Ukazi CLI se prekinejo, ko poteče časovna omejitev, specifična za ukaz. Ta časovna omejitev je 10 sekund za `ls` in `albumart`, 60 sekund za `autoimport` in `filter` ter 3 sekunde za vse druge ukaze. Če je treba obdelati ogromno datotek, so lahko te časovne omejitve preveč omejujoče, zato je mogoče časovno omejitev za vse ukaze nastaviti na `TIME` ms, popolnoma izklopiti ali pustiti privzete vrednosti.

#### Zapri aplikacijo

    exit force

Izhod iz aplikacije. Če obstajajo spremenjene neshranjene datoteke, je potreben parameter `force`.

#### Spremeni mapo

    cd MAPA

Če ni podana `FOLDER`, preklopite v domačo mapo. Če je podana mapa, spremenite v mapo. Če je podana ena ali več poti do datoteke, pojdite v njihovo skupno mapo in izberite datoteke.

#### Natisne ime datoteke trenutne mape

    pwd

Natisne ime datoteke trenutne delovne mape.

#### Seznam map

    ls

Navedite vsebino trenutne mape. To ustreza seznamu datotek v datoteki &kid3; &GUI;. Pet znakov pred imeni datotek prikazuje stanje datoteke.

- `>` Datoteka je izbrana.

- `*` Datoteka je spremenjena.

- `1` Datoteka ima oznako 1, sicer se prikaže »`-`«.

- `2` Datoteka ima oznako 2, sicer se prikaže »`-`«.

- `3` Datoteka ima oznako 3, sicer se prikaže »`-`«.

    kid3-cli> ls
      1-- 01 Intro.mp3

    > 12- 02 We Only Got This One.mp3
     *1-- 03 Outro.mp3

V tem primeru imajo vse datoteke oznako 1, druga datoteka ima prav tako oznako 2 in je izbrana. Tretja datoteka je spremenjena.

#### Shranite spremenjene datoteke

    save

#### Izberite datoteko

    select  all none first previous next FILE

Če želite izbrati vse datoteke, vnesite `select all`, če želite preklicati izbiro vseh datotek, vnesite `select none`. Za premikanje po datotekah v trenutni mapi začnite z `izberite najprej`, nato se pomaknite naprej z `izberite naslednje` ali nazaj z `izberite prejšnje`. Določene datoteke lahko dodate trenutnemu izboru tako, da podate njihova imena. Možni so nadomestni znaki, zato bo `izberi *.mp3` izbral vse datoteke MP3 v trenutni mapi.

    kid3-cli> select first
    kid3-cli> ls

    > 1-- 01 Intro.mp3
      12- 02 We Only Got This One.mp3
     *1-- 03 Outro.mp3
    kid3-cli> select next
    kid3-cli> ls
      1-- 01 Intro.mp3

    > 12- 02 We Only Got This One.mp3
     *1-- 03 Outro.mp3
    kid3-cli> select *.mp3
    kid3-cli> ls

    > 1-- 01 Intro.mp3

    > 12- 02 We Only Got This One.mp3

    >*1-- 03 Outro.mp3

#### Izberi oznako

    tag TAG-NUMBERS

Številni ukazi imajo izbirni parameter `TAG-NUMBERS`, ki določa, ali ukaz deluje na oznaki 1, 2 ali 3. Če ta parameter izpustite, se uporabijo privzete številke oznak, ki jih lahko nastavite ta ukaz. Ob zagonu je nastavljen na `12`, kar pomeni, da se informacije berejo iz oznake 2, če je na voljo, drugače pa iz oznake 1; spremembe so narejene na oznaki 2. ``TAG-NUMBERS`` je mogoče nastaviti na `1`, `2` ali `3` za delovanje samo z ustrezno oznako. Če je parameter izpuščen, se prikaže trenutna nastavitev.

#### Pridobite okvir oznake

    get  all FRAME-NAME  TAG-NUMBERS

Ta ukaz lahko uporabite za branje vrednosti določenega okvira oznake ali pridobivanje informacij o vseh okvirih oznake (če je argument izpuščen ali uporabljen `all`). Spremenjeni okvirji so označeni z '`*`'.

    kid3-cli> get
    File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
      Name: 01 Intro.mp3
    Tag 1: ID3v1.1
      Title         Intro
      Artist        One Hit Wonder
      Album         Let's Tag
      Date          2013
      Track Number  1
      Genre         Pop
    kid3-cli> get title
    Intro

Če želite shraniti vsebino okvirja slike v datoteko, uporabite

    get picture:'/path/to/folder.jpg'

Če želite shraniti sinhronizirana besedila v datoteko LRC, uporabite

    get SYLT:'/path/to/lyrics.lrc'

Iz okvira je mogoče pridobiti samo določeno polje, na primer `get POPM.Email` za polje Email okvirja Popularimeter. Če ima datoteka več okvirjev iste vrste, je mogoče različne okvire indeksirati z oklepaji, na primer prvega izvajalca iz komentarja Vorbis je mogoče pridobiti z uporabo `get performer[0]`, drugega z uporabo `get performer[1]`.

Ime psevdo polja "selected" lahko uporabite za preverjanje, ali je okvir izbran, na primer `get artist.selected` bo vrnil `1`, če je izbran okvir izvajalca, drugače `0`.

Ime psevdo okvira "ratingstars" se lahko uporabi za pridobitev vrednosti okvira "rating" kot vrednosti, specifične za format, ki ustreza številu zvezdic (0 do 5). Pri uporabi "rating" se vrne notranja vrednost.

#### Nastavite okvir oznake

    set FRAME-NAME FRAME-VALUE TAG-NUMBERS

Ta ukaz nastavi vrednost določenega okvira oznake. Če je `FRAME-VALUE` prazno, je okvir izbrisan.

    kid3-cli> set remixer 'O.H. Wonder'

Za nastavitev vsebine okvirja slike iz datoteke uporabite

    set picture:'/path/to/folder.jpg' 'Picture Description'

Če želite nastaviti sinhronizirana besedila iz datoteke LRC, uporabite

    set SYLT:'/path/to/lyrics.lrc' 'Lyrics Description'

Če želite nastaviti določeno polje okvira, lahko ime polja podate za piko, npr. za nastavitev polja Števec okvira Popularimeter uporabite

    set POPM.Counter 5

Aplikacija za specifikacije polja je primer, ko želite okvir po meri TXXX z opisom "rating" namesto standardnega okvira Popularimetra (zdi se, da to uporabljajo nekateri vtičniki). Ustvarite lahko takšen ocenjevalni okvir TXXX s `kid3-cli`, vendar morate najprejustvariti okvir TXXX z opisom "rating" in nato nastavite vrednostta okvir na vrednost ocene.

    kid3-cli> set rating ""
    kid3-cli> set TXXX.Description rating
    kid3-cli> set rating 5

Prvi ukaz bo izbrisal obstoječi okvir POPM, ker četakšen okvir obstaja, bi `set rating 5` nastavil POPMokvir in ne okvir TXXX. Druga možnost bi bila uporaba`set TXXX.Text 5`, vendar bi to delovalo le, če ni prisoten noben drug okvir TXXX.

Če želite nastaviti več okvirjev iste vrste, lahko indeks navedete v oklepajih, npr. za nastavitev več izvajalcev v komentarju Vorbis uporabite

    kid3-cli> set performer[0] 'Liza don Getti (soprano)'
    kid3-cli> set performer[1] 'Joe Barr (piano)'

Če želite izbrati določene okvirje pred dejanjem kopiranja, lepljenja ali odstranjevanja, lahko uporabite ime psevdo polja "selected". Običajno so izbrani vsi okvirji, za preklic izbire vseh uporabite `set '*.selected' 0`, nato pa na primer `set artist.selected 1`, da izberete okvir izvajalca.

Ime psevdo okvira "ratingstars" lahko uporabite za nastavitev vrednosti okvira "rating" na vrednost, specifično za format, ki ustreza številu zvezdic (0 do 5). Ime okvirja "rating" se lahko uporablja za nastavitev notranje vrednosti.

Nastavitev "ratingstars" za več datotek z različnimi oblikami oznak ne bo delovala, ker je okvir z vrednostjo, preslikano iz števila zvezdic, ustvarjen za prvo datoteko in nato uporabljen za vse datoteke. Torej namesto `kid3-cli -c "set ratingstars 2" *` raje uporabite `for f in *; do kid3-cli -c "set ratingstars 2" "$f"; done`.

#### Razveljavi

    revert

Razveljavi vse spremembe v izbranih datotekah (ali vseh datotekah, če ni izbrana nobena datoteka).

#### Uvoz iz datoteke

    import FILE FORMAT-NAME TAG-NUMBERS

Oznake so uvožene iz datoteke `FILE` v formatu z imenom `FORMAT-NAME` (npr. `"CSV unquoted"` , glejte Uvoz).

Če so `oznake` podane za `FILE`, se oznake uvozijo iz drugih oznak. Namesto `FORMAT-NAME` sta potrebna parametra `SOURCE` in `EXTRACTION`, glejte Uvoz iz oznak. Za uporabo uvoza iz oznak na izbranih datotekah uporabite `tagsel` namesto `oznak`. Ta funkcija podpira tudi izpis izvlečene vrednosti z uporabo `EXTRACTION` z vrednostjo `%{__return}(.+)`.

#### Samodejni uvoz

    autoimport PROFILE-NAME TAG-NUMBERS

Paketni uvoz z uporabo profila `PROFILE-NAME` (glejte Samodejni uvoz, `"Vse"` se uporabi, če je izpuščen).

#### Prenesi naslovnico albuma

    albumart URL all

Nastavite sliko albuma tako, da prenesete sliko z `URL`. Pravila, določena v pogovornem oknu Prebrskaj naslovnico, se uporabljajo za pretvorbo splošnih &URL;-jev (npr. iz Amazona) v sliko &URL;. Če želite nastaviti naslovnico albuma iz lokalne slikovne datoteke, uporabite ukaz set.

    kid3-cli> albumart http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

#### Izvozi v datoteko

    export FILE FORMAT-NAME TAG-NUMBERS

Oznake se izvozijo v datoteko `FILE` v formatu z imenom `FORMAT-NAME` (npr. `»CSV unquoted«`, glejte Izvoz).

#### Ustvari seznam predvajanja

    playlist

Ustvarite seznam predvajanja v formatu, nastavljenem v konfiguraciji, glejte Ustvari seznam predvajanja.

#### Uporabi obliko imena datoteke

    filenameformat

Uporabite obliko imena datoteke, nastavljeno v konfiguraciji, glejte Uporabi obliko imena datoteke.

#### Uporabi obliko oznake

    tagformat

Uporabite obliko imena oznake, nastavljeno v konfiguraciji, glejte Uporabi obliko oznake.

#### Uporabite kodiranje besedila

    textencoding

Uporabite kodiranje besedila, nastavljeno v konfiguraciji, glejte Uporabi kodiranje besedila.

#### Preimenuj mapo

    renamedir FORMAT  create rename dryrun  TAG-NUMBERS

Preimenujte ali ustvarite mape iz vrednosti v oznakah glede na dan `FORMAT` (npr. `%{artist} - %{album}`, glejte Preimenuj mapo), če ni podana nobena oblika, se uporabi oblika, določena v pogovornem oknu Preimenuj mapo. Privzeti način je `preimenuj`; za ustvarjanje map morate izrecno podati `create`. Dejanja preimenovanja bodo izvedena takoj, če želite videti, kaj bo storjeno, uporabite možnost `dryrun`.

#### Oštevilči sledi

    numbertracks TRACK-NUMBER TAG-NUMBERS

Oštevilči izbrane skladbe, ki se začnejo s `TRACK-NUMBER` (`1`, če je izpuščeno).

#### Filter

    filter  FILTER-NAME FILTER-FORMAT

Filtriraj datoteke tako, da so vidne samo datoteke, ki se ujemajo z `FILTER-FORMAT`. Ime vnaprej določenega izraza filtra (npr. `"Filename Tag Mismatch"`) lahko uporabite namesto izraza filtra, glejte Filter.

    kid3-cli> filter '%{title} contains "tro"'
    Started
      /home/urs/One Hit Wonder - Let's Tag
    + 01 Intro.mp3
    - 02 We Only Got This One.mp3
    + 03 Outro.mp3
    Finished
    kid3-cli> ls
      1-- 01 Intro.mp3
      1-- 03 Outro.mp3
    kid3-cli> filter All
    Started
      /home/urs/One Hit Wonder - Let's Tag
    + 01 Intro.mp3
    + 02 We Only Got This One.mp3
    + 03 Outro.mp3
    Finished
    kid3-cli> ls
      1-- 01 Intro.mp3
      12- 02 We Only Got This One.mp3
      1-- 03 Outro.mp3

#### Pretvori ID3v2.3 v ID3v2.4

    to24

#### Pretvori ID3v2.4 v ID3v2.3

    to23

#### Ime datoteke iz oznake

    fromtag FORMAT TAG-NUMBERS

Nastavi imena datotek za izbrane datoteke iz vrednosti v oznakah, na primer `fromtag '%{track} - %{title}' 1`. Če format ni določen, se se uporablja format nastavljen v &GUI;.

#### Oznaka iz imena datoteke

    totag FORMAT TAG-NUMBERS

Nastavi okvirje oznak iz imen datotek, na primer `totag '%{albumartist} - %{album}/%{track} %{title}' 2`. Če format ni določen, se uporablja format nastavljen v &GUI;. Če se oblika imena datoteke ne ujema s tem vzorcem, se poskusi nekaj drugih pogosto uporabljenih oblik.

#### Oznaka z drugo oznako

    syncto TAG-NUMBER

Kopiraj okvirje oznak iz ene oznake v drugo oznako, npr., da nastavite oznako ID3v2 iz oznake ID3v1, uporabite `syncto 2`.

#### Kopiraj

    copy TAG-NUMBER

Kopiraj okvirje oznak izbrane datoteke v notranji medpomnilnik za kopiranje. Nato jih lahko nastavite na drugo datoteko z ukazom `paste`.

Če želite kopirati samo podmnožico okvirjev, uporabite "selected" psevdo polje z ukazom `set`. Če želite na primer kopirati samo številko diska in okvirje avtorskih pravic, uporabite

    set '*.selected' 0
    set discnumber.selected 1
    set copyright.selected 1
    copy

#### Prilepi

    paste TAG-NUMBER

Nastavi okvirje oznak iz vsebine medpomnilnika `copy` v izbranih datotekah.

#### Odstrani

    remove TAG-NUMBER

Odstrani oznako.

Odstraniti je mogoče le podnabor okvirjev, tako da jih izberete, kot je opisano v ukazu `copy`.

#### Konfiguriraj Kid3

    config OPTION VALUE

Poizvedi ali nastavi možnost konfiguracije.

`OPTION` je sestavljena iz imena skupine in imena lastnosti, ločenih s piko. Če ni podane `OPTION`, so prikazane vse razpoložljive skupine. Če je navedeno samo ime skupine, so prikazane vse razpoložljive lastnosti skupine. Za dano skupino in lastnost je prikazana trenutno konfigurirana vrednost. Če želite spremeniti nastavitev, lahko novo vrednost posredujete kot drugi argument.

Če je vrednost nastavitve seznam, morajo biti vsi elementi seznama podani kot argumenti. To pomeni, da je treba za dodajanje elementa obstoječemu seznamu elementov posredovati vse obstoječe elemente, ki jim sledi nov element. V takšni situaciji je lažje uporabiti način JSON, kjer je mogoče trenutni seznam kopirati z dodanim novim elementom.

#### Izvedite program ali skript QML

    execute @qml FILE ARGS

Izvedi skript QML ali izvršljivo datoteko.

Brez `@qml` se program izvaja z argumenti. Ko je `@qml` podan kot prvi argument, so naslednji argumenti skripta QML in njegovi argumenti. Na primer, oznake mape je mogoče izvoziti v datoteko `export.csv` z naslednjim ukazom.

    kid3-cli -c "execute @qml
    /usr/share/kid3/qml/script/ExportCsv.qml export.csv"
    /path/to/folder/

Tukaj je `export.csv` argument za skript `ExportCsv.qml`, medtem ko je `/path/to/folder/` ``FILE`` argument za `kid3-cli`.

### Primeri

Nastavite naslov, ki vsebuje apostrof. Ukazi, posredovani `kid3-cli` s `-c`, morajo biti v narekovajih, če niso sestavljeni le iz ene same besede. Če ima sam tak ukaz argument, ki vsebuje presledke, je treba tudi ta argument navesti. V &UNIX; lupinah lahko uporabite enojne ali dvojne narekovaje, vendar je v ukaznem pozivu sistema Windows pomembno, da je zunanje narekovaje izvedeno z dvojnimi narekovaji, znotraj teh narekovajev pa so uporabljeni enojni narekovaji. Če besedilo znotraj enojnih narekovajev vsebuje en narekovaj, ga je treba ubežati s poševnico nazaj, kot je prikazano v naslednjem primeru:

    kid3-cli -c "set title 'I\'ll be there for you'" /path/to/folder

Nastavi naslovnico albuma v vseh datotekah mape s funkcijo paketnega uvoza:

    kid3-cli -c "autoimport 'Cover Art'" /path/to/folder

Odstrani okvirje komentarjev in uporabite obliko oznake v obeh oznakah vseh datotek MP3 v mapi:

    kid3-cli -c "set comment '' 1" -c "set comment '' 2" \
    -c "tagformat 1" -c "tagformat 2" /path/to/folder/*.mp3

Samodejno uvozi oznako 2, sinhronizira z oznako 1, nastavi imena datotek iz oznake 2 in končno ustvari seznam predvajanja:

    kid3-cli -c autoimport -c "syncto 1" -c fromtag -c playlist \
      /path/to/folder/*.mp3

Za vse datoteke z oznako ID3v2.4.0 pretvori v ID3v2.3.0 in odstrani okvir aranžerja:

    kid3-cli -c "filter 'ID3v2.4.0 Tag'" -c "select all" -c to23 \
      -c "set arranger ''" /path/to/folder

This Python script uses `kid3-cli` to generate iTunes Sound Check iTunNORM frames from replay gain information.

    #!/usr/bin/env python3
    # Generate iTunes Sound Check from ReplayGain.
    import os, sys, subprocess

    def rg2sc(dirpath):
      for root, dirs, files in os.walk(dirpath):
        for name in files:
          if name.endswith(('.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])

### &JSON; Format

Za lažjo razčlenitev rezultatov iz `kid3-cli`, je mogoče dobiti izhod v &JSON; formatu. Ko je zahteva v &JSON; obliki, bo tudi odgovor &JSON;. Kompaktna oblika zahteve bo prav tako zagotovila kompaktno predstavitevodgovora. Če zahteva vsebuje polje "id", se domneva, da je aZahteva &JSON;-RPC in odgovor bosta vsebovala polje »jsonrpc« in"id" zahteve. Format zahteve uporablja iste ukaze kotstandardni CLI, polje "method" vsebuje ukaz in parametre (če obstajajo) so navedeni na seznamu "params". Odgovor vsebuje predmet "result", ki je lahko tudi null, če ustrezen ukaz `kid3-cli` ne vrne rezultata. V primeru napake je predmet "error" je vrnjen s polji "code" in "message", kot se uporabljata v&JSON;-RPC.

    kid3-cli> {"method":"set","params":["artist","An Artist"]}
    {"result":null}
    kid3-cli> {"method":"get","params":["artist",2]}
    {"result":"An Artist"}
    kid3-cli> {"method": "get", "params": ["artist"]}
    {
        "result": "An Artist"
    }

    kid3-cli> {"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]}
    {"id":"123","jsonrpc":"2.0","result":"An Artist"}

## Zasluge in licenca

&kid3;

Program je napisal Urs Fleisch ufleisch@users.sourceforge.net

Prevod: Matjaž Jeran matjaz.jeran@amis.net

&underFDL; &underGPL;

## Namestitev

### Kako pridobiti &kid3;

&kid3; najdete na https://kid3.kde.org.

### Zahteve

&kid3; potrebuje &Qt;. &kde; je priporočljiv, vendar ni potreben, saj &kid3; se lahko prevede tudi kot &Qt; aplikacija. &kid3; je mogoče prevesti za sisteme, kjer so te knjižnice na voljo, npr. za GNU/&Linux;, &Windows; in &macOS;. Če želite označiti datoteke Ogg/Vorbis, libogg, libvorbis in libvorbisfile so potrebni za datoteke FLAC libFLAC++ in libFLAC. id3lib se uporablja za datoteke MP3. Te štiri formate podpira tudi TagLib, ki lahko obravnava tudi Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, Datoteke WAV, AIFF in sledilni moduli. Za uvoz iz akustičnih prstnih odtisov se uporabljata Chromaprint in libav .

&kid3; je na voljo za večino &Linux; distribucije, &Windows; in &macOS;. Povezave najdete na https://kid3.kde.org.

### Prevajanje in namestitev

Prevedete lahko &kid3; z ali brez &kde;. Brez &kde;, &kid3; je preprost &Qt; in nima nekaterih funkcij konfiguracije in seje.

Za &kde; različico, pojdite v zgornjo mapo in vnesite

    % cmake .
    % make
    % make install

Za prevajanje za različne različice &Qt; ali &kde;, nastavite ustrezne možnosti `cmake`.

Če niso prisotne vse knjižnice, &kid3; je zgrajen z zmanjšano funkcionalnostjo. Zato morate poskrbeti, da imate nameščene vse želene razvojne pakete. Na drugi strani možnosti `cmake` nadzirajo, v katere knjižnice so prevedene. Privzeto je `-DWITH_TAGLIB:BOOL=ON -DWITH_MP4V2:BOOL=OFF -DWITH_ID3LIB:BOOL=ON -DWITH_CHROMAPRINT:BOOL =ON -DWITH_VORBIS:BOOL=ON -DWITH_FLAC:BOOL=ON` . Te možnosti lahko onemogočite z `OFF`.

Če želite zgraditi &kid3; kot &Qt; aplikacije brez &kde;, uporabite možnost `cmake` `-DWITH_APPS=Qt`. Če želite zgraditi oba &kde; in &Qt; aplikacijo, nastavite `-DWITH_APPS="Qt;KDE"`.

Za uporabo določene &Qt; namestitve, nastavite `-DQT_QMAKE_EXECUTABLE=/path/to/qmake`.

Generiranje RPM-paketov podpira datoteka `kid3.spec`, za &Debian; pakete, zaženite `build.sh deb`.

&Qt; aplikacijo je mogoče prevesti tudi za &Windows; in &macOS;. Skript `build.sh` lahko uporabite za prenos in gradnjo vseh potrebnih knjižnic ter ustvarjanje datoteke &kid3; paketa.

### Konfiguracija

Pri &kde; so nastavitve shranjene v `.config/kid3rc`, stanje aplikacije v `.local/share/kid3/kid3staterc`. Kot &Qt; aplikacije, je ta datoteka v `.config/Kid3/Kid3.conf`. V &Windows; je konfiguracija shranjena v registru. na &macOS; v datoteki plist.

Spremenljivko okolja `KID3_CONFIG_FILE` lahko uporabite za nastavitev poti konfiguracijske datoteke.

## &DBus; Vmesnik

### &DBus; Primeri

Na &Linux; vmesnik &DBus; se lahko uporablja za nadzor &kid3; po skriptah. Skripte je mogoče napisati v katerem koli jeziku z &DBus;-vezami (npr. v Pythonu) in jih je mogoče dodati v Uporabniška dejanja za razširitev funkcionalnosti &kid3;.

Izvajalca v oznaki 2 trenutne datoteke lahko nastavite na vrednost "One Hit Wonder" z naslednjo kodo:

Shell

-     dbus-send --dest=org.kde.kid3 --print-reply=literal \
      /Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
      string:'One Hit Wonder'

  ali lažje z &Qt;-jem `qdbus` (`qdbusviewer` lahko uporabite za raziskovanje vmesnika v &GUI;):

      qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \
      'One Hit Wonder'

Python

-     import dbus
      kid3 = dbus.SessionBus().get_object(
        'org.kde.kid3', '/Kid3')
      kid3.setFrame(2, 'Artist', 'One Hit Wonder')

Perl

-     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");

### &DBus; API

&DBus; API je določen v `org.kde.Kid3.xml`. &kid3; vmesnik ima naslednje metode:

#### Odpri datoteko ali mapo

    boolean openDirectory string path

`path`

- pot do datoteke ali mape

Vrne true, če je v redu.

#### Odstrani oznake vseh datotek, ki niso spremenjene ali izbrane

      unloadAllTags

#### Shranite vse spremenjene datoteke

      boolean save

Vrne true, če je v redu.

#### Pridobi podrobno sporočilo o napaki, ki ga zagotovijo nekatere metode

      string getErrorMessage

Vrne podrobno sporočilo o napaki.

#### Razveljavi spremembe v izbranih datotekah

      revert

#### Zaženi samodejni paketni uvoz

    boolean batchImport int32 tagMask niz profileName

`tagMask`

- oznaka maske (bit 0 za oznako 1, bit 1 za oznako 2)

`profileName`

- ime profila paketnega uvoza za uporabo

#### Uvozi oznake iz datoteke

    boolean importFromFile int32 tagMask string path int32 fmtIdx

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`path`

- pot datoteke

`fmtIdx`

- indeks formata

Vrne true, če je v redu.

#### Uvozi oznake iz drugih oznak

    importFromTags int32 tagMask string source  niz ekstrakcija

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`source`

- format za pridobivanje izvornega besedila iz oznak

`ekstrakcija`

- regularni izraz z imeni okvirjev in zajemi za ekstrahiranje iz izvornega besedila

#### Uvozi oznake iz drugih oznak na izbrane datoteke

    array importFromTagsToSelection int32 tagMask string source string extraction

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`source`

- format za pridobivanje izvornega besedila iz oznak

`ekstrakcija`

- regularni izraz z imeni okvirjev in zajemi za ekstrahiranje iz izvornega besedila

`returnValues`

- ekstrahirana vrednost za "%{__return}(.+)"

#### Prenesi naslovnico albuma

    downloadAlbumArt niz url boolean allFilesInDir

`url`

- &URL; slikovne datoteke ali vira naslovnice albuma

`allFilesInDir`

- true, da dodate sliko vsem datotekam v mapi

#### Izvozi oznake v datoteko

    boolean exportToFile int32 tagMask string path int32 fmtIdx

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`path`

- pot datoteke

`fmtIdx`

- indeks formata

Vrne true, če je v redu.

#### Ustvari seznam predvajanja

      boolean createPlaylist

Vrne true, če je v redu.

#### Pridobi elemente seznama predvajanja

    array getPlaylistItems string path

`path`

- pot do datoteke seznama predvajanja

Vrne seznam absolutnih poti do elementov seznama predvajanja.

#### Nastavi elemente seznama predvajanja

    boolean setPlaylistItems string path matrika items

`path`

- pot do datoteke seznama predvajanja

`predmeti`

- seznam absolutnih poti do elementov seznama predvajanja

Vrne true, če je v redu, false, če niso bili najdeni in dodani vsi elementi ali shranjevanje ni uspelo.

#### Zapri aplikacijo

      quit

#### Izberi vse datoteke

      selectAll

#### Prekliči izbiro vseh datotek

      deselectAll

#### Nastavi prvo datoteko kot trenutno datoteko

      boolean firstFile

Vrne true, če obstaja prva datoteka.

#### Nastavi prejšnjo datoteko kot trenutno datoteko

      boolean previousFile

Vrne true, če obstaja prejšnja datoteka.

#### Naslednjo datoteko nastavite kot trenutno datoteko

      boolean nextFile

Vrne true, če obstaja naslednja datoteka.

#### Izberi prvo datoteko

      boolean selectFirstFile

Vrne true, če obstaja prva datoteka.

#### Izberi prejšnjo datoteko

      boolean selectPreviousFile

Vrne true, če obstaja prejšnja datoteka.

#### Izberi naslednjo datoteko

      boolean selectNextFile

Vrne true, če obstaja naslednja datoteka.

#### Izberi trenutno datoteko

      boolean selectCurrentFile

Vrne true, če obstaja trenutna datoteka.

#### Razširi ali strni trenutni element datoteke, če je to mapa

      boolean expandDirectory

Element seznama datotek je mapa, če getFileName() vrne ime z '/' kot zadnjim znakom.

Vrne true, če je trenutni element datoteke mapa.

#### Uporabi obliko imena datoteke

      applyFilenameFormat

#### Uporabi obliko oznake

      applyTagFormat

#### Uporabite kodiranje besedila

      applyTextEncoding

#### Nastavi ime mape iz oznak

    boolean setDirNameFromTag int32 tagMask niz format boolean create

`tagMask`

- oznaka maske (bit 0 za oznako 1, bit 1 za oznako 2)

`format`

- oblika imena mape

`create`

- true za ustvarjanje, false za preimenovanje

Vrne true, če je v redu, sicer je sporočilo o napaki na voljo z uporabo getErrorMessage().

#### Nastavi naslednje številke skladb v izbranih datotekah

    numberTracks int32 tagMask int32 firstTrackNr

`tagMask`

- oznaka maske (bit 0 za oznako 1, bit 1 za oznako 2)

`firstTrackNr`

- število za prvo datoteko

#### Filtriraj datoteke

    filter string expression

`expression`

- izraz filtra

#### Pretvori oznake ID3v2.3 v ID3v2.4

      convertToId3v24

#### Pretvori oznake ID3v2.4 v ID3v2.3

      convertToId3v23

Vrne true, če je v redu.

#### Pridobi pot do mape

      string getDirectoryName

Vrne absolutno pot do mape.

#### Pridobi ime trenutne datoteke

      string getFileName

Vrne pravo absolutno ime datoteke, ki se konča z "/", če je mapa.

#### Nastavi ime izbrane datoteke

    setFileName string name

`name`

- ime datoteke

Ko bo mapa shranjena, bo datoteka preimenovana.

#### Nastavi obliko za uporabo pri nastavljanju imena datoteke iz oznak

    setFileNameFormat string format

`format`

- format imena datoteke

#### Nastavi imena datotek za izbrane datoteke iz oznak

    setFileNameFromTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Pridobi vrednost okvirja

    string getFrame int32 tagMask string name

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`name`

- ime okvirja (npr. "artist")

Če želite dobiti binarne podatke, kot je slika, lahko za `ime` dodate ime datoteke za pisanje, npr. "Picture:/path/to/file". Na enak način je mogoče izvoziti sinhronizirana besedila, npr. "SYLT:/path/to/file".

Vrne vrednost okvirja.

#### Nastavi vrednost okvirja

    boolean setFrame int32 tagMask string name string value

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

`name`

- ime okvirja (npr. "artist")

`vrednost`

- vrednost okvirja

Za oznako 2 (`tagMask` 2), če ne obstaja okvir z `name`, se doda nov okvir, če je `value` prazen, je okvir izbrisano. Če želite dodati binarne podatke, kot je slika, lahko za `ime` dodate datoteko, npr. "Picture:/path/to/file". »SYLT:/path/to/file« lahko uporabite za uvoz sinhroniziranih besedil.

Vrne true, če je v redu.

#### Pridobite vse okvirje oznake

    array of string getTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

Vrne seznam z izmeničnimi imeni in vrednostmi okvirjev.

#### Pridobi tehnične informacije o datoteki

      array of string getInformation

Lastnosti so Format, Bitrate, Samplerate, Channels, Duration, Channel Mode, VBR, Tag 1, Tag 2. Lastnosti, ki niso na voljo, so izpuščene.

Vrne seznam z izmeničnimi imeni lastnosti in vrednostmi.

#### Nastavi oznako iz imena datoteke

    setTagFromFileName int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Nastavi oznako iz druge oznake

    setTagFromOtherTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Kopiraj oznako

    copyTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Prilepi oznako

    pasteTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Odstrani oznako

    removeTag int32 tagMask

`tagMask`

- tag bit (1 za oznako 1, 2 za oznako 2)

#### Ponovno razčleni konfiguracijo

      preparseConfiguration

Samodejne spremembe konfiguracije so možne tako, da spremenite konfiguracijsko datoteko in nato ponovno razčlenite konfiguracijo.

#### Predvaja izbrane datoteke

      playAudio

## Vmesnik QML

### Primeri QML

Skripte QML lahko prikličete prek kontekstnega menija seznama datotek in jih lahko nastavite na zavihku Uporabniška dejanja pogovornega okna z nastavitvami. Tam nastavljene skripte lahko uporabite kot primere za programiranje skriptov po meri. QML uporablja &javascript;, tukaj je obvezen "Hello World":

    import Kid3 1.0

    Kid3Script {
      onRun: {
        console.log("Hello world, folder is", app.dirName)
        Qt.quit()
      }
    }

Če je ta skript shranjen kot `/path/to/Example.qml`, lahko uporabniški ukaz definirate kot `@qml /path/to/Example.qml` z imenom `QML Test` in Izhod označena. Nato ga lahko zaženete z elementom QML Test v kontekstnem meniju seznama datotek in rezultat bo viden v oknu.

Na žalost je zagon skriptov QML z uporabo `qml` (npr. `qml -apptype widget -I /usr/lib/kid3/plugins/imports /path/to/Example.qml`) pokvarjen v zadnjih različicah Qt. Toda `kid3-cli` ponuja alternativni način za zagon skripta QML iz ukazne vrstice z uporabo ukaza `execute`.

    kid3-cli -c "execute @qml /path/to/Example.qml"

Za seznam naslovov v oznakah 2 vseh datotek v trenutni mapi bi lahko uporabili naslednji skript:

    import Kid3 1.0

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

Če je v mapi veliko datotek, lahko tak skript blokira uporabnikov vmesnik za nekaj časa. Za daljše operacije mora imeti torej odmor od časa do časa. Spodnja alternativna izvedba ima deloza posamezno datoteko, premaknjeno v funkcijo. Ta funkcija se prikliče sama s časovno omejitvijo 1 ms na koncu, glede na to, da mora biti obdelanih več datotek. To bo zagotovilo, da &GUI; ostane odziven, medtem ko se skript izvaja.

    import Kid3 1.0

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

        app.firstFile()
        doWork()
      }
    }

Pri uporabi ukaza `app.firstFile()` z `app.nextFile()` bodo obdelane vse datoteke trenutne mape. Če to vpliva le na izbrane datoteke, uporabite `firstFile()` in `nextFile()` namesto tega so to priročne funkcije komponente `Kid3Script`. Naslednji primer je skript, ki kopira samo številko diska in okvire avtorskih pravic izbrane datoteke.

    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()
      }
    }

Več primerov skriptov je priloženih &kid3; in so že registrirani kot uporabniški ukazi.

- ReplayGain to SoundCheck (`ReplayGain2SoundCheck.qml`):Create iTunNORM SoundCheck information from replay gain frames.

- Spreminjanje velikosti naslovnice (`ResizeAlbumArt.qml`): Spremeni velikost vdelanih naslovnic, ki so večje od 500x500 slikovnih pik.

- Extract Album Art (`ExtractAlbumArt.qml`): Ekstrahiraj vse vdelane slike naslovnic, pri čemer se izogni dvojnikom.

- Embed Album Art (`EmbedAlbumArt.qml`): Vdelaj naslovnico, ki jo najdeš v slikovnih datotekah, v zvočne datoteke v isti mapi.

- Embed Lyrics (`EmbedLyrics.qml`): Pridobi nesinhronizirana besedila iz spletne storitve.

- Text Encoding ID3v1 (`ShowTextEncodingV1.qml`): pomaga najti kodiranje oznak ID3v1 tako, da prikaže oznake trenutne datoteke v vseh razpoložljivih kodiranjih znakov.

- ID3v1 to ASCII (`Tag1ToAscii.qml`): Prečrkuj razširjene latinične znake v oznaki ID3v1 v ASCII.

- English Title Case (`TitleCase.qml`): Oblikuje besedilo v oznakah v skladu z angleškimi naslovi.

- Rewrite Tags (`RewriteTags.qml`): Prepiši vse oznake v izbranih datotekah.

- Export CSV (`ExportCsv.qml`): Rekurzivno izvozi vse oznake vseh datotek v datoteko CSV.

- Import CSV (`ImportCsv.qml`): uvozi rekurzivno vse oznake vseh datotek iz datoteke CSV.

- Export JSON (`ExportJson.qml`): Rekurzivno izvozi vse oznake vseh datotek v datoteko JSON.

- Import JSON (`ImportJson.qml`): uvozi rekurzivno vse oznake vseh datotek iz datoteke JSON.

- Export Playlist Folder (`ExportPlaylist.qml`): Kopiraj vse datoteke s seznama predvajanja v mapo in jih preimenuj glede na njihov položaj.

- QML Console (`QmlConsole.qml`): Enostavna konzola za igranje z QML API &kid3;.

### QML API

API je mogoče preprosto raziskati s konzolo QML, ki je na voljo kot primer skripta z uporabniškim vmesnikom.

#### Kid3Script

`Kid3Script` je običajna komponenta QML, ki se nahaja znotraj mape vtičnika. Prav tako lahko uporabite drugo komponento QML. Uporaba `Kid3Script` olajša zagon funkcije skripta z uporabo `onRun` obdelovalnika signalov. Poleg tega ponuja nekaj funkcij:

    onRun: Signal handler which is invoked when the script is started
    tagv1, tagv2, tagv2v1: Constants for tag parameters
    script: Access to scripting functions
    configs: Access to configuration objects
    getArguments(): List of script arguments
    isStandalone(): true if the script was not started from within Kid3
    setTimeout(callback, delay): Starts callback after delay ms
    firstFile(): To first selected file
    nextFile(): To next selected file

#### Funkcije skriptiranja

Kot &javascript; ima zato tudi QML le omejen nabor funkcij za skriptiranje, zato ima objekt `script` nekaj dodatnih metod, na primer:

    script.properties(obj): String with Qt properties
    script.writeFile(filePath, data): Write data to file, true if OK
    script.readFile(filePath): Read data from file
    script.removeFile(filePath): Delete file, true if OK
    script.fileExists(filePath): true if file exists
    script.fileIsWritable(filePath): true if file is writable
    script.getFilePermissions(filePath): Get file permission mode bits
    script.setFilePermissions(filePath, modeBits): Set file permission mode bits
    script.classifyFile(filePath): Get class of file (folder "/", symlink "@", exe "*",
      file " ")
    script.renameFile(oldName, newName): Rename file, true if OK
    script.copyFile(source, dest): Copy file, true if OK
    script.makeDir(path): Create folder, true if OK
    script.removeDir(path): Remove folder, true if OK
    script.tempPath(): Path to temporary folder
    script.musicPath(): Path to music folder
    script.listDir(path, [nameFilters], [classify]): List folder entries
    script.system(program, [args], [msecs]): Synchronously start a system command,
      [exit code, standard output, standard error] if not timeout
    script.systemAsync(program, [args], [callback]): Asynchronously start a system
    command, callback will be called with [exit code, standard output, standard
    error]
    script.getEnv(varName): Get value of environment variable
    script.setEnv(varName, value): Set value of environment variable
    script.getQtVersion(): Qt version string, e.g. "5.4.1"
    script.getDataMd5(data): Get hex string of the MD5 hash of data
    script.getDataSize(data): Get size of byte array
    script.dataToImage(data, [format]): Create an image from data bytes
    script.dataFromImage(img, [format]): Get data bytes from image
    script.loadImage(filePath): Load an image from a file
    script.saveImage(img, filePath, [format]): Save an image to a file, true if OK
    script.imageProperties(img): Get properties of an image, map containing
      "width", "height", "depth" and "colorCount", empty if invalid image
    script.scaleImage(img, width, [height]): Scale an image, returns scaled image

#### Kontekst aplikacije

Z uporabo QML je dostopen velik del &kid3; funkcij. API jepodoben tistemu, ki se uporablja za &DBus;. Zapodrobnosti, glejte ustrezne opombe.

    app.openDirectory(path): Open folder
    app.unloadAllTags(): Unload all tags
    app.saveDirectory(): Save folder
    app.revertFileModifications(): Revert
    app.importTags(tag, path, fmtIdx): Import file
    app.importFromTags(tag, source, extraction): Import from tags
    app.importFromTagsToSelection(tag, source, extraction): Import from tags of selected files
    app.downloadImage(url, allFilesInDir): Download image
    app.exportTags(tag, path, fmtIdx): Export file
    app.writePlaylist(): Write playlist
    app.getPlaylistItems(path): Get items of a playlist
    app.setPlaylistItems(path, items): Set items of a playlist
    app.selectAllFiles(): Select all
    app.deselectAllFiles(): Deselect
    app.firstFile([select], [onlyTaggedFiles]): To first file
    app.nextFile([select], [onlyTaggedFiles]): To next file
    app.previousFile([select], [onlyTaggedFiles]): To previous file
    app.selectCurrentFile([select]): Select current file
    app.selectFile(path, [select]): Select a specific file
    app.getSelectedFilePaths([onlyTaggedFiles]): Get paths of selected files
    app.requestExpandFileList(): Expand all
    app.applyFilenameFormat(): Apply filename format
    app.applyTagFormat(): Apply tag format
    app.applyTextEncoding(): Apply text encoding
    app.numberTracks(nr, total, tag, [options]): Number tracks
    app.applyFilter(expr): Filter
    app.convertToId3v23(): Convert ID3v2.4.0 to ID3v2.3.0
    app.convertToId3v24(): Convert ID3v2.3.0 to ID3v2.4.0
    app.getFilenameFromTags(tag): Filename from tags
    app.getTagsFromFilename(tag): Filename to tags
    app.getAllFrames(tag): Get object with all frames
    app.getFrame(tag, name): Get frame
    app.setFrame(tag, name, value): Set frame
    app.getPictureData(): Get data from picture frame
    app.setPictureData(data): Set data in picture frame
    app.copyToOtherTag(tag): Tags to other tags
    app.copyTags(tag): Copy
    app.pasteTags(tag): Paste
    app.removeTags(tag): Remove
    app.playAudio(): Play
    app.readConfig(): Read configuration
    app.applyChangedConfiguration(): Apply configuration
    app.dirName: Folder name
    app.selectionInfo.fileName: File name
    app.selectionInfo.filePath: Absolute file path
    app.selectionInfo.detailInfo: Format details
    app.selectionInfo.tag(Frame.Tag_1).tagFormat: Tag 1 format
    app.selectionInfo.tag(Frame.Tag_2).tagFormat: Tag 2 format
    app.selectionInfo.formatString(tag, format): Substitute codes in format string
    app.selectFileName(caption, dir, filter, saveFile): Open file dialog to
    select a file
    app.selectDirName(caption, dir): Open file dialog to select a folder

Za asinhrone operacije je mogoče povratne klice povezati s signali.

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

#### Konfiguracija predmetov

Različni razdelki konfiguracije so dostopni prek metode `configs`. Njihove lastnosti so lahko navedene v QML konzoli.

    script.properties(configs.networkConfig())

Lastnosti lahko nastavite:

    configs.networkConfig().useProxy = false

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

&documentation.index;