kid3-core - Online in de cloud

PROGRAMMA:

NAAM

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

KORTE INHOUD

kid3 [--help | --help-qt | --help-kde | --Help iedereen
|--auteur | --versie | --vergunning] [FILE​

kid3-qt [Qt-opties] [FILE​

kid3-cli [-h | --help] [-c COMMANDO1] [-c COMMANDO2...] [FILE​

OPTIES

FILE
If FILE het pad naar een map is, wordt deze geopend. Als een of meer bestandspaden zijn
gegeven, wordt hun gemeenschappelijke map geopend en worden de bestanden geselecteerd.

kid3
--help
Help over opties weergeven.

--help-qt
Toon Qt-specifieke opties, zie opties(7).

--help-kde
Toon KDE-specifieke opties, zie kdeopties(7).

--Help iedereen
Toon alle opties.

--auteur
Auteursinformatie weergeven.

--versie
Versie-informatie weergeven.

--vergunning
Licentie-informatie weergeven.

kid3-qt
Qt-opties
Bekijk opties(7) de opties hebben echter "-" als voorvoegsel, niet "--".

kid3-cli
-c
Voer een opdracht uit. Meerdere -c opties mogelijk zijn, worden ze in volgorde uitgevoerd.
Zie de sectie over kid3-cli voor een beschrijving van de beschikbare commando's.

-h|--help
Help over opties en opdrachten weergeven.

INLEIDING

Kid3 is een applicatie om de ID3v1- en ID3v2-tags in MP3-bestanden op een efficiënte manier te bewerken.
Deze tags kunnen door de meeste MP3-spelers worden bewerkt, maar niet op een erg comfortabele en efficiënte manier
manier. Bovendien zijn de tags in Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex,
TrueAudio, WavPack, WMA, WAV, AIFF-bestanden en trackermodules (MOD, S3M, IT, XM) zijn
ook ondersteund.

Kid3 pakt of codeert geen MP3-bestanden, maar is bedoeld om de ID3-tags van allemaal te bewerken
bestanden van een album op een efficiënte manier, dat wil zeggen met zo weinig muisklikken en toetsaanslagen als
mogelijk. Waar de meeste andere programma's ID3v1- of ID3v2-tags kunnen bewerken, heeft Kid3 volledige
controle over beide versies, kan tags tussen de twee formaten converteren en heeft toegang tot alles
ID3v2-tags. Tags van meerdere bestanden kunnen op dezelfde waarde worden ingesteld, bijv. artiest, album,
jaar en genre van alle bestanden van een album hebben doorgaans dezelfde waarden en kunnen worden ingesteld
samen. Als de informatie voor de tags in de bestandsnaam staat, kunnen de tags
automatisch ingesteld op basis van de bestandsnaam. Het is ook mogelijk om de bestandsnaam in te stellen volgens
naar de tags in het bestand in willekeurige formaten.

De bewerkingstaak wordt verder ondersteund door automatische vervanging van tekens of
substrings, bijvoorbeeld om illegale tekens uit bestandsnamen te verwijderen. Automatische besturing van
hoofdletters en kleine letters maken het gemakkelijk om een ​​consistent naamgevingsschema te gebruiken
labels.

De tag-informatie voor volledige albums kan worden overgenomen uit: gnudb.org[1], TrackType.org[2],
MusicBrainz[3], Discogs[4], Amazone[5] of andere bronnen van tracklijsten. Het importformaat
is vrij configureerbaar door reguliere expressies.

Meld eventuele problemen of functieverzoeken aan de auteur.

GEBRUIK MAKEND VAN KID3

Kid3 functionaliteiten
· ID3v1.1-tags bewerken

· Bewerk alle ID3v2.3- en ID3v2.4-frames

· Bewerk tags van meerdere bestanden

· Converteren tussen ID3v1- en ID3v2-tags

· Bewerk MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio,
WavPack-, WMA-, WAV- en AIFF-tags

· Genereer tags van bestandsnaam

· Genereer tags uit de inhoud van tagvelden

· Genereer bestandsnaam van tags

· Genereer en wijzig directorynamen van tags

· Genereer afspeellijstbestand

· Automatische hoofdletterconversie en tekenreeksvertaling

· Importeren van gnudb.org[1], TrackType.org[2], MusicBrainz[3], Discogs[4], Amazone[5] en
andere gegevensbronnen

· Exporteren als CSV, HTML, afspeellijst, Kover XML en andere formaten. Geëxporteerde CSV-bestanden kunnen
weer geïmporteerd.

Voorbeeld Gebruik
Deze sectie beschrijft een typische sessie met Kid3. Laten we aannemen dat we een directory hebben
met mp3-bestanden met de nummers van het album "Let's Tag" van de band "One Hit
Wonder". De map wordt genoemd in het formaat "artist - album", in ons geval One Hit Wonder
- Laten we taggen. De directory bevat de tracks in het formaat "track title.mp3", wat ik
denk dat het handig is omdat de bestandsnamen kort zijn (belangrijk bij het gebruik van mobiele mp3-spelers
met kleine displays) en in de juiste volgorde indien alfabetisch gesorteerd (belangrijk wanneer
met behulp van hardware MP3-spelers die de nummers in alfabetische volgorde of in de volgorde in
welke ze op cd zijn gebrand en die volgorde is alfabetisch bij gebruik mkisofs). Daarnaast
dit, de artiest- en albuminformatie staat al in de mapnaam en heeft geen
te herhalen in de bestandsnaam. Maar terug naar ons voorbeeld, de directorylijst ziet er als volgt uit:
deze:

01 Intro.mp3

02 We hebben alleen deze.mp3

03 Outro.mp3

Deze bestanden hebben nog geen tags en we willen ze genereren met Kid3. We gebruiken Open (Bestand
menu of werkbalk) en selecteer een van de bestanden in deze map. Alle bestanden worden
weergegeven in de bestandslijst. Lui als we zijn, willen we de informatie in de
directory- en bestandsnamen om tags te genereren. Daarom selecteren we alle bestanden en klikken vervolgens op de
To:Tag 1-knop in het gedeelte Bestand. Hiermee worden de titel, artiest, album en track ingesteld
waarden in alle bestanden. Om de jaar- en genrewaarden van alle bestanden in te stellen, bewaren we alle bestanden
geselecteerd en typ "2002" voor het jaar en selecteer "Pop" in de keuzelijst Genre. Om in te stellen
alleen deze twee waarden, hun selectievakjes worden automatisch aangevinkt en alle andere selectievakjes
worden niet aangevinkt. Nu veranderen we de selectie door alleen het eerste bestand te selecteren en we
zorg ervoor dat alle tags de juiste waarden bevatten. De tags van de andere bestanden kunnen worden geverifieerd
ook door ze een voor een te selecteren. Als we tevreden zijn met de tags, gebruiken we Opslaan (Bestand
menu of werkbalk). Door Create Playlist te selecteren in het File-menu wordt een bestand One . gegenereerd
Druk op Wonder - Laten we Tag.m3u in de map plaatsen.

COMMAND REFERENTIE

De GUI Elementen
De Kid3 GUI is opgedeeld in vijf secties: Aan de linkerkant staan ​​het bestand en de directory
keuzelijsten, bevat de rechterkant de secties Bestand, Tag 1 en Tag 2.

Dien in Lijst
De bestandenlijst bevat de namen van alle bestanden in de geopende map die overeenkomen met
het geselecteerde bestandsnaamfilter (meestal *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). een enkele of
meerdere bestanden kunnen worden geselecteerd. Om geen bestand te selecteren, klikt u in het lege gebied na de
lijst met vermeldingen. De selectie bepaalt de bestanden die worden beïnvloed door de
bewerkingen die beschikbaar zijn met behulp van de hieronder beschreven knoppen.

Naast Naam kunnen ook andere kolommen Grootte, Type, Datum Gewijzigd met bestandsdetails zijn:
weergegeven. Kolommen kunnen worden verborgen door hun naam uit te vinken in het contextmenu van de
lijst kop. De volgorde van de kolommen kan worden gewijzigd door middel van drag'n'drop. De sorteervolgorde
kan worden omgeschakeld door op de kolomkop te klikken.

Links van de namen kan een pictogram worden weergegeven: een schijf om aan te geven dat het bestand:
gewijzigd of informatie over welke tags aanwezig zijn (V1, V2, V1V2 of GEEN TAG, nee
icoon wordt weergegeven als het bestand nog niet is ingelezen).

Directory's worden weergegeven met een mappictogram. Als een map wordt geopend, zijn de bestanden:
weergegeven in een hiërarchische boomstructuur. Door bestanden te selecteren uit submappen, operaties
kan worden uitgevoerd op bestanden in verschillende mappen, wat handig is als de muziek
collectie is georganiseerd met een map voor elke artiest met mappen voor albums van
deze kunstenaar.

Als u met de rechtermuisknop in de bestandenlijst klikt, wordt een contextmenu geopend met de
volgende commando's:

· Alles uitvouwen: vouwt alle mapstructuren uit (alleen de huidige structuur als de Shift-toets is
ingedrukt)

· Alles samenvouwen: vouwt alle mapstructuren samen

· Hernoemen: Wijzigt de naam van een bestand

· Verplaatsen naar prullenbak: Verplaatst een bestand naar de prullenbak

· Afspelen: Speelt een bestand af, zie Afspelen

· De volgende invoeren zijn gebruikerscommando's, die kunnen worden gedefinieerd in de Gebruikersacties
tabblad van Configureer Kid3. Daar kan ook het afspelen op dubbelklik worden geactiveerd.

Directory Lijst
De directorylijst bevat de namen van de directory's in de geopende directory, zoals:
evenals de huidige (.) en de bovenliggende (..) directory. Het stelt iemand in staat om snel te veranderen
de map zonder de opdracht Openen... of slepen en neerzetten te gebruiken.

Zichtbaarheid, volgorde en sortering van kolommen kunnen worden geconfigureerd zoals beschreven in de sectie
over de bestandenlijst.

Dien in
Toont informatie over de codering (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), bitrate, sample rate, kanalen en
de lengte van het bestand.

De bewerking in de regel Naam bevat de naam van het bestand (als er slechts één bestand is geselecteerd).
Als deze naam wordt gewijzigd, wordt het bestand hernoemd wanneer de opdracht Opslaan wordt gebruikt.

Het invoervak ​​met invoervak ​​Formaat en regelbewerking bevat het formaat dat moet worden gebruikt als de bestandsnaam is
gegenereerd op basis van de eerste of de tweede tag. De bestandsnaam kan willekeurig bevatten:
tekens, zelfs een directorygedeelte gescheiden door een schuine streep van de bestandsnaam, maar dat
map moet al bestaan ​​om het hernoemen te laten slagen. De volgende speciale codes:
worden gebruikt om tagwaarden in de bestandsnaam in te voegen:

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} Track (bijv. 01)

· %t %{track.n} Track met veldbreedte n (bijv. 001 voor %{track.3})

· %T %{tracknumber} Track (zonder voorloopnullen, bijv. 1)

· %g %{genre} Genre

· %{ignore} Genegeerd bij het genereren van tags van de bestandsnaam

De formaatcodes zijn niet beperkt tot de hierboven gegeven voorbeelden. Elke framenaam kan zijn
gebruikt, bijvoorbeeld uniforme framenamen zoals %{bpm} of formatteer specifieke namen zoals
%{popm}.

Een tweede Formaat combobox (met pijl naar beneden) wordt gebruikt om de tags te genereren uit de
bestandsnaam. Als het formaat van de bestandsnaam niet overeenkomt met dit patroon, een paar andere
veelgebruikte formaten worden uitgeprobeerd.

Sommige veelgebruikte bestandsnaamindelingen zijn al beschikbaar in de keuzelijst met invoervak, maar het is:
het is ook mogelijk om in een speciaal formaat in de regelbewerking te typen.

Van:Tag 1, Tag 2: Stelt de bestandsnaam in met het geselecteerde formaat en de eerste tag of
respectievelijk de tweede tag.

To:Tag 1, Tag 2: De tags worden ingesteld vanaf de bestandsnaam. Ten eerste, het formaat gespecificeerd in
Formaat wordt gebruikt. Als de bestaande bestandsnaam niet overeenkomt met dit formaat, gaat het volgende:
formaten worden geprobeerd:

· Artiest - Album/tracknummer

· Album/Track - Artiest - Nummer

· /Artiest - Album - Track - Nummer

· Album/Artiest - Nummer - Nummer

· Album/Artiest - Nummer

· Artiest/Album/Track Nummer

Als een enkel bestand is geselecteerd, worden de GUI-besturingselementen gevuld met de geëxtraheerde waarden
van de bestandsnaam. Als er meerdere bestanden zijn geselecteerd, worden de tags van de bestanden direct
ingesteld volgens de bestandsnamen.

Tag 1
De regelbewerkingswidgets voor Titel, Artiest, Album, Commentaar, Jaar, Track en Genre zijn:
gebruikt om de corresponderende waarde in de eerste tag van de geselecteerde bestanden te bewerken. De waarde
wordt gewijzigd wanneer de bestandsselectie wordt gewijzigd of vóór bewerkingen zoals Opslaan en
Sluit af en wanneer het bijbehorende selectievakje links van de veldnaam is aangevinkt.
Dit is handig om slechts enkele waarden te wijzigen en de andere waarden ongewijzigd te laten.

Als een enkel bestand is geselecteerd, zijn alle selectievakjes aangevinkt en de regelbewerkingswidgets
bevatten de waarden gevonden in de tags van dit bestand. Als er geen tag in het bestand wordt gevonden,
de bijbehorende lege waarde wordt weergegeven, wat een lege tekenreeks is voor de titel,
Artiest-, album- en commentaarregelbewerkingen, 0 voor de numerieke jaar- en trackbewerkingen en an
lege geselecteerde waarde voor de keuzelijst Genre. De waarden kunnen worden gewijzigd en als de
overeenkomstige selectievakje is aangevinkt, worden ze ingesteld voor het geselecteerde bestand na de
selectie wordt gewijzigd. Het bestand wordt dan gemarkeerd als gewijzigd door een schijfsymbool in het bestand
listbox maar blijft ongewijzigd totdat de opdracht Opslaan wordt gebruikt.

Als er meerdere bestanden zijn geselecteerd, alleen de waarden die identiek zijn in alle geselecteerde
bestanden worden weergegeven. In alle andere besturingselementen zijn de lege waarden zoals hierboven beschreven:
weergegeven. Alle selectievakjes zijn uitgeschakeld om ongewenste wijzigingen te voorkomen. Als een waarde moet
worden ingesteld voor alle geselecteerde bestanden, kan het worden bewerkt en moet het selectievakje worden ingesteld. De
waarden worden ingesteld voor alle geselecteerde bestanden wanneer de selectie wordt gewijzigd en kan worden
opgeslagen met de opdracht Opslaan.

De selectievakjes regelen ook de werking van de meeste opdrachten die van invloed zijn op de tags, zoals:
als kopiëren, plakken en overbrengen tussen tags 1 en 2. Om het gemakkelijker te maken om te gebruiken met
meerdere bestanden waar alle selectievakjes zijn uitgeschakeld, gedragen deze opdrachten zich hetzelfde
manier waarop alle selectievakjes zijn aangevinkt en wanneer alle selectievakjes zijn uitgeschakeld.

Van Tag 2: De tag 1-velden worden ingesteld op basis van de corresponderende waarden in tag 2. Als a
enkel bestand is geselecteerd, worden de GUI-besturingselementen gevuld met de waarden van tag 2. Als
meerdere bestanden zijn geselecteerd, worden de tags van de bestanden direct ingesteld.

Kopie: De kopieerbuffer is gevuld met de Tag 1-waarden. Alleen waarden met aangevinkt
aankruisvak zal worden gebruikt in volgende Plakken-commando's.

Plakken: plakt de waarden uit de kopieerbuffer in de GUI-besturingselementen.

Verwijderen: hiermee worden alle GUI-besturingselementen op hun lege waarden ingesteld, wat resulteert in verwijderen
alle waarden. Het opgeslagen bestand bevat dan geen tag 1.

Tag 2
De GUI-bedieningselementen werken op dezelfde manier als beschreven voor de Tag 1-sectie, maar de
grootte van de snaren is niet beperkt.

Voor de tag 2 Genre kun je naast de genres die in de . staan ​​ook je eigen namen gebruiken
combobox, typ gewoon de naam in de regel bewerken.

De tag 2 kan niet alleen dezelfde waarden bevatten als de tag 1, het formaat is gebouwd in a
flexibele manier van verschillende frames die zelf zijn samengesteld uit verschillende velden. De
tag 2 tabel toont alle frames die beschikbaar zijn in het geselecteerde bestand.

Bewerken: Dit opent een venster waarin u alle velden van de geselecteerde kunt bewerken
kader. Als er meerdere bestanden zijn geselecteerd, worden de bewerkte velden toegepast op alle geselecteerde
bestanden die zo'n frame bevatten.

Toevoegen: Er verschijnt een aanvrager om het frametype te selecteren en een frame van het geselecteerde type
kan worden bewerkt en aan het bestand worden toegevoegd. Dit werkt ook om een ​​frame aan meerdere toe te voegen
geselecteerde bestanden.

Verwijderen: verwijdert het geselecteerde frame in de geselecteerde bestanden.

Sleep albumillustraties hierheen wordt weergegeven als het bestand geen ingesloten albumhoezen bevat. EEN
foto kan worden toegevoegd door middel van slepen en neerzetten vanuit een browser of bestandsbeheerder en zal
hier weergegeven. Fotolijsten kunnen worden bewerkt of toegevoegd door hierop te dubbelklikken
controle.

Synchronized songtekst en Event timing Codes
Voor informatie die is gesynchroniseerd met de audiogegevens, is een specifieke editor beschikbaar.
Deze frames worden ondersteund voor ID3v2.3.0- en ID3v2.4.0-tags. Om zo'n frame toe te voegen, de
specifieke framenaam moet worden geselecteerd in de lijst die verschijnt wanneer de knop Toevoegen
is geklikt - respectievelijk gesynchroniseerde songteksten of gebeurtenistimingcodes. De redacteur is
hetzelfde voor beide typen, voor de gebeurtenistimingcodes, alleen een vooraf gedefinieerde set gebeurtenissen
is beschikbaar, terwijl voor de gesynchroniseerde songtekst tekst moet worden ingevoerd. In de
hierna wordt het bewerken van gesynchroniseerde songteksten uitgelegd.

Een bestand met een ID3v2-tag is geselecteerd, de teksteditor wordt ingevoerd met Toevoegen en
door Gesynchroniseerde songteksten te selecteren. Voor een bestaand frame met gesynchroniseerde songteksten is het:
geselecteerd en op Bewerken wordt geklikt. De speler wordt automatisch geopend met het huidige bestand
zodat het bestand kan worden afgespeeld en gepauzeerd om songteksten te synchroniseren.

De instellingen bovenaan de SYLT-editor hoeven normaal gesproken niet te worden gewijzigd. Als de
songtekst bevat karakters die niet aanwezig zijn in de Latin 1 karakterset,
het is raadzaam om de tekstcodering te wijzigen in UTF16 (of UTF8 voor ID3v2.4.0). Voor Engels
songteksten en maximale compatibiliteit, moet ISO-8859-1 worden gebruikt.

Het Lyrics-gedeelte heeft bovenaan vijf knoppen. Toevoegen voegt een nieuwe tijdgebeurtenis toe in de
tafel. De tijd wordt genomen vanaf de positie van de speler, waardoor een invoer wordt toegevoegd terwijl
het afspelen van de track zal een regel toevoegen voor de momenteel afgespeelde positie. De gebeurtenissen in de
tabel moet chronologisch worden geordend, daarom wordt de rij ingevoegd
overeenkomstig. Inschrijvingen met een ongeldige tijd worden speciaal behandeld: Als de huidige
geselecteerde rij heeft een ongeldige tijd, de tijdstempel wordt vervangen door de huidige tijd
in plaats van een nieuwe rij toe te voegen. Als de huidige tijd niet ongeldig is, wordt de eerste rij met een
ongeldige tijd zal worden gebruikt indien aanwezig. Dit gedrag zou het toevoegen van tijd moeten vergemakkelijken
stempels als de tekst van de songtekst al in de tabel staat, maar de tijdstempels ontbreken
(wat het geval is bij het importeren van niet-gesynchroniseerde songteksten). Merk op dat de ongeldige tijd
wordt weergegeven als 00:00.00, dwz hetzelfde als de tijd aan het absolute begin van de
track, die niet ongeldig is. Om een ​​tijd ongeldig te maken, drukt u op de Delete-toets of gebruikt u
Wis uit het contextmenu. Nieuwe rijen ingevoegd met Rij invoegen vanuit het contextmenu
of gemaakt bij het importeren van niet-gesynchroniseerde songteksten met Van klembord of ook importeren
ongeldige tijdstempels bevatten. Rijen in de tabel kunnen worden verwijderd door op de knop Verwijderen . te klikken
knop of door Rijen verwijderen uit het contextmenu te gebruiken.

Gesynchroniseerde songteksten kunnen worden geïmporteerd uit een bestand met behulp van Importeren. Het verwachte formaat is
eenvoudige of verbeterde LRC. Als het geselecteerde bestand geen vierkante haken bevat in de
eerste regel, het zou een eenvoudig tekstbestand moeten zijn met niet-gesynchroniseerde songteksten. De
regels uit zo'n bestand worden dan geïmporteerd met ongeldige tijdstempels. De tijd
informatie kan worden toegevoegd met behulp van de knop Toevoegen of door handmatige invoer. Het is ook mogelijk
om songteksten te importeren via kopiëren en plakken met Van klembord. Gesynchroniseerde songteksten kunnen
naar LRC-bestanden geschreven met behulp van Export. Houd er rekening mee dat alleen inzendingen met geldige tijdstempels zullen
worden geëxporteerd en dat de items op tijd worden gesorteerd. Inzendingen met ongeldige tijd
wordt ook niet opgeslagen in het SYLT-frame, dus zorg ervoor dat u alle timing opneemt
informatie voordat u het dialoogvenster verlaat.

De ID3 specificatie[6] suggereert een tijdstempel voor elke lettergreep. Maar de meeste spelers
ondersteunen alleen de granulariteit van een regel of zin. Om beide gebruiksscenario's te ondersteunen, heeft Kid3
volgt dezelfde conventies als SYLT editor[7]. Tekst die in de tabel wordt ingevoerd
wordt verondersteld een nieuwe regel te beginnen, tenzij deze begint met een spatie of een koppelteken. Uitzonderingen
aan deze regel zijn mogelijk door een regel te beginnen met een onderstrepingsteken ('_') om te forceren
voortzetting of een hekje ('#') om een ​​nieuwe regel te forceren. Deze escape-tekens zijn niet
opgeslagen in het SYLT-frame. Binnen het SYLT-frame beginnen nieuwe regels met een regelinvoer
karakter (hex 0A) terwijl voortzettingen dat niet doen. Bij het lezen van SYLT-frames, controleert Kid3
als de eerste invoer begint met een regelinvoer. Als dit niet het geval is, wordt aangenomen
dat alle ingangen nieuwe regels zijn en dat er geen lettergreepvervolgingen worden gebruikt.

Terwijl de track wordt afgespeeld, is de rij die is gekoppeld aan de huidige afspeelpositie:
gemarkeerd, zodat de juistheid van de synchronisatie-informatie kan worden
geverifieerd. Als er een offset moet worden toegevoegd aan een of meer tijdstempels, kan dit:
bereikt met het contextmenu Offset toevoegen. Negatieve waarden kunnen worden gebruikt om te verminderen
de tijd. Met Zoeken naar positie in het contextmenu is het mogelijk om de
afspeelpositie tot de tijd van de geselecteerde rij.

De Dien in Menu
Bestand → Openen... (Ctrl+O)
Opent een map. Alle bestanden die overeenkomen met het geselecteerde bestandsnaamfilter worden weergegeven
in de bestandslijst en het gekozen bestand is geselecteerd.

Bestand → Recent openen
Opent een recent geopende map.

Bestand → Map openen... (Ctrl+D)
Opent een map. Alle bestanden die overeenkomen met het geselecteerde bestandsnaamfilter worden weergegeven
in de bestandslijst.

Bestand → Opslaan (Ctrl+S)
Slaat alle gewijzigde bestanden op in de directory. De gewijzigde bestanden zijn gemarkeerd met een schijf
symbool in de bestandslijst. Als er bestandsnamen zijn gewijzigd, zijn die bestanden:
hernoemd.

Bestand → Terugzetten
Zet de wijzigingen van een of meerdere bestanden terug. Als er geen bestanden zijn geselecteerd in het bestand
listbox, worden de wijzigingen van alle bestanden ongedaan gemaakt, anders alleen de wijzigingen van de
geselecteerde bestanden worden teruggezet.

Bestand → Importeren...
Het dialoogvenster Importeren kan worden gebruikt om gegevens rechtstreeks van een freedb.org-server te importeren, van a
MusicBrainz-server, van Discogs, Amazon of andere bronnen van albumtracklijsten in
tekstueel formaat.

Importeren vanaf een freedb.org-server is mogelijk met behulp van een dialoogvenster dat verschijnt wanneer Van
Server:gnudb.org of TrackType.org is geselecteerd. De naam van de artiest en het album waarnaar moet worden gezocht
kan worden ingevoerd in de twee bovenste velden, de albums die overeenkomen met de zoekopdracht zijn:
weergegeven wanneer op Zoeken wordt geklikt en de resultaten van www.gnudb.org[8] worden ontvangen.
Het importeren van de trackgegevens voor een album doet u door te dubbelklikken op het album in de
lijst. De freedb.org-server om van te importeren kan worden geselecteerd, evenals het CGI-pad.
De geïmporteerde gegevens worden weergegeven in de voorbeeldtabel van het importdialoogvenster. Wanneer
tevreden bent met de weergegeven tracks, kunnen ze worden geïmporteerd door de import te beëindigen
dialoog met OK.

Een zoekopdracht op de Discogs-server kan worden uitgevoerd met Discogs. Zoals in de gnudb.org
dialoogvenster, kunt u artiest en album invoeren en vervolgens kiezen uit een lijst met releases. Indien
Standaardtags zijn gemarkeerd, de standaardinformatie wordt geïmporteerd, bijv. artiest, album en
titel. Als Extra tags is gemarkeerd, wordt indien beschikbaar meer informatie geïmporteerd, bijv
uitvoerders, arrangeurs of de uitgever. Als Cover Art is gemarkeerd, is Cover Art:
gedownload indien beschikbaar.

Een zoekopdracht op Amazon kan worden uitgevoerd met behulp van Amazon. Net als in het gnudb.org-dialoogvenster, kunt u:
voer artiest en album in en kies vervolgens uit een lijst met releases. Als extra tags is
gemarkeerd, wordt indien beschikbaar meer informatie geïmporteerd, bijv. uitvoerders, arrangeurs of de
uitgeverij. Als Cover Art is gemarkeerd, wordt de Cover Art gedownload indien beschikbaar.

U kunt op dezelfde manier zoeken in de releasedatabase van MusicBrainz met Van
MusicBrainz-release. De workflow is hetzelfde als beschreven voor Van gnudb.org.

Importeren vanaf een MusicBrainz-server is mogelijk met behulp van het dialoogvenster dat verschijnt wanneer Van
MusicBrainz-vingerafdruk is geselecteerd. De server kan worden geselecteerd zoals in de freedb
dialoogvenster importeren. Hieronder vindt u een tabel met de geïmporteerde trackgegevens. De rechterkolom
toont de status van de MusicBrainz-query, die begint met "In behandeling" wanneer het dialoogvenster
is geopend. Vervolgens wordt de vingerafdruk opgezocht en levert dit geen resultaat op,
een andere zoekopdracht met behulp van de tags in het bestand wordt geprobeerd. Het kan dus nuttig zijn voor een
succesvolle MusicBrainz-query om bekende informatie (bijv. artiest en album) op te slaan in de
tags vóór de import. Als er een resultaat is gevonden, eindigt de zoekopdracht in de staat
"Herkend", anders is er niets gevonden of meerdere dubbelzinnige resultaten en een van
ze moeten door de gebruiker worden geselecteerd. OK en Toepassen gebruik de geïmporteerde gegevens, Annuleren
sluit het dialoogvenster. De afsluiting kan even duren aangezien de hele MusicBrainz machinerie
moet worden afgesloten.

Voor het importeren van tekstuele gegevens opent Van bestand/klembord een subdialoogvenster, waar verschillende
vooraf geconfigureerde importformaten zijn beschikbaar. De eerste twee, "CSV niet geciteerd" en "CSV
quoted" kan worden gebruikt om gegevens te importeren die zijn geëxporteerd door het dialoogvenster Exporteren. De CSV
gegevens kunnen worden bewerkt met een spreadsheet en worden geschreven met tabs als scheidingstekens.
Importeren zou dan mogelijk moeten zijn met "CSV quoted", wat flexibeler is dan "CSV
unquoted". De velden mogen echter geen dubbele aanhalingstekens bevatten. Als u alleen exporteert
van Kid3 en later importeren, "CSV unquoted" kan hiervoor als een eenvoudig formaat worden gebruikt
doel. Merk op dat er ook "Export CSV" en "Import CSV" commando's in de
contextmenu van de bestandenlijst, die scripts gebruiken om CSV-gegevens te exporteren en te importeren in a
meer complete, krachtige en flexibele manier.

Het volgende formaat, "freedb HTML-tekst", kan worden gebruikt om informatie van een HTML-pagina te kopiëren
of freedb.org[9]. Zoek een album in freedb en als de gewenste informatie is
weergegeven in de webbrowser, kopieert u de inhoud naar het klembord. Klik vervolgens op de Van
Klembord-knop en de geïmporteerde tracks worden weergegeven in de voorbeeldtabel op de
bovenaan het dialoogvenster. Als u tevreden bent met de geïmporteerde gegevens, beëindigt u het dialoogvenster
met OK, waarmee de gegevens in de tags van de huidige map worden ingevoegd. De
bestemming (Tag 1, Tag 2 of Tag 1 en Tag 2) kan worden geselecteerd met een keuzelijst. De
bestanden in de huidige map moeten in de juiste trackvolgorde staan ​​om hun tags te krijgen
toegewezen. Dit is het geval als ze genummerd zijn.

Het volgende vooraf geconfigureerde importformaat, "freedb HTML source", kan worden gebruikt als de gegevens
is beschikbaar als een HTML-document. Importeren is mogelijk met de knop Uit bestand, die
opent een bestandskiezer, of kopieert de inhoud van een editor en importeert vervolgens uit
klembord. Deze indeling kan handig zijn voor offline import, hoewel het HTML-document
kan ook in een browser worden geopend en vervolgens in het eerste formaat worden geïmporteerd via de
klembord.

Meer voorgeconfigureerde formaten, bijv. "Track Title Time", zijn beschikbaar. Een lege gewoonte
formaat kan worden gemaakt met Toevoegen om door de gebruiker in te stellen. Twee regels onder de formaatnaam
kan worden ingesteld met een reguliere expressie om de velden uit de importtekst vast te leggen. De
de eerste reguliere expressie wordt één keer per document geparseerd om gegevens per album te verzamelen
zoals artiest, album, jaar en genre. De tweede regel wordt geprobeerd te matchen vanaf de
begin van het document naar het einde om trackgegevens te krijgen, meestal nummer en titel. De
reguliere expressies bevatten alle functies die door Qt worden aangeboden, wat het meeste is
Perl biedt. Bracketing-constructies "(..)" maken opnamebuffers voor de velden die moeten worden
import en worden voorafgegaan door Kid3-specifieke codes om aan te geven welk veld moet worden vastgelegd. De
codes zijn dezelfde als die worden gebruikt voor de bestandsnaamindeling, behalve de onderstaande codes,
elke framenaam is mogelijk:

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} spoor

· %g %{genre} Genre

· %d %{duur} Duur

Bijvoorbeeld een reguliere expressie van een track (tweede regel) om te importeren uit een .m3u-afspeellijst
kan "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]" zijn. Alle formaten kunnen worden gewijzigd
door de reguliere expressies en de naam te bewerken en vervolgens op Instellingen opslaan te klikken. Zij
wordt opgeslagen in het kid3rc-bestand in de configuratiemap. Dit bestand kan
direct bewerkt om meer importformaten te hebben of het kan worden verwijderd om terug te keren naar de
standaard formaten. Formaten kunnen worden verwijderd met Verwijderen.

Nauwkeurigheid toont een schatting van hoe goed de geïmporteerde informatie overeenkomt met de gegeven
sporen. Het gebruikt trackduur of bestandsnamen om de mate van overeenkomst in
procent. Cover Art toont de URL van de afbeelding van de albumhoes die wordt gedownload.

Om te controleren of de geïmporteerde tracks overeenkomen met de huidige set bestanden, moet de duur van:
de geïmporteerde tracks kunnen worden vergeleken met de duur van de bestanden. Deze optie kan zijn:
ingeschakeld met het selectievakje Controleer het maximaal toegestane tijdsverschil en het maximum
het getolereerde tijdsverschil kan in seconden worden ingesteld. Als een mismatch in een lengte is
gedetecteerd, wordt de lengte weergegeven met een rode achtergrond in de voorbeeldtabel.

Als de bestanden anders zijn geordend dan de geïmporteerde tracks, hun toegewezen tracks
veranderd moeten worden. Deze taak kan worden vergemakkelijkt met behulp van de Match met knoppen Lengte,
Track en Title, die de tracks opnieuw ordenen volgens het overeenkomstige veld.
Om de toewijzingen handmatig te corrigeren, kan een track worden gesleept met de linkermuisknop
en de Ctrl-toets ingedrukt houden en vervolgens op de nieuwe locatie laten vallen.

Wanneer het importdialoogvenster wordt geopend, bevat het de feitelijke inhoud van de tags. Het label
type (Tag 1, Tag 2, Tag 1 en Tag 2) kan worden geselecteerd met behulp van de keuzelijst Bestemming.
De knop rechts van deze combobox kan worden gebruikt om de tabel terug te zetten naar de
huidige inhoud van de tags. De selectievakjes in de eerste tabelkolom kunnen worden gebruikt om:
selecteer de tracks die worden geïmporteerd. Dit kan handig zijn als een map de . bevat
nummers van beide cd's van een dubbel-cd en alleen de nummers van de tweede cd hoeven
geïmporteerd.

Om de geïmporteerde tracks te identificeren, is het mogelijk om de bestandsnamen of
de volledige paden naar de bestanden met behulp van het contextmenu van de tabelkop. de waarden in
de importtabel kan worden bewerkt. De terug-knop rechts van de Bestemming
combobox kan worden gebruikt om de inhoud van de tags te herstellen, wat ook handig kan zijn
na het wijzigen van de bestemming.

Bijna alle dialoogvensters hebben een knop Instellingen opslaan, die kan worden gebruikt om de
dialoogspecifieke instellingen en de venstergrootte blijvend.

Van tags leidt naar een subdialoogvenster om tagframes in te stellen op basis van de inhoud van een andere tag
kozijnen. Dit kan worden gebruikt om eenvoudig informatie tussen tags te kopiëren of een onderdeel te extraheren
van het ene frame en plaats het in een ander.

Net als bij het importeren uit bestand/klembord, zijn er vrij configureerbare formaten om uit te voeren
verschillende operaties. Reeds voorgeconfigureerd zijn formaten om de albumwaarde naar te kopiëren
Albumartiest, Componist of Dirigent, en om het tracknummer uit titelvelden te extraheren
die een nummer bevatten. Er is ook een indeling om een ​​ondertitel uit een titel te extraheren
veld.

In het volgende voorbeeld wordt uitgelegd hoe u een aangepaste indeling kunt toevoegen, waarmee de informatie wordt ingesteld
uit het veld Ondertitel ook in het veld Opmerking. Maak een nieuw formaat aan met Toevoegen en
stel een nieuwe naam in, bijv. "Ondertitel bij commentaar". Voer vervolgens "%{subtitle}" in Bron in en
"%{comment}(.*)" voor Extractie en klik op Instellingen opslaan.

De uitdrukking in Bron kan opmaakcodes bevatten voor willekeurige tagframes, meerdere
codes kunnen worden gebruikt om de inhoud van verschillende frames te combineren. Voor elke track, a
tekst wordt gegenereerd op basis van de tags met behulp van het bronformaat en de reguliere expressie
van Extraction wordt op deze tekst toegepast om nieuwe waarden voor de tags in te stellen. Formaat codes
worden gebruikt vóór de vastleghaakjes om het tagframe te specificeren waar de vastgelegde
tekst wordt opgeslagen. Het werkt op dezelfde manier als voor het importeren uit bestand/klembord.

Bestand → Importeren van gnudb.org...
Importeer vanaf een freedb.org-server met behulp van gnudb.org-albumzoekfunctie. Dit menu-item wordt geopend
hetzelfde importvenster als Importeren..., maar opent direct het gnudb.org-dialoogvenster.

Bestand → Importeren van TrackType.org...
Importeer vanaf de TrackType.org-server. Dit menu-item opent hetzelfde importvenster als:
Importeren..., maar opent direct het dialoogvenster TrackType.org.

Bestand → Importeren uit Discogs...
Importeer vanaf de Discogs-server. Dit menu-item opent hetzelfde importvenster als:
Importeren..., maar opent direct het dialoogvenster Van Discogs.

Bestand → Importeren van Amazon...
Importeren van Amazon. Dit menu-item opent hetzelfde importvenster als Importeren..., maar
opent direct het dialoogvenster Van Amazon.

Bestand → Importeren uit MusicBrainz Release...
Importeer uit de MusicBrainz-releasedatabase. Dit menu-item opent dezelfde import
dialoogvenster als Importeren..., maar opent direct het dialoogvenster Van MusicBrainz Release.

Bestand → Importeren van MusicBrainz-vingerafdruk...
Importeren vanaf een MusicBrainz-server. Dit menu-item opent hetzelfde importvenster als:
Importeren..., maar opent direct het dialoogvenster Van MusicBrainz-vingerafdruk.

Bestand → Automatisch importeren...
Automatisch importeren maakt het mogelijk om informatie voor meerdere albums van verschillende websites te importeren
Diensten. Als mappen zijn geselecteerd in de bestandenlijst, trackgegevens voor de geselecteerde
mappen worden geïmporteerd. Als er geen map is geselecteerd, alle mappen in het bestand
lijst wordt geïmporteerd.

Het tagtype (Tag 1, Tag 2, Tag 1 en Tag 2) kan worden geselecteerd met behulp van de Bestemming
combobox.

Profielen bepalen met welke servers contact wordt opgenomen om albuminformatie op te halen. Sommige
profielen zijn vooraf gedefinieerd (Alle, MusicBrainz, Discogs, Cover Art), aangepaste profielen kunnen worden
toegevoegd met behulp van de knop Toevoegen rechts van de keuzelijst Profiel.

De onderstaande tabel toont de servers die worden gebruikt bij het importeren van albuminformatie
met het geselecteerde profiel. Het importproces voor een album is voltooid als alles
vereiste informatie is gevonden, dus de volgorde van de rijen in de tabel is
belangrijk. Het kan worden gewijzigd met de knoppen Omhoog en Omlaag. Bewerken kan zijn
gebruikt om een ​​bestaande invoer te wijzigen. De Server-selectie biedt dezelfde servers als can
worden gebruikt in de importfuncties. Standaard Tags, Extra Tags, Cover Art bepalen
de informatie die van de server moet worden opgehaald. Tot slot, nauwkeurigheid is de
minimale nauwkeurigheid die moet worden bereikt om de geïmporteerde gegevens te accepteren. Als de nauwkeurigheid
onvoldoende is, wordt de volgende server in de lijst geprobeerd. Hetzelfde dialoogvenster met
de servereigenschappen verschijnen wanneer op Toevoegen wordt geklikt om een ​​nieuw serveritem toe te voegen. bestaande
vermeldingen kunnen worden verwijderd met Verwijderen.

Klik op Start om een ​​automatische batchimport met het geselecteerde profiel te starten. Details
over de lopende import worden bovenaan het dialoogvenster weergegeven. Het proces kan zijn:
afgebroken met de knop Afbreken.

Bestand → Door albumhoezen bladeren...
Het dialoogvenster Bladeren omslagafbeeldingen helpt bij het vinden van albumhoezen. Artiest/Album is gevuld
van de tags indien mogelijk. Source biedt een verscheidenheid aan websites met albumhoezen.
De URL met artiest en album als parameters vind je onder de naam. URL-gecodeerd
waarden voor artiest en album kunnen worden ingevoegd met %u{artiest} en %u{album}andere
waarden van de tags zijn ook mogelijk, zoals beschreven in Kid3 configureren, Gebruikersacties.
Er kunnen meer bronnen worden ingevoerd na de invoer "Aangepaste bron" door "Aangepast" te vervangen
Source" met de naam van de bron, druk op Enter, voer dan de URL in en tot slot
door op Instellingen opslaan te drukken. Het resulterende browsercommando wordt bovenaan het scherm weergegeven
dialoogvenster en kan worden gestart door op Bladeren te klikken. De browser, die kan worden geconfigureerd in
de instellingen, wordt gestart met de geselecteerde bron. Een omslagafbeelding kan dan worden gesleept
vanuit de browser naar het Kid3-venster en wordt in het fotolijstje van de
geselecteerde bestanden.

Omdat niet alle browsers slepen en neerzetten van afbeeldingen en de afbeeldingen op websites ondersteunen
hebben vaak een URL, in dergelijke gevallen ontvangt Kid3 de URL en niet de afbeelding. Als de
URL verwijst naar een afbeelding, deze wordt gedownload. Als de URL echter verwijst naar een
andere webresource, moet deze worden vertaald naar de bijbehorende afbeelding. Zo een
toewijzingen worden gedefinieerd in de tabel-URL-extractie. De linkerkolom Match bevat een
reguliere expressie die wordt vergeleken met de URL. Als het overeenkomt, wordt de vastgelegde
uitdrukkingen tussen haakjes worden ingevoegd in het patroon van de juiste afbeeldings-URL
kolom (op de posities gemarkeerd met \1 etc.). De vervangen reguliere expressie
bevat de URL van de afbeelding. Op deze manier kan albumhoes worden geïmporteerd uit Amazon,
Google Afbeeldingen, enz. met drag'n'drop. Het is ook mogelijk om uw eigen te definiëren
toewijzingen.

Bestand → Exporteren...
De Export Dialog wordt gebruikt om gegevens van de tags op te slaan in een bestand of het klembord. De
editor bovenaan toont een voorbeeld van de te exporteren gegevens. Als de exportgegevens bevatten:
tabulatortekens, wordt de export weergegeven in een tabel. De gegevens worden gegenereerd
van de tags in de huidige map volgens het geconfigureerde formaat.

De formaatinstellingen zijn vergelijkbaar met die in het dialoogvenster Importeren: Het bovenste veld bevat
de titel (bijv. "CSV zonder aanhalingstekens"), gevolgd door de koptekst, die wordt gegenereerd op
het begin van het bestand. De trackgegevens volgen; het wordt voor elk nummer gebruikt. Eindelijk,
de trailer kan worden gebruikt om wat afwerkingstekst te genereren.

De opmaakvelden bevatten geen reguliere expressies zoals in het dialoogvenster Importeren, maar alleen
output formaat expressies met speciale %-expressies, die zullen worden vervangen door waarden
van de labels. Het hele ding werkt als de bestandsnaamindeling, en dezelfde codes zijn:
gebruikt plus enkele extra codes. Niet alleen de onderstaande codes, maar alle tagframes
namen kunnen worden gebruikt.

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} Track (bijv. 01)

· %t %{track.n} Track met veldbreedte n (bijv. 001 voor %{track.3})

· %T %{tracknumber} Track (zonder voorloopnullen, bijv. 1)

· %g %{genre} Genre

· %f %{file} Bestandsnaam

· %p %{bestandspad} Pad

· %u %{url} URL

· %d %{duration} Duur in minuten:seconden

· %D %{seconds} Duur in seconden

· %n %{tracks} Aantal nummers van het album

· %e %{extension} Bestandsextensie

· %O %{tag1} Het formaat van tag 1 (ID3v1.1 of leeg indien niet aanwezig)

· %o %{tag2} Het formaat van tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF, of leeg indien niet aanwezig)

· %b %{bitrate} Bitsnelheid in kbit/s

· %v %{vbr} VBR of leeg (alleen voor ID3v2.3 met id3lib)

· %r %{samplerate} Bemonsteringsfrequentie in Hz

· %m %{mode} Kanaalmodus (Stereo of Joint Stereo)

· %h %{channels} Aantal kanalen (1 of 2)

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

Een paar formaten zijn vooraf gedefinieerd. "CSV niet geciteerd" scheidt de velden door tabs. Gegevens in
dit formaat kan opnieuw worden geïmporteerd in Kid3 met behulp van het importformaat met hetzelfde
naam. "CSV aangehaald" omsluit de velden bovendien met dubbele aanhalingstekens, wat de
importeren in spreadsheet-applicaties. De velden mogen echter geen dubbele
aanhalingstekens wanneer dit formaat wordt gebruikt. "Extended M3U" en "Extended PLS" genereren afspeellijsten
met uitgebreide attributen en absolute padnamen. "HTML" kan worden gebruikt om een
HTML-pagina met hyperlinks naar de tracks. "Kover XML" creëert een bestand dat kan worden
geïmporteerd door het omslagdrukprogramma Kover. "Technische details" geeft informatie
over bitrate, sample rate, kanalen, enz. Ten slotte wordt "Aangepast formaat" leeg gelaten voor
definitie van een aangepast formaat. U kunt meer eigen formaten definiëren door lijnen toe te voegen
in het bestand kid3rc in de configuratiemap. De andere formaten kunnen worden aangepast aan:
je behoeften.

De bron van de tags om de exportgegevens te genereren (Tag 1 of Tag 2) kan worden geselecteerd
met een combobox. Door naar bestand of naar klembord te duwen, worden de gegevens in een bestand of op de
klembord. OK en Annuleren sluiten het dialoogvenster, terwijl OK het huidige dialoogvenster accepteert
instellingen.

Bestand → Afspeellijst maken
Maakt een afspeellijst. Het formaat en de inhoud van de afspeellijst kan worden ingesteld door verschillende
opties.

De naam van de afspeellijst kan hetzelfde zijn als de naam van de map of gebruik een formaat met waarden
van de tags, bijv. "%{artist} - %{album}" om de naam van de artiest en het album in de
bestandsnaam van de afspeellijst. De formaatcodes zijn hetzelfde als voor Export. De extensie is afhankelijk van:
op het afspeellijstformaat.

De locatie van de gegenereerde playlist wordt bepaald door de selectie van de Create in
combobox.

Huidige map
De afspeellijst wordt gemaakt in de huidige map en bevat alleen bestanden van de
huidige map.

Elke map
Er wordt een afspeellijst gemaakt in elke map die bestanden in de lijst bevat, en elke
playlist bevat de bestanden van die map.

Directory op het hoogste niveau
Er wordt slechts één afspeellijst gemaakt in de map op het hoogste niveau (dwz de map van de
bestandslijst) en het bevat de vermelde bestanden van de map op het hoogste niveau en alle
zijn submappen.

Het formaat van de afspeellijst kan M3U, PLS of XSPF zijn.

Als Alleen de geselecteerde bestanden opnemen is aangevinkt, worden alleen de geselecteerde bestanden:
opgenomen in de afspeellijst. Als een map is geselecteerd, worden alle bestanden geselecteerd.
Als dit selectievakje niet is ingeschakeld, worden alle audiobestanden in de afspeellijst opgenomen.

Sorteren op bestandsnaam selecteert het gebruikelijke geval waarin de bestanden op bestandsnaam worden geordend.
Met Sorteren op tag-veld is het mogelijk om te sorteren op een formaattekenreeks met waarden uit tag
velden. "%{track.3}" kan bijvoorbeeld worden gebruikt om te sorteren op tracknummer (de ".3" is
gebruikt om drie cijfers te krijgen met voorloopnullen omdat strings worden gebruikt voor het sorteren). Het
het is ook mogelijk om meerdere velden te gebruiken, bijv. "%{genre}%{year}" om te sorteren met een string
samengesteld uit genre en jaartal.

De afspeellijstitems hebben relatieve of absolute bestandspaden, afhankelijk van of:
Relatief pad gebruiken voor bestanden in afspeellijst of Volledig pad gebruiken voor bestanden in afspeellijst is ingesteld.

Als Alleen lijst met bestanden schrijven is ingesteld, bevat de afspeellijst alleen de paden naar de
bestanden. Om een ​​uitgebreide afspeellijst met aanvullende informatie te genereren, een format string
kan worden ingesteld met behulp van de Schrijf info met besturing.

Bestand → Afsluiten (Ctrl+Q)
Sluit de toepassing af.

De Edit Menu
Bewerken → Alles selecteren (Alt+A)
Selecteert alle bestanden.

Bewerken → Deselecteren (Ctrl+Shift+A)
Deselecteert alle bestanden.

Bewerken → Alles selecteren in map
Selecteert alle bestanden van de huidige map.

Bewerken → Vorig bestand (Alt+Up)
Selecteert het vorige bestand.

Bewerken → Volgend bestand (Alt+Omlaag)
Selecteert het volgende bestand.

Bewerken → Zoeken... (Ctrl+F)
Zoek strings in de bestandsnamen en de tags. Het dialoogvenster Zoeken is een subset van de
Dialoogvenster Vervangen, dat hieronder wordt beschreven.

Bewerken → Vervangen... (Ctrl+R)
Deze functie opent een dialoogvenster voor het zoeken en vervangen van tekenreeksen in de bestandsnamen en de
labels. De set frames waarin de zoekopdracht wordt uitgevoerd, kan worden beperkt door:
het deactiveren van het selectievakje Alles selecteren en het selecteren van de frames die moeten worden doorzocht.
Er zijn ook zoekopties beschikbaar om achteruit, hoofdlettergevoelig te zoeken en om
gebruik reguliere expressies.

Afhankelijk van het aantal bestanden kan het zoeken enige tijd in beslag nemen, daarom kan het:
afgebroken door het dialoogvenster te sluiten.

De Tools Menu
Hulpmiddelen → Bestandsnaamindeling toepassen
Als Formatteren tijdens bewerken is uitgeschakeld voor het bestandsnaamformaat in de configuratie
dialoogvenster, kan dit menu-item worden gebruikt om het geconfigureerde formaat toe te passen op de namen van de
geselecteerde bestanden. Dit kan ook worden gebruikt om te controleren of de bestandsnamen voldoen aan de
geconfigureerd formaat door het formaat toe te passen op alle opgeslagen bestanden en vervolgens te controleren of deze er zijn
bestanden zijn gewijzigd (en daarom gemarkeerd met een schijfsymbool in de bestandslijst).

Hulpmiddelen → Tag-indeling toepassen
Als Formaat tijdens bewerken is uitgeschakeld voor het tagformaat in de configuratie
dialoogvenster, kan dit menu-item worden gebruikt om het geconfigureerde formaat toe te passen op de tags van de
geselecteerde bestanden. Dit kan ook worden gebruikt om te controleren of de tags voldoen aan de
geconfigureerd formaat door het formaat toe te passen op alle opgeslagen bestanden en vervolgens te controleren of deze er zijn
bestanden zijn gewijzigd (en daarom gemarkeerd met een schijfsymbool in de bestandslijst).

Hulpmiddelen → Tekstcodering toepassen
Stelt de tekstcodering in die is geselecteerd in Instellingen/Kid3 configureren.../Tags/Tag 2 voor iedereen
geselecteerde bestanden. Als UTF8 is geselecteerd, wordt UTF16 gebruikt voor ID3v2.3.0-tags omdat:
UTF8 wordt niet ondersteund voor dit formaat.

Extra → Naam directory wijzigen...
Dit dialoogvenster biedt de mogelijkheid om de momenteel geopende
directory volgens de tags in de bestanden. Verschillende formaten zijn vooraf geconfigureerd om:
informatie over artiest, album en jaar opnemen in de directorynaam. Het is ook
mogelijk om een ​​aangepast formaat in te stellen, de volgende speciale codes worden gebruikt om een ​​tag in te voegen:
waarden in de mapnaam:

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} Track (bijv. 01)

· %t %{track.n} Track met veldbreedte n (bijv. 001 voor %{track.3})

· %T %{tracknumber} Track (zonder voorloopnullen, bijv. 1)

· %g %{genre} Genre

Als een mapscheidingsteken "/" wordt gevonden in het formaat, worden er meerdere mappen gemaakt.
Als u een nieuwe map wilt maken in plaats van de huidige map te hernoemen,
selecteer Directory maken in plaats van Directory hernoemen. De bron van de tag-informatie
kan worden gekozen tussen Van Tag 1 en Tag 2, Van Tag 1 en Van Tag 2. Een preview voor
de hernoemingsbewerking die op het eerste bestand is uitgevoerd, is te zien in de Van en Naar
secties van het dialoogvenster.

Meerdere mappen kunnen worden hernoemd door ze te selecteren.

Hulpmiddelen → Nummersporen...
Als de tracknummers in de tags niet zijn ingesteld of de verkeerde waarden hebben, deze functie
kan de tracks automatisch in oplopende volgorde nummeren. Het startnummer kan worden ingesteld in
de dialoog. Als slechts een deel van de sporen genummerd moet worden, moeten deze worden geselecteerd.

Als Totaal aantal tracks is aangevinkt, wordt het aantal tracks ook ingesteld in de
labels.

Het is mogelijk om de tracks over meerdere mappen te nummeren. De mappen moeten
uitgebreid en geselecteerd.

Als Teller resetten voor elke directory is aangevinkt, wordt de tracknummering opnieuw gestart met de
gegeven nummer voor elke map wanneer meerdere mappen zijn geselecteerd.

Het nummertracks-dialoogvenster kan ook worden gebruikt om bestaande tracknummers op te maken zonder
het wijzigen van de waarden wanneer het selectievakje links naar Startnummer is gedeactiveerd. Het totaal
het aantal tracks wordt toegevoegd als het bijbehorende selectievakje actief is, wat kan zijn:
gebruikt om het totaal voor alle geselecteerde tracks in te stellen. Als alleen de opmaak van de bestaande
nummers gewenst is, moet dit selectievakje ook worden uitgeschakeld.

Hulpmiddelen → Filteren...
Het filter kan worden gebruikt om alleen die bestanden weer te geven die aan bepaalde criteria voldoen. Dit
is handig als u een grote verzameling wilt ordenen en alleen die bestanden wilt bewerken die
niet in het gewenste schema. De uitdrukking die definieert welke bestanden moeten worden weergegeven, gebruikt de
dezelfde formaatcodes die worden gebruikt in de bestandsnaamindeling, import en export.

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} Track (bijv. 01)

· %t %{track.n} Track met veldbreedte n (bijv. 001 voor %{track.3})

· %T %{tracknumber} Track (zonder voorloopnullen, bijv. 1)

· %g %{genre} Genre

· %f %{file} Bestandsnaam

· %p %{filepath} Absoluut pad naar bestand

· %e %{extension} Bestandsextensie

· %O %{tag1} Het formaat van tag 1 (ID3v1.1 of leeg indien niet aanwezig)

· %o %{tag2} Het formaat van tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF, of leeg indien niet aanwezig)

· %b %{bitrate} Bitsnelheid in kbit/s

· %v %{vbr} VBR of leeg (alleen voor ID3v2.3 met id3lib)

· %r %{samplerate} Bemonsteringsfrequentie in Hz

· %m %{mode} Kanaalmodus (Stereo of Joint Stereo)

· %h %{channels} Aantal kanalen (1 of 2)

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

· %1a %1{artist}, ... Gebruik het voorvoegsel 1 om de waarden van tag 1 te krijgen

· %2a %2{artist}, ... Gebruik het voorvoegsel 2 om de waarden van tag 2 te krijgen

Deze codes worden vervangen door de waarden voor het bestand, en de resulterende strings kunnen
worden vergeleken met de volgende bewerkingen:

· s1 is gelijk aan s2: waar als s1 en s2 gelijk zijn.

· s1 bevat s2: waar als s1 s2 bevat, dwz s2 is een substring van s1.

· s komt overeen met re: waar als s overeenkomt met de reguliere expressie re.

True-expressies worden vervangen door 1, false door 0. True-waarden worden weergegeven door 1,
waar, aan en ja, onwaar met 0, onwaar, uit en nee. Booleaanse bewerkingen zijn niet,
en, of (in deze volgorde van prioriteit) en kan worden gegroepeerd door haakjes.

Sommige filterregels zijn vooraf gedefinieerd en kunnen als voorbeeld dienen voor uw eigen expressies:

Alles
Wanneer de bestandslijst is gefilterd, wordt dit weergegeven door "[gefilterd]" in de titel van het venster
- en alle bestanden worden opnieuw weergegeven, de filtering kan hiermee worden teruggedraaid
filter. Het gebruikt een lege uitdrukking, maar een echte waarde zou hetzelfde effect hebben.

Bestandsnaamtag komt niet overeen
niet (%{bestandspad} bevat "%{artiest} - %{album}/%{nummer} %{titel}")

Test of het bestandspad overeenkomt met de bestandsnaamindeling. Deze regel is:
automatisch aangepast als het formaat van de bestandsnaam verandert.

Geen tag 1
%{tag1} is gelijk aan ""

Geeft alleen bestanden weer die geen tag 1 hebben.

Geen tag 2
%{tag2} is gelijk aan ""

Geeft alleen bestanden weer die geen tag 2 hebben.

ID3v2.3.0-tag
%{tag2} is gelijk aan "ID3v2.3.0"

Geeft alleen bestanden weer die een ID3v2.3.0-tag hebben.

ID3v2.4.0-tag
%{tag2} is gelijk aan "ID3v2.4.0"

Geeft alleen bestanden weer die een ID3v2.4.0-tag hebben.

Label 1 != Label 2
niet (%1{titel} is gelijk aan %2{titel} en %1{album} is gelijk aan %2{album} en %1{artiest}
is gelijk aan %2{artiest} en %1 reactie} is gelijk aan %2 reactie} en %1 jaar} is gelijk aan %2 jaar}
en %1{track} is gelijk aan %2{track} en %1{genre} is gelijk aan %2{genre})

Toont bestanden met verschillen tussen tag 1 en tag2.

Label 1 == Label 2
%1{titel} is gelijk aan %2{titel} en %1{album} is gelijk aan %2{album} en %1{artiest} is gelijk aan
%2{artiest} en %1 reactie} is gelijk aan %2 reactie} en %1 jaar} is gelijk aan %2 jaar} en
%1{track} is gelijk aan %2{track} en %1{genre} is gelijk aan %2{genre}

Geeft bestanden weer met identieke tag 1 en tag 2.

Onvolledig
%{titel} is gelijk aan "" or %{artiest} is gelijk aan "" or %{album} is gelijk aan "" or %{jaar} is gelijk aan
"" or %{tracknummer} is gelijk aan "" or %{genre} is gelijk aan ""

Toont bestanden met lege waarden in de standaard tags (titel, artiest, album, datum,
tracknummer, genre).

Geen beeld
%{afbeelding} is gelijk aan ""

Geeft alleen bestanden weer die geen afbeelding hebben.

Aangepast filter
Selecteer dit item om uw eigen filter toe te voegen. Als u bijvoorbeeld een
filter voor artiesten die beginnen met "The", vervang "Custom Filter" door de naam "The
Bands" en druk op Enter. Voeg vervolgens de volgende uitdrukking in de regelbewerking in:

%{artiest} lucifers "De.*"

Klik vervolgens op Instellingen opslaan. Klik op Toepassen om de bestanden te filteren. Alle verwerkte bestanden zijn:
weergegeven in de tekstweergave, met een "+" voor degenen die overeenkomen met het filter en een "-"
voor de anderen. Als u klaar bent, worden alleen de bestanden met een artiest die begint met "The"
worden weergegeven en de titel van het venster is gemarkeerd met "[gefilterd]".

Hulpmiddelen → Converteer ID3v2.3 naar ID3v2.4
Als er ID3v2.3-tags in de geselecteerde bestanden staan, worden deze geconverteerd naar ID3v2.4
labels. Frames die niet door TagLib worden ondersteund, worden verwijderd. Alleen bestanden zonder
niet-opgeslagen wijzigingen worden geconverteerd.

Hulpmiddelen → Converteer ID3v2.4 naar ID3v2.3
Als er ID3v2.4-tags in de geselecteerde bestanden staan, worden deze geconverteerd naar ID3v2.3
labels. Alleen bestanden zonder niet-opgeslagen wijzigingen worden geconverteerd.

Hulpmiddelen → Afspelen
Dit opent een eenvoudige werkbalk om audiobestanden af ​​te spelen. Het bevat knoppen voor de basis
bewerkingen (afspelen/pauzeren, afspelen stoppen, vorig nummer, volgend nummer, sluiten), schuifregelaars voor
positie en volume en een weergave van de huidige positie. Als meerdere bestanden zijn
geselecteerd, worden de geselecteerde tracks afgespeeld, anders worden alle bestanden afgespeeld.

De Instellingen Menu
Instellingen → Werkbalk tonen
Schakelt de weergave van de werkbalk in.

Instellingen → Statusbalk tonen
Schakelt de weergave van de statusbalk in, die langere acties weergeeft, zoals openen of
een map opslaan.

Instellingen → Afbeelding tonen
Schakelt de weergave van de voorbeeldafbeelding van de albumhoes in.

Instellingen → Tags automatisch verbergen
Lege tags worden automatisch verborgen als deze optie actief is. Het bestand, tag 1 en tag
2 secties kunnen handmatig worden samengevouwen en uitgevouwen door op de bijbehorende -/+ . te klikken
knoppen.

Instellingen → Kid3 configureren...
Opent de configuratiedialoog, die bestaat uit pagina's voor tags, bestanden, gebruikersacties,
en netwerkinstellingen.

Tag-specifieke opties zijn te vinden op de pagina Tags, die zelf is onderverdeeld in:
drie tabbladen voor Tag 1, Tag 2 en Tag 1 en Tag 2.

Als Afgekapte velden markeren is aangevinkt, worden afgekapte ID3v1.1-velden rood gemarkeerd. De
tekstvelden van ID3v1.1-tags mogen slechts 30 tekens bevatten, de opmerking slechts 28
karakters. Ook het genre en de tracknummers zijn beperkt, zodat velden kunnen worden
afgekapt wanneer geïmporteerd of overgedragen van ID3v2. Afgekapte velden en het bestand zal
rood worden gemarkeerd en de markering wordt verwijderd nadat het veld is bewerkt.

Met tekstcodering voor ID3v1 is het mogelijk om de tekenset in te stellen die wordt gebruikt in ID3v1
labels. Deze codering zou ISO-8859-1 moeten zijn, dus het wordt aanbevolen om deze te behouden
standaardwaarde. Er zijn echter tags met verschillende codering, dus het kan zijn:
stel hier in en de ID3v1-tags kunnen vervolgens worden gekopieerd naar ID3v2 die Unicode ondersteunt.

Het selectievakje Gebruik track/totaal aantal tracks formaat bepaalt of de track
nummerveld van ID3v2-tags bevat alleen het tracknummer of bovendien het totaal
aantal nummers in de directory.

Als Genre als tekst in plaats van numerieke tekenreeks is aangevinkt, worden alle ID3v2-genres
opgeslagen als een tekenreeks, zelfs als er een corresponderende code is voor ID3v1-genres. Indien
deze optie is niet ingesteld, genres waarvoor een ID3v1-code bestaat, worden opgeslagen als het nummer
van de genrecode (tussen haakjes voor ID3v2.3). Zo wordt het genre Metal opgeslagen als
"Metaal" of "(9)", afhankelijk van deze optie. Genres die niet in de lijst van ID3v1 staan
genres worden altijd opgeslagen als een tekenreeks. Het doel van deze optie is verbeterd
compatibiliteit met apparaten die genrecodes niet correct interpreteren.

Tekstcodering definieert de standaardcodering die wordt gebruikt voor ID3v2-frames en kan worden ingesteld op:
ISO-8859-1, UTF16 of UTF8. UTF8 is niet geldig voor ID3v2.3.0-frames; als het is ingesteld,
In plaats daarvan wordt UTF16 gebruikt. Voor ID3v2.4.0-frames zijn alle drie de coderingen mogelijk.

Versie gebruikt voor nieuwe tags bepaalt of nieuwe ID3v2-tags als versie worden gemaakt
2.3.0 of 2.4.0. In het eerste geval wordt id3lib gebruikt zoals het was in eerdere versies van
Kid3 en TagLib worden alleen toegepast wanneer een ID3v2.4.0-tag wordt aangetroffen. In de seconde
case, ID3v2.4.0 (TagLib), TagLib wordt over het algemeen gebruikt voor MP3-bestanden; veranderd of nieuw
gemaakte tags worden vervolgens opgeslagen in versie 2.4.0. Wanneer ID3v2.3.0 (TagLib) is geselecteerd,
TagLib wordt ook gebruikt voor ID3v2.3.0-tags.

Tracknummercijfers is het aantal cijfers in Tracknummervelden. Voorloopnullen zijn
gebruikt om te lappen. Bij een waarde van 2 wordt bijvoorbeeld het tracknummer 5 op "05" gezet.

De combobox Naam van het veld Opmerking is alleen relevant voor Ogg/Vorbis- en FLAC-bestanden en
stelt de naam in van het veld dat voor opmerkingen wordt gebruikt. Verschillende toepassingen lijken te gebruiken
verschillende namen, "COMMENT" bijvoorbeeld wordt gebruikt door xmms, terwijl amaroK gebruik maakt van
"OMSCHRIJVING".

Het formaat van afbeeldingen in Ogg/Vorbis-bestanden wordt bepaald door de afbeeldingsveldnaam, die
kan METADATA_BLOCK_PICTURE of COVERART zijn. De eerste is de officiële standaard en gebruikt
hetzelfde formaat als afbeeldingen in FLAC-tags. COVERART is een eerdere onofficiële manier om
foto's opnemen in Vorbis-opmerkingen. Het kan worden gebruikt voor compatibiliteit met legacy
spelers.

Als het selectievakje Markeren indien groter dan is geactiveerd, worden bestanden met ingesloten album
albumhoezen die de opgegeven grootte in bytes overschrijden, zijn rood gemarkeerd. Dit kan worden gebruikt om te vinden
bestanden met te grote afbeeldingen die door sommige toepassingen niet worden geaccepteerd en
spelers. De standaardwaarde is 131072 bytes (128 KB).

Aangepaste genres kunnen worden gebruikt om genres te definiëren die niet beschikbaar zijn in de standaard
genrelijst, bijv. "Gothic Metal". Dergelijke aangepaste genres verschijnen in de keuzelijst Genre
van Tag 2. Voor ID3v1.1-tags kunnen alleen de vooraf gedefinieerde genres worden gebruikt.

De lijst met aangepaste genres kan ook worden gebruikt om het aantal beschikbare genres in
de Genre-combobox voor diegene die doorgaans worden gebruikt. Als je verzameling voornamelijk muziek bevat
in de genres Metal, Gothic Metal, Ancient en Hard Rock kun je in die genres terecht
en markeer Alleen aangepaste genres weergeven. De Tag 2Genre-combobox bevat dan alleen:
die vier genres en je hoeft niet door de volledige lijst met genres te zoeken
hen. In dit voorbeeld worden alleen Metal en Hard Rock vermeld in de tag 1-genres
lijst, omdat die twee aangepaste genres-items standaardgenres zijn. Als Toon alleen aangepast
genres niet actief is, vindt u de aangepaste genres aan het einde van de lijst met genres.

Quick Access Frames definieert welke frametypes altijd worden getoond in de Tag 2 sectie.
Dergelijke frames kunnen dan worden toegevoegd zonder eerst de knop Toevoegen te gebruiken. De volgorde van deze
snelle toegangsframes kunnen worden gewijzigd door items te slepen en neer te zetten.

Tag Format bevat opties voor het formaat van de tags. Wanneer Formatteren tijdens bewerken is
aangevinkt, wordt de formaatconfiguratie automatisch gebruikt tijdens het bewerken van tekst in de regel
bewerkingen. De hoofdletterconversie kan worden ingesteld op Geen wijzigingen, Alle kleine letters, Alle hoofdletters,
Eerste letter hoofdletter of Alle eerste letters hoofdletters. Om locale-bewuste conversie te gebruiken
tussen kleine letters en hoofdletters, kan een landinstelling worden geselecteerd in de combobox
onderstaand. De lijst met stringvervangingen kan worden ingesteld op willekeurige stringtoewijzingen. om een ​​toe te voegen
nieuwe toewijzing, selecteer de Van cel van een rij en voeg de tekst in die u wilt vervangen, ga dan naar
de kolom Aan en voer de vervangende tekst in. Om een ​​toewijzing te verwijderen, stelt u de Van cel in op
een lege waarde (bijvoorbeeld door eerst spatie te typen en dan backspace). Invoegen en verwijderen
rijen is ook mogelijk met behulp van een contextmenu dat verschijnt wanneer de rechtermuisknop
wordt geklikt. Vervanging is alleen actief als het selectievakje Stringvervanging is aangevinkt.

Op de pagina Bestanden kan het selectievakje Laad laatst geopende bestanden worden gemarkeerd zodat Kid3 dit doet
open en selecteer het laatst geselecteerde bestand wanneer het de volgende keer wordt gestart. Beschermen
bestandstijdstempel kan worden gecontroleerd om de tijdstempel van de bestandswijziging te behouden. Bestandsnaam
voor omslag stelt de naam in die wordt voorgesteld wanneer een ingesloten afbeelding wordt geëxporteerd naar a
bestand.

Als Wijzigingen markeren actief is, worden gewijzigde velden gemarkeerd met een lichtgrijs label
achtergrond.

Bestandsnaam Formaat bevat opties voor het formaat van de bestandsnamen. Dezelfde opties als
in Tag-formaat zijn beschikbaar.

De pagina Gebruikersacties bevat een tabel met de opdrachten die beschikbaar zijn in de
contextmenu van de bestandenlijst. Voor kritieke bewerkingen zoals het verwijderen van bestanden is het:
raadzaam om Bevestigen te markeren om een ​​bevestigingsvenster te openen voordat u de
opdracht. Uitvoer kan worden gemarkeerd om de uitvoer te zien die is geschreven door consolecommando's (standaard
output en standaardfout). Naam is de naam die wordt weergegeven in het contextmenu. Opdracht
is de opdrachtregel die moet worden uitgevoerd. Argumenten kunnen worden doorgegeven met behulp van de volgende codes:

· %F %{files} Bestandspaden (een lijst als er meerdere bestanden zijn geselecteerd)

· %f %{file} Bestandspad naar enkel bestand

· %uF %{urls} URL's (een lijst als er meerdere bestanden zijn geselecteerd)

· %uf %{url} URL naar enkel bestand

· %d %{directory} Directory

· %s %{title} Titel (Song)

· %a %{artist} Artiest

· %l %{album} Album

· %c %{comment} Opmerking

· %y %{jaar} Jaar

· %t %{track} Track (bijv. 01)

· %t %{track.n} Track met veldbreedte n (bijv. 001 voor %{track.3})

· %T %{tracknumber} Track (zonder voorloopnullen, bijv. 1)

· %g %{genre} Genre

· %b %{browser} Commando om de webbrowser te starten

· %q %{qmlpath} Basismap van verstrekte QML-bestanden

De speciale code @scheidingsteken kan worden ingesteld als een opdracht om een ​​scheidingsteken in te voegen in de
contextmenu gebruikersacties. Menu-items kunnen in een submenu worden geplaatst door ze in te sluiten met
@beginmenu en @eindmenu commando's. De naam van het submenu wordt bepaald door de Naam
kolom van de @beginmenu opdracht.

Om QML-scripts uit te voeren, @qml wordt gebruikt als een opdrachtnaam. Het pad naar het QML-script is
doorgegeven als parameter. De meegeleverde scripts zijn te vinden in de map
%{qmlpath}/script/ (op Linux meestal /usr/share/kid3/qml/script/, op Windows
qml/script/ in de installatiemap en op OS X in de app-map
kid3.app/Contents/Resources/qml/script/). Aangepaste scripts kunnen worden opgeslagen in elke
map. Als de QML-code GUI-componenten gebruikt, @qmlview wordt gebruikt in plaats van
@qml. Aanvullende parameters worden doorgegeven aan het QML-script waar ze beschikbaar zullen zijn
via de getArgumenten() functie. Een overzicht van enkele functies en eigenschappen die:
beschikbaar zijn in QML vindt u in de bijlage QML Interface.

Het commando dat zal worden ingevoegd met %{browser} kan worden gedefinieerd in de webbrowser
regel bewerking hierboven. Commando's die beginnen met %{browser} kunnen worden gebruikt om informatie op te halen
over de audiobestanden van internet, bijvoorbeeld

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

zal de songtekst van het huidige nummer opvragen in LyricWiki[10]. De "u" in %u{artist} en
%u{title} wordt gebruikt om de informatie over de artiest %{artist} en het nummer %{title} te coderen. Het
is eenvoudig om uw eigen zoekopdrachten op dezelfde manier te definiëren, bijvoorbeeld een afbeelding zoeken met
Kopen Google Reviews[11]:

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

Als u albumhoezen wilt toevoegen aan tag 2, kunt u afbeeldingen zoeken met Google of Amazon met behulp van
de hierboven beschreven commando's. De afbeelding kan met slepen en neerzetten aan de tag worden toegevoegd.
U kunt ook een afbeelding toevoegen met Toevoegen, vervolgens de Afbeeldingslijst selecteren en een afbeelding importeren
bestand of plak vanaf het klembord. Fotolijsten worden ondersteund voor ID3v2, MP4, FLAC,
Ogg- en ASF-tags.

Om items in de tabel toe te voegen en te verwijderen, kan een contextmenu worden gebruikt.

De netwerkpagina bevat alleen een veld om het proxyadres in te voeren en optioneel de
poort, gescheiden door een dubbele punt. De proxy wordt gebruikt bij het importeren vanaf een internet
server wanneer het selectievakje is aangevinkt.

Op de pagina Plug-ins kunnen beschikbare plug-ins worden in- of uitgeschakeld. De plug-ins zijn:
verdeeld in twee secties. De lijst met plug-ins en prioriteiten voor metagegevens bevat plug-ins
die audiobestandsindelingen ondersteunen. De volgorde van de plug-ins is belangrijk omdat ze
worden van boven naar beneden uitgeprobeerd. Sommige formaten worden ondersteund door meerdere plug-ins, dus bestanden
wordt geopend met de eerste plug-in die ze ondersteunt. De TaglibMetadata ondersteunt de meeste
formaten, als het bovenaan de lijst staat, worden de meeste bestanden geopend. Als je wilt
om een ​​andere plug-in voor een bestandsindeling te gebruiken, moet u ervoor zorgen dat deze wordt vermeld vóór de
TaglibMetadata-plug-in. Details over de metadata-plug-in en waarom u deze misschien wilt gebruiken
ze in plaats van TagLib staan ​​hieronder vermeld.

· Id3libMetadata: Gebruik id3lib[12] voor ID3v1.1- en ID3v2.3-tags in MP3, MP2, AAC
bestanden. Ondersteunt nog een paar frametypes dan TagLib. Een andere reden om het te gebruiken is:
dat TagLib alleen ID3v2.3 ondersteunt sinds versie 1.8.

· OggFlacMetadata: gebruik libogg[13], libvorbis, libvorbisbestand[14] voor Ogg-bestanden, en
bovendien libFLAC++ en libFLAC[15] voor FLAC-bestanden. Redenen om ze te gebruiken zijn:
afbeeldingen in Ogg-bestanden, die niet worden ondersteund door TagLib en dat dit de
officiële bibliotheken voor deze formaten.

· TaglibMetadata: Gebruik TagLib[16] die veel audiobestandsindelingen ondersteunt. Sinds
versie 1.8, het ondersteunt ook ID3v2.3, dus het kan voor alle audiobestanden worden gebruikt
ondersteund door Kid3.

· Mp4v2Metagegevens: mp4v2[17] werd oorspronkelijk door Kid3 gebruikt om M4A-bestanden te ondersteunen.
Nieuwere versies van TagLib bieden echter goede M4A-ondersteuning, dus deze plug-in niet
standaard gebouwd.

In het gedeelte Beschikbare plug-ins worden de resterende plug-ins weergegeven. Hun bestelling is niet
belangrijk, maar ze kunnen worden in- of uitgeschakeld met behulp van de selectievakjes.

· AmazonImport: Gebruikt voor de functie Importeren uit Amazon....

· DiscogsImport: Gebruikt voor de functie Importeren uit Discogs....

· FreedbImport: Gebruikt voor het importeren van gnudb.org... en importeren van
TrackType.org... functies.

· MusicBrainzImport: Gebruikt voor de functie Importeren vanuit MusicBrainz Release....

· AcoustidImport: wordt gebruikt voor de functie Importeren vanuit MusicBrainz Fingerprint...,
dat hangt af van de Chromaafdruk[18] en Libav[19] bibliotheken.

Plug-ins die zijn uitgeschakeld, worden niet geladen. Dit kan worden gebruikt om de bron te optimaliseren
gebruik en opstarttijd. De instellingen op deze pagina worden pas van kracht na een herstart van
Kind3.

Instellingen → Snelkoppelingen configureren...
Opent een dialoogvenster om sneltoetsen toe te wijzen voor de meeste programmafuncties. Daar
zijn zelfs functies zonder bijbehorend menu of knop beschikbaar, bijv. volgend bestand,
vorig bestand, alles selecteren.

De Help Menu
Help → Kid3-handboek
Opent dit handboek.

Help → Over Kid3
Toont een korte informatie over Kid3;.

KID3-CLI

commando's
kid3-cli biedt een opdrachtregelinterface voor Kid3. Als een directorypad wordt gebruikt, wordt de
map wordt geopend. Als een of meer bestandspaden zijn opgegeven, wordt de gemeenschappelijke map geopend
en de bestanden zijn geselecteerd. Volgende opdrachten werken dan op deze bestanden. Commando's
worden gespecificeerd met behulp van -c opties. Als er meerdere opdrachten worden doorgegeven, worden deze uitgevoerd in de
opdracht gegeven. Als bestanden worden gewijzigd door de opdrachten, worden ze aan het einde opgeslagen. Als Nee
opdrachtopties worden doorgegeven, kid3-cli start in de interactieve modus. Commando's kunnen worden ingevoerd
en werkt op de huidige selectie. De volgende secties geven een lijst van alle beschikbare
commando's.

Help
hulp [COMMANDO-NAAM]

Geeft hulp weer over de parameters van COMMANDO-NAAM of over alle commando's indien geen commando
naam wordt gegeven.

Timeout
time-out [standaard | uit | TIJD]

Overschrijf de standaard time-out voor opdrachten. De CLI-opdrachten worden afgebroken na een specifieke opdracht
time-out is verlopen. Deze time-out is 10 seconden voor ls en albumhoes, 60 seconden voor
automatisch importeren en filter, en 3 seconden voor alle andere opdrachten. Als een groot aantal bestanden
moet worden verwerkt, kan deze time-out te beperkend zijn, dus de time-out voor iedereen
commando's kunnen worden ingesteld op: TIJD ms, helemaal uitgeschakeld of standaard laten staan
waarden.

Verlaten toepassing
afrit [kracht]

Sluit app af. Als er gewijzigde niet-opgeslagen bestanden zijn, dwingen parameter is
vereist.

Veranderen directory
cd [DIRECTORY]

Zo nee DIRECTORY wordt gegeven, ga naar de homedirectory. Als er een directory is opgegeven,
veranderen in de directory. Als een of meer bestandspaden worden gegeven, verander dan naar hun common
map en selecteer de bestanden.

Print de actueel werkzaam directory
pwd

Druk de bestandsnaam van de huidige werkdirectory af.

Directory lijst
ls

Maak een lijst van de inhoud van de huidige map. Dit komt overeen met de bestandenlijst in de
Kid3 GUI. Vier tekens voor de bestandsnamen geven de status van het bestand aan.

· > Bestand is geselecteerd.

· * Bestand is gewijzigd.

· 1 Bestand heeft een tag 1, anders wordt '-' weergegeven.

· 2 Bestand heeft een tag 2, anders wordt '-' weergegeven.

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

In dit voorbeeld hebben alle bestanden een tag 1, het tweede bestand heeft ook een tag 2 en het is
geselecteerd. Het derde bestand wordt gewijzigd.

Bespaar de veranderd bestanden
besparen

kies filet
kiezen [alle | geen | eerst | vorige | volgende | FILE​

Om alle bestanden te selecteren, typt u kiezen allen, om alle bestanden te deselecteren, typ kiezen geen. naar
doorloop de bestanden in de huidige map beginnen met kiezen eerste, ga dan vooruit
gebruik kiezen volgende of achteruit met behulp van kiezen vorig. Specifieke bestanden kunnen worden toegevoegd aan
de huidige selectie door hun bestandsnamen op te geven. Wildcards zijn mogelijk, dus kiezen
* .mp3 selecteert alle MP3-bestanden in de huidige map.

kid3-cli> kiezen eerste
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 We hebben alleen deze.mp3
*1- 03 Outro.mp3
kid3-cli> kiezen volgende
kid3-cli> ls
1- 01 Inleiding.mp3
> 12 02 We Only Got This One.mp3
*1- 03 Outro.mp3
kid3-cli> kiezen * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 We Only Got This One.mp3
>*1- 03 Outro.mp3

kies label
label [TAG-NUMMERS]

Veel commando's hebben een optionele TAG-NUMMERS parameter, die aangeeft of de
commando werkt op tag 1 of tag 2. Als deze parameter wordt weggelaten, wordt de standaard tag
cijfers worden gebruikt, die met dit commando kunnen worden ingesteld. Bij het opstarten is is ingesteld op 12, wat:
betekent dat informatie wordt gelezen van tag 2 indien beschikbaar, anders van tag 1; wijzigingen
zijn gedaan op tag 2. De TAG-NUMMERS kan worden ingesteld op 1 or 2 om alleen te werken op de
bijbehorende label. Als de parameter wordt weggelaten, wordt de huidige instelling weergegeven.

Krijgen label omlijsting
krijgen [alle | FRAME-NAAM] [TAG-NUMMERS]

Deze opdracht kan worden gebruikt om de waarde van een specifiek tagframe te lezen of om informatie te krijgen
over alle tagframes (als het argument is weggelaten of allen is gebruikt). Gewijzigde frames zijn:
gemarkeerd met een '*'.

kid3-cli> krijgen
Bestand: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
Naam: 01 Intro.mp3
Label 1: ID3v1.1
Titel Intro
Artiest One Hit Wonder
Album Laten we taggen
Datum 2013
Tracknummer 1
Genre-pop
kid3-cli> krijgen titel
Intro

Om de inhoud van een fotolijst in een bestand op te slaan, gebruik

krijgen afbeelding:"/pad/naar/map.jpg"

Om gesynchroniseerde songteksten op te slaan in een LRC-bestand, gebruik

krijgen SYLT:"/pad/naar/lyrics.lrc"

Zet de label omlijsting
reeks {FRAME-NAAM​FRAME-WAARDE} [TAG-NUMMERS]

Deze opdracht stelt de waarde van een specifiek tagframe in.

kid3-cli> reeks remixer "OH Vraag me af"

Om de inhoud van een fotolijst uit een bestand in te stellen, gebruik

reeks afbeelding:"/pad/naar/map.jpg" "Afbeelding Beschrijving"

Om gesynchroniseerde songteksten van een LRC-bestand in te stellen, gebruik

reeks SYLT:"/pad/naar/lyrics.lrc" "Songtekst Beschrijving"

Terugkeren
terugkeren

Zet alle wijzigingen in de geselecteerde bestanden terug (of alle bestanden als er geen bestanden zijn
geselecteerd).

import oppompen van filet or klembord
importeren {FILE​FORMAAT-NAAM} [TAG-NUMMERS]

Tags worden geïmporteerd uit het bestand FILE (of van het klembord als klembord is gebruikt voor
FILE) in het formaat met de naam FORMAAT-NAAM (bv "CSV niet geciteerd", zie Importeren).

Automatisch importeren
automatisch importeren [PROFIELNAAM] [TAG-NUMMERS]

Batchimport met profiel PROFIELNAAM (zie Automatisch importeren, "Alle" wordt gebruikt als
overgeslagen).

Downloaden album deksel kunstwerk
albumhoes {URL} [alle]

Stel de albumillustraties in door een afbeelding te downloaden van URL. De regels gedefinieerd in de
Dialoogvenster Cover Art bladeren wordt gebruikt om algemene URL's (bijv. van Amazon) om te zetten in een
foto URL. Gebruik de opdracht set om de albumhoes in te stellen vanuit een lokaal afbeeldingsbestand.

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

Exporteren naar filet or klembord
exporteren {FILE​FORMAAT-NAAM} [TAG-NUMMERS]

Tags worden geëxporteerd naar bestand FILE (of naar het klembord als klembord is gebruikt voor FILE) in
het formaat met de naam FORMAAT-NAAM (bv "CSV niet geciteerd", zie Exporteren).

creëren afspeellijst
afspeellijst

Maak een afspeellijst in het formaat dat is ingesteld in de configuratie, zie Afspeellijst maken.

Solliciteer bestandsnaam formaat
bestandsnaamformaat

Pas de bestandsnaamindeling toe die is ingesteld in de configuratie, zie Bestandsnaamindeling toepassen.

Solliciteer label formaat
tagformaat

Pas de tagnaamindeling toe die is ingesteld in de configuratie, zie Tagindeling toepassen.

Solliciteer tekst codering
tekstcodering

Tekstcodering toepassen die is ingesteld in de configuratie, zie Tekstcodering toepassen.

andere naam geven directory
hernoemd naar ir [FORMAT] [maak | hernoemen | oefening] [TAG-NUMMERS]

Hernoem of maak mappen aan van de waarden in de tags volgens een gegeven FORMAT
(bv %{artiest} - %{album}, zie Directory hernoemen), als er geen formaat is opgegeven, het formaat
gedefinieerd in het dialoogvenster Naam directory wijzigen, wordt gebruikt. De standaardmodus is andere naam geven; maken
mappen, en je merk te creëren expliciet moet worden gegeven. De hernoemingsacties worden uitgevoerd
onmiddellijk, om gewoon te zien wat er zou worden gedaan, gebruik de oefening optie.

Telefoon Nummer tracks
nummersporen [TRACK-NUMMER] [TAG-NUMMERS]

Nummer de geselecteerde tracks beginnend met TRACK-NUMMER (1 indien weggelaten).

FILTER
filter [FILTERNAAM | FILTER-FORMAAT]

Filter de bestanden zodat alleen de bestanden overeenkomen met de FILTER-FORMAAT zijn zichtbaar. De
naam van een vooraf gedefinieerde filterexpressie (bijv "Bestandsnaam Tag komt niet overeen") kan worden gebruikt
in plaats van een filterexpressie, zie Filter.

kid3-cli> filter '%{titel} bevat "tro"'
Begonnen
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
- 02 We hebben alleen deze.mp3
+ 03 Outro.mp3
Geëindigd
kid3-cli> ls
1- 01 Inleiding.mp3
1-03 Outro.mp3
kid3-cli> filter Alles
Begonnen
/home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
+ 02 We hebben alleen deze.mp3
+ 03 Outro.mp3
Geëindigd
kid3-cli> ls
1- 01 Inleiding.mp3
12 02 We hebben alleen deze.mp3
1-03 Outro.mp3

Converteren Id3v2.3 naar Id3v2.4
to24

Converteren Id3v2.4 naar Id3v2.3
to23

Bestandsnaam oppompen van label
vantag [FORMAT] [TAG-NUMMERS]

Stel de bestandsnamen van de geselecteerde bestanden in op basis van waarden in de tags, bijvoorbeeld vantag
"%{spoor} - %{titel}" 1. Als er geen formaat is opgegeven, wordt het formaat gebruikt dat in de GUI is ingesteld.

Tag oppompen van bestandsnaam
merken [FORMAT] [TAG-NUMMERS]

Stel bijvoorbeeld de tagframes van de bestandsnamen in merken "%{album artiest} -
%{album}/%{nummer} %{titel}" 2. Als er geen formaat is opgegeven, is het formaat dat in de GUI is ingesteld:
gebruikt. Als het formaat van de bestandsnaam niet overeenkomt met dit patroon, zijn er een paar andere veelvoorkomende
gebruikte formaten worden uitgeprobeerd.

Tag naar anders label
synchroniseren met {ETIKET NUMMER}

Kopieer de tagframes van de ene tag naar de andere tag, bijv. om de ID3v2-tag van de . in te stellen
ID3v1-tag, gebruik synchroniseren met 2.

Kopiëren
kopiëren [ETIKET NUMMER]

Kopieer de tagframes van het geselecteerde bestand naar de interne kopieerbuffer. Ze kunnen dan
stel in op een ander bestand met behulp van de pasta opdracht.

pasta
pasta [ETIKET NUMMER]

Stel tagframes in vanuit de inhoud van de kopiëren buffer in de geselecteerde bestanden.

verwijderen
verwijderen [ETIKET NUMMER]

Een label verwijderen.

Spelen
spelen [pauze | stop | vorige | De volgende]

Start het afspelen van audio. Als het eenmaal is gestart, kan het worden bestuurd met de pauze
(om te pauzeren en te hervatten), stoppen, vorig en volgende opties.

Voorbeelden
Stel albumomslag in alle bestanden van een map in met behulp van de batchimportfunctie:

kid3-cli -c 'automatisch importeren' "Hoes Kunst"' /pad/naar/directory

Verwijder commentaarframes en pas het tagformaat toe in beide tags van alle MP3-bestanden van a
directory:

kid3-cli -c 'set commentaar "" 1' -c 'set commentaar "" 2' \
-c 'tagformaat' 1' -c 'tagformaat' 2' /pad/naar/dir/*.mp3

Automatisch tag 2 importeren, synchroniseren met tag 1, bestandsnamen instellen van tag 2 en tot slot
maak een afspeellijst:

kid3-cli -c automatisch importeren -c 'synchroniseren' 1' -c vantag -c afspeellijst \
/pad/naar/dir/*.mp3

Voor alle bestanden met een ID3v2.4.0-tag, converteer naar ID3v2.3.0 en verwijder het arrangerframe:

kid3-cli -c "filter 'ID3v2.4.0' Label'" -c "selecteer alle" -c to23 \
-c "set regelen ''" /pad/naar/directory

Dit Python-script gebruikt kid3-cli om iTunes Sound Check iTunNORM-frames te genereren van
informatie over het afspelen van informatie.

#!/usr/bin/env python
# Genereer iTunes Sound Check van ReplayGain.
van __future__ import print_function
import os, sys, subproces

def rg2sc(pad):
voor root, dirs, bestanden in os.walk(dirpath):
voor naam in bestanden:
if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join(root, naam)
rg = subproces.check_output([
'kid3-cli', '-c', 'get "replaygain_track_gain"',
fn]).strip()
als rg.eindigtmet(b' dB'):
rg = rg[:-3]
Probeer het volgende:
rg = zweven (rg)
behalve ValueError:
print('Waarde %s van %s in geen float' % (rg, fn))
voortzetten
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
subproces.call([
'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

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

CREDITS EN LICENTIE

Kid3

Programma geschreven door Urs Fleisch

LDF[20]

LPG[21]

INSTALLATIE

Hoe naar verkrijgen Kid3
Kid3 is te vinden op http://kid3.sourceforge.net.

Voorwaarden
Kid3 behoeften Qt[22]. KDE[23] wordt aanbevolen, maar is niet noodzakelijk, aangezien Kid3 ook kan worden gecompileerd
als een Qt-toepassing. Kid3 kan worden gecompileerd voor systemen waar deze bibliotheken zijn
beschikbaar, bijv. voor GNU/Linux, Windows en Mac OS X. Om Ogg/Vorbis-bestanden te taggen, libogg[13],
libvorbis en libvorbisbestand[14] zijn vereist, voor FLAC-bestanden libFLAC++ en libFLAC[15].
id3lib[12] wordt gebruikt voor MP3-bestanden. Deze vier formaten worden ook ondersteund door: TagLib[16],
die ook Opus-, MPC-, APE-, MP2-, Speex-, TrueAudio-, WavPack-, WMA-, WAV-, AIFF-bestanden aankan
en volgmodules. Om te importeren van akoestische vingerafdrukken, Chromaafdruk[18] en Libav[19]
worden gebruikt.

Kid3 is beschikbaar voor de meeste Linux-distributies, Windows en Mac OS X. Links zijn te vinden
on http://kid3.sourceforge.net.

Compilatie en Installatie
U kunt Kid3 met of zonder KDE compileren. Zonder KDE is Kid3 een eenvoudige Qt-toepassing en
mist enkele configuratie- en sessiefuncties.

Ga voor een KDE-versie naar de bovenste map en typ

% cmake .
% maken
% maken installeren

Om te compileren voor verschillende versies van Qt of KDE, stelt u de corresponderende cmake opties.

Als niet alle bibliotheken aanwezig zijn, is Kid3 gebouwd met verminderde functionaliteit. Dus je zou moeten
zorg ervoor dat alle gewenste ontwikkelpakketten zijn geïnstalleerd. Aan de andere kant,
cmake-opties bepalen in welke bibliotheken wordt gecompileerd. De standaardwaarde is: -D
WITH_TAGLIB:BOOL=AAN -D WITH_MP4V2:BOOL=UIT -D WITH_ID3LIB:BOOL=AAN -D
WITH_CHROMAPRINT:BOOL=AAN -D WITH_VORBIS:BOOL=AAN -D WITH_FLAC:BOOL=AAN . Deze opties kunnen
worden uitgeschakeld met behulp van UIT.

Om Kid3 te bouwen als een Qt-toepassing zonder KDE, gebruikt u de cmake optie -DWITH_APPS=Qt. naar
bouw zowel een KDE- als een Qt-toepassing, set -DWITH_APPS="Qt;KDE".

Qt 4 of Qt 5 kan worden gebruikt. Om het gebruik van Qt 4 te forceren, stelt u in -DWITH_QT4=AAN, om het gebruik van te forceren
Qt 5, ingesteld -DWITH_QT5=AAN, als beide opties UIT zijn (standaard), heeft Qt 4 de voorkeur als
beide versies zijn geïnstalleerd. Om een ​​specifieke Qt-installatie te gebruiken, stelt u in:
-DQT_QMAKE_EXECUTABLE=/pad/naar/qmake. Als het bouwen van de KDE-toepassing is ingeschakeld, wordt instelling
Qt 4 gebruikt KDE 4, terwijl het instellen van Qt 5 KDE 5 gebruikt.

Het genereren van RPM-pakketten wordt ondersteund door het bestand kid3.spec, voor Debian-pakketten, de
script build-deb.shis beschikbaar.

De Qt-applicatie kan ook worden gecompileerd voor Windows en Mac OS X. De scripts in de
mappen win32 en macosx kunnen worden gebruikt om pakketten te bouwen en te maken. De bibliotheken kunnen
geïnstalleerd met buildlibs.sh.

Configuratie
Met KDE, het bestandsnaamfilter en formaat, de importformaten, de bestandsnaam en ID3
formaten, de werkbalk- en statusbalkinstellingen en de venstergrootte worden opgeslagen in
de standaardlocatie in bestand kid3rc. Als een Qt-toepassing is dit bestand in
.config/Kid3/Kid3.conf. In Windows wordt de configuratie opgeslagen in het register.

D-BUS INTERFACE

D-bus Voorbeelden
De Qt 4- en KDE 4-versies op Linux bieden een D-Bus-interface om Kid3 via scripts te besturen.
Scripts kunnen in elke taal worden geschreven met D-Bus-bindingen (bijv. in Python) en kunnen worden
toegevoegd aan de gebruikersacties om de functionaliteit van Kid3 uit te breiden.

De artiest in tag 2 van het huidige bestand kan worden ingesteld op de waarde "One Hit Wonder" met de
volgende code:

Shell

dbus-send --dest=net.sourceforge.kid3 --print-reply=letterlijk \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 string:'Artiest' \
snaar:'One Hit Wonder'

of makkelijker met Qt's qdbus (qdbusviewer kan worden gebruikt om de interface in een GUI te verkennen):

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Artiest \
'Eendagsvlieg'

Python

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

Perl

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

D-bus API
De D-Bus API wordt gespecificeerd in net.sourceforge.Kid3.xml. De Kid3-interface heeft de
volgende methoden:

Openen filet or directory
boolean openDirectory(tekenreeks pad);

pad
pad naar bestand of map

Retourneert waar als OK.

Bespaar allen gewijzigd bestanden
boolean opslaan (ongeldig);

Retourneert waar als OK.

Krijgen a gedetailleerd fout Bericht mits by sommige methoden
snaar getErrorMessage (ongeldig);

Geeft een gedetailleerd foutbericht terug.

Terugkeren veranderingen in de gekozen bestanden
terug (ongeldig);

Start an automatisch partij importeren
boolean batchImport (int32) tagMasker, snaar profielnaam);

tagMasker
tagmasker (bit 0 voor tag 1, bit 1 voor tag 2)

profielnaam
naam van te gebruiken batchimportprofiel

import labels oppompen van a filet
boolean importFromFile(int32 tagMasker, snaar pad, int32 fmtIdx);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

pad
pad van bestand

fmtIdx
index van formaat

Retourneert waar als OK.

Downloaden album deksel kunst
downloadAlbumArt(tekenreeks url, boolean alleBestandenInDir);

url
URL van afbeeldingsbestand of bron voor albumhoezen

alleBestandenInDir
true om de afbeelding toe te voegen aan alle bestanden in de map

Exporteren labels naar a filet
boolean exportNaarBestand(int32 tagMasker, snaar pad, int32 fmtIdx);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

pad
pad van bestand

fmtIdx
index van formaat

Retourneert waar als OK.

creëren a afspeellijst
boolean createPlaylist (ongeldig);

Retourneert waar als OK.

Verlaten de toepassing
stoppen (ongeldig);

kies allen bestanden
selectAll(ongeldig);

deselecteren allen bestanden
deselecteerAlles (ongeldig);

Zet de de eerste filet as de actueel filet
boolean eersteBestand(ongeldig);

Retourneert waar als er een eerste bestand is.

Zet de de vorig filet as de actueel filet
boolean vorigBestand(ongeldig);

Retourneert waar als er een vorig bestand is.

Zet de de volgende filet as de actueel filet
boolean nextFile (ongeldig);

Retourneert waar als er een volgend bestand is.

kies de eerste filet
boolean selectFirstFile(ongeldig);

Retourneert waar als er een eerste bestand is.

kies de vorig filet
boolean selectPreviousFile(ongeldig);

Retourneert waar als er een vorig bestand is.

kies de volgende filet
boolean selecteerVolgendBestand(ongeldig);

Retourneert waar als er een volgend bestand is.

kies de actueel filet
boolean selectCurrentFile(ongeldig);

Retourneert waar als er een huidig ​​bestand is.

Uitvouwen or ineenstorting de actueel filet item if it is a directory
boolean expandDirectory(ongeldig);

Een item in de bestandslijst is een map als getFileName() een naam retourneert met '/' als laatste
karakter.

Retourneert waar als het huidige bestandsitem een ​​map is.

Solliciteer de filet naam formaat
ApplyFilenameFormat(void);

Solliciteer de label formaat
ApplyTagFormat(ongeldig);

Solliciteer tekst codering
ApplyTextEncoding(void);

Zet de de directory naam oppompen van de labels
boolean setDirNameFromTag(int32 tagMasker, snaar formaat, boolean en je merk te creëren );

tagMasker
tagmasker (bit 0 voor tag 1, bit 1 voor tag 2)

formaat
indeling mapnaam:

en je merk te creëren
true om te creëren, false om te hernoemen

Retourneert true indien OK, anders is het foutbericht beschikbaar met getErrorMessage().

Zet de volgend spoor nummers in de gekozen bestanden
nummerTracks(int32 tagMasker, int32 eersteTrackNr);

tagMasker
tagmasker (bit 0 voor tag 1, bit 1 voor tag 2)

eersteTrackNr
nummer te gebruiken voor eerste bestand

FILTER de bestanden
filter(tekenreeks uitdrukking);

uitdrukking
uitdrukking filteren

Converteren Id3v2.3 labels naar Id3v2.4
convertToId3v24 (ongeldig);

Converteren Id3v2.4 labels naar Id3v2.3
convertToId3v23 (ongeldig);

Retourneert waar als OK.

Krijgen pad of directory
snaar getDirecte naam (ongeldig);

Retourneert het absolute pad van de map.

Krijgen naam of actueel filet
snaar getFileName (ongeldig);

Retourneert de echte absolute bestandsnaam, eindigt met "/" als het een map is.

Zet de naam of gekozen filet
setBestandsnaam(tekenreeks naam);

naam
bestandsnaam

Het bestand wordt hernoemd wanneer de map wordt opgeslagen.

Zet de formaat naar . wanneer het instellen van de bestandsnaam oppompen van de labels
setFileNameFormat(tekenreeks formaat);

formaat
formaat bestandsnaam

Zet de de filet namen of de gekozen bestanden oppompen van de labels
setFileNameFromTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

Krijgen waarde of omlijsting
snaar getFrame(int32 tagMasker, snaar naam);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

naam
naam van frame (bijv. "artiest")

Om binaire gegevens zoals een afbeelding te krijgen, kan de naam van een te schrijven bestand worden toegevoegd na de
naam, bijv. "Afbeelding:/pad/naar/bestand". Op dezelfde manier kunnen gesynchroniseerde songteksten
geëxporteerd, bijv. "SYLT:/pad/naar/bestand".

Retourneert de waarde van het frame.

Zet de waarde of omlijsting
boolean setFrame(int32 tagMasker, snaar naam, snaar waarde);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

naam
naam van frame (bijv. "artiest")

waarde
waarde van frame

Voor label 2 (tagMasker 2), indien geen frame met naam bestaat, wordt een nieuw frame toegevoegd, als waarde is
leeg is, wordt het frame verwijderd. Om binaire gegevens zoals een afbeelding toe te voegen, kan een bestand worden toegevoegd
na de naam, bijv. "Afbeelding:/pad/naar/bestand". "SYLT:/pad/naar/bestand" kan worden gebruikt om
importeer gesynchroniseerde songteksten.

Retourneert waar als OK.

Krijgen allen frames of a label
reeks of snaar getTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

Retourneert een lijst met afwisselende framenamen en waarden.

Krijgen technisch informatie over ons filet
reeks of snaar getInformation (ongeldig);

Eigenschappen zijn Formaat, Bitrate, Samplerate, Kanalen, Duur, Kanaalmodus, VBR, Tag
1, Tag 2. Eigenschappen die niet beschikbaar zijn, worden weggelaten.

Retourneert lijst met afwisselende eigenschapsnamen en waarden.

Zet de label oppompen van filet naam
setTagVanBestandsnaam(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

Zet de label oppompen van anders label
setTagVanAnderTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

Kopiëren label
kopieTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

pasta label
pasteTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

verwijderen label
verwijderTag(int32 tagMasker);

tagMasker
tagbit (1 voor tag 1, 2 voor tag 2)

Repareren de configuratie
reparseConfiguration (ongeldig);

Geautomatiseerde configuratiewijzigingen zijn mogelijk door het configuratiebestand te wijzigen en
vervolgens de configuratie repareren.

Plays de gekozen bestanden
playAudio(leegte);

QML INTERFACE

QML Voorbeelden
QML-scripts kunnen worden aangeroepen via het contextmenu van de bestandenlijst en kunnen worden ingesteld in het tabblad
Gebruikersacties van het instellingendialoogvenster. De scripts die daar zijn ingesteld, kunnen worden gebruikt als:
voorbeelden om aangepaste scripts te programmeren. QML gebruikt JavaScript, hier is de verplichte "Hallo
Wereld":

importeer Kid3 1.0

Kid3Script {
opRun: {
console.log("Hallo wereld, map is", app.dirName)
Qt.stop()
}
}

Als dit script wordt opgeslagen als /path/to/Example.qml, kan het gebruikerscommando worden gedefinieerd als: @qml
/pad/naar/Voorbeeld.qml met naam QML test en Uitgang gecontroleerd. Het kan dan worden gestart met behulp van
het QML-testitem in het contextmenu van de bestandslijst, en de uitvoer zal zichtbaar zijn in de
venster.

Als alternatief kan het script ook onafhankelijk van Kid3 worden gestart met behulp van de QML-tools.

qmlviewer -I /usr/lib/kid3/plugins/imports /pad/naar/Voorbeeld.qml

Voor Qt 5, de commando's

qml -apptype widget -I /usr/lib/kid3/plugins/imports /pad/naar/Example.qml

or

qmlscene -I /usr/lib/kid3/plugins/imports /pad/naar/Voorbeeld.qml

kan worden gebruikt. Op Windows en OS X moet het importpad worden aangepast aan de importmap
in de installatiemap. Scripts die buiten Kid3 zijn gestart, gebruiken de huidige
directory, dus deze moet van tevoren worden gewijzigd.

Om de titels in de tags 2 van alle bestanden in de huidige map weer te geven, gaat u als volgt te werk:
script kan worden gebruikt:

importeer Kid3 1.0

Kid3Script {
opRun: {
app.firstFile()
Doen {
als (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2, "titel"))
} terwijl (app.nextFile())
}
}

Als de directory veel bestanden bevat, kan een dergelijk script de gebruikersinterface blokkeren voor:
enige tijd. Voor langere operaties moet het daarom van tijd tot tijd een pauze hebben. De
alternatieve implementatie hieronder heeft het werk voor een enkel bestand verplaatst naar een functie.
Deze functie roept zichzelf aan met een time-out van 1 ms aan het einde, aangezien meer bestanden
te verwerken. Dit zorgt ervoor dat de GUI responsief blijft terwijl het script is
uitgevoerd.

importeer Kid3 1.0

Kid3Script {
opRun: {
functie doWork() {
als (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2, "titel"))
}
als (!app.nextFile()) {
Qt.stop()
} Else {
setTimeout(doWork, 1)
}
}

app.firstFile()
werken()
}
}

Meer voorbeeldscripts worden geleverd met Kid3 en zijn al geregistreerd als gebruikerscommando's.

· ReplayGain naar SoundCheck (ReplayGain2SoundCheck.qml): maak iTunNORM SoundCheck
informatie uit herhalingsversterkingsframes.

· Formaat van albumhoezen wijzigen (ResizeAlbumArt.qml): formaat van ingebedde albumhoezen wijzigen die:
groter dan 500x500 pixels.

· Albumhoezen extraheren (ExtractAlbumArt.qml): alle ingesloten albumhoezen extraheren
het vermijden van duplicaten.

· Albumhoezen insluiten (EmbedAlbumArt.qml): sluit albumhoezen in afbeeldingsbestanden in in audio
bestanden in dezelfde map.

· Lyrics insluiten (EmbedLyrics.qml): haal niet-gesynchroniseerde songteksten op van de webservice.

· Tekstcodering ID3v1 (ShowTextEncodingV1.qml): helpt bij het vinden van de codering van ID3v1-tags
door de tags van het huidige bestand in alle beschikbare tekencoderingen te tonen.

· Export CSV (ExportCsv.qml): Exporteer recursief alle tags van alle bestanden naar een CSV-bestand.

· QML Console (QmlConsole.qml): Eenvoudige console om te spelen met Kid3's QML API.

QML API
De API kan eenvoudig worden verkend met behulp van de QML-console, die als voorbeeld beschikbaar is
script met een gebruikersinterface.

Kid3Script
Kid3Script is een normale QML-component die zich in de plug-in-directory bevindt. Je zou kunnen
gebruik net zo goed een ander QML-component. Het gebruik van Kid3Script maakt het gemakkelijk om de
scriptfunctie met behulp van de opRun signaal behandelaar. Het verbergt ook de verschillen tussen
de QtQuick-versies, om scripts compatibel te maken met zowel Qt 4 als Qt 5.
Bovendien biedt het enkele functies:

onRun: Signaal-handler die wordt aangeroepen wanneer het script wordt gestart
tagv1, tagv2, tagv2v1: constanten voor tagparameters
script: toegang tot scriptfuncties
configs: toegang tot configuratieobjecten
getArguments(): Lijst met scriptargumenten
isStandalone(): waar als het script niet is gestart vanuit Kid3
setTimeout (terugbellen, vertraging): Start terugbellen na vertraging ms

Scripting Functies
Omdat JavaScript en dus ook QML slechts een beperkte set functies voor scripting heeft,
de script object heeft enkele aanvullende methoden, bijvoorbeeld:

script.properties(obj): String met Qt-eigenschappen
script.writeFile(filePath, data): Schrijf gegevens naar bestand, waar indien OK
script.readFile(filePath): Gegevens uit bestand lezen
script.removeFile(filePath): Bestand verwijderen, true indien OK
script.fileExists(filePath): waar als bestand bestaat
script.renameFile(oldName, newName): hernoem bestand, true indien OK
script.tempPath(): pad naar tijdelijke map
script.listDir(path, [nameFilters], [classify]): Lijst met vermeldingen in de directory
script.system(programma, [args], [msecs]): start synchroon een systeemopdracht,
[afsluitcode, standaarduitvoer, standaardfout] indien geen time-out
script.getEnv(varName): waarde van omgevingsvariabele ophalen
script.setEnv(varName, value): waarde van omgevingsvariabele instellen
script.getQtVersion(): Qt-versietekenreeks, bijv. "5.4.1"
script.getDataMd5(data): Hex-tekenreeks van de MD5-hash van gegevens ophalen
script.getDataSize(data): Grootte van bytearray ophalen
script.dataToImage(data, [format]): maak een afbeelding van databytes
script.dataFromImage(img, [format]): Haal databytes uit de afbeelding
script.loadImage(filePath): Laad een afbeelding uit een bestand
script.saveImage(img, filePath, [format]): Sla een afbeelding op in een bestand, waar indien OK
script.imageProperties(img): Krijg eigenschappen van een afbeelding, kaart met
"breedte", "hoogte", "diepte" en "colorCount", leeg indien ongeldige afbeelding
script.scaleImage(img, width, [height]): Schaal een afbeelding, retourneert geschaalde afbeelding
script.selectFileName(caption, dir, filter, saveFile): Open bestandsdialoog om
Selecteer een bestand

Aanvraag Context
Met QML is een groot deel van de Kid3-functies toegankelijk. De API is vergelijkbaar met:
degene die wordt gebruikt voor D-Bus. Raadpleeg de respectieve opmerkingen voor meer informatie.

app.openDirectory(pad): Open map
app.saveDirectory(): Bewaar map
app.revertFileModifications(): Terugzetten
app.importTags(tag, pad, fmtIdx): Bestand importeren
app.downloadImage(url, allFilesInDir): Afbeelding downloaden
app.exportTags(tag, pad, fmtIdx): Bestand exporteren
app.writePlaylist(): Schrijf afspeellijst
app.selectAllFiles(): Alles selecteren
app.deselectAllFiles(): Deselecteren
app.firstFile([select]): Naar eerste bestand
app.nextFile([select]): Naar volgend bestand
app.previousFile([select]): Naar vorig bestand
app.selectCurrentFile([select]): Selecteer huidig ​​bestand
app.requestExpandFileList(): Alles uitvouwen
app.applyFilenameFormat(): Pas bestandsnaamindeling toe
app.applyTagFormat(): Tag-indeling toepassen
app.applyTextEncoding(): Tekstcodering toepassen
app.numberTracks(nr, totaal, tag, [opties]): Nummer tracks
app.applyFilter(expr): Filter
app.convertToId3v23(): Converteer ID3v2.4.0 naar ID3v2.3.0
app.convertToId3v24(): Converteer ID3v2.3.0 naar ID3v2.4.0
app.getFilenameFromTags(tag): Bestandsnaam van tags
app.getTagsFromFilename(tag): Bestandsnaam naar tags
app.getAllFrames(tag): object ophalen met alle frames
app.getFrame(tag, naam): Frame ophalen
app.setFrame(tag, naam, waarde): Frame instellen
app.getPictureData(): Gegevens ophalen uit fotolijst
app.setPictureData(data): gegevens instellen in afbeeldingsframe
app.copyToOtherTag(tag): Tags naar andere tags
app.copyTags(tag): Kopiëren
app.pasteTags(tag): Plakken
app.removeTags(tag): Verwijderen
app.playAudio(): Afspelen
app.readConfig(): Configuratie lezen
app.applyChangedConfiguration(): Configuratie toepassen
app.dirName: Directorynaam
app.selectionInfo.fileName: Bestandsnaam
app.selectionInfo.filePath: Absoluut bestandspad
app.selectionInfo.detailInfo: Formaatdetails
app.selectionInfo.tagFormatV1: Tag 1-indeling
app.selectionInfo.tagFormatV2: Tag 2-indeling
app.selectionInfo.formatString(tag, format): Vervang codes in format string

Voor asynchrone operaties kunnen callbacks worden verbonden met signalen.

functie automatischImport(profiel) {
functie onAutomaticImportFinished() {
app.batchImporter.finished.disconnect (opAutomaticImportFinished)
}
app.batchImporter.finished.connect(opAutomaticImportFinished)
app.batchImport(profiel, tagv2)
}

functie hernoemenDirectory(formaat) {
functie onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory(tagv2v1, formaat, false)
}

Configuratie Objecten
De verschillende configuratiesecties zijn toegankelijk via methodes van: configs. Hun
eigenschappen kunnen worden weergegeven in de QML-console.

script.properties(configs.networkConfig())

Eigenschappen kunnen worden ingesteld:

configs.networkConfig().useProxy = false

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

Gebruik kid3-core online met onworks.net-services