KID3(1) Handbok Kid3 KID3(1) NAMN kid3, kid3-qt, kid3-cli - Kid3 ID3 Tagger OVERSIKT kid3 [ | --help | --author | --version | --license | --desktopfile FIL ] [FIL...] kid3-qt [--portable] [Qt-valjare] [FIL...] kid3-cli [--portable] [--dbus] [ | -h | --help ] [-c KOMMANDO1] [-c KOMMANDO2...] [FIL...] VALJARE --portable Lagra installningen i filen kid3.ini i programkatalogen. FIL Om FIL ar sokvagen for en katalog, som oppnas. Om en eller flera filsokvagar anges, oppnas deras gemensamma katalog och filerna markeras. kid3 --help Visa hjalp om valjare. --author Visa information om upphovsman. --version Visa versionsinformation. --license Visa licensinformation. --desktopfile FIL Basfilnamnet pa skrivbordsposten for programmet. kid3-qt Qt-valjare Se qt5options(7). kid3-cli --dbus Aktivera D-Bus-granssnittet. -c Kor ett kommando. Flera -c valjare ar mojliga, och de kors i en foljd. Se avsnittet om kid3-cli for en beskrivning av tillgangliga kommandon. -h|--help Visa hjalp om valjare och kommandon. INLEDNING Kid3 ar ett program for att redigera ID3v1 och ID3v2 taggar i MP3 filer pa ett effektivt satt. Taggarna kan redigeras i de flesta MP3-spelare, men inte pa ett sarskilt bekvamt och effektiv satt. Dessutom stods ocksa taggar i Ogg/Vorbis-, Opus-, DSF-, FLAC-, MPC-, APE-, MP4/AAC-, MP2-, Speex-, TrueAudio-, WavPack-, WMA-, WAV-, AIFF-filer och sparningsmoduler (MOD, S3M, IT, XM). Kid3 griper eller kodar inte MP3-filer, men har som mal att redigera ID3-taggarna i alla filer i ett album pa ett effektivt satt, dvs. med sa fa musklick och tangentnedtryckningar som mojligt. Aven om de flesta program kan redigera antingen ID3v1 eller ID3v2 taggar, har Kid3 fullstandig kontroll over bada versionerna, kan konvertera taggar mellan de tva formaten och kan komma at alla ID3v2-taggar. Taggar i flera filer kan tilldelas samma varde, t.ex. artist, album, ar och genre i alla filer i ett album har ofta samma varden och kan tilldelas tillsammans. Om informationen for taggarna ingar i filnamnet kan taggarna automatiskt tilldelas fran filnamnet. Det ar ocksa mojligt att andra filnamnet enligt taggarna som hittas i filen med godtyckliga format. Redigeringsaktiviteten stods ytterligare genom automatisk ersattning av tecken eller delstrangar, exempelvis for att ta bort ogiltiga tecken fran filnamn. Automatisk kontroll av stora och sma bokstaver gor det enkelt att anvanda en konsekvent namngivningsmetod for alla taggar. Tagginformationen for hela album kan tas fran gnudb.org[1], MusicBrainz[2], Discogs[3], Amazon[4] eller andra kallor for sparlistor. Importformatet ar fritt installningsbart med reguljara uttryck. Rapportera garna eventuella problem eller onskemal till upphovsmannen. ANVANDA KID3 Funktioner i Kid3 o Redigera ID3v1.1 taggar o Redigera alla ID3v2.3 och ID3v2.4 ramar o Redigera taggar i flera filer o Konvertera mellan ID3v1 och ID3v2 taggar o Redigera MP3-, Ogg/Vorbis-, Opus-, DSF-, FLAC-, MPC-, APE-, MP4/AAC-, MP2-, Speex-, TrueAudio-, WavPack-, WMA-, WAV- och AIFF-taggar o Generera taggar fran filnamn o Generera taggar fran innehallet i taggfalt o Generera filnamn fran taggar o Generera och andra katalognamn fran taggar o Genererar spellistefil o Automatisk skiftlageskonvertering och strangoversattning o Importera fran gnudb.org[1], MusicBrainz[2], Discogs[3], Amazon[4] och andra datakallor o Exportera som CSV, HTML, spellista, Kover XML och andra format. Exporterade CSV-filer kan importeras igen. Exempel pa anvandning Det har avsnittet beskriver en typisk session med Kid3. Lat oss anta att vi har en katalog som innehaller MP3-filer med spar fran albumet "Lat oss tagga" fran bandet "Dagslanda". Katalogen ar namngiven med formatet "artist - album", i vart fall Dagslanda - Lat oss tagga. Katalogen innehaller sparen pa formatet "spar titel.mp3", som jag tycker ar anvandbart eftersom filnamnen ar korta (viktigt vid anvandning av mobila MP3-spelare med sma skarmar) och i ratt ordning nar de sorteras alfabetiskt (viktigt vid anvandning av MP3-hardvaruspelare som spelar sparen i alfabetisk ordning eller ordningen som de ar branda pa en cd och den ordningen ar alfabetisk nar mkisofs anvands). Bortsett fran det, ar artist- och albuminformationen redan i katalognamnet och behover inte upprepas i filnamnet. Men ater till vart exempel, dar listningen av katalog ser ut sa har: 01 Borjan.mp3 02 Vi har bara den har.mp3 03 Slutet.mp3 Filerna har inga taggar an och vi vill generera dem med Kid3. Vi anvander Arkiv -> Oppna (eller knappen i verktygsraden) och markerar en av filerna i katalogen. Alla filer visas i fillistrutan. Lata som vi ar, vill vi anvanda informationen i katalogen och filnamnen for att skapa taggar. Darfor markerar vi alla filerna, och klickar pa knappen Till: Tagg 1 i sektionen Arkiv. Det tilldelar varden for titel, artist, album och spar i alla filer. For att tilldela varden for ar och genre i alla filer, behaller vi alla filer markerade och skriver in "2002" for Datum och valjer "Pop" i kombinationsrutan Genre. For att bara tilldela de har tva vardena markeras deras kryssrutor automatiskt och alla andra kryssrutor lamnas omarkerade. Nu andrar vi markeringen genom att bara markera den forsta filen och vi ser att alla taggar innehaller ratt varden. De andra filernas taggar kan ocksa verifieras genom att markera dem en i taget. Nar vi ar nojda med taggarna, anvander vi menyalternativet Arkiv -> Spara (eller knappen i verktygsraden). Att valja menyalternativet Arkiv -> Skapa spellista skapar filen Dagslanda - Lat oss tagga.m3u i katalogen. KOMMANDOREFERENS Elementen i det grafiska anvandargranssnittet Det grafiska granssnittet i Kid3 ar uppdelat i sex sektioner: Till vanster ar fil- och kataloglistrutorna, och till hoger finns sektionerna Fil, Tagg 1, Tagg 2 och Tagg 3. For att navigera mellan de olika sektionerna med tangentbordet, stods flera snabbtangenter. I taggsektionerna ar genvagarna aktiva nar inte text redigeras eller nar man ar i den forsta kolumnen. o Alt+Vansterpil: Ga till foregaende sektion (Kommando+[ pa macOS(R)) o Alt+Hogerpil: Ga till nasta sektion (Kommando+] pa macOS(R)) o Ctrl+Skift+V: Fran annan tagg o Ctrl+C: Kopiera o Ctrl+V: Klistra in o Skift+Delete: Ta bort o F2: Redigera o Insert: Lagg till o Delete: Ta bort Fillista Fillistan innehaller namnen pa alla filerna i de oppnade katalogerna som motsvarar det valda filnamnsfiltret (oftast *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac *.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). En enda eller flera filer kan markeras. For att inte markera nagon fil, klicka pa det tomma utrymmet efter listrutans poster. Markeringen bestammer filerna som paverkas av de tillgangliga atgarderna genom att anvanda knapparna som beskrivs nedan. Forutom Namn kan andra kolumner med detaljerad filinformation visas, Storlek, Typ och Andringsdatum. Kolumner kan doljas genom att avmarkera deras namn i listrubrikens sammanhangsberoende meny. Kolumnordningen kan andras genom att dra och slappa dem. Sorteringsordningen kan andras genom att klicka pa kolumnrubriken. Vardet pa standardtaggarna kan ocksa visas och redigeras i fillistans kolumner. Till vanster om namnen kan en ikon visas: en skiva for att visa att filen har andrats eller information om vilka taggar som finns (V1, V2, V1V2 eller NO TAG). Om filen inte annu har lasts in visas ingen ikon. Kataloger visas med en katalogikon. Om en katalog ar oppnad, visas dess filer i ett hierarkiskt trad. Genom att markera filer i underkataloger, kan atgarder utforas med filer i olika kataloger, vilket ar anvandbart om musiksamlingen ar organiserad med en katalog for varje artist som innehaller kataloger for album av artisten. Genom att klicka med hoger musknapp inne i fillistan visas en sammanhangsberoende meny med foljande kommandon: o Expandera alla: Expanderar alla katalogtrad (bara det aktuella tradet om skifttangenten halls nere) o Dra ihop alla: Drar ihop alla katalogtrad o Byt namn: Byter namn pa en fil o Flytta till papperskorgen: Flyttar en fil till papperskorgen o Spela: Spelar upp en fil, se Spela. Om den markerade filen ar en spellista, spelas filerna i spellistan. o Redigera: Redigera en spellista, se Redigera spellista. o Efterfoljande alternativ ar anvandarkommandon, som kan definieras under fliken Anvandaratgarder i Anpassa Kid3. Uppspelning vid dubbelklick kan ocksa aktiveras dar. Nar Valj fil vid spela ar aktiverat, valjs sparet som for narvarande spelas automatiskt i fillistan. Redigera spellista En spellista kan skapas tom eller med sparen i en katalog, se Skapa spellista. Spellistefilen skapas pa ett sadant satt att den kan redigeras genom att dubbelklicka eller genom att anvanda Redigera i fillistans sammanhangsberoende meny. En dialogruta med posterna i spellistan visas. Det ar mojligt att oppna flera spellistor samtidigt. Nya poster kan laggas till genom att dra och slappa fran fillistan, en filhanterare eller en annan spellista. Om en post dras fran en annan spellista flyttas eller kopieras den beroende pa systemet. For att utfora den andra atgarden, maste Shift-, Ctrl- eller Alt-tangenten anvandas (for att kopiera eller flytta pa macOS(R)). Det ar ocksa mojligt att ordna om poster i spellistan med dra och slapp. Som alternativ kan poster flyttas genom att anvanda snabbtangenterna Ctrl+Shift+Uppatpil och Ctrl+Shift+Neratpil (pa macOS(R) maste Kommando anvandas istallet for Ctrl). En post kan tas bort med Delete-tangenten. Observera foljande: For att dra poster fran fillistan, maste de hallas pa vanster sida (nara ikonerna), samma gest pa hoger sida utfor multipel markering, en sadan atgard ar darmed fortfarande enkel att gora. Nar en spellista har andrats, andringarna kan lagras genom att anvanda Spara eller kastas genom att anvanda Avbryt. Nar fonstret stangs, visas en bekraftelseruta om det finns osparade andringar. Spar som markeras i spellistan markeras automatiskt i fillistan, och darigenom blir det mojligt att redigera deras taggar. For att utfora atgarder for en spellista maste dess fil vara markerad i fillistan. Redigera i den sammanhangsberoende menyn ger dialogrutan beskriven i det har avsnittet, och Spela startar mediaspelaren med sparen i spellistan. Anvandaratgarder kan galla spellistor, exempelvis Exportera spellistekatalog, som kopierar filerna fran en spellista till en katalog. Kataloglista Kataloglista innehaller namnet pa katalogerna i den oppnade katalogen, forutom den aktuella (.) och den overliggande (..) katalogen. Den gor att man snabbt kan byta katalog utan att anvanda kommandot Oppna... eller dra och slapp. Kolumnsynlighet, ordning och sortering kan stallas in som beskrivs i avsnittet om fillistan. Fil Visar information om kodningen (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), bithastighet, samplingsfrekvens, kanaler och filens langd. Redigeringsraden Namn innehaller filens namn (om bara en enda fil ar markerad). Om namnet andras, andras ocksa filens namn nar kommandot Spara anvands. Kombinationsrutan Format och redigeringsraden innehaller formatet som ska anvandas nar filnamnet genereras fran den forsta eller andra taggen. Filnamnet kan anvanda godtyckliga tecken, till och med en katalogdel atskild med ett snedstreck fran filnamnet, men katalogen maste redan finnas for att namnbytet ska lyckas. Foljande specialkoder anvands for att infoga taggvarden i filnamnet: o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar (t.ex. 01) o %t %{track.n} Spar med faltbredd n (t.ex. 001 for %{track.3}) o %T %{tracknumber} Spar (utan inledande nollor, t.ex. 1) o %g %{genre} Genre o %{ignore} Ignoreras nar taggar genereras fran filnamnet Formatkoderna ar inte begransade till exemplen som ges ovan. Alla ramnamn kan anvandas, exempelvis gemensamma ramnamn som %{albumartist}, %{discnumber.1}, %{bpm} eller formatspecifika namn sasom %{popm}. Det ar mojligt att lagga till strangar i borjan eller slutet av en formatkod genom att lagga till den i dubbla citationstecken inne i en formatkods klammerparenteser. Strangarna laggs bara till i resultatstrangen om formatkoden ger ett varde som inte ar tomt. Om filnamnet exempelvis bade ska innehalla titeln och undertiteln, skulle man kunna anvanda %{title} [%{subtitle}] i formatstrangen. Men det skulle resultera i en strang som slutar med [] om undertitel saknas i en fil. For att utelamna hakparenteserna om det inte finns nagon undertitel, maste %{title}%{" ["subtitle"]"} anvandas istallet. Det utelamnar hakparenteserna, det inledande mellanslaget och undertiteln om det inte finns nagon undertitel. Listan med tillgangliga format kan redigeras i dialogrutan som visas nar knappen Filnamn fran tagg klickas under fliken Fil i installningarna. En andra kombinationsruta Format (med neratpil) anvands for att generera taggarna fran filnamnet. Om filnamnsformatet inte motsvarar monstret, provas ett antal andra ofta anvanda format. Vissa ofta anvanda filnamnsformat ar redan tillgangliga i kombinationsrutan, men det ar ocksa mojligt att skriva in nagra specialformat pa redigeringsraden. Listan med tillgangliga format kan redigeras i dialogrutan som visas genom att klicka pa knappen Tagg fran filnamn under fliken Fil i installningarna. Internt byggs ett reguljart uttryck fran formatkoderna. Om avancerade reguljara uttryck kravs, kan formatet for att generera taggarna fran filnamnen anges som ett fullstandigt reguljart uttryck med infangning som foregas av formatkoderna, t.ex. for att extrahera sparnumren utan borttagning av inledande nollor, ett format som "/%{track}(\d+) %{title}(.*)" kunna anvandas. Fran: Tagg 1, Tagg 2: Staller in filnamnet genom att anvanda det valda formatet och den forsta taggen eller den andra taggen. Till: Tagg 1, Tagg 2: Taggarna stalls in fran filnamnet. Forst anvands formatet angivet i Format. Om det befintliga filnamnet inte motsvarar formatet, provas foljande format: o Artist - Album/Spar Lat o Album/Spar - Artist - Lat o /Artist - Album - Spar - Lat o Album/Artist - Spar - Lat o Album/Artist - Lat o Artist/Album/Spar Lat Om en enda fil ar markerad, fylls kontrollerna i det grafiska anvandargranssnittet med varden som extraheras fran filnamnet. Om flera filer ar markerade, stalls filernas taggar direkt in enligt filnamnen. Tagg 1 Redigeringsraden for Titel, Artist, Album, Kommentar, Datum, Sparnummer och Genre anvands for att redigera motsvarande varde i de markerade filernas forsta tagg. Vardet andras nar filmarkeringen andras eller innan atgarder som Spara och Avsluta och nar motsvarande kryssruta till vanster om faltnamnet markeras. Det ar anvandbart for att bara andra vissa varden och lamna andra oforandrade. Om en enda fil ar markerad, ar alla kryssrutor markerade och redigeringsraderna innehaller vardena som fanns i filens taggar. Om en tagg inte finns i filen, visas det motsvarande tomma vardet, som ar en tom strang for redigeringsraderna Titel, Artist, Album och Kommentar, 0 for de numeriska redigeringsraderna Datum och Sparnummer och ett tomt utvalt varde for kombinationsrutan Genre. Vardena kan andras och om motsvarande kryssruta ar markerad, tilldelas de i den markerade filen efter markeringen andras. Filen markeras darefter som andrad av en disksymbol i fillistrutan men forblir oforandrad tills kommandot Spara anvands. Om flera filer ar markerad, visas bara vardena som ar identiska i alla markerade filer. I alla andra kontroller, visas de tomma vardena visas enligt beskrivningen ovan. Alla kryssrutor ar avmarkerade for att undvika oonskade andringar. Om ett varde ska tilldelas i alla markerade filer, kan det redigeras och kryssrutan kan markeras. Vardena tilldelas for alla markerade filer nar markeringen andras, och kan sparas med kommandot Spara. Kryssrutorna styr ocksa funktionen hos de flesta kommandon som paverkar taggar, sasom kopiera, klistra in och overforing mellan tagg 1 och tagg 2. For att gora det enklare att anvanda med flera filer, da alla kryssrutor ar avmarkerade, beter sig kommandona likadant nar alla kryssrutor ar markerade och nar alla kryssrutor ar avmarkerade. Fran tagg 2: Falten i tagg 1 tilldelas fran motsvarande varden i tagg 2. Om en enda fil ar markerad, fylls det grafiska anvandargranssnittets kontroller med vardena fran tagg 2. Om flera filer ar markerade, tilldelas filernas taggar direkt. Kopiera: Kopieringsbufferten fylls i med varden fran Tagg 1. Bara varden med markerade kryssrutor anvands i efterfoljande kommandon for att klistra in. Klistra in: Klistrar in vardena fran kopieringsbufferten till de grafiska anvandargranssnittets kontroller. Ta bort: Tilldelar alla grafiska anvandargranssnittets kontroller sina tomma varden, vilket leder till att alla varden tas bort. Den sparade filen innehaller da inte nagon tagg 1. Tagg 2 Det grafiska anvandargranssnittet styr funktionen pa samma satt som beskrivs for Tagg 1 sektionen, men strangarnas storlek ar inte begransad. For Genre i tagg 2 kan du ocksa anvanda dina egna namn forutom genrer listad i kombinationsrutan, skriv bara in namnet pa redigeringsraden. Tagg 2 kan inte bara innehalla samma varden som tagg 1, utan formatet ar uppbyggt pa ett flexibelt satt fran flera ramar som i sin tur bestar av flera falt. Tabellen over tagg 2 visar alla ramar som ar tillgangliga i den markerade filen. Redigera: Oppnar ett fonster som gor att man kan redigera alla falt i den markerade ramen. Om flera filer ar markerade, tilldelas de redigerade falten till alla markerade filer som innehaller en sadan ram. Lagg till: En fraga om att valja ramtyp dyker upp och en ram av den valda typen kan redigeras och laggas till i filen. Det fungerar ocksa for att lagga till en ram i flera markerade filer. Ta bort: Tar bort den markerade ramen i de markerade filerna. Dra album-omslag hit visas om filen inte innehaller nagot inbaddat omslag. En bild kan laggas till genom att anvanda dra och slapp fran en filbladdrare eller filhanterare och visas har. Bildramar kan ocksa redigeras eller laggas till genom att dubbelklicka pa kontrollen. Tagg 3 Visa filer kan ha mer an tva taggar, och en tredje taggsektion ar synlig. Foljande filtyper kan ha en sadan Tagg 3 sektion: o MP3-filer kan ha en ID3v1.1-tagg, en ID3v2 (2.3.0 eller 2.4.0)-tagg och en APE-tagg i den tredje sektionen. Sadan APE-taggar anvands for information om uppspelningsforstarkning. I sektionen Tagg 3 ar informationen synlig, och APE-taggen kan tas bort med knappen Ta bort. o RIFF INFO segmentet i WAV-filer ar tillgangligt i sektionen Tagg 3 eftersom sektionen Tagg 1 ar tillagnad ID3v1.1-taggar och hanterar deras begransningar. Tagg 2 anvands fortfarande for ID3v2.4.0-taggar, som ocksa stods for WAV-filer, men RIFF INFO segment verkar stodjas battre. o FLAC-filer anvander normalt en Vorbis-kommentar for sin metadata. Dock finns det FLAC-filer som har ID3v1- och ID3v2-taggar, som finns i sektionerna Tagg 1 och Tagg 3. ID3-taggar i FLAC-filer stods bara av TagLib, darfor maste insticksprogrammet QggFlacMetadata inaktiveras under fliken Insticksprogram i installningarna. De grafiska anvandargranssnittets kontroller fungerar pa samma satt som i Tagg 2 sektionen. Synkroniserad sangtext och handelsetidskoder For information synkroniserad med ljuddata ar en sarskild editor tillganglig. Sadana ramar stods for ID3v2.3.0- och ID3v2.4.0-taggar. For att lagga till en sadan ram, maste det specifika ramnamnet valjas i listan som dyker upp nar knappen Lagg till klickas: respektive Synkroniserad sangtext eller Handelsetidskoder. Editorn ar samma for bada typerna, men for handelsetidskoderna ar bara en fordefinierad uppsattning handelser tillgangliga, medan for de synkroniserade sangtexterna maste text matas in. I det foljande forklaras synkroniserad sangtext. En fil som har en ID3v2-tagg markeras, och sangtexteditorn startas genom att anvanda Lagg till och valja Synkroniserad sangtext. For en befintlig synkroniserad sangtextram, markeras den och Redigera klickas. Spelaren oppnas automatiskt med aktuell fil sa att filen kan spelas och pausas for att synkronisera sangtexten. Installningarna langst upp i SYLT-editorn behover normalt inte andras. Om sangtexten innehaller tecken som inte finns i teckenuppsattningen Latin 1, ar det lampligt att andra textkodningen till UTF16 (eller UTF8 for ID3v2.4.0). For engelsk sangtext och maximal kompatibilitet bor ISO-8859-1 anvandas. Sektionen Sangtext har fem knappar langst upp. Lagg till lagger till en ny tidshandelse i tabellen. Tiden tas fran spelarens position, och att lagga till en post nar sparet spelas lagger darmed till en rad for positionen som spelas just nu. Handelserna i tabellen maste vara kronologiskt ordnade, och darfor infogas raden i enlighet med det. Poster med en ogiltig tid hanteras speciellt: om raden som for narvarande ar markerad har en ogiltig tid, ersatts dess tidstampel med aktuell tid istallet for att lagga till en ny rad. Om den aktuella tiden inte ar ogiltig, anvands den forsta raden med en ogiltig tid om det finns nagon. Beteendet bor forenkla tillagg av tidsstamplar om sangtexten redan finns i tabellen men tidsstamplarna saknas (vilket ar fallet nar osynkroniserad sangtext importeras). Observera att den ogiltiga tiden representeras som 00:00.00, dvs. samma som tiden i sparets absoluta borjan, som inte ar ogiltig. For att gora tiden ogiltig, tryck pa tangenten Delete, eller anvand Rensa i den sammanhangsberoende menyn. Nya rader som infogas genom att anvanda Infoga rad i den sammanhangsberoende menyn eller som skapas nar osynkroniserad sangtext importeras med Fran klippbord eller Importera innehaller ocksa ogiltiga tidsstamplar. Rader i tabellen kan tas bort genom att klicka pa knappen Ta bort eller anvanda Ta bort rader fran den sammanhangsberoende menyn. Synkroniserad sangtext kan importeras fran en fil genom att anvanda Importera. Forvantat format ar enkel eller forbattrad LRC. Om den markerade filen inte innehaller en hakparentes pa forsta raden, antas den vara en enkel textfil med osynkroniserad sangtext. Raderna fran en sadan fil importeras med ogiltiga tidsstamplar. Tidsinformationen kan laggas till genom att anvanda knappen Lagg till eller med manuell inmatning. Det ar ocksa mojligt att importera sangtext genom att kopiera och klistra in genom att anvanda Fran klippbord. Synkroniserad sangtext kan skrivas till LRC-filer genom att anvanda Exportera. Observera att bara poster med giltiga tidsstamplar exporteras, och att posterna sorteras enligt tid. Poster med ogiltig tid lagras inte heller i SYLT-ramarna, sa sakerstall att all tidsinformation innan dialogrutan lamnas. ID3-specifikationen[5] foreslar en tidsstampel for varje stavelse. Dock stoder de flesta spelare bara granulariteten rad eller mening. Kid3 foljer samma konvention som SYLT-editorn[6] for att stodja bada anvandningsfallen. Text som matas in i tabellen antas starta en ny rad om den inte borjar med ett mellanslag eller ett bindestreck. Undantag av regeln ar mojliga genom att inleda an rad med ett understreck ('_') for att tvinga en fortsattning, eller ett nummertecken ('#') for att tvinga en ny rad. Dessa undantagstecken lagras inte i SYLT-ramen. Inne i SYLT-ramen, borjar nya rader med ett nyradstecken (hexadecimalt 0A) medan fortsattningar inte gor det. Nar SYLT-ramar lases in, kontrollerar Kid3 om den forsta posten startar med en nyrad. Om det inte ar fallet, antas att alla poster ar nyrader och att ingen stavelsefortsattning anvands. Medan sparet spelas, farglaggs raden som hor ihop med positionen som for narvarande spelas upp, sa att synkroniseringsinformationens riktighet kan verifieras. Om en forskjutning maste laggas till for en eller flera tidsstamplar, kan det astadkommas med Lagg till forskjutning i den sammanhangsberoende menyn. Negativa varden kan anvandas for att reducera tiden. Genom att anvanda Ga till position i den sammanhangsberoende menyn, ar det mojligt att stalla in uppspelningsposition till den markerade radens tid. Rekommenderad procedur for att lagga till ny synkroniserad sangtext o Hamta den osynkroniserade sangtexten, t.ex. genom att anvanda Sangtext -> Inbadda sangtext i fillistans sammanhangsberoende meny. o Kopiera den osynkroniserade sangtexten till klippbordet. Ga bara till raden Sangtext i ramtabellen och tryck pa Ctrl+C. o Lagg till en synkroniserad sangtextram (Lagg till..., Synkroniserad sangtext, Ok), klicka pa Fran klippbord. o Nu finns alla raderna fran den osynkroniserade sangtexten i tabellen, med alla tidsstamplar ogiltiga (0:0:0.00). Tomma poster kan tas bort i forvag. o Starta uppspelning av sangen genom att klicka pa uppspelningsknappen i uppspelningsverktygsraden langst ner i huvudfonstret. o Nar nasta sangtextrad med ogiltig tidsstampel, klicka pa Lagg till eller tryck pa Alt+A, sa uppdateras tidsstampeln. o Fortsatt pa detta satt tills alla tidsstamplar ar uppdaterade. Om du missade nagonting, stoppa uppspelningen och nollstall tidsstamplarna med tangenten Delete eller genom att markera dem och anvanda Rensa i den sammanhangsberoende menyn. For att starta om uppspelning fran en given tidsstampel, anvand Ga till position fran den sammanhangsberoende menyn. Kapitel i MP4-filer MP4-ljudbocker har oftast filandelsen .m4b och ar ratt stora eftersom de innehaller alla kapitel i en enda fil. For att navigera i sadana filer, kan de innehalla kapitelmarkorer, som kan redigeras i Kid3 med pseudoramen "Chapters", genom att anvanda samma editor som anvands for synkroniserad sangtext. Observera dock att funktionen bara ar tillganglig med insticksprogrammet Mp4v2Metadata, sa sakerstall att det ar aktiverat och ovanfor insticksprogrammet TaglibMetadata under fliken Insticksprogram i installningarna om du behover redigera MP4-kapitel. Menyn Arkiv Arkiv -> Oppna... ( Ctrl+O ) Oppnar en katalog. Alla filer som matchar den markerade filens namnfilter visas i fillistrutan och den valda filen markeras. Arkiv -> Oppna senaste Oppnar en nyligen oppnad katalog. Arkiv -> Oppna katalog... ( Ctrl+D ) Oppnar en katalog. Alla filer som matchar den markerade filens namnfilter visas i fillistrutan. Arkiv -> Las in igen ( F5 ) Uppdatera katalog. Andrade filer maste forst sparas. Expanderade underkataloger dras ihop. Arkiv -> Spara ( Ctrl+S ) Sparar alla andrade filer i katalogen. De andrade filerna ar markerade med en disksymbol i fillistrutan. Om nagra filnamn har andrats, byts namnen pa de filerna. Arkiv -> Aterstall Aterstaller andringarna av en eller flera filer. Om inga filer ar markerade i fillistrutan aterstalls andringarna av alla filer, annars aterstalls bara andringar av de markerade filerna. Arkiv -> Importera... Importdialogrutan kan anvandas for att direkt importera data fran en freedb.org server, fran en MusicBrainz server, fran Discogs, Amazon eller andra kallor for albumsparlistor med textformat. Import fran en freedb.org server ar mojlig genom att anvanda en dialogruta som dyker upp nar Fran server: gnudb.org valjes. Artisten och albumnamnet att soka efter kan skrivas in i de tva oversta falten, och albumen som matchar fragan visas nar Sok klickas och resultaten fran www.gnudb.org[7] tas emot. Import av spardata for ett album gors genom att dubbelklicka pa albumet i listan. Vilken freedb.org server att anvanda for import kan valjas, samt CGI-sokvagen. Importerad data visas i forhandsgranskningstabellen i importdialogrutan. Nar du ar nojd med de visade sparen kan de importeras genom att avsluta importdialogrutan med Ok. Om du redan har ett sokresultat oppet i webblasaren, kan du ange webbadressen i det forsta sokfaltet. Resultatet dyker da upp i albumlistan och kan direkt importeras i Kid3. En sokning pa Discogs server kan utforas genom att anvanda Discogs. Som i dialogrutan gnudb.org, kan du mata in artist och album och sedan valja bland en lista av utgavor. En Symbol kan matas in for att anvanda programmeringsgranssnittet RESTful i Discogs istallet for deras webbgranssnitt, vilket ofta andras, och darigenom tar sonder importtolkningen. Du maste registrera for att fa ett konto pa Discogs[8], och sedan generera en symbol pa deras webbplats (Settings/Developers, Generate new token). Glom inte att Spara installningar efter att ha matat in symbolen for att ocksa kunna anvanda den i efterfoljande fragor. Om Standardtaggar ar markerat, importeras standardinformationen, t.ex. artist, album och titel. Om Ytterligare taggar ar markerat, importeras mer information om tillgangligt, t.ex. utovare, arrangor eller utgivare. Om Omslag ar markerat, laddas omslaget ner om tillgangligt. En sokning pa Amazon kan utforas genom att anvanda Amazon Som i dialogrutan gnudborg, kan du mata in artist och album och sedan valja bland en lista av utgavor. Om Ytterligare taggar ar markerat, importeras mer information om tillgangligt, t.ex. utovare, arrangor eller utgivare. Om Omslag ar markerat, laddas omslaget ner om tillgangligt. Du kan soka pa samma vag i MusicBrainz utgivningsdatabas genom att anvanda Fran MusicBrainz Release. Arbetsflodet ar samma som beskrivs for Fran gnudb.org. Import fran en MusicBrainz server ar mojlig genom att anvanda dialogrutan som dyker upp nar Fran MusicBrainz Fingerprint valjes. Servern kan valjas som i freedb importdialogrutan. Nedan visas en tabell som visar importerad spardata. Den hogra kolumnen visar tillstandet for forfragan till MusicBrainz, vilket borjar med "Vantande" nar dialogrutan oppnas. Darefter slas fingeravtrycket upp och om det inte ger nagot resultat, gors en annan uppslagning med taggarna i filen. Salunda kan det vara till hjalp for en lyckad MusicBrainz uppslagning att lagra kand information (t.ex. artist och album) i taggarna innan importen. Om ett resultat hittas, slutar sokningen i tillstandet "Igenkand", annars hittades ingenting eller hittades flera tvetydiga resultat och ett av dem maste valjas av anvandaren. Ok och Verkstall anvander importerad data, medan Avbryt stanger dialogrutan. Stangningen kan ta en stund, eftersom hela MusicBrainz maskineri maste stangas av. For att importera textdata, oppnar Fran fil/klippbord en underdialogruta dar flera forinstallda importformat ar tillgangliga. De tva forsta, "CSV unquoted" och "CSV quoted" kan anvandas for att importera data som exporterades med exportdialogrutan. CSV-data kan redigera med ett kalkylark, och maste skrivas ut genom att anvanda tabulator som avgransare. Import ska sedan vara mojlig genom att anvanda "CSV quoted", som ar flexiblare an "CSV unquoted". Dock kan dess falt inte innehalla nagra dubbla citationstecken. Om du bara exporterar fran Kid3 och importerar senare, kan "CSV unquoted" anvandas som ett enkelt format i detta syfte. Observera att det ocksa finns kommandona "Exportera CSV" och "Importera CSV" i fillistans sammanhangsberoende meny, som anvander skript for att exportera och importera CSV-data pa ett fullstandigare, kraftfullare och flexiblare satt. Nasta format, "freedb HTML-text" kan anvandas for att kopiera information fran en HTML-sida pa freedb.org[9]. Sok efter ett album pa freedb, sa visas onskad information i webblasaren. Kopiera innehallet till klippbordet. Klicka darefter pa knappen Fran klippbord sa visas de importerade sparen i forhandsgranskningstabellen langst upp i dialogrutan. Om du ar nojd med importerad data, avsluta dialogrutan med Ok, vilket infogar data i den aktuella katalogens taggar. Malet (Tagg 1, Tagg 2 eller Tagg 1 och tagg 2) kan valjas med en kombinationsruta. Filerna i den aktuella katalogen ska vara i ratt ordning for att fa sina taggar tilldelade. Det ar fallet om de ar numrerade. Nasta forinstallda importformat, "freedb HTML-kallkod", kan anvandas om data ar tillgangligt som ett HTML-dokument. Import ar mojlig genom att anvanda knappen Fran fil, som oppnar en filvaljare, eller genom att kopiera innehallet fran en editor och sedan importera fran klippbordet. Formatet kan vara anvandbart for nerkopplad import, aven om HTML-dokumentet ocksa skulle kunna oppnas i en webblasare och sedan importeras med det forsta formatet via klippbordet. Fler forinstallda format, t.ex. "Spar titel tid" ar tillgangliga. Ett tomt eget format kan skapas med Lagg till for att sedan stallas in av anvandaren. Tva rader nedanfor kan formatnamnet stallas in med ett reguljart uttryck for att lagra falten fran den importerade texten. Det forsta reguljara uttrycket tolkas en gang per dokument for att samla in data for varje album, sasom artist, album, ar och genre. Den andra raden forsoker matcha fran dokumentets borjan till slut for att hamta spardata, oftast nummer och titel. De reguljara uttrycken inkluderar alla funktioner som erbjuds av Qt(TM), vilket ar det mesta som Perl erbjuder. Parenteskonstruktioner "(..)" skapar tagningsbuffertar for falten att importera och foregas av Kid3 specifika koder for att ange vilket falt som ska lagras. Koderna ar samma som anvands for filnamnsformat, forutom koderna listade nedan, ar alla ramnamn mojliga: o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar o %g %{genre} Genre o %d %{duration} Langd Exempelvis kan ett reguljart uttryck for spar (andra raden) for att importera fran en .m3u-spellista vara "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]". Alla format kan andras genom att redigera de reguljara uttrycken och namnet, och darefter klicka pa Spara installningar. De lagras i filen kid3rc i installningskatalogen. Filen kan redigeras direkt for att fa fler importformat, eller kan tas bort for att aterga till standardformaten. Format kan tas bort genom att anvanda Ta bort. Noggrannhet visar en uppskattning av hur bra den importerade informationen motsvarar givna spar. Den anvander sparlangder eller filnamn for att berakna likhetsnivan i procent. Omslag visar webbadressen for albumets omslagsbild som kommer att laddas ner. For att kontrollera om de importerade sparen motsvarar aktuell uppsattning filer, kan de importerade sparens langd jamforas med filernas langd. Alternativet kan aktiveras med kryssrutan Kontrollera maximal tillaten tidsskillnad (s): och den maximalt tolererade tidsskillnaden kan stallas in i sekunder. Om en avvikelse i langd detekteras visas den med en rod bakgrund i forhandsgranskningstabellen. Om filerna ar ordnade pa annat satt an de importerade sparen, maste deras tilldelade spar andras. Uppgiften kan forenklas genom att anvanda alternativet Matcha med och knapparna Langd, Spar och Titel, vilket ordnar om sparen enligt motsvarande falt. For att korrigera tilldelningarna manuellt, kan ett spar dras med vanster musknapp och tangenten Ctrl nedtryckt, och darefter slappas pa den nya platsen. Nar importdialogrutan oppnas innehaller den taggarnas verkliga innehall. Taggtypen (Tagg 1, Tagg 2, Tagg 1 och tagg 2) kan valjas med kombinationsrutan Mal. Knappen till hoger om kombinationsrutan kan anvandas for att aterstalla tabellen till taggarnas nuvarande innehall. Kryssrutorna i den forsta tabellkolumnen kan anvandas for att markera sparen som ar importerade. Det kan vara anvandbart om en katalog innehaller sparen for bada cd-skivorna av en dubbel-cd, och bara sparen pa den andra cd-skivan behover importeras. For att identifiera spar som importeras ar det mojligt att visa filnamnen eller hela sokvagarna till filerna genom att anvanda den sammanhangsberoende menyn i tabellrubrikerna. Vardena i importtabellen kan redigeras. Angringsknappen till hoger om kombinationsrutan Mal kan anvandas for att aterstalla taggarnas innehall, vilket ocksa kan vara anvandbart efter att ha andrat Mal. Nastan alla dialogrutornas funktioner har knappen Spara installningar, som kan anvandas for att bestandigt lagra dialogspecifika installningar och fonsterstorlekar. Fran taggar leder till en underdialogruta for att tilldela taggramar fran innehallet i andra taggramar. Det kan anvandas for att helt enkelt kopiera information mellan taggar eller extrahera en del fran en ram och infoga den i en annan. Liksom i dialogrutan Importera fran fil/klippbord finns det fritt installningsbara format for att utfora olika atgarder. Format for att kopiera albumvardet till albumartist, tonsattare eller dirigent, och for att extrahear sparnummer fran titelfalt som innehaller ett nummer ar redan fordefinierade. Det finns ocksa ett format for att extrahera en undertitel fran ett titelfalt. Foljande exempel forklarar hur man lagger till ett eget format, vilket ocksa tilldelar informationen fran undertiteln till kommentarfaltet. Skapa ett nytt format genom att anvanda knappen Lagg till och ange ett nytt namn, t.ex. "Undertitel till kommentar". Mata darefter in "%{subtitle}" i Kalla and "%{comment}(.*)" for Extrahering och klicka pa Spara installningar. Uttrycket i Kalla kan innehalla formatkoder for godtyckliga taggramar, flera koder kan anvandas for att kombinera innehallet fran olika ramar. For varje spar skapas en text fran dess taggar genom att anvanda formatet i Kalla, och det reguljara uttrycket fran Extrahering anvands pa texten for att tilldela nya varden till taggarna. Formatkoder anvands innan lagringsparenteserna for att ange taggramen dar den tagna texten ska lagras. Det fungerar pa samma satt som import fran fil/klippbord. Importera fran taggar... ar ocksa direkt tillganglig i menyn Arkiv. Skillnaden mellan dessa tva funktioner ar att importdialogrutans underdialogruta arbetar med alla filer i aktuell katalog, medan menyfunktionen arbetar med de markerade filerna (vilka kan vara i olika kataloger). Menyfunktionen stoder ytterligare en kod "%{__return}" for att returnera det extraherade vardet, vilket kan vara anvandbart med kommandorads- och QML-granssnitten. Arkiv -> Importera fran gnudb.org... Importera fran en freedb.org server med gnudb.org albumsokning. Menyalternativet oppnar samma importdialogruta som Importera... men oppnar direkt dialogrutan gnudb.org. Arkiv -> Importera fran Discogs... Importera fran Discogs servern Menyalternativet oppnar samma importdialogruta som Importera.. men oppnar direkt dialogrutan Fran Discogs. Arkiv -> Importera fran Amazon... Importera fran Amazon. Menyalternativet oppnar samma importdialogruta som Importera. men oppnar direkt dialogrutan Fran Amazon. Arkiv -> Importera fran MusicBrainz Release... Importera fran MusicBrainz Release databas. Menyalternativet oppnar samma importdialogruta som Importera. men oppnar direkt dialogrutan Fran MusicBrainz Release. Arkiv -> Importera fran MusicBrainz Fingerprint... Importera fran en MusicBrainz server. Menyalternativet oppnar samma importdialogruta som Importera. men oppnar direkt dialogrutan Fran MusicBrainz Fingerprint. Arkiv -> Importera fran taggar... Som Fran taggar, men importen galler de markerade filerna. Arkiv -> Automatisk import... Automatisk import gor att man kan importera information fran flera album pa diverse webbtjanster. Om kataloger ar markerade i fillistan, importeras spardata for de markerade katalogerna. Om inga kataloger ar markerade, importeras alla kataloger i fillistan. Taggtypen (Tagg 1, Tagg 2, Tagg 1 och tagg 2) kan valjas med kombinationsrutan Mal. Profiler bestammer vilka servrar som kontaktas for att hamta albuminformation. Vissa profiler ar fordefinierade (Alla, MusicBrainz, Discogs, Omslag), och egna profiler kan laggas till genom att anvanda knappen Lagg till till hoger om kombinationsrutan Profil. Tabellen nedan visar servrarna som anvands nar albuminformation importeras med anvandning av den valda profilen. Importprocessen for ett album ar klar om all nodvandig information har hittas, sa radernas ordning i tabellen ar viktig. Den kan andras genom att anvanda knapparna Flytta upp och Flytta ner. Redigera kan anvandas for att andra en befintlig post. Valet Server erbjuder samma servrar som kan anvandas av importfunktionerna. Standardtaggar, Ytterligare taggar, Omslag bestammer informationen som ska hamtas fran servern. Till sist ar Noggrannhet den minimala noggrannheten som maste uppnas for att acceptera importerad data. Om noggrannheten ar otillracklig, provas nasta server i listan. Samma dialogruta som innehaller serveregenskaperna dyker upp nar Lagg till klickas for att lagga till en ny serverpost. Befintliga poster kan tas bort genom att anvanda Ta bort. Klicka pa Starta for att starta en automatisk import i bakgrunden med den valda profilen. Detaljinformation om pagaende import visas langst upp i dialogrutan. Processen kan avbrytas med knappen Avbryt. Arkiv -> Bladdra bland omslag... Dialogrutan Bladdra bland omslag hjalper till att hitta albumomslag. Artist/Album fylls i fran taggarna om mojligt. Kalla erbjuder ett antal webbplatser med albumomslag. Webbadressen med artist och album som parametrar finns under namnet. Webbadresskodade varden for artist och album kan infogas genom att anvanda "%u{artist}" och "%u{album}". Andra varden fran taggarna ar ocksa mojliga, som beskrivs i Anpassa Kid3, Anvandaratgarder. Fler kallor kan matas in efter posten "Egen kalla" genom att ersatta "Egen kalla" med kallans namn, trycka pa Enter, darefter infoga webbadressen, och slutligen klicka pa Spara installningar. Det resulterande webblasarkommandot visas langst upp i dialogrutan och kan utforas genom att klicka pa Bladdra. Webblasaren, som kan anpassas i installningarna, startas med den valda kallan. En omslagsbild kan sedan dras fran webblasaren till fonstret i Kid3 och tilldelas till de markerade filernas bildram. Eftersom inte alla webblasare stoder drag och slapp av bilder, och bilderna pa webbplatser har ofta en webbadress. I sadana fall tar Kid3 emot webbadressen och inte bilden. Om webbadressen pekar pa en bild, laddas den ner. Om webbadressen dock refererar till nagon annan webbresurs, maste den oversattas till motsvarande bild. Sadana avbildningar definieras i tabellen Webbadressextrahering. Den vanstra kolumnen Matcha innehaller ett reguljart uttryck som jamfors med webbadressen. Om det matchar, infogas de infangade uttrycken inom parenteser i den hogra kolumnens monster Bildwebbadress (i positionerna markerade med \1 etc.). Det ersatta reguljara uttrycket innehaller bildens webbadress. Pa detta satt kan omslag importeras fran Amazon, Google bilder, etc. genom att anvanda drag och slapp. Det ar ocksa mojligt att definiera dina egna avbildningar. Arkiv -> Exportera... Exportdialogrutan anvands for att lagra data fran taggarna i en fil eller pa klippbordet. Editorn langst upp visar en forhandsgranskning av data att exportera. Om exporterad data innehaller tabulatortecken, visas exporten i en tabell. Data genereras fran taggarna i aktuell katalog enligt det installda formatet. Formatinstallningarna liknar dem i importdialogrutan: Det oversta faltet innehaller titeln (t.ex. "CSV unquoted"), foljd av huvudet, som genereras i borjan av filen. Spardata foljer, och den anvands for varje spar. Till sist kan avslutningen anvandas for att generera nagon avslutande text. Formatfalten innehaller inte reguljara uttryck som i importdialogrutan, men bara formatuttryck for utdata med speciella %-uttryck, som ersatts med varden fran taggarna. Det hela fungerar som filnamnsformat, och samma koder anvands samt nagra ytterligare. Alla taggramnamn kan anvandas, inte bara koderna som listas nedan. o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar (t.ex. 01) o %t %{track.n} Spar med faltbredd n (t.ex. 001 for %{track.3}) o %T %{tracknumber} Spar (utan inledande nollor, t.ex. 1) o %g %{genre} Genre o %f %{file} Filnamn o %p %{filepath} Sokvag o %{modificationdate} Andringsdatum o %{creationdate} Skapad datum o %u %{url} Webbadress o %{dirname} Katalognamn o %d %{duration} Langd i minuter:sekunder o %D %{seconds} Langd i sekunder o %n %{tracks} Antal spar pa albumet o %e %{extension} Filandelse o %O %{tag1} Format pa tagg 1 (ID3v1.1 eller tom om den inte finns) o %o %{tag2} Formatet pa tagg 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1, Vorbis, APE, MP4, ASF eller tom om den inte finns) o %b %{bitrate} Bithastighet i kbit/s o %v %{vbr} VBR eller tom (bara for ID3v2.3 med id3lib) o %r %{samplerate} Samplingsfrekvens i Hz o %m %{mode} Kanallage (Stereo eller Joint Stereo) o %h %{channels} Antal kanaler (1 eller 2) o %k %{codec} Kodare (t.ex. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV) Nagra fa format ar fordefinierade. "CSV unquoted" skiljer falten med tabulatorer. Data med det har formatet kan importeras till Kid3 igen genom att anvanda importformatet med samma namn. "CSV quoted" omger dessutom falten med dubbla citationstecken, som forenklar import till kalkylprogram. Dock kan falten inte innehalla nagra dubbla citationstecken nar det har formatet anvands. "Extended M3U" och "Extended PLS" genererar spellistor med utokade attribut och absoluta sokvagsnamn. "HTML" kan anvandas for att generera en HTML-sida med hyperlankar till spar. "Kover XML" skapar en fil som kan importeras i omslagsutskriftsprogrammet Kover. "Tekniska detaljer" tillhandahaller information om bithastighet, samplingsfrekvens, kanaler, etc. Till sist, ar "Eget format" lamnat tomt for att definiera ett eget format. Du kan definiera fler egna format genom att lagga till rader i filen kid3rc i installningskatalogen. Ovriga format kan anpassas efter dina behov. Taggarnas Kalla for att generera exportdata (Tagg 1 eller Tagg 2) kan valjas med en kombinationsruta. Genom att klicka pa Till fil eller Till klippbord lagrar data i en fil eller pa klippbordet. Ok och Avbryt stanger dialogrutan, medan Ok accepterar de nuvarande dialoginstallningarna. Arkiv -> Skapa spellista... Skapar en spellista. Spellistans format och innehall kan stallas in med diverse alternativ. Spellistans namn kan vara Samma som katalognamnet eller anvand ett Format med varden fran taggarna, t.ex. "%{artist} - %{album}", for att fa artist- och albumnamn i spellistans filnamn. Formatkoderna ar likadana for Exportera. Listan over tillgangliga format kan redigeras i sektionen Format under fliken Filer i installningarna. Skapa ny tom spellista skapar en tom spellista med angivet namn. Filandelsen beror pa spellisteformatet. Den skapade spellistans plats bestams av valet i kombinationsrutan Skapa i. Nuvarande katalog Spellistan skapas i aktuell katalog och innehaller bara filer fran aktuell katalog. Den aktuella katalogen ar katalogen dar den aktuella filen finns. Om flera filer ar markerade, ar den aktuella filen troligtvis den senast markerade filen. Varje katalog En spellista skapas i varje katalog som innehaller listade filer, och varje spellista innehaller den katalogens filer. Toppnivakatalog Bara en spellista skapas i toppnivakataloger (dvs. fillistans katalog) och den innehaller de listade filerna i toppnivakatalogen och alla dess underkataloger. Spellistans format kan vara M3U, PLS eller XSPF. Om Inkludera bara de markerade filerna ar markerad, inkluderas bara de markerade filerna i spellistan. Om en katalog ar markerad, ar alla dess filer markerade. Om den har kryssrutan inte ar aktiverad, inkluderas alla ljudfiler i spellistan. Sortera enligt filnamn valjer det vanliga fallet dar filerna ar ordnade enligt filnamn. Med Sortera enligt taggfalt, ar det mojligt att sortera enligt en formatstrang med varden fran taggfalt. Exempelvis kan "%{track.3}" kan anvandas for att sortera enligt sparnummer ("3" anvands for att fa tre siffror med inledande nollor eftersom strangar anvands vid sortering). Det ar ocksa mojligt att anvanda flera falt, t.ex. "%{genre}%{year}" for att sortera med anvandning av en strang sammansatt av genre och ar. Spellisteposterna har relativa eller absoluta filsokvagar beroende pa om Anvand relativ sokvag for filer i spellista eller Anvand fullstandig sokvag for filer i spellista ar valt. Nar Skriv bara lista med filer ar valt, innehaller spellistan bara sokvagarna till filerna. For att skapa en utokad spellista med ytterligare information, kan en formatstrang anges genom att anvanda alternativet Skriv information med anvandning av. Arkiv -> Avsluta ( Ctrl+Q ) Avslutar programmet. Menyn Redigera Redigera -> Markera alla ( Alt+A ) Markerar alla filer. Redigera -> Avmarkera ( Ctrl+Shift+A ) Avmarkerar alla filer. Redigera -> Markera alla i katalog Markerar alla filer i den aktuella katalogen. Redigera -> Foregaende fil ( Alt+Uppatpil ) Valjer foregaende fil Redigera -> Nasta fil ( Alt+Neratpil ) Valjer nasta fil Redigera -> Sok... ( Ctrl+F ) Sok efter strangar i filnamnen och taggarna. Dialogrutan Sok ar en delmangd av dialogrutan Ersatt, som beskrivs nedan. Redigera -> Ersatt... ( Ctrl+R ) Funktionen oppnar en dialogruta for att hitta och ersatta strangar i filnamnen och taggarna. Uppsattningen av ramar dar sokningen utfors kan begransas genom att inaktivera kryssrutan Markera alla och markera alla ramar som ska sokas igenom. Det finns ocksa sokalternativ tillgangliga for att soka bakat, skiftlagesokansligt och for att anvanda reguljara uttryck. Beroende pa antalet filer kan sokningen ta en stund, och darfor kan den avbrytas genom att stanga dialogrutan. Menyn Verktyg Verktyg -> Verkstall filnamnsformat Nar Verkstall format automatiskt stangs av for filnamnsformatet i installningsdialogrutan, kan menyalternativet anvandas for att verkstalla det installda formatet for de markerade filernas namn. Det kan ocksa anvandas for att kontrollera om filnamnen motsvarar det installda formatet genom att verkstalla formatet for alla sparade filer och sedan kontrollera om nagra filer andrades (och darfor markerades med en skivsymbol i fillistrutan). Verktyg -> Verkstall taggformat Nar Verkstall format automatiskt stangs av for taggformatet i installningsdialogrutan, kan menyalternativet anvandas for att verkstalla det installda formatet for taggarna i de markerade filerna. Det kan ocksa anvandas for att kontrollera om taggarna motsvarar det installda formatet genom att verkstalla formatet for alla sparade filer och sedan kontrollera om nagra filer andrades (och darfor markerades med en skivsymbol i fillistrutan). Verktyg -> Verkstall textkodning Tilldelar Textkodning vald med Installningar -> Anpassa Kid3... -> Sektionen Tagg -> Fliken Tagg 2 till alla markerade filerna. Om UTF8 ar valt, anvands UTF16 for ID3v2.3.0 taggar eftersom UTF8 inte stods for det formatet. Verktyg -> Byt namn pa katalog... Dialogrutan erbjuder mojligheten att automatiskt byta namn pa katalogen som for narvarande ar oppen till taggarna i filerna. Flera format ar forinstallda att inkludera information om artist, album och ar i katalognamnet. Det ar ocksa mojligt att ange ett eget format och Redigera listan med tillgangliga format. Foljande speciella koder anvands for att infoga taggvarden i katalognamnet: o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar (t.ex. 01) o %t %{track.n} Spar med faltbredd n (t.ex. 001 for %{track.3}) o %T %{tracknumber} Spar (utan inledande nollor, t.ex. 1) o %g %{genre} Genre o %{dirname} Katalognamn (t.ex. %{year" "}%{dirname} lagger till aret forst i det aktuella katalognamnet) o %{max-year} Det maximala vardet pa aret som hittas i katalogen, kan ocksa anvandas med andra koder an "year" o %{max-year} Det minimala vardet pa aret som hittas for den har katalogen o %{unq-year} Det unika vardet pa aret som hittas for den har katalogen, eller tomt om det inte ar unikt Om en katalogavskiljare "/" finns i formatet, skapas flera kataloger. Om du vill skapa en ny katalog istallet for att byta namn pa den aktuella katalogen, valj Skapa katalog i kombinationsrutan Atgard istallet for Byt namn pa katalog. Kalla for tagginformationen kan valjas mellan Tagg 1 och tagg 2, Tagg 1 och Tagg 2. En forhandsgranskning av namnbytesatgarden utford for den forsta filen visas i sektionerna Fran och Till i dialogrutan. Namnet pa flera kataloger kan bytas genom att markera dem. Verktyg -> Numrera spar... Om sparnumren i taggarna inte ar installda eller har fel varden, kan funktionen automatiskt numrera sparen i stigande ordning. Startnumret kan stallas in i dialogrutan. Om bara delar av sparen ska numreras, maste de markeras. Nar Totalt antal spar ar markerat, anges ocksa antal spar i taggarna. Det ar mojligt att numrera sparen i flera kataloger. Katalogerna maste expanderas och markeras. Om Nollstall raknare for varje katalog ar markerat, startas sparnumrering om med det angivna numret for varje katalog nar flera kataloger ar markerade. Dialogrutan for att numrera spar kan ocksa anvandas for att formatera befintliga sparnummer utan att andra vardena nar kryssrutan till vanster om Startnummer ar inaktiverad. Det totala antalet spar laggs till om motsvarande kryssruta ar aktiverad, vilket kan anvandas for att stalla in totalantalet for alla markerade spar. Om bara formatering av befintliga nummer onskas, maste den kryssrutan ocksa inaktiveras. Verktyg -> Filtrera... Filtret kan anvandas for att bara visa de filer som motsvarar vissa kriterier. Det ar anvandbart om du vill organisera en stor samling och bara redigera filerna som inte har onskat format. Uttrycket som definierar vilka filer som ska visas anvander samma formatkoder som anvands for filnamnsformat, import och export. o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar (t.ex. 01) o %t %{track.n} Spar med faltbredd n (t.ex. 001 for %{track.3}) o %T %{tracknumber} Spar (utan inledande nollor, t.ex. 1) o %g %{genre} Genre o %f %{file} Filnamn o %p %{filepath} Absolut sokvag till fil o %e %{extension} Filandelse o %O %{tag1} Format pa tagg 1 (ID3v1.1 eller tom om den inte finns) o %o %{tag2} Formatet pa tagg 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1, Vorbis, APE, MP4, ASF eller tom om den inte finns) o %b %{bitrate} Bithastighet i kbit/s o %v %{vbr} VBR eller tom (bara for ID3v2.3 med id3lib) o %r %{samplerate} Samplingsfrekvens i Hz o %m %{mode} Kanallage (Stereo eller Joint Stereo) o %h %{channels} Antal kanaler (1 eller 2) o %k %{codec} Kodare (t.ex. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF, AIFF, WAV) o %w %{marked} Markerad, ar 1 om filen ar markerad (t.ex. pa grund av avkortning eller avvikelse fran standarden), annars tom o %1a %1{artist}, ... Anvand prefix 1 for att fa vardet pa tagg 1 o %a %{artist}, ... Anvand prefix 2 for att fa vardet pa tagg 2 Koderna ersatts med filens varden, och resulterade strangarna kan jamforas med foljande operationer: o s1 equals s2: true om s1 och s2 ar lika. o s1 contains s2: true om s1 innehaller s2, dvs. s2 ar en delstrang av s1. o s matches re: true om s matchar det reguljara uttrycket re. Sanna uttryck ersatts med 1, falska med 0. Sanna varden representeras med 1, true, on och yes. Falska varden av 0, false, off och no. Booleska operationer ar not, and, or (i den rangordningen) och kan grupperas med parenteser. Nagra filterregler ar fordefinierade och kan tjana som exempel for dina egna uttryck: Alla Nar fillistan ar filtrerad (det visas med "[filtrerad]" i fonsterrubriken) och alla filer ska visas igen, kan filtreringen aterstallas med det har filtret. Det anvander ett tomt uttryck, men ett sant varde skulle fa samma effekt. Filnamn tagg missanpassning not (%{filepath} contains "%{artist} - %{album}/%{track} %{title}") Testar om filsokvagen motsvarar filnamnsformatet. Regeln anpassas automatiskt om filnamnsformatet andras. Ingen tagg 1 %{tag1} equals "" Visa bara filer som inte har tagg 1. Ingen tagg 2 %{tag2} equals "" Visa bara filer som inte har tagg 2. ID3v2.3.0 tagg %{tag2} equals "ID3v2.3.0" Visa bara filer som inte har en ID3v2.3.0 tagg. ID3v2.4.0 tagg %{tag2} equals "ID3v2.4.0" Visa bara filer som inte har en ID3v2.4.0 tagg. Tagg 1 != Tagg 2 not (%1{title} equals %2{title} and %1{album} equals %2{album} and %1{artist} equals %2{artist} and %1{comment} equals %2{comment} and %1{year} equals %2{year} and %1{track} equals %2{track} and %1{genre} equals %2{genre}) Visar filer med skillnader mellan tagg 1 och tagg 2. Tagg 1 == Tagg 2 %1{title} equals %2{title} and %1{album} equals %2{album} and %1{artist} equals %2{artist} and %1{comment} equals %2{comment} and %1{year} equals %2{year} and %1{track} equals %2{track} and %1{genre} equals %2{genre} Visar filer med identiska tagg 1 och tagg 2. Ofullstandig %{title} equals "" or %{artist} equals "" or %{album} equals "" or %{year} equals "" or %{tracknumber} equals "" or %{genre} equals "" Visar filer med tomma varden i standardtaggarna (titel, artist, album, datum, sparnummer, genre). Ingen bild %{picture} equals "" Visa bara filer som inte har en bild. Markerad not (%{marked} equals "") Visar bara filerna som ar markerade eftersom de bryter mot ID3-standarden, ar avkortade eller har en for stor bild. Egna filter Valj den har posten for att lagga till ditt eget filter. Om du exempelvis vill ha ett filter for artister som borjar med "The", ersatt "Eget filter" med namnet "The Bands" och tryck pa Enter. Infoga darefter foljande uttryck i radeditorn: %{artist} matches "The.*" Klicka darefter pa Spara installningar. Klicka pa Verkstall for att filtrera filerna. Alla filer som behandlas visas i textvyn med ett "+" for de som motsvarar filtret och ett "-" for de ovriga. Nar det ar klart, visas bara filerna med en artist som borjar pa "The", och fonsterrubriken ar markerad med "[filtrerad]". Verktyg -> Konvertera till ID3v2.3 till ID3v2.4 Om det finns nagra ID3v2.3 taggar i de markerade filerna konverteras de till ID3v2.4 taggar. Ramar som inte stods av TagLib kastas. Bara filer utan osparade andringar konverteras. Verktyg -> Konvertera till ID3v2.4 till ID3v2.3 Om det finns nagra ID3v2.4 taggar i de markerade filerna konverteras de till ID3v2.3 taggar. Bara filer utan osparade andringar konverteras. Verktyg -> Spela Visar en enkel verktygsrad for att spela ljudfiler. Den innehaller knappar for grundfunktionerna (Spela/Paus, Stoppa uppspelning, Foregaende spar, Nasta spar, Stang), skjutreglage for position och volym, samt visning av aktuell position. Om flera filer ar markerade, spelas de markerade sparen, annars spelas alla filer. Tiden som visas kan andras mellan forfluten och aterstaende tid genom att klicka pa visad tid. Menyn Installningar Installningar -> Visa verktygsrad Andrar visning av verktygsraden. Installningar -> Visa statusrad Andrar visning av statusraden, som visar langre atgarder som att oppna eller spara en katalog. Installningar -> Visa bild Andrar visning av forhandsgranskningsbilden av albumomslag. Installningar -> Dolj taggar automatiskt Tomma taggar ar automatiskt dolda om alternativet ar aktivt. Sektionerna Fil, Tagg 1 och Tagg 2 kan dras ihop och expanderas manuellt genom att klicka pa motsvarande knappar -/+. Installningar -> Anpassa snabbtangenter... Visar en dialogruta for att tilldela snabbtangenter for de flesta av programmets funktioner. Det finns till och med funktioner utan motsvarande meny eller knapp tillgangliga, t.ex. nasta fil, foregaende fil, markera alla. Installningar -> Anpassa Kid3... Visar installningsdialogrutan, som bestar av sidor for taggar, filer, anvandaratgarder och natverksinstallningar. Taggspecifika alternativ finns pa sidan Taggar, som i sig ar uppdelad i fyra flikar for Tagg 1, Tagg 2, Tagg 3 och Alla taggar. Om Markera avkortade falt ar aktiverat, markeras avkortade ID3v1.1 falt med rott. Textfalten i ID3v1.1 taggar kan bara ha 30 tecken, och kommentaren bara 28 tecken. Dessutom ar genre- och sparnumren begransade, sa att falten kan avkortas nar de importeras eller overfors fran ID3v2. Avkortade falt och filen markeras med rott, och markeringen tas bort efter faltet har redigerats. Med Textkodning for ID3v1 ar det mojligt att ange teckenuppsattningen som anvands i ID3v1 taggar. Kodningen forvantas vara ISO-8859-1, sa det rekommenderas att behalla detta forvalda varde. Dock finns det en del taggar med annorlunda kodning, sa den kan stallas in har och ID3v1 taggarna kan sedan kopieras till ID3v2, som stoder Unicode. Kryssrutan Anvand formatet spar/totalt antal spar bestammer om sparnummerfaltet i ID3v2 taggar helt enkelt innehaller sparnumret eller dessutom det totala antalet spar i katalogen. Nar Genre som text istallet for numerisk strang ar markerad, lagras alla ID3v2 genrer som textstrangar aven om det finns en motsvarande kod for ID3v1 genrer. Om alternativet inte ar valt, lagras genrer for vilka det finns en ID3v1 kod lagras som den genrekodens nummer (inom parentes for ID3v2.3). Salunda lagras genren Metal som "Metal" eller "(9)" beroende pa alternativet. Genrer som inte finns i listan over ID3v1 genrer lagras alltid som en textstrang. Syftet med alternativet ar forbattrad kompatibilitet med enheter som inte tolkar genrekoder korrekt. Nar WAV-filer med id3-stycke med sma bokstaver ar markerad, anvands RIFF-stycket anvandes for att lagra ID3v2-taggar i WAV-filer med namnet "id3" istallet for "ID3". Normalt Kid3 och andra program som anvander TagLib accepterar bade varianter med sma och stora bokstaver nar WAV-filer lases, men de anvander "ID3" nar ID3v2 taggar skrivs till WAV-filer. Eftersom det finns andra program som bara accepterar "Id3" (t.ex. JRiver Media Center och foobar2000), kan alternativet anvandas for att skapa taggar som kan lasas av sadana program. Nar Markera avvikelser fran standard ar markerad, ar ID3v2-falt som avviker fran standarden markerade med rott. Detaljinformation om avvikelsen visas i ett verktygstips: o Maste vara unik o Nyrad otillaten o Returtecken otillatet o Agare maste vara icke-tom o Maste vara numerisk o Maste vara numerisk eller nummer/totalantal o Format ar DDMM o Format ar TTMM o Format ar AAAA o Maste borja med ett ar och ett mellanslag o Maste vara ISO 8601 datum eller tid o Maste vara en tonart, tre tecken, A-G, b, #, m, o o Maste ha ISO 639-2 sprakkod, tre sma bokstaver o Maste vara ISRC-kod, 12 tecken o Maste vara lista av strangar atskilda av '|' o Har overflodiga blanktecken ID3-standarddokumenten ar tillgangliga pa natet: o ID3-tagg version 2.3.0[10] o ID3-tagg version 2.4.0 - Huvudstruktur[11] o ID3-tagg version 2.4.0 - Inbyggda ramar[5] Textkodning definierar standardkodningen anvand for ID3v2 ramar och kan stallas in till ISO-8859-1, UTF16 eller UTF8. UTF8 ar inte giltigt for ID3v2.3.0 ramar: om det ar installt, anvands UTF16 istallet. For ID3v2.4.0 ar alla tre kodningarna mojliga. Version anvand for nya taggar bestammer om nya ID3v2 taggar skapas som version 2.3.0 eller 2.4.0. Sparnummersiffror ar antal siffror i sparnummerfalt. Inledande nollor anvands for att fylla ut. Exempelvis med vardet 2 anges sparnummer 5 som "05". Kombinationsrutan Kommentarfaltnamn ar bara relevant for Ogg/Vorbis- och FLAC-filer och anger namnet pa faltet anvands for kommentarer. Olika program verkar anvanda olika namn, "KOMMENTAR" anvands exempelvis for XMMS, medan Amarok anvander "BESKRIVNING". Bildernas format i Ogg/Vorbis-filer bestams av Bildfaltnamn, som kan vara "METADATA_BLOCK_PICTURE" eller "COVERART". Den forsta ar officiell standard och anvander samma format i FLAC-taggar. "COVERART" ar en tidigare inofficiellt satt for att inkludera bilder i Vorbis-kommentarer. Det kan anvandas for kompatibilitet med tidigare spelare. Om kryssrutan Markera om storre an (byte) ar aktiverad, markeras filer som innehaller inbaddade albumomslag som overskrider given storlek i byte. Det kan anvandas for att hitta filer som innehaller alltfor stora bilder som inte accepteras av vissa program och spelare. Standardvardet ar 131072 byte (128 KB). Egna genrer kan anvandas for att definiera genrer som inte ar tillgangliga i standardlistan over genren, t.ex. "Gothic Metal". Sadana egna genrer dyker upp i kombinationsrutan Genre for Tagg 2. For ID3v1.1, kan bara fordefinierade genrer. Listan over egna genrer kan ocksa anvandas for att reducera antalet genrer tillgangliga i kombinationsrutan Genre till de som typiskt anvands. Om din samling innehaller mest musik i genrerna Metal, Gothic Metal, Ancient och Hard Rock, kan du mata in dessa genrerna och markera Visa bara egna genrer. Kombinationsrutan Tagg 2 Genre innehaller da bara de fyra genrerna och du behover inte soka igenom den fullstandiga genrelistan for att hitta dem. I det har exemplet listas bara Metal och Hard Rock i genrelistan for tagg 1, eftersom dessa tva egna genrer ar standardgenrer. Om Visa bara egna genrer inte ar aktiverad, hittar man de egna genrerna i slutet av genrelistan. Under Egna ramar kan upp till atta egna ramnamn definieras, vilka kan sedan anvandas som de gemensamma ramarna, exempelvis for snabbatkomst. Snabbatkomstramar definierar vilka ramtyper som alltid visas i sektionen Tagg 2. Sadana ramar kan darefter laggas till utan att forst anvanda knappen Lagg till. Ordningen pa snabbatkomstramarna kan andras genom att dra och slappa objekt. Kombinationsrutan Sparnummerfaltnamn ar bara relevant for RIFF INFO och staller in namnet pa faltet som anvands for sparnummer. Sparnummer ar inte specificerade i den ursprungliga RIFF-standarden. Det finns program som anvander "ITRK" och andra som anvander "IPRT". Taggformat innehaller alternativ for taggarnas format. Nar Verkstall format automatiskt ar markerat, anvands formatinstallningen automatiskt nar text andras i redigeringsrader. Validering aktiverar validering i rutorna med varden for spar/totalt och datum/tid. Skiftlageskonvertering kan stallas in till Ingen andringar, Bara sma bokstaver, Bara stora bokstaver, Forsta bokstaven stor bokstav eller Alla forsta bokstaver stora. For att anvanda konvertering mellan sma och stora bokstaver som kanner till landsinstallningar, kan en landsinstallning valjas i kombinationsrutan nedanfor. Strangersattningslistan kan stallas in till godtyckliga strangavbildningar. For att lagga till en ny avbildning, markera cellen Fran pa en rad och infoga texten att ersatta, och ga sedan till kolumnen Till och skriv in ersattningstexten. Nar texten att ersatta borjar och slutar med ett snedstreck ("/"), anvands ett reguljart uttryck. For reguljara uttryck som innehaller infangningsgrupper, ersatts forekomster av \1, \", ... i Till ersatts av strangen som representeras av motsvarande infangningsgrupp. For att ta bort en avbildning, andra cellen Fran till ett tomt varde (t.ex. genom att forst skriva in ett mellanslag och sedan ett baksteg). Att infoga och ta bort rader ar ocksa mojligt med en sammanhangsberoende meny som dyker upp nar hoger musknapp klickas. Ersattning ar bara aktiv om kryssrutan Strangersattning ar markerad. Tabellen Betyg innehaller avbildningen av stjarnbetyg till de verkliga vardena lagrade i taggen. Ramarna med betygsinformation listas pa raden Betyg i ramlistan. For dessa ramar, kan betyget anges genom att ge ett antal stjarnor av fem stjarnor. Olika taggformat och olika program anvander olika varden for att avbilda stjarnbetygen till vardet lagrat i taggen. For att visa ratt antal stjarnor slar Kid3 upp en avbildning i den har tabellen. Nyckeln for att sla upp avbildningen ar ramnamnet, till exempel "RATING" som anvands for Vorbis-kommentarer eller "IRTD" for RIFF INFO. For ID3v2-taggar, anvands en kombinerad nyckel som bestar av ram-id "POPM" i ramen Popularimeter och dess "Email" falt, separerade av en punkt. Darfor finns olika nycklar for ID3v2, t.ex. "POPM.Windows Media Player 9 Series" for avbildningen som anvands av Windows mediaspelare och utforskare, och helt enkelt "POPM" for POPM-ramar med ett tomt "Email" falt. Eftersom flera poster kan finnas for "POPM" ar deras ordning viktig. Nar Kid3 lagger till en ny Popularimeter-ram, anvands den forsta "POPM" posten for att bestamma vardet som ska skrivas in i "Email" faltet. Det vardet anger sedan avbildningen som anvands for stjarnbetyg. Den forsta posten anvands ocksa om ingen nyckel hittades, och ar darfor den forvalda posten. Forutom kolumnen Namn som innehaller nycklarna, har tabellen kolumnerna 1 till 5 for varden som ska lagras nar motsvarande antal stjarnor ges. At andra hallet, avgor vardena antal stjarnor som visas for vardet som ar lagrat i ramen. Raden i tabellen nedan innehaller exempelvis vardena 1, 64, 128, 196, 255. Trosklarna for antal stjarnor som visas ligger mellan dessa varden och ar kompatibla med det som Windows(R) utforskare anvander. Tabell 1. Post i betygstabell +----------+------+-------+--------+---------+---------+ |Namn | 1 | 2 | 3 | 4 | 5 | +----------+------+-------+--------+---------+---------+ |POPM | 1 | 64 | 128 | 196 | 255 | +----------+------+-------+--------+---------+---------+ |Intervall | 1-31 | 32-95 | 96-159 | 160-223 | 224-255 | +----------+------+-------+--------+---------+---------+ Pa sidan Filer akn kryssrutan Las in senast oppnade filer sa att Kid3 oppnar och markerar den senast markerade filen nar det startas nasta gang. Bevara filtidsstampel kan markeras for att bevara filens andringstidsstampel. Filnamn for omslag staller in namnet som foreslas nar en inbaddad bild exporteras till en fil. Med Textkodning (export, spellista) kan kodningen som anvands nar filer skrivs ut stallas in. Forvalet System kan andras om spellistor exempelvis behover anvandas pa en annan enhet. Om Markera andringar ar aktiverad, markeras andrade falt med en ljusgra bakgrund. Sektionen Fillista bestamer vilka filer som visas i fillistan. Ett Filter kan anvandas for att begransa objekten i listan till filer med filandelser som stods. For att explicit ange vilka kataloger som ska visas i fillistan eller undanta vissa kataloger, kan alternativen Inkludera kataloger och Undanta kataloger anvandas. De kan innehalla uttryck med jokertecken, exempelvis */Musik/* for att bara inkludera katalogen Musik, eller */iTunes/* for att undanta katalogen iTunes fran fillistan. Om flera sadana uttryck behover anvandas, kan de atskiljas av mellanslag eller semikolon. Knapparna Filnamn fran tagg och Tagg fran filnamn i sektionen Format visar dialogrutor for att redigera formaten som ar tillgangliga i kombinationsrutorna Format (med piltangenterna uppat och nerat) som finns i sektionen Fil i huvudfonstret. Knappen Spellista kan anvandas for att redigera filnamnsformaten tillgangliga i dialogrutan Skapa spellista. Filnamnsformat innehaller alternativ for filnamnens format. Samma alternativ som for Taggformat ar tillgangliga. Dessutom kan Maximal langd som tillats for filnamn stallas in. De flesta moderna filsystem har gransen 255 tecken, men om du vill skriva filerna till en cd, ska du stalla in gransen till 64. Om Anvand for spellista och katalognamn ar markerat, anvands ocksa filnamnsformatet nar spellistor skapas och namn pa kataloger bytes. Sidan Anvandaratgarder innehaller en tabell med kommandon som ar tillgangliga i fillistans sammanhangsberoende meny. For kritiska atgarder, som att ta bort filer, ar det lampligt att markera Bekrafta for att visa en bekraftelseruta innan kommandot utfors. Utmatning kan markeras for att se utmatning skriven av terminalkommandon (standardutmatning och standardfelutmatning). Namn ar namnet som visas i den sammanhangsberoende menyn. Kommando ar kommandoraden som ska utforas. Argument kan skickas med genom att anvanda foljande koder: o %F %{files} Filsokvagar (en lista om flera filer ar markerade) o %f %{file} Filsokvag till en enstaka fil o %uF %{urls} Webbadresser (en lista om flera filer ar markerade) o %uf %{url} Webbadress till en enstaka fil o %d %{directory} Katalog o %s %{title} Titel (Lat) o %a %{artist} Artist o %l %{album} Album o %c %{comment} Kommentar o %y %{year} Ar o %t %{track} Spar (t.ex. 01) o %t %{track.n} Spar med faltbredd n (t.ex. 001 for %{track.3}) o %T %{tracknumber} Spar (utan inledande nollor, t.ex. 1) o %g %{genre} Genre o %b %{browser} Kommando for att starta webblasaren o %q %{qmlpath} Baskatalog for tillhandahallna QML-filer Specialkoden @separator kan anges som ett kommando for att infoga en avskiljare i den sammanhangsberoende menyn med anvandaratgarder. Menyalternativ kan laggas till i en undermeny genom att omge dem med kommandona @beginmenu och @endmenu. Namnet pa undermenyn bestams av kolumnen Namn for kommandot @beginmenu. For att kora QML-skript anvands @qml som kommandonamn. Sokvagen till QML-skriptet skickas med som en parameter. Skripten som tillhandahalls finns i katalogen %{qmlpath}/script/ (pa Linux(R) oftast /usr/share/kid3/qml/script/, pa Windows qml/script/ inne i installationskatalogen, och pa macOS(R) i app-katalogen kid3.app/Contents/Resources/qml/script/). Egna skript kan lagras i vilken katalog som helst. Om QML-koden anvander grafiska anvandargranssnittskommandon, maste @qmlview anvandas istallet for @qml. Ytterligare parametrar kan skickas med till QML-skriptet, dar de ar tillgangliga via funktionen getArguments(). En oversikt av nagra funktioner och egenskaper som ar tillgangliga i QML finns i appendixet QML-granssnitt. Kommandot som infogas med %{browser} kan definieras pa redigeringsraden Webblasare ovanfor. Kommandon som borjar med %{browser} kan anvandas for att hamta information om ljudfilerna fran webben, exempelvis fragar %{browser} http://lyricwiki.org/%u{artist}:%u{title} efter sangtexten for nuvarande sang hos LyricWiki[12]. Bokstaven "u" i %u{artist} och %u{title} anvands for att webbadresskoda artist- %{artist} och sang- %{title} information. Det ar enkelt att definiera dina egna fragor pa samma satt, t.ex. en bildsokning med Google[13]: %{browser} http://images.google.com/images?q=%u{artist}%20%u{album} For att lagga till albumomslag till tagg 2 kan du soka efter bilder med Google eller Amazon genom att anvanda kommandona som beskrivs ovan. Bilden kan laggas till i taggen med drag och slapp. Du kan ocksa lagga till en bild med Lagg till och darefter markera bildramen och importera en bildfil eller klistra in fran klippbordet. Bildramar stods for ID3v2-, MP4-, FLAC-, Ogg- och ASF-taggar En sammanhangsberoende meny kan anvandas for att lagga till eller ta bort poster i tabellen. Sidan Natverk innehaller bara ett falt for att infoga proxy-adressen och valfritt porten, atskilda av ett kolon. Proxy anvands vid import fran en Internet-server nar kryssrutan ar markerad. Pa sidan Insticksprogram, kan tillgangliga insticksprogram aktiveras eller inaktiveras. Insticksprogrammen ar uppdelade i tva sektioner. Listan Metadatainsticksprogram och prioritet innehaller insticksprogram som stoder ljudfilformat, Insticksprogrammens ordning ar viktig eftersom de provas uppifran och ner. Nagra format stods av flera insticksprogram, sa filer oppnas med det forsta insticksprogrammet som stoder dem. Tablibmetadata stoder flest format. Om det ar langst upp i listan, oppnar det de flesta filerna. Om du vill anvanda ett annat insticksprogram for ett filformat, sakerstall att det listas innan insticksprogrammet Taglibmetadata. Detaljinformation om metadatainsticksprogram och varfor du kan vilja anvanda dem istallet for Taglib listas nedan. o Id3libMetadata: Anvander id3lib[14] for ID3v1.1 och ID3v2.3 taggar i MP3-, MP2-, AAC-filer. Stoder nagra fa fler ramtyper an TagLib. o OggFlacMetadata: Anvander libogg[15], libvorbis, libvorbisfile[16] for Ogg-filer, och ytterligare libFLAC++ och libFLAC[17] for FLAC-filer. De ar de officiella biblioteken for dessa format. o TaglibMetadata: Anvander TagLib[18] som stoder manga ljudfilformat. Det kan anvandas for alla ljudfiler som stods av Kid3. o Mp4v2Metadata: mp4v2[19] anvandes ursprungligen av Kid3 for att stodja M4A-filer. Kan anvandas i handelse av problem med M4A-stodet i TagLib. Sektionen Tillgangliga insticksprogram listar de aterstaende insticksprogram. Deras ordning ar inte viktig, men de kan aktiveras och inaktiveras genom att anvanda kryssrutorna. o AmazonImport: Anvands for funktionen Import fran Amazon.... o DiscogsImport: Anvands for funktionen Import fran Discogs.... o FreedbImport: Anvands for funktionen Import fran gnudb.org.... o MusicBrainzImport: Anvands for funktionen Import fran MusicBrainz Release.... o AcoustidImport: Anvands for funktionen Import fran MusicBrainz Fingerprint..., som beror pa biblioteken Chromaprint[20] och libav[21]. Insticksprogram som ar inaktiverade laddas inte. Det kan anvandas for att optimera resursanvandning och starttid. Installningarna pa sidan far bara effekt efter att Kid3 har startats om. Menyn Hjalp Hjalp -> Handbok Kid3 Visar den har handboken. Hjalp -> Om Kid3 Visar en kort information om Kid3. KID3-CLI Kommandon kid3-cli erbjuder ett kommandoradsgranssnitt for Kid3. Om en katalogsokvag anvands, oppnas den katalogen. Om en eller flera filsokvagar anges, oppnas den gemensamma katalogen och filerna markeras. Efterfoljande kommandon arbetar darefter med dessa filer. Kommandon anges med valjaren -c. Om flera kommandon anges, utfors de i angiven ordning. Om filer andras av kommandon, sparas de pa slutet. Om inga kommandovaljare anges, startar kid3-cli i interaktivt lage. Kommandon kan matas in och utfors med den aktuella markeringen. Foljande avsnitt listar alla tillgangliga kommandon. Hjalp help [KOMMANDONAMN] Visar hjalp om parametrarna for KOMMANDONAMN eller om alla kommandon om inget kommandonamn anges. Tidsgrans timeout [ | default | off | TID ] Skriv over den normala kommandotidsgransen. Kommandoradens kommandon avbryts efter en kommandospecifik tidsgrans har overskridits. Tidsgransen ar 10 sekunder for ls och albumart, 60 sekunder for autoimport och filter, och 3 sekunder for alla andra kommandon. Om ett mycket stort antal filer maste behandlas, kan tidsgranserna vara for restriktiva, och salunda kan tidsgransen for alla kommandon stallas in till TID ms, stangas av helt och hallet eller lamnas som normala varden. Avsluta programmet exit [force] Avsluta programmet. Om det finns andrade osparade filer, kravs parametern force. Byt katalog cd [KATALOGER] Om FOLDER inte anges, byt till hemkatalogen. Om en katalog anges, byt till den katalogen. Om en eller flera filsokvagar anges, byt till deras gemensamma katalog och markera filerna. Skriv ut den aktuella katalogens filnamn pwd Skriver ut den aktuella arbetskatalogens filnamn. Kataloglista ls Lista innehallet i den aktuella katalogen. Det motsvarar fillistan i Kid3s grafiska anvandargranssnitt. Fem tecken innan filnamnen visar filernas tillstand. o > Filen ar markerad. o * Filen ar andrad. o 1 Filen har en tagg 1, annars visas '-'. o 2 Filen har en tagg 2, annars visas '-'. o 3 Filen har en tagg 3, annars visas '-'. kid3-cli> ls 1-- 01 Borjan.mp3 > 12- 02 Vi har bara den har.mp3 *1-- 03 Slutet.mp3 I det har exemplet har alla filer en tagg 1, den andra filen har ocksa en tagg 2 och den ar markerad. Den tredje filen ar andrad. Spara de andrade filerna save Markera fil select [ | all | none | first | previous | next | FIL... ] Skriv in select all for att markera alla filer,skriv in select none for att avmarkera alla filer. For att ga igenom filerna i aktuell katalog, borja med select first, ga sedan framat med select next eller bakat med select previous. Specifika filer kan laggas till i aktuell markering genom att ange deras filnamn. Jokertecken ar mojliga, sa select *.mp3 markerar alla MP3-filer i den aktuella katalogen. kid3-cli> select first kid3-cli> ls > 1-- 01 Borjan.mp3 12- 02 Vi har bara den har.mp3 *1-- 03 Slutet.mp3 kid3-cli> select next kid3-cli> ls 1-- 01 Borjan.mp3 > 12- 02 Vi har bara den har.mp3 *1-- 03 Slutet.mp3 kid3-cli> select *.mp3 kid3-cli> ls > 1-- 01 Borjan.mp3 > 12- 02 Vi har bara den har.mp3 >*1-- 03 Slutet.mp3 Valj tagg tag [TAGGNUMMER] Manga kommandon har en valfri parameter TAGGNUMMER, som anger om kommandot galler tagg 1, 2 eller 3. Om parametern utelamnas, anvands forvalda taggnummer, som kan stallas in med kommandot. Vid start ar det installt till 12, vilket betyder att information lases fran tagg 2 om tillganglig, annars fran tagg 1, och andringar gors av tagg 2. TAGGNUMMER kan stallas in till 1, 2 eller 3 for att bara galla motsvarande tagg. Om parametern utelamnas visas den nuvarande installningen. Hamta taggram get [ | all | RAMNAMN ] [TAGGNUMMER] Kommandot kan anvandas for att lasa vardet pa en specifik taggram eller fa information om alla taggramar (om argumentet utelamnas eller all anvands). Andrade ramar ar markerade med '*'. kid3-cli> get File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo Name: 01 Borjan.mp3 Tag 1: ID3v1.1 Title Intro Artist Dagslanda Album Lat oss tagga Date 2013 Track Number 1 Genre Pop kid3-cli> get title Intro For att spara innehallet i en bildram till en fil, anvand get picture:'/sokvag/till/katalog.jpg' For att spara synkroniserad sangtext till en LRC-fil, anvand get SYLT:'/sokvag/till/sangtext.lrc' Det ar mojilgt att bara hamta ett specifikt falt fran en ram, exempelvis get POPM.Email for Email faltet i en Popularimeter ram. Om en fil har flera ramar av samma sort, kan de olika ramarna indexeras med hakparenteser, exempelvis kan den forsta utforaren fran en Vorbis-kommentar hamtas genom att anvanda get performer[0], den andra genom att anvanda get performer[1]. Pseudofaltnamnet "selected" kan anvandas for att kontrollera om en ram ar markerad, exempelvis returnerar get artist.selected 1 om artistramen ar markerad, annars 0. Pseudorramnamnet "ratingstars" kan anvandas for att hamta vardet av rutan "rating" eftersom det formatspecifika vardet motsvarar antal stjarnor (0 till 5). Nar "rating" anvands, returneras det interna vardet. Ange taggram set {RAMNAMN} {RAMVARDE} [TAGGNUMMER] Kommandot tilldelar en specifik taggrams varde. Om FRAMEVALUE ar tomt, tas ramen bort. kid3-cli> set remixer 'O.H. Wonder' For att stalla in innehallet i en bildram fran en fil, anvand set picture:'/sokvag/till/katalog.jpg' 'Bildbeskrivning' For att tilldela synkroniserad sangtext fran en LRC-fil, anvand set SYLT:'/sokvag/till/sangtext.lrc' 'Sangtextbeskrivning' For att tilldela ett specifikt falt i en ram, kan faltnamnet anges efter en punkt. For att tilldela faltet Counter i ramen Popularimeter anvand t.ex. set POPM.Counter 5 Ett program for faltspecifikationer ar fallet da du vill ha en egen TXXX-ram med beskrivning av "rating" istallet for den vanliga Popularimeter ramen (som verkar anvandas av vissa insticksprogram). Du kan skapa en sadan TXXX-betygsram med kid3-cli. Dock maste du forst skapa en TXXX-ram med beskrivningen "rating" och darefter tilldela ramens varde till betygsvardet. kid3-cli> set rating "" kid3-cli> set TXXX.Description rating kid3-cli> set rating 5 Det forsta kommandot tar bort en befintlig POPM-ram, eftersom om en sadan ram finns, skulle set rating 5 anvanda POPM-ramen och inte TXXX-ramen. En annan mojlighet skulle vara att anvanda set TXXX.Text 5, men det skulle bara fungera om det inte fanns nagon annan TXXX-ram. For att tilldela flera ramar av samma sort, kan ett index anges inom hakparenteser. For att tilldela flera utovare i en Vorbis-kommentar anvand t.ex. kid3-cli> set performer[0] 'Liza don Getti (sopran)' kid3-cli> set performer[1] 'Joe Barr (piano)' For att markera vissa ramar innan kopierings-, inklistrings- eller borttagningsatgarder, kan pseudofaltnamnet "selected" anvandas. Normalt ar alla ramar markerade. For att avmarkera alla, anvand set '*.selected' 0, och darefter exempelvis set artist.selected 1 for att markera artistramen. Pseudorramnamnet "ratingstars" kan anvandas for ange vardet av rutan "rating" till det formatspecifika vardet som motsvarar antal stjarnor (0 till 5). Ramnamnet "rating" kan anvandas for att ange det interna vardet. Att ange "ratingstars" for flera filer som har olika taggformat fungerar inte, eftersom ramen med vardet som avbildas fran stjarnantalet skapas for den forsta filen och sedan anvands for alla filer. Sa att istallet anvanda kid3-cli -c "set ratingstars 2" * ska du istallet anvanda for f in *; do kid3-cli -c "set ratingstars 2" "$f"; done. Aterstall revert Aterstall alla andringar i de markerade filerna (eller alla filer om inga filer ar markerade). Importera fran fil import {FIL} {FORMATNAMN} [TAGGNUMMER] Taggar importeras fran filen FIL pa formatet vid namn FORMATNAMN (tex. "CSV unquoted". Se Import). Om tags anges for FIL, importeras taggar fran andra taggar. Istallet for FORMATNAMN kravs KALLA och EXTRAHERING, se Import fran taggar. For att utfora import fran taggar med de markerade filerna, anvanda tagsel istallet for tags. Funktionen stoder ocksa utmatning av det extraherade vardet genom att anvanda EXTRAHERING med vardet %{__return}(.+). Automatisk import autoimport [PROFILNAMN] [TAGGNUMMER] Import i bakgrunden genom att anvanda profilen PROFILNAMN (se Automatisk import, "All" anvands om utelamnat). Ladda ner albumomslag albumart {WEBBADRESS} [all] Tilldela albumomslaget genom att ladda ner en bild fran WEBBADRESS. Reglerna definierade i dialogrutan Bladdra bland omslag anvands for att oversatta allmanna webbadresser (t.ex. fran Amazon) till en bildwebbadress. For att tilldela albumomslaget fran en lokal bildfil, anvand kommandot set. kid3-cli> albumart http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC Exportera till fil export {FIL} {FORMATNAMN} [TAGGNUMMER] Taggar exporteras till filen FIL pa formatet vid namn FORMATNAMN (t.ex. "CSV unquoted". Se Export. Skapa spellista playlist Skapa en spellista med formatet valt i installningarna, se Skapa spellista. Verkstall filnamnsformat filenameformat Verkstall filnamnsformatet valt i installningarna, se Verkstall filnamnsformat. Verkstall taggformat tagformat Verkstall taggnamnsformatet valt i installningarna, se Verkstall taggformat. Verkstall textkodning textencoding Verkstall textkodningen vald i installningarna, se Verkstall textkodning. Byt namn pa katalog renamedir [FORMAT] [ | create | rename | dryrun ] [TAGGNUMMER] Byt namn pa eller skapa kataloger fran vardena i taggarna enligt ett givet FORMAT (t.ex. %{artist} - %{album}, se Byt namn pa katalog). Om inget format anges, anvands formatet definierat i Byt namn pa katalog. Standardlaget ar rename. For att skapa kataloger maste create explicit anvandas. Namnbytesatgarderna utfors omedelbart, for att bara se vad som skulle goras, anvand valjaren dryrun. Numrera spar numbertracks [SPARNUMMER] [TAGGNUMMER] Numrera de markerade sparen med borjan pa SPARNUMMER (1 om utelamnat). Filtrera filter [ | FILTERNAMN | FILTERFORMAT ] Filtrera filerna sa att bara filerna som matchar FILTERFORMAT ar synliga. Namnet pa ett fordefinierat filteruttryck (t.ex. "Filnamn tagg missanpassning") kan anvandas istallet for att filteruttryck, se Filter. kid3-cli> filter '%{title} contains "tro"' Started /home/urs/Dagslanda - Lat oss tagga + 01 Borjan.mp3 - 02 Vi har bara den har.mp3 + 03 Slutet.mp3 Finished kid3-cli> ls 1-- 01 Borjan.mp3 1-- 03 Slutet.mp3 kid3-cli> filter All Started /home/urs/Dagslanda - Lat oss tagga + 01 Borjan.mp3 + 02 Vi har bara den har.mp3 + 03 Slutet.mp3 Finished kid3-cli> ls 1-- 01 Borjan.mp3 12- 02 Vi har bara den har.mp3 1-- 03 Slutet.mp3 Konvertera ID3v2.3 till ID3v2.4 to24 Konvertera ID3v2.4 till ID3v2.3 to23 Filnamn fran tagg fromtag [FORMAT] [TAGGNUMMER] Stall in filnamn for markerade filer fran varden i taggarna, exempelvis fromtag '%{track} - %{title}' 1. Om inget format anges, anvands formatet som stallts in i det grafiska anvandargranssnittet. Tagg fran filnamn totag [FORMAT] [TAGGNUMMER] Tilldela taggramar fran filnamnen, exempelvis totag '%{albumartist} - %{album}/%{track} %{title}' 2. Om inget format anges, anvands formatet installt i det grafiska anvandargranssnittet. Om filnamnets format inte matchar monstret, provas nagra andra ofta anvanda format. Tagg till annan tagg syncto {TAGGNUMMER} Kopiera taggramarna fran en tagg till den andra taggen, anvand t.ex. syncto 2 for att tilldela ID3v2-taggen fran ID3v1-taggen. Kopiera copy [TAGGNUMMER] Kopiera de markerade filernas taggramar till den interna kopieringsbufferten. De kan darefter tilldelas till en annan fil genom att anvanda kommandot paste. For att bara kopiera en delmangd av ramarna, anvand pseudofaltet "selected" med kommandot set. For att exempelvis bara kopiera skivnummer- och copyrightramar, anvand set '*.selected' 0 set discnumber.selected 1 set copyright.selected 1 copy Klistra in paste [TAGGNUMMER] Tilldela taggramar fran innehallet i copy-bufferten for de markerade filerna. Ta bort remove [TAGGNUMMER] Ta bort en tagg. Det ar mojligt att bara ta bort en delmangd av ramarna genom att markera dem som beskrivs for kommandot copy. Anpassa Kid3 config [ALTERNATIV] [VARDE] Fraga efter eller stall in ett installningsalternativ. ALTERNATIV bestar av ett gruppnamn och ett egenskapsnamn atskilda av en punkt. Nar inget ALTERNATIV anges, visas alla tillgangliga grupper. Om bara ett gruppnamn anges, visas alla gruppens tillgangliga egenskaper. For en given grupp och egenskap, visas det for narvarande installda vardet. For att andra installningen kan det nya vardet anges som andra argument. Om en installnings varde ar en lista, maste alla listelement anges som argument. Det betyder att for att lagga till ett element i en befintlig lista, maste alla befintliga element anges, foljda av det nya elementet. I ett sadant fall ar det enklare att anvanda JSON, dar den nuvarande listan kan kopieras, med det nya elementet tillagt. Kor program eller QML-skript execute [@qml] {FIL} [ARGUMENT] Kor ett QML-skript eller korbar fil. Utan @qml kors ett program med valjare. Nar @qml anges som forsta argument, ar foljande argument QML-skriptet och dess argument. Exempelvis kan taggarna i en katalog exporteras till filen export.csv med foljande kommando. kid3-cli -c "execute @qml /usr/share/kid3/qml/script/ExportCsv.qml export.csv" /sokvag/till/katalog/ Har ar export.csv argumentet for skriptet ExportCsv.qml, medan /sokvag/till/katalog/ ar argumentet FIL for kid3-cli. Exempel Tilldela en titel som innehaller en apostrof. Kommandon som skickas till kid3-cli med -c maste vara inom citationstecken om de inte bara bestar av enstaka ord. OM ett sadant kommando sjalv har ett argument som innehaller mellanslag, maste det argumentet ocksa citeras. Med UNIX(R)-skal kan enkla eller dubbla citationstecken anvandas, men med Windows kommandofonster ar det viktigt att de yttre citationstecknen ar dubbla och att enkla citationstecken anvands inom dessa. Om texten inom de enkla citationstecknen innehaller ett enkelt citationstecken maste det undantas genom att anvanda ett bakstreck, som visas i foljande exempel: kid3-cli -c "set title 'I\'ll be there for you'" /sokvag/till/katalog Tilldela albumomslag till alla filer i en katalog med anvandning av bakgrundsimportfunktionen: kid3-cli -c "autoimport 'Cover Art'" /sokvag/till/katalog Ta bort kommentarramar och tilldela taggformatet i bada taggar av alla MP3-filer i en katalog: kid3-cli -c "set comment '' 1" -c "set comment '' 2" \ -c "tagformat 1" -c "tagformat 2" /sokvag/till/katalog/*.mp3 Importera automatiskt tagg 2, synkronisera med tagg 1, stall in filnamn fran tagg 2 och skapa slutligen en spellista: kid3-cli -c autoimport -c "syncto 1" -c fromtag -c playlist \ /sokvag/till/katalog/*.mp3 For alla filer med en ID3v24.0-tagg, konvertera till ID3v2.3.0 och ta bort ramen arranger: kid3-cli -c "filter 'ID3v2.4.0 Tag'" -c "select all" -c to23 \ -c "set arranger ''" /sokvag/till/katalog Python-skriptet anvander kid3-cli for att generera iTunes Sound Check iTunNORM ramar fran information om uppspelningsforstarkning. #!/usr/bin/env python3 # Generate iTunes Sound Check from ReplayGain. import os, sys, subprocess def rg2sc(dirpath): for root, dirs, files in os.walk(dirpath): for name in files: if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')): fn = os.path.join(root, name) rg = subprocess.check_output([ 'kid3-cli', '-c', 'get "replaygain_track_gain"', fn]).strip() if rg.endswith(b' dB'): rg = rg[:-3] try: rg = float(rg) except ValueError: print('Value %s of %s in not a float' % (rg, fn)) continue sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10 subprocess.call([ 'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn]) if __name__ == '__main__': rg2sc(sys.argv[1]) JSON-format For att gora det enklare att tolka resultat fran kid3-cli ar det mojligt att fa utmatningen pa JSON-format. Nar begaran anvander JSON-format blir ocksa svaret JSON. Ett kompakt format pa begaran ger ocksa kompakt representation av svaret. Om begaran innehaller ett "id"-falt antas det bara en JSON-RPC-begaran och svaret innehaller faltet "jsonrpc" och "id" for begaran. Formatet pa en begaran anvander samma kommando som det vanliga kommandoradsgranssnittet, faltet "method" innehaller kommandot och parametrarna (om det finns nagra) anges i listan "params". Svaret innehaller objektet "result", som ocksa kan vara null om motsvarande kid3-cli kommando inte returnerar ett resultat. I handelse av fel, returneras objektet "error" med falten "code" och "message" som anvands av JSON-RPC. kid3-cli> {"method":"set","params":["artist","An Artist"]} {"result":null} kid3-cli> {"method":"get","params":["artist",2]} {"result":"An Artist"} kid3-cli> {"method": "get", "params": ["artist"]} { "result": "An Artist" } kid3-cli> {"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]} {"id":"123","jsonrpc":"2.0","result":"An Artist"} TACK TILL OCH LICENS Kid3 Program skrivet av Urs Fleisch Oversattning Stefan Asserhall .PP FDL[22] .PP GPL[23] INSTALLATION Hur man skaffar Kid3 Kid3 finns pa https://kid3.kde.org. Krav Kid3 behover Qt(TM)[24], KDE[25] rekommenderas men ar inte nodvandigt, eftersom Kid3 ocksa kan kompileras som ett Qt(TM)-program. Kid3 kan kompileras for system dar dessa bibliotek ar tillgangliga, t.ex. for GNU/Linux(R), Windows(R) och macOS(R). For att hantera Ogg/Vorbis-filer, behovs libogg[15], libvorbis och libvorbisfile[16], for FLAC-filer behovs libFLAC++ och libFLAC[17], id3lib[14] anvands for MP3-filer. Dessa fyra format stods ocksa av TagLib[18], som ocksa kan hantera Opus-, MPC-, APE-, MP2-, Speex-, TrueAudio-, WavPack-, WMA-, WAV-, AIFF-filer och tracker-moduler. For att importera fran akustiska fingeravtryck anvands Chromaprint[20] och libav[21]. Kid3 ar tillgangligt for de flesta Linux(R)-distributioner, Windows(R) och macOS(R). Lankar finns pa https://kid3.kde.org. Kompilering och installation Kid3 kan kompileras med eller utan KDE. Utan KDE ar Kid3 ett enkelt Qt(TM)-program och saknar nagra installnings- och sessionsfunktioner. For en KDE-version, ga till toppkatalogen och skriv % cmake . % make % make install Stall in motsvarande alternativ i cmake for att kompilera for andra versioner av Qt(TM) eller KDE. Om alla bibliotek inte ar narvarande, byggs Kid3 med reducerad funktionalitet. Sa du bor vara noga med att alla onskade utvecklingspaket ar installerade. A andra sidan, styr cmake-alternativ vilka bibliotek som kompileras med. Forval ar -DWITH_TAGLIB:BOOL=ON -DWITH_MP4V2:BOOL=OFF -DWITH_ID3LIB:BOOL=ON -DWITH_CHROMAPRINT:BOOL=ON -DWITH_VORBIS:BOOL=ON -DWITH_FLAC:BOOL=ON . Alternativen kan inaktiveras genom att anvanda OFF. For att bygga Kid3 som ett Qt(TM)-program utan KDE, anvand alternativet-DWITH_APPS=Qt i cmake. For att bade bygga ett KDE- och ett Qt(TM)-program, anvand -DWITH_APPS="Qt;KDE". For att anvanda en specifik Qt(TM)-installation, stall in -DQT_QMAKE_EXECUTABLE=/sokvag/till/qmake. Att generera RPM-paket stods av filen kid3.spec. For Debian(R)-paket, kor build-deb.sh. Qt(TM)-programmet kan ocksa kompileras for Windows(R) och macOS(R). Skriptet build.sh kan anvandas for att ladda ner och bygga alla nodvandiga bibliotek och skapa ett Kid3-paket. Installning Med KDE, lagras installningarna i .config/kid3rc och programmets tillstand i .local/share/kid3/kid3staterc. Som ett Qt(TM)-program, finns filen i .config/Kid3/Kid3.conf. Pa Windows(R), lagras installningarna i registret, och pa macOS(R) i en plist-fil. Miljovariabeln KID3_CONFIG_FILE kan anvandas for att ange installningsfilens sokvag. D-BUS GRANSSNITT D-Bus-exempel Pa Linux(R) kan ett D-Bus-granssnitt anvandas for att styra Kid3 med skript. Skript kan skrivas i vilket sprak som helst med D-Bus-granssnitt (t.ex. i Python) och kan laggas till i Anvandaratgarder for att utoka funktionaliteten i Kid3. Artisten i tagg 2 for aktuell fil kan tilldelas vardet "Dagslanda" med foljande kod: Skal dbus-send --dest=org.kde.kid3 --print-reply=literal \ /Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \ string:'Dagslanda' eller enklare med Qt(TM):s qdbus (qdbusviewer kan anvandas for att utforska granssnittet i ett grafiskt anvandargranssnitt): qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \ 'Dagslanda' Python import dbus kid3 = dbus.SessionBus().get_object( 'org.kde.kid3', '/Kid3') kid3.setFrame(2, 'Artist', 'Dagslanda') Perl use Net::DBus; $kid3 = Net::DBus->session->get_service( "org.kde.kid3")->get_object( "/Kid3", "org.kde.Kid3"); $kid3->setFrame(2, "Artist", "Dagslanda"); D-Bus programmeringsgranssnitt Programmeringsgranssnittet for D-Bus specificeras i org.kde.Kid3.xml. Granssnittet i Kid3 har foljande metoder: Oppna fil eller katalog boolean openDirectory(string path); .PP sokvag sokvag till fil eller katalog .RE Returnerar true om ok. Ladda ur taggarna for alla filer som inte ar andrade eller markerade unloadAllTags(void); Spara alla andrade filer boolean save(void); Returnerar true om ok. Hamta ett detaljerat felmeddelande som tillhandahalls av vissa metoder string getErrorMessage(void); Returnerar detaljerat felmeddelande. Angrar andringar i markerade filer revert(void); Starta en automatisk import i bakgrunden boolean batchImport(int32 tagMask, string profileName); .PP tagMask taggmask (bit 0 for tagg 1, bit 1 for tagg 2) .RE .PP profileName namn pa bakgrundsimportprofil att anvanda .RE Importera taggar fran en fil boolean importFromFile(int32 tagMask, string path, int32 fmtIdx); .PP tagMask taggbit (1 for tagg 1, 2 for tagg 2) .RE .PP sokvag sokvag till fil .RE .PP fmtIdx formatets index .RE Returnerar true om ok. importera taggar fran andra taggar importFromTags(int32 tagMask, string source, string extraction); .PP tagMask taggbit (1 for tagg 1, 2 for tagg 2) .RE .PP kalla format for att hamta kalltext fran taggar .RE .PP extrahering reguljart uttryck med ramnamn och infangningar for att extraheara fran kalltext .RE importera taggar fran andra taggar for markerade filer array importFromTagsToSelection(int32 tagMask, string source, string extraction); taggbit (1 for tagg 1, 2 for tagg 2) .RE .PP kalla format for att hamta kalltext fran taggar .RE .PP extrahering reguljart uttryck med ramnamn och infangningar for att extraheara fran kalltext .RE .PP returnValues extraherat varde for "%{__return}(.+)" .RE Ladda ner albumomslag downloadAlbumArt(string url, boolean allFilesInDir); Webbadress till bildfil eller albumomslagsresurs .RE .PP allFilesInDir true for att lagga till bilden i alla filer i katalogen .RE Exportera taggar till en fil boolean exportToFile(int32 tagMask, string path, int32 fmtIdx); .RE .PP sokvag Returnerar true om ok. Skapa en spellista boolean createPlaylist(void); Returnerar true om ok. Hamta objekt i en spellista array getPlaylistItems(string path); Returerar en lista over absoluta sokvagar till objekt i spellistan. Tilldela objekten i en spellista boolean setPlaylistItems(string path, array items); Returnerar true om ok, false om inte alla objekt hittades och lades till eller spara misslyckades. Avsluta programmet avsluta(void); Markera alla filer selectAll(void); Avmarkera alla filer deselectAll(void); Stall in forsta filen som den aktuella filen boolean firstFile(void); Returnerar true om det finns en forsta fil. Stall in foregaende fil som den aktuella filen boolean previousFile(void); Returnerar true om det finns en foregaende fil. Stall in nasta fil som den aktuella filen boolean nextFile(void); Returnerar true om det finns en nasta fil. Markera forsta filen boolean selectFirstFile(void); Returnerar true om det finns en forsta fil. Markera foregaende fil boolean selectPreviousFile(void); Returnerar true om det finns en foregaende fil. Markera nasta fil boolean selectNextFile(void); Returnerar true om det finns en nasta fil. Markera aktuell fil boolean selectCurrentFile(void); Returnerar true om det finns en aktuell fil. Expandera eller dra ihop aktuellt filobjekt om det ar en katalog boolean expandDirectory(void); Ett objekt i fillistan ar en katalog om getFileName() returnerar ett namn med '/' som det sista tecknet. Returnera true om aktuellt filobjekt ar en katalog. Verkstall filnamnsformatet applyFilenameFormat(void); Verkstall taggformatet applyTagFormat(void); Verkstall textkodning applyTextEncoding(void); Ange katalognamn fran taggar boolean setDirNameFromTag(int32 tagMask, string format, boolean create); Returnerar true om ok, annars ar felmeddelandet tillgangligt genom att anvanda getErrorMessage(). Stall in foljande sparnummer i markerade filer numberTracks(int32 tagMask, int32 firstTrackNr); Filtrera filerna filter(string expression); Konvertera ID3v2.3 taggar till ID3v2.4 convertToId3v24(void); Konvertera ID3v2.4 taggar till ID3v2.3 convertToId3v23(void); Returnerar true om ok. Hamta katalogens sokvag string getDirectoryName(void); Returnerar katalogens absoluta sokvag. Hamta namnet pa den aktuella filen string getFileName(void); Returnerar det verkliga absoluta filnamnet, slutar med "/" om det ar en katalog. Stall in namnet pa markerad fil setFileName(string name); Filens namn byts nar katalogen sparas. Stall in format att anvanda nar filnamnet stalls in fran taggarna setFileNameFormat(string format); Stall in filnamn for markerade filer fran taggarna setFileNameFromTag(int32 tagMask); Hamta ramens varde string getFrame(int32 tagMask, string name); For att hamta binardata, som en bild, kan namnet pa en fil att skriva till laggas till efter namn, t.ex. ""Picture:/path/to/file". Pa samma satt kan synkroniserad sangtext exporteras, t.ex. "SYLT:/sokvag/till/fil". Returnerar ramens varde. Tilldela ramens varde boolean setFrame(int32 tagMask, string name, string value); Om det inte finns nagon ram med namn for tagg 2 (tagMask 2), laggs en ny ram till. Om varde ar tomt, tas ramen bort. For att lagga till binardata, som en bild, kan en fil laggas till efter namn, t.ex. ""Picture:/path/to/file". "SYLT:/sokvag/till/fil" kan anvandas for att importera synkroniserad sangtext. Returnerar true om ok. Hamta alla ramar i en tagg array of string getTag(int32 tagMask); Returnerar lista med alternerande ramnamn och varden. Hamta teknisk information om filen array of string getInformation(void); Egenskaperna ar Format, Bithastighet, Samplingsfrekvens, Kanaler, Langd, Kanallage, VBR, Tagg 1, Tagg 2. Egenskaper som inte ar tillgangliga utelamnas. Returnerar lista med alternerande egenskapsnamn och varden. Tilldela tagg fran filnamn setTagFromFileName(int32 tagMask); Tilldela tagg fran en annan tagg setTagFromOtherTag(int32 tagMask); Kopiera tagg copyTag(int32 tagMask); Klistra in tagg pasteTag(int32 tagMask); Ta bort tagg removeTag(int32 tagMask); Tolka om installningen reparseConfiguration(void); Automatiserade installningsandringar ar mojliga genom att andra installningsfilen och sedan tolka om installningen. Spelar markerade filer playAudio(void); QML-GRANSSNITT QML-exempel QML-skript kan startas via fillistans sammanhangsberoende meny och det kan stallas in under fliken Anvandaratgarder i installningsdialogrutan. Skriptet som stalls in dar kan anvandas som exempel for att programmera egna skript. QML anvander JavaScript, och har ar det obligatoriska "Hello World". import Kid3 1.0 Kid3Script { onRun: { console.log("Hej allesamman, katalogen ar", app.dirName) Qt.quit() } } Om skriptet sparas som /sokvag/till/Exempel.qml kan anvandarkommandot definieras som @qml /sokvag/till/Exempel.qml med namnet Test av QML och Utmatning markerat. Darefter kan det startas med alternativet Test av QML i fillistans sammanhangsberoende meny, sa visas utmatningen i fonstret. Tyvarr ar start av QML-skript genom att anvanda qml (t.ex. qml -apptype widget -I /usr/lib/kid3/plugins/imports /sokvag/till/exempel.qml) sonder i senare versioner av Qt. Men kid3-cli erbjuder ett alternativt satt att kora ett QML-skript fran kommandoraden genom att anvanda dess kommando execute. kid3-cli -c "execute @qml /sokvag/till/exempel.qml" For att lista titlarna i tagg 2 for alla filer i aktuell katalog, skulle foljande skript kunna anvandas: import Kid3 1.0 Kid3Script { onRun: { app.firstFile() do { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { console.log(app.getFrame(tagv2, "title")) } } while (app.nextFile()) } } Om katalogen innehaller manga filer, ett sadant skript kan blockera anvandargranssnittet under en viss tid. For langre atgarder, bor det darfor ta en paus da och da. Den alternativa implementeringen nedan har flyttat ut arbetet for en enstaka fil till en funktion. Funktionen aktiverar sig sjalv med en 1 ms tidsgrans i slutet, under forutsattning att flera filer maste behandlas. Det sakerstaller att det grafiska anvandargranssnittet forblir mottagligt medan skriptet kor. import Kid3 1.0 Kid3Script { onRun: { function doWork() { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { console.log(app.getFrame(tagv2, "title")) } if (!app.nextFile()) { Qt.quit() } else { setTimeout(doWork, 1) } } app.firstFile() doWork() } } Vid anvandning av app.firstFile() med app.nextFile(), processas alla filer i den aktuella katalogen. Om bara de markerade filerna ska paverkas, anvand istallet firstFile() och nextFile(), som ar bekvamlighetsfunktioner i komponenten Kid3Script. Foljande exempel ar ett skript som bara kopierar den markerade filens skivnummer- och copyrightram. import Kid3 1.1 Kid3Script { onRun: { function doWork() { if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) { app.setFrame(tagv2, "*.selected", false) app.setFrame(tagv2, "discnumber.selected", true) app.setFrame(tagv2, "copyright.selected", true) app.copyTags(tagv2) } if (!nextFile()) { Qt.quit() } else { setTimeout(doWork, 1) } } firstFile() doWork() } } Fler exempelskript levereras med Kid3 och ar redan registrerade som anvandarkommandon. o ReplayGain till SoundCheck (ReplayGain2SoundCheck.qml): Skapa iTunNORM SoundCheck information fran ramar med uppspelningsforstarkning. o Andra storlek pa omslag (ResizeAlbumArt.qml): Andra storlek pa inbaddade omslagsbilder som ar storre an 500 x 500 bildpunkter. o Extrahera omslag (ExtractAlbumArt.qml): Extrahera alla inbaddade omslagsbilder och undvik dubbletter. o Inbadda omslag (EmbedAlbumArt.qml): Inbadda omslag funna i bildfiler till ljudfiler i samma katalog. o Inbadda sangtexter (EmbedLyrics.qml): Hamta osynkroniserade sangtexter fran webbtjanst. o Textkodning ID3v1 (ShowTextEncodingV1.qml): Hjalper till att hitta kodning av ID3v1-taggar genom att visa den aktuella filens taggar med alla tillgangliga teckenkodningar. o ID3v1 till ASCII (Tag1ToAscii.qml): Omvandlar utokade latinska tecken i ID3v1-taggar till ASCII. o Engelskt titelskiftlage (TitleCase.qml): Formaterar texten i taggarna med engelskt titelskiftlage. o Skriv om taggar (RewriteTags.qml): Skriv om alla taggar i de markerade filerna. o Exportera CSV (ExportCsv.qml): Exportera rekursivt alla taggar for alla filer till en CSV-fil. o Importera CSV (ImportCsv.qml): Importera rekursivt alla taggar for alla filer fran en CSV-fil. o Exportera JSON (Exportjson.qml): Exportera rekursivt alla taggar for alla filer till en JSON-fil. o Importera JSON (Importjson.qml): Importera rekursivt alla taggar for alla filer till en JSON-fil. o Exportera spellistekatalog (ExportPlaylist.qml): Kopiera alla filer fran en spellista till en katalog och byt namn pa dem enligt deras position. o QML-terminal (QmlConsole.qml): Enkel terminal for att leka med Kid3s QML programmeringsgranssnitt. QML-programmeringsgranssnitt Programmeringsgranssnittet kan enkelt utforskas genom att anvanda QML-terminalen, som ar tillganglig som ett exempelskript med ett anvandargranssnitt. Kid3Script Kid3Script ar en vanlig QML-komponent som finns i katalogen med insticksprogram. Du skulle lika enkelt kunna anvanda en annan QML-komponent. Genom att anvanda Kid3Script blir det enkelt att starta skriptfunktionen med signalhanteraren onRun. Dessutom erbjuder den nagra funktioner: onRun: Signalhanterare som anropas nar skriptet startas tagv1, tagv2, tagv2v1: Konstanter for taggparametrar script: Atkomst till skriptfunktioner configs: Atkomst till installningsobjekt getArguments(): Lista over skripargument isStandalone(): true om skriptet inte startades inifran Kid3 setTimeout(callback, delay): Startar ateranrop efter delay ms firstFile(): Till forsta markerade fil nextFile(): Till nasta markerade fil Skriptfunktioner Eftersom JavaScript och darfor ocksa QML bara har en begransad uppsattning funktioner for skript, har objektet script nagra ytterligare metoder, exempelvis: script.properties(obj): Strang med Qt-egenskaper script.writeFile(filePath, data): Skriv data i filen, true om ok script.readFile(filePath): Las data fran fil script.removeFile(filePath): Ta bort fil, true om ok script.fileExists(filePath): true om filen finns script.fileIsWritable(filePath): true om filen ar skrivbar script.getFilePermissions(filePath): Hamta filrattighetsbitar script.setFilePermissions(filePath, modeBits): Tilldela filrattighetsbitar script.classifyFile(filePath): Hamta filklassen (katalog "/", symbolisk lank "@", exe "*", file " ") script.renameFile(oldName, newName): Byt namn pa fil, true om ok script.copyFile(source, dest): Kopiera fil, true om ok script.makeDir(path): Skapa katalog, true om ok script.removeDir(path): Ta bort katalog, true om ok script.tempPath(): Sokvag till temporar katalog script.musicPath(): Sokvag till musikfolder script.listDir(path, [nameFilters], [classify]): Lista katalogposter script.system(program, [args], [msecs]): Starta ett systemkommando synkront, [avslutningskod, standardutmatning, standardfelutmatning] om tidsgrans inte overskrids script.systemAsync(program, [args], [callback]): Starta ett systemkommando asynkront, ateranrop gors med [avslutningskod, standardutmatning, standardfelutmatning] script.getEnv(varName): Hamta varde pa miljovariabel script.setEnv(varName, value): Tilldela miljovariabel varde script.getQtVersion(): Qt-versionsstrang, t.ex. "5.4.1" script.getDataMd5(data): Hamta hexadecimal strang med MD5-kondensat for data script.getDataSize(data): Hamta storlek pa bytefalt script.dataToImage(data, [format]): Skapa en bild fran data script.dataFromImage(img, [format]): Hamta data fran en bild script.loadImage(filePath): Las in en bild fran en fil script.saveImage(img, filePath, [format]): Spara en bild i en fil, true om ok script.imageProperties(img): Hamta egenskaper for en bild, avbildning med "width", "height", "depth" och "colorCount", tom om ogiltig bild script.scaleImage(img, width, [height]): Skala en bild, returnerar skalad bild Programsammanhang Med anvandning av QML, ar en stor del av funktionerna i Kid3 tillgangliga. Programmeringsgranssnittet liknar det som anvands for D-Bus. For detaljerad information, se respektive anmarkningar. app.openDirectory(path): Oppna katalog app.unloadAllTags(): Ladda ur alla taggar app.saveDirectory(): Spara katalog app.revertFileModifications(): Angra app.importTags(tag, path, fmtIdx): Importera filer app.importFromTags(tag, source, extraction): Importera fran taggar app.importFromTagsToSelection(tag, source, extraction): Importera fran taggar fran markerade filer app.downloadImage(url, allFilesInDir): Ladda ner bild app.exportTags(tag, path, fmtIdx): Exportera filer app.writePlaylist(): Skriv spellista app.getPlaylistItems(path): Hamta objekt i en spellista app.setPlaylistItems(path, items): Tilldela objekt i en spellista app.selectAllFiles(): Markera alla app.deselectAllFiles(): Avmarkera app.firstFile([select], [onlyTaggedFiles]): Till forsta fil app.nextFile([select], [onlyTaggedFiles]): Till nasta fil app.previousFile([select], [onlyTaggedFiles]): Till foregaende fil app.selectCurrentFile([select]): Markera aktuell fil app.selectFile(path, [select]): Markera en specifik fil app.getSelectedFilePaths([onlyTaggedFiles]): Hamta sokvagar for markerade filer app.requestExpandFileList(): Expandera alla app.applyFilenameFormat(): Anvand filnamnsformat app.applyTagFormat(): Verkstall taggformat app.applyTextEncoding(): Verkstall textkodning app.numberTracks(nr, total, tag, [options]): Nummerspar app.applyFilter(expr): Filtrera app.convertToId3v23(): Konvertera ID3v2.4.0 till ID3v2.3.0 app.convertToId3v24(): Konvertera ID3v2.3.0 till ID3v2.4.0 app.getFilenameFromTags(tag): Filnamn fran taggar app.getTagsFromFilename(tag): Filnamn till taggar app.getAllFrames(tag): Hamta object med alla ramar app.getFrame(tag, name): Hamta ram app.setFrame(tag, name, value): Tilldela ram app.getPictureData(): Hamta data fran bildram app.setPictureData(data): Tilldela data i bildram app.copyToOtherTag(tag): Taggar till andra taggar app.copyTags(tag): Kopiera app.pasteTags(tag): Klistra in app.removeTags(tag): Ta bort app.playAudio(): Spela app.readConfig(): Las installning app.applyChangedConfiguration(): Verkstall installning app.dirName: Katalognamn app.selectionInfo.fileName: Filnamn app.selectionInfo.filePath: Absolut filsokvag app.selectionInfo.detailInfo: Formatdetaljer app.selectionInfo.tag(Frame.Tag_1).tagFormat: Tagg 1 format app.selectionInfo.tag(Frame.Tag_2).tagFormat: Tagg 2 format app.selectionInfo.formatString(tag, format): Ersatt koder i formatstrang app.selectFileName(caption, dir, filter, saveFile): Oppna fildialogruta for att markera en fil app.selectDirName(caption, dir): Oppna fildialogruta for att markera en katalog For asynkrona operationer, kan ateranrop anslutas till signaler. function automaticImport(profile) { function onAutomaticImportFinished() { app.batchImporter.finished.disconnect(onAutomaticImportFinished) } app.batchImporter.finished.connect(onAutomaticImportFinished) app.batchImport(profile, tagv2) } function renameDirectory(format) { function onRenameActionsScheduled() { app.renameActionsScheduled.disconnect(onRenameActionsScheduled) app.performRenameActions() } app.renameActionsScheduled.connect(onRenameActionsScheduled) app.renameDirectory(tagv2v1, format, false) } Installningsobjekt De olika installningsdelarna kan kommas at via metoder kallade configs. Deras egenskaper kan listas i QML-konsolen. script.properties(configs.networkConfig()) Egenskaperna kan stallas in: configs.networkConfig().useProxy = false configs.batchImportConfig() configs.exportConfig() configs.fileConfig() configs.filenameFormatConfig() configs.filterConfig() configs.findReplaceConfig() configs.guiConfig() configs.importConfig() configs.mainWindowConfig() configs.networkConfig() configs.numberTracksConfig() configs.playlistConfig() configs.renDirConfig() configs.tagConfig() configs.tagFormatConfig() configs.userActionsConfig() AUTHORS Urs Fleisch Programvaruutveckling Stefan Asserhall Oversattare COPYRIGHT Copyright (C) 2023 Urs Fleisch FDL NOTER 1. gnudb.org http://gnudb.org 2. MusicBrainz http://musicbrainz.org 3. Discogs http://discogs.com 4. Amazon http://www.amazon.com 5. ID3-specifikationen http://id3.org/id3v2.4.0-frames 6. SYLT-editorn http://www.compuphase.com/software_sylteditor.htm 7. www.gnudb.org http://www.gnudb.org 8. Discogs https://www.discogs.com/ 9. freedb.org http://freedb.org 10. ID3-tagg version 2.3.0 http://id3.org/id3v2.3.0 11. ID3-tagg version 2.4.0 - Huvudstruktur http://id3.org/id3v2.4.0-structure 12. LyricWiki http://www.lyricwiki.org 13. Google http://www.google.com 14. id3lib http://id3lib.sourceforge.net 15. libogg http://xiph.org/ogg/ 16. libvorbis, libvorbisfile http://xiph.org/vorbis/ 17. libFLAC++ och libFLAC http://flac.sourceforge.net 18. TagLib http://taglib.github.io/ 19. mp4v2 https://mp4v2.org/ 20. Chromaprint http://acoustid.org/chromaprint 21. libav http://libav.org/ 22. FDL http://www.gnu.org/licenses/licenses.html#FDL 23. GPL http://www.gnu.org/licenses/licenses.html#GPL 24. Qt(TM) https://www.qt.io 25. KDE http://www.kde.org 3.9.4 2023-07-09 KID3(1)