kid3-core - Online w chmurze

PROGRAM:

IMIĘ

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

STRESZCZENIE

dziecko3 [--help | --pomoc-qt | --help-kde | --Pomóż wszystkim
|--autor | --wersja | --licencja] [FILE...]

kid3-qt [Opcje Qt] [FILE...]

kid3-cli [-h | --help] [-c POLECENIE1] [-c POLECENIE2...] [FILE...]

OPCJE

FILE
If FILE jest ścieżką do katalogu, zostanie on otwarty. Jeśli jedna lub więcej ścieżek plików to
podana, ich wspólny katalog jest otwierany, a pliki są wybierane.

dziecko3
--help
Pokaż pomoc o opcjach.

--pomoc-qt
Pokaż opcje specyficzne dla Qt, zobacz qopcje(7).

--help-kde
Pokaż opcje specyficzne dla KDE, zobacz kdeopcje(7).

--Pomóż wszystkim
Pokaż wszystkie opcje.

--autor
Pokaż informacje o autorze.

--wersja
Pokaż informacje o wersji.

--licencja
Pokaż informacje o licencji.

kid3-qt
Opcje Qt
See qopcje(7) jednak opcje mają przedrostek „-”, a nie „--”.

kid3-cli
-c
Wykonaj polecenie. Wiele -c opcje są możliwe, są wykonywane po kolei.
Zobacz sekcję o kid3-cli, aby uzyskać opis dostępnych poleceń.

-h|--help
Pokaż pomoc dotyczącą opcji i poleceń.

WPROWADZENIE

Kid3 to aplikacja do wydajnej edycji tagów ID3v1 i ID3v2 w plikach MP3.
Tagi te mogą być edytowane przez większość odtwarzaczy MP3, ale nie w sposób bardzo wygodny i wydajny
sposób. Ponadto tagi w formatach Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex,
Pliki TrueAudio, WavPack, WMA, WAV, AIFF i moduły śledzące (MOD, S3M, IT, XM) są
obsługiwane również.

Kid3 nie pobiera ani nie koduje plików MP3, ale jest przeznaczony do edycji wszystkich tagów ID3
pliki albumu w wydajny sposób, tj. za pomocą kilku kliknięć myszą i naciśnięć klawiszy, jak
możliwy. Tam, gdzie większość innych programów może edytować tagi ID3v1 lub ID3v2, Kid3 ma pełną
kontrola nad obiema wersjami, może konwertować tagi między dwoma formatami i ma dostęp do wszystkich
Tagi ID3v2. Tagi wielu plików można ustawić na tę samą wartość, np. wykonawca, album,
rok i gatunek wszystkich plików albumu zazwyczaj mają te same wartości i można je ustawić
razem. Jeśli informacje o znacznikach są zawarte w nazwie pliku, znaczniki mogą być:
automatycznie ustawiane na podstawie nazwy pliku. Możliwe jest również ustawienie nazwy pliku według
do tagów znalezionych w pliku w dowolnych formatach.

Zadanie edycji jest dodatkowo wspierane przez automatyczną zamianę znaków lub
podciągów, na przykład w celu usunięcia niedozwolonych znaków z nazw plików. Automatyczna kontrola
duże i małe litery ułatwiają stosowanie spójnego schematu nazewnictwa we wszystkich
tagi.

Informacje o znacznikach dla pełnych albumów można pobrać z gnudb.org[1], TrackType.org[2],
MusicBrainz[3], Dyskoteki[4], Amazonka[5] lub inne źródła list utworów. Format importu
można dowolnie konfigurować za pomocą wyrażeń regularnych.

Wszelkie problemy lub prośby o nowe funkcje prosimy zgłaszać autorowi.

ZA POMOCĄ KID3

Kid3 cechy
· Edytuj tagi ID3v1.1

· Edycja wszystkich ramek ID3v2.3 i ID3v2.4

· Edytuj tagi wielu plików

· Konwersja między tagami ID3v1 i ID3v2

· Edycja MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio,
Tagi WavPack, WMA, WAV i AIFF

· Generuj tagi z nazwy pliku

· Generowanie tagów z zawartości pól tagów

· Generuj nazwę pliku z tagów

· Generuj i zmieniaj nazwy katalogów z tagów

· Generuj plik listy odtwarzania

· Automatyczna konwersja wielkości liter i tłumaczenie ciągów

· Importuj z gnudb.org[1], TrackType.org[2], MusicBrainz[3], Dyskoteki[4], Amazonka[5] i
inne źródła danych

· Eksportuj jako CSV, HTML, listę odtwarzania, Kover XML i inne formaty. Wyeksportowane pliki CSV mogą być
importowane ponownie.

Przykład Stosowanie
Ta sekcja opisuje typową sesję z Kid3. Załóżmy, że mamy katalog
zawierające pliki MP3 z utworami z albumu „Let's Tag” zespołu „One Hit
Wonder”. Katalog ma nazwę w formacie „artysta – album”, w naszym przypadku One Hit Wonder
- Oznaczmy. Katalog zawiera utwory w formacie „tytuł utworu.mp3”, który ja
think jest przydatne, ponieważ nazwy plików są krótkie (ważne w przypadku korzystania z mobilnych odtwarzaczy MP3)
z małymi wyświetlaczami) i we właściwej kolejności przy sortowaniu alfabetycznym (ważne, gdy
za pomocą sprzętowych odtwarzaczy MP3, które odtwarzają utwory w kolejności alfabetycznej lub w kolejności według
które są wypalone na płycie CD, a kolejność jest alfabetyczna podczas używania mkisofs). Oprócz
oznacza to, że informacje o wykonawcy i albumie są już w nazwie katalogu i nie mają
do powtórzenia w nazwie pliku. Ale wracając do naszego przykładu, lista katalogów wygląda tak
to:

01 Wstęp.mp3

02 Mamy tylko ten.mp3

03 Outro.mp3

Te pliki nie mają jeszcze tagów i chcemy je wygenerować za pomocą Kid3. Używamy Open (Plik
menu lub pasku narzędzi) i wybierz jeden z plików w tym katalogu. Wszystkie pliki będą
wyświetlane w polu listy plików. Chociaż jesteśmy leniwi, chcemy wykorzystać informacje zawarte w
nazwy katalogów i plików do generowania znaczników. Dlatego wybieramy wszystkie pliki, a następnie klikamy
Do:Oznacz 1 przycisk w sekcji Plik. Spowoduje to ustawienie tytułu, wykonawcy, albumu i utworu
wartości we wszystkich plikach. Aby ustawić rok i wartości gatunku dla wszystkich plików, przechowujemy wszystkie pliki
wybierz i wpisz "2002" jako Rok i wybierz "Pop" z listy rozwijanej Gatunek. Ustawić
tylko te dwie wartości, ich pola wyboru są automatycznie zaznaczone i wszystkie inne pola wyboru
pozostają niezaznaczone. Teraz zmieniamy zaznaczenie, wybierając tylko pierwszy plik i my
zobacz, czy wszystkie tagi zawierają prawidłowe wartości. Tagi innych plików można zweryfikować
również wybierając je jeden po drugim. Kiedy jesteśmy zadowoleni z tagów, używamy Save (File
menu lub pasku narzędzi). Wybranie opcji Utwórz listę odtwarzania z menu Plik wygeneruje plik Jeden
Hit Wonder - Let's Tag.m3u w katalogu.

COMMAND REFERENCE

Połączenia GUI Elementy
Kid3 GUI jest podzielony na pięć sekcji: Po lewej stronie znajdują się plik i katalog
po prawej stronie znajdują się sekcje Plik, Znacznik 1 i Znacznik 2.

filet Lista
Lista plików zawiera nazwy wszystkich plików w otwartym katalogu, które pasują
filtr wybranych nazw plików (zwykle *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac
*.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Pojedynczy lub
można wybrać wiele plików. Aby nie wybrać żadnego pliku, kliknij pusty obszar po
wpisy w polu listy. Wybór określa pliki, na które ma wpływ
operacje dostępne za pomocą przycisków opisanych poniżej.

Oprócz nazwy, również inne kolumny Rozmiar, Typ, Data modyfikacji ze szczegółami pliku mogą być
wystawiany. Kolumny można ukryć, odznaczając ich nazwę w menu kontekstowym
nagłówek listy. Kolejność kolumn można zmienić metodą drag'n'drop. Porządek sortowania
można przełączać, klikając nagłówek kolumny.

Po lewej stronie nazw może zostać wyświetlona ikona: płyta wskazująca, że ​​plik ma
zostały zmodyfikowane lub informacje o tym, które tagi są obecne (V1, V2, V1V2 lub NO TAG, no
ikona jest wyświetlana, jeśli plik nie został jeszcze wczytany).

Katalogi są wyświetlane z ikoną folderu. Jeśli katalog jest otwarty, jego pliki są
wyświetlane w drzewie hierarchicznym. Wybierając pliki z podkatalogów, operacje
mogą być wykonywane na plikach w różnych katalogach, co jest przydatne, jeśli muzyka
kolekcja jest zorganizowana z folderem dla każdego wykonawcy zawierającym foldery na albumy
ten artysta.

Kliknięcie prawym przyciskiem myszy na liście plików otwiera menu kontekstowe z
następujące polecenia:

· Rozwiń wszystko: Rozwija wszystkie drzewa folderów (tylko bieżące drzewo, jeśli klawisz Shift to
prasowany)

· Zwiń wszystko: Zwija wszystkie drzewa folderów

· Zmień nazwę: Zmienia nazwę pliku

· Przenieś do kosza: przenosi plik do kosza

· Odtwórz: Odtwarza plik, patrz Odtwórz

· Kolejne wpisy to polecenia użytkownika, które można zdefiniować w Akcje użytkownika
zakładka Konfiguruj Kid3. Można tam również aktywować odtwarzanie po podwójnym kliknięciu.

Informator Lista
Lista katalogów zawiera nazwy katalogów w otwartym katalogu, jako
a także katalog bieżący (.) i nadrzędny (..). Pozwala na szybką zmianę
katalogu bez użycia polecenia Otwórz... lub przeciągania i upuszczania.

Widoczność kolumn, kolejność i sortowanie można skonfigurować zgodnie z opisem w sekcji
o liście plików.

filet
Wyświetla informacje o kodowaniu (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), szybkość transmisji, częstotliwość próbkowania, kanały i
długość pliku.

Edycja wiersza Nazwa zawiera nazwę pliku (jeśli wybrano tylko jeden plik).
Jeśli ta nazwa zostanie zmieniona, nazwa pliku zostanie zmieniona po użyciu polecenia Zapisz.

Pole kombi Format i edycja linii zawiera format, który ma być używany, gdy nazwa pliku to
wygenerowane z pierwszego lub drugiego tagu. Nazwa pliku może zawierać dowolne
znaków, nawet część katalogu oddzieloną ukośnikiem od nazwy pliku, ale to
katalog musi już istnieć, aby zmiana nazwy się powiodła. Następujące kody specjalne
służą do wstawiania wartości znaczników do nazwy pliku:

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} Utwór (np. 01)

· %t %{track.n} Ścieżka o szerokości pola n (np. 001 dla %{track.3})

· Ścieżka %T %{tracknumber} (bez wiodących zer, np. 1)

· %g %{genre} Gatunek

· %{ignore} Ignorowany podczas generowania tagów z nazwy pliku

Kody formatu nie ograniczają się do przykładów podanych powyżej. Dowolna nazwa ramki może być
używane, na przykład zunifikowane nazwy ramek, takie jak %{bpm} lub sformatuj określone nazwy, takie jak
%{popm}.

Drugie pole kombi Format (ze strzałką w dół) służy do generowania tagów z
Nazwa pliku. Jeśli format nazwy pliku nie pasuje do tego wzorca, kilka innych
wypróbowane są powszechnie używane formaty.

Niektóre powszechnie używane formaty nazw plików są już dostępne w polu kombi, ale jest to
możliwe jest również wpisanie specjalnego formatu do edycji wiersza.

Od: Tag 1, Tag 2: Ustawia nazwę pliku przy użyciu wybranego formatu i pierwszego tagu lub
odpowiednio drugi znacznik.

To:Tag 1, Tag 2: Tagi są ustawiane na podstawie nazwy pliku. Po pierwsze, format określony w
Używany jest format. Jeśli istniejąca nazwa pliku nie jest zgodna z tym formatem, następujące:
wypróbowane są formaty:

· Wykonawca - Album/Utwór utworu

· Album/utwór – Artysta – Piosenka

· /Artysta - Album - Utwór - Piosenka

· Album/Wykonawca – Utwór – Piosenka

· Album/Artysta - Piosenka

· Artysta/Album/Utwór utworu

Jeśli wybrany jest pojedynczy plik, kontrolki GUI są wypełniane wyodrębnionymi wartościami
z nazwy pliku. Jeśli wybrano wiele plików, tagi plików są bezpośrednio
ustawić zgodnie z nazwami plików.

etykieta 1
Widżety edycji linii dla tytułu, wykonawcy, albumu, komentarza, roku, utworu i gatunku są
służy do edycji odpowiedniej wartości w pierwszym znaczniku wybranych plików. Wartość
zostanie zmieniony, gdy wybór pliku zostanie zmieniony lub przed operacjami takimi jak Zapisz i
Zakończ i po zaznaczeniu odpowiedniego pola wyboru po lewej stronie nazwy pola.
Jest to przydatne do zmiany tylko niektórych wartości i pozostawienia innych wartości bez zmian.

Jeśli wybrany jest pojedynczy plik, wszystkie pola wyboru są zaznaczone, a widżety edycji linii
zawierają wartości znalezione w tagach tego pliku. Jeśli tag nie zostanie znaleziony w pliku,
wyświetlana jest odpowiednia pusta wartość, która jest pustym ciągiem dla Tytułu,
Edycje wiersza wykonawcy, albumu i komentarza, 0 dla numerycznych edycji roku i ścieżki oraz
opróżnij wybraną wartość w polu kombi Gatunek. Wartości można zmienić, a jeśli
odpowiednie pole wyboru jest zaznaczone, zostaną one ustawione dla wybranego pliku po
wybór został zmieniony. Plik jest następnie oznaczany jako zmodyfikowany przez symbol dysku w pliku
listbox, ale pozostaje niezmienione, dopóki nie zostanie użyte polecenie Zapisz.

Jeśli wybrano wiele plików, tylko wartości, które są identyczne we wszystkich wybranych
wyświetlane są pliki. We wszystkich innych kontrolkach puste wartości opisane powyżej to:
wystawiany. Wszystkie pola wyboru są odznaczone, aby uniknąć niepożądanych zmian. Jeśli wartość musi
być ustawiony dla wszystkich wybranych plików, można go edytować i należy zaznaczyć pole wyboru. ten
wartości zostaną ustawione dla wszystkich wybranych plików po zmianie wyboru i mogą być:
zapisane za pomocą polecenia Zapisz.

Pola wyboru kontrolują również działanie większości poleceń wpływających na tagi, takich jak
jako kopiuj, wklej i przenieś między tagami 1 i 2. Aby ułatwić korzystanie z
wiele plików, w których wszystkie pola wyboru są odznaczone, te polecenia zachowują się tak samo
sposób, gdy wszystkie pola wyboru są zaznaczone i gdy wszystkie pola wyboru są odznaczone.

Z tagu 2: Pola tagu 1 są ustawiane z odpowiednich wartości w tagu 2. Jeśli a
wybrany jest pojedynczy plik, kontrolki GUI są wypełniane wartościami z tagu 2. Jeśli
wybranych jest wiele plików, tagi plików są ustawiane bezpośrednio.

Kopiowanie: Bufor kopiowania jest wypełniony wartościami Tag 1. Tylko wartości z zaznaczonym
pole wyboru będzie używane w kolejnych poleceniach wklejania.

Wklej: Wkleja wartości z bufora kopiowania do kontrolek GUI.

Usuń: spowoduje to ustawienie wszystkich kontrolek GUI na ich puste wartości, co spowoduje usunięcie
wszystkie wartości. Zapisany plik nie będzie wtedy zawierał znacznika 1.

etykieta 2
Kontrolki GUI działają w taki sam sposób, jak opisano w sekcji Tag 1, ale
rozmiar strun nie jest ograniczony.

W przypadku tagu 2 Gatunek możesz również użyć własnych nazw poza gatunkami wymienionymi w
pole kombi, po prostu wpisz nazwę w linii edycji.

Znacznik 2 może nie tylko zawierać te same wartości, co znacznik 1, format jest zbudowany w a
elastyczny sposób z kilku ramek, które same składają się z kilku pól. ten
Tabela tag 2 pokazuje wszystkie ramki, które są dostępne w wybranym pliku.

Edytuj: Otworzy się okno, w którym można edytować wszystkie pola wybranego
rama. Jeśli wybrano wiele plików, edytowane pola są stosowane do wszystkich wybranych
pliki zawierające taką ramkę.

Dodaj: pojawi się prośba o wybranie typu ramki i ramka wybranego typu
można edytować i dodawać do pliku. Działa to również w celu dodania ramki do wielu
wybrane pliki.

Usuń: Usuwa wybraną klatkę w wybranych plikach.

Przeciągnij tutaj okładkę albumu jest pokazywana, jeśli plik nie zawiera osadzonej okładki. A
zdjęcie można dodać za pomocą przeciągania i upuszczania z przeglądarki lub menedżera plików i będzie
wyświetlane tutaj. Ramki do zdjęć można edytować lub dodawać, klikając je dwukrotnie
kontrola.

zsynchronizowane teksty i wydarzenie Chronometraż Kody
Dla informacji zsynchronizowanych z danymi audio dostępny jest specjalny edytor.
Ramki te są obsługiwane dla tagów ID3v2.3.0 i ID3v2.4.0. Aby dodać taką ramkę,
określona nazwa ramki musi być wybrana z listy, która pojawia się po naciśnięciu przycisku Dodaj
zostanie kliknięte – odpowiednio zsynchronizowane słowa lub kody czasu zdarzenia. Redaktorem jest
to samo dla obu typów, dla kodów czasowych zdarzeń tylko predefiniowany zestaw zdarzeń
jest dostępna, podczas gdy w przypadku zsynchronizowanych tekstów tekstowych należy wprowadzić tekst. w
poniżej objaśniono edycję zsynchronizowanych tekstów.

Wybrano plik z tagiem ID3v2, wejście do edytora tekstów za pomocą Dodaj i
wybierając zsynchronizowane słowa. W przypadku istniejącej ramki zsynchronizowanych tekstów:
zaznaczony i kliknij przycisk Edytuj. Odtwarzacz jest automatycznie otwierany z bieżącym plikiem
aby plik mógł być odtwarzany i zatrzymywany w celu synchronizacji tekstu.

Ustawienia w górnej części edytora SYLT zwykle nie muszą być zmieniane. Jeśli
tekst zawiera znaki, które nie występują w zestawie znaków Latin 1,
zalecana jest zmiana kodowania tekstu na UTF16 (lub UTF8 dla ID3v2.4.0). Dla angielskiego
teksty piosenek i maksymalna kompatybilność, należy stosować ISO-8859-1.

Sekcja Tekst ma pięć przycisków u góry. Dodaj doda nowe wydarzenie czasowe w
Tabela. Czas jest pobierany z pozycji gracza, co dodaje wpis while
odtwarzanie utworu doda linię do aktualnie odtwarzanej pozycji. Wydarzenia w
tabela musi być uporządkowana chronologicznie, dlatego wiersz zostanie wstawiony
odpowiednio. Wpisy z nieprawidłową godziną są traktowane specjalnie: Jeśli aktualnie
wybrany wiersz ma nieprawidłową godzinę, jego znacznik czasu zostanie zastąpiony aktualnym czasem
zamiast dodawać nowy wiersz. Jeśli aktualny czas nie jest nieprawidłowy, pierwszy wiersz z
jeśli jest obecny, zostanie użyty nieprawidłowy czas. Takie zachowanie powinno ułatwić dodawanie czasu
znaczniki, jeśli tekst tekstu jest już w tabeli, ale brakuje znaczników czasu
(co ma miejsce w przypadku importowania niezsynchronizowanych tekstów). Zwróć uwagę, że nieprawidłowy czas
jest reprezentowany jako 00:00.00, tj. taki sam jak czas na bezwzględnym początku
utwór, który nie jest nieprawidłowy. Aby zmienić czas, naciśnij klawisz Delete lub użyj
Wyczyść z menu kontekstowego. Nowe wiersze wstawiane za pomocą opcji Wstaw wiersz z menu kontekstowego
lub utworzone podczas importowania niezsynchronizowanych tekstów za pomocą funkcji Ze schowka lub Importuj również
zawierają nieprawidłowe znaczniki czasu. Wiersze w tabeli można usunąć, klikając przycisk Usuń
lub korzystając z opcji Usuń wiersze z menu kontekstowego.

Zsynchronizowane teksty można importować z pliku za pomocą funkcji Importuj. Oczekiwany format to
proste lub ulepszone LRC. Jeśli wybrany plik nie zawiera nawiasu kwadratowego w
pierwsza linia, ma to być prosty plik tekstowy z niezsynchronizowanymi tekstami. ten
linie z takiego pliku są następnie importowane z nieprawidłowymi znacznikami czasu. Czas
informacje można dodać za pomocą przycisku Dodaj lub wpisując ręcznie. Jest to również możliwe
do importowania tekstów za pomocą funkcji kopiuj-wklej za pomocą funkcji Ze schowka. Zsynchronizowane teksty mogą być
zapisywane do plików LRC za pomocą funkcji Export. Pamiętaj, że tylko wpisy z prawidłowymi znacznikami czasu będą
zostać wyeksportowane, a wpisy zostaną posortowane według czasu. Wpisy z nieprawidłowym czasem
nie będą również przechowywane w ramce SYLT, więc pamiętaj, aby uwzględnić wszystkie czasy
informacje przed opuszczeniem okna dialogowego.

Połączenia ID3 specyfikacja[6] sugeruje znacznik czasu dla każdej sylaby. Jednak większość graczy
obsługuje tylko szczegółowość wiersza lub zdania. Aby obsługiwać oba przypadki użycia, Kid3
przestrzega tych samych konwencji, co SYLT redaktor[7]. Tekst wpisywany do tabeli
zakłada się, że zaczyna nowy wiersz, chyba że zaczyna się od spacji lub łącznika. Wyjątki
do tej reguły można rozpocząć linię z podkreśleniem ('_') aby wymusić
kontynuacja lub znak krzyża ('#'), aby wymusić nową linię. Te znaki ucieczki nie są
przechowywane wewnątrz ramy SYLT. Wewnątrz ramki SYLT nowe wiersze zaczynają się od wysuwu wiersza
znak (hex 0A), podczas gdy kontynuacje nie. Podczas czytania ramek SYLT Kid3 sprawdza
jeśli pierwszy wpis zaczyna się od wysuwu wiersza. Jeśli tak nie jest, zakłada się
że wszystkie wpisy są nowymi liniami i że nie są używane żadne kontynuacje sylab.

Podczas odtwarzania utworu wiersz powiązany z bieżącą pozycją odtwarzania to
podświetlone, aby można było określić poprawność informacji o synchronizacji
zweryfikowane. Jeśli przesunięcie ma zostać dodane do jednego lub więcej znaczników czasu, może to być:
realizowane za pomocą menu kontekstowego Dodaj przesunięcie. Wartości ujemne można wykorzystać do zmniejszenia
czas. Używając Szukaj do pozycji w menu kontekstowym, można ustawić
pozycję odtwarzania do czasu wybranego wiersza.

Połączenia filet Menu
Plik → Otwórz... (Ctrl+O)
Otwiera katalog. Zostaną wyświetlone wszystkie pliki pasujące do wybranego filtra nazw plików
w polu listy plików i wybrany plik jest zaznaczony.

Plik → Otwórz ostatnie
Otwiera ostatnio otwarty katalog.

Plik → Otwórz katalog... (Ctrl+D)
Otwiera katalog. Zostaną wyświetlone wszystkie pliki pasujące do wybranego filtra nazw plików
w polu listy plików.

Plik → Zapisz (Ctrl+S)
Zapisuje wszystkie zmienione pliki w katalogu. Zmienione pliki są oznaczone dyskiem
symbol w polu listy plików. Jeśli jakiekolwiek nazwy plików zostały zmienione, pliki te będą
zmieniono nazwę.

Plik → Przywróć
Cofa zmiany jednego lub wielu plików. Jeśli w pliku nie wybrano żadnych plików
listbox, zmiany wszystkich plików zostaną cofnięte, w przeciwnym razie tylko zmiany
wybrane pliki są przywracane.

Plik → Importuj...
Okno dialogowe Import może być użyte do importowania danych bezpośrednio z serwera freedb.org, z
Serwer MusicBrainz, z Discogs, Amazon lub innych źródeł list utworów albumów w
format tekstowy.

Import z serwera freedb.org jest możliwy za pomocą okna dialogowego, które pojawia się, gdy Od
Wybrano serwer:gnudb.org lub TrackType.org. Nazwa wykonawcy i albumu do wyszukania
można wpisać w dwóch najwyższych polach, albumy pasujące do zapytania będą
wyświetlane po kliknięciu Znajdź i wynikach z www.gnudb.org[8] są odbierane.
Importowanie danych utworów do albumu odbywa się poprzez dwukrotne kliknięcie albumu w
lista. Można wybrać serwer freedb.org do importowania, a także ścieżkę CGI.
Zaimportowane dane są wyświetlane w tabeli podglądu okna dialogowego importu. Kiedy
Zadowolony z wyświetlanych utworów, można je zaimportować, przerywając import
dialog z OK.

Wyszukiwanie na serwerze Discogs można przeprowadzić za pomocą Discogs. Jak na gnudb.org
można wpisać wykonawcę i album, a następnie wybrać z listy wydawnictw. Gdyby
Standardowe tagi są zaznaczone, importowane są standardowe informacje, np. wykonawca, album i
tytuł. Jeśli zaznaczone są dodatkowe tagi, więcej informacji jest importowanych, jeśli są dostępne, np.
wykonawców, aranżerów czy wydawcy. Jeśli okładka jest zaznaczona, okładka będzie
pobrane, jeśli są dostępne.

Wyszukiwanie w Amazon można przeprowadzić za pomocą Amazon. Podobnie jak w oknie dialogowym gnudb.org, możesz
wpisz wykonawcę i album, a następnie wybierz z listy wydawnictw. Jeśli dodatkowe tagi to
zaznaczone, więcej informacji jest importowanych, jeśli są dostępne, np. wykonawców, aranżerów lub
wydawca. Jeśli okładka jest zaznaczona, okładka zostanie pobrana, jeśli jest dostępna.

Możesz wyszukiwać w ten sam sposób w bazie danych wydań MusicBrainz, używając From
Wydanie MusicBrainz. Przepływ pracy jest taki sam, jak opisano dla From gnudb.org.

Import z serwera MusicBrainz jest możliwy za pomocą okna dialogowego, które pojawia się, gdy Od
Wybrano odcisk palca MusicBrainz. Serwer można wybrać jak we freedb
okno dialogowe importu. Poniżej znajduje się tabela wyświetlająca zaimportowane dane toru. Prawa kolumna
pokazuje stan zapytania MusicBrainz, które zaczyna się od „Oczekujące” w oknie dialogowym
jest otwarty. Następnie odcisk palca jest sprawdzany i jeśli nie daje wyniku,
próbowane jest kolejne wyszukiwanie przy użyciu znaczników w pliku. W ten sposób może być pomocny dla
udane zapytanie MusicBrainz do przechowywania znanych informacji (np. wykonawcy i albumu) w
tagi przed importem. Jeśli znaleziono wynik, wyszukiwanie kończy się na stanie
„Rozpoznano”, w przeciwnym razie nic nie znaleziono lub wiele niejednoznacznych wyników i jeden z
muszą być wybrane przez użytkownika. OK i Zastosuj, użyj zaimportowanych danych, Anuluj
zamyka okno dialogowe. Zamknięcie może chwilę potrwać, ponieważ cała machina MusicBrainz
musi zostać zamknięty.

W przypadku importu danych tekstowych Z pliku/Schoweka otwiera podrzędne okno dialogowe, w którym kilka
dostępne są wstępnie skonfigurowane formaty importu. Pierwsze dwa, „CSV bez notowania” i „CSV
cytowane” może służyć do importowania danych, które zostały wyeksportowane za pomocą okna dialogowego Eksportuj. Plik CSV
dane można edytować za pomocą arkusza kalkulacyjnego i należy je zapisywać za pomocą tabulatorów jako ograniczników.
Import powinien być wtedy możliwy przy użyciu „CSV cytowanego”, który jest bardziej elastyczny niż „CSV
bez cudzysłowów”. Jednak jego pola nie mogą zawierać żadnych podwójnych cudzysłowów. Jeśli tylko eksportujesz
z Kid3 i zaimportuj później, "CSV bez cytowania" może być użyty jako prosty format do tego
cel, powód. Pamiętaj, że w menu znajdują się również polecenia „Eksportuj CSV” i „Importuj CSV”.
menu kontekstowe listy plików, które używają skryptów do eksportowania i importowania danych CSV w
bardziej kompletny, mocny i elastyczny sposób.

Następny format, "tekst freedb HTML", może być użyty do kopiowania informacji ze strony HTML
of freedb.org[9]. Wyszukaj album w freedb i jeśli żądane informacje są
wyświetlane w przeglądarce internetowej, skopiuj zawartość do schowka. Następnie kliknij Od
przycisk Schowka, a zaimportowane utwory zostaną wyświetlone w tabeli podglądu na
w górnej części okna dialogowego. Jeśli jesteś zadowolony z importowanych danych, zamknij okno dialogowe
z OK, co spowoduje wstawienie danych do znaczników bieżącego katalogu. ten
miejsce docelowe (Tag 1, Tag 2 lub Tag 1 i Tag 2) można wybrać za pomocą pola kombi. ten
pliki w bieżącym katalogu powinny mieć prawidłową kolejność ścieżek, aby uzyskać ich tagi
przydzielony. Tak jest w przypadku, gdy są ponumerowane.

Następny wstępnie skonfigurowany format importu, „źródło HTML freedb”, może zostać użyty, jeśli dane
jest dostępny jako dokument HTML. Import jest możliwy za pomocą przycisku Z pliku, który
otwiera selektor plików lub kopiuje jego zawartość z edytora, a następnie importuje z
schowek. Ten format może być przydatny do importu offline, chociaż dokument HTML
można również otworzyć w przeglądarce, a następnie zaimportować w pierwszym formacie za pomocą
schowek.

Dostępnych jest więcej wstępnie skonfigurowanych formatów, np. „Czas tytułu utworu”. Pusty zwyczaj
format można utworzyć za pomocą opcji Dodaj do ustawienia przez użytkownika. Dwie linie poniżej nazwy formatu
można ustawić za pomocą wyrażenia regularnego, aby przechwycić pola z tekstu importu. ten
pierwsze wyrażenie regularne zostanie przeanalizowane raz na dokument w celu zebrania danych dotyczących poszczególnych albumów
takich jak wykonawca, album, rok i gatunek. Druga linia próbuje dopasować z
od początku dokumentu do końca, aby uzyskać dane o utworze, zwykle numer i tytuł. ten
wyrażenia regularne zawierają wszystkie funkcje oferowane przez Qt, czyli większość z nich
Oferty Perla. Konstrukcje nawiasów „(..)” tworzą bufory przechwytywania dla pól do
import i są poprzedzone specyficznymi kodami Kid3, aby określić, które pole ma zostać przechwycone. ten
kody są takie same, jak w przypadku formatu nazwy pliku, oprócz kodów wymienionych poniżej,
możliwa jest dowolna nazwa ramki:

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} utworu

· %g %{genre} Gatunek

· %d %{duration} Czas trwania

Na przykład wyrażenie regularne utworu (drugi wiersz) do zaimportowania z listy odtwarzania .m3u
może być "%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]". Wszystkie formaty można zmienić
edytując wyrażenia regularne i nazwę, a następnie klikając Zapisz ustawienia. Oni
zostanie zapisany w pliku kid3rc w katalogu konfiguracyjnym. Ten plik może być
bezpośrednio edytowany, aby mieć więcej formatów importu, lub można go usunąć, aby powrócić do
formaty domyślne. Formaty można usunąć za pomocą Usuń.

Dokładność pokazuje oszacowanie, jak dobrze importowane informacje pasują do podanych
utwory. Wykorzystuje czasy trwania utworów lub nazwy plików, aby obliczyć poziom podobieństwa w
procent. Okładka pokazuje adres URL obrazu okładki albumu, który zostanie pobrany.

Aby sprawdzić, czy importowane utwory pasują do bieżącego zestawu plików, czas trwania
importowane utwory można porównać z czasem trwania plików. Ta opcja może być
włączone za pomocą pola wyboru Sprawdź maksymalną dopuszczalną różnicę czasu i maksymalną
tolerowaną różnicę czasu można ustawić w sekundach. Jeśli niezgodność w długości to
wykryte, długość jest wyświetlana na czerwonym tle w tabeli podglądu.

Jeśli pliki są uporządkowane inaczej niż importowane ścieżki, ich przypisane ścieżki
muszą zostać zmienione. Zadanie to można ułatwić za pomocą Dopasuj za pomocą przycisków Długość,
Track i Title, które zmienią kolejność utworów zgodnie z odpowiednim polem.
Aby ręcznie poprawić przypisania, ścieżkę można przeciągnąć lewym przyciskiem myszy
i przytrzymaj klawisz Ctrl, a następnie upuść w nowej lokalizacji.

Kiedy okno dialogowe importu jest otwarte, zawiera rzeczywistą zawartość tagów. Tag
Typ (Tag 1, Tag 2, Tag 1 i Tag 2) można wybrać za pomocą pola kombi Miejsce docelowe.
Przycisk po prawej stronie tego pola kombi może być użyty do przywrócenia tabeli do
aktualna zawartość tagów. Pola wyboru w pierwszej kolumnie tabeli mogą służyć do:
wybierz utwory, które są importowane. Może to być przydatne, jeśli folder zawiera
utwory z obu płyt CD podwójnej płyty CD i tylko utwory z drugiej płyty CD muszą być
importowany.

Aby zidentyfikować importowane utwory, można wyświetlić nazwy plików lub
pełne ścieżki do plików za pomocą menu kontekstowego nagłówka tabeli. Wartości w
tabelę importu można edytować. Przycisk powrotu po prawej stronie miejsca docelowego
Pole kombi może służyć do przywracania zawartości tagów, co również może być przydatne
po zmianie miejsca docelowego.

Prawie wszystkie okna dialogowe zawierają przycisk Zapisz ustawienia, który może być używany do przechowywania
ustawienia specyficzne dla okna dialogowego i rozmiar okna na stałe.

Z tagów prowadzi do podrzędnego okna dialogowego, w którym można ustawić ramki tagów z zawartości innego tagu
ramki. Można to wykorzystać do prostego kopiowania informacji między tagami lub wyodrębniania części
z jednej ramki i włóż ją do drugiej.

Podobnie jak w przypadku importu z pliku/schowka, do wykonania są dowolnie konfigurowalne formaty
różne operacje. Wstępnie skonfigurowane są już formaty, do których należy skopiować wartość albumu
Artysta albumu, kompozytor lub dyrygent, a także wyodrębnić numer utworu z pól tytułu
które zawierają liczbę. Istnieje również format, w którym można wyodrębnić napisy z tytułu
pole.

Poniższy przykład wyjaśnia, jak dodać niestandardowy format, który ustawia informacje
z pola Podtytuł również w polu Komentarz. Utwórz nowy format za pomocą Dodaj i
ustawić nową nazwę, np. „Podtytuł do komentarza”. Następnie wpisz „%{subtitle}” w źródle i
„%{comment}(.*)” dla wyodrębniania i kliknij Zapisz ustawienia.

Wyrażenie w źródle może zawierać kody formatu dla dowolnych ramek znaczników, wielokrotnych
kody mogą służyć do łączenia treści z różnych ramek. Dla każdego utworu a
tekst jest generowany z jego znaczników przy użyciu formatu źródłowego i wyrażenia regularnego
from Extraction jest stosowany do tego tekstu, aby ustawić nowe wartości dla tagów. Kody formatu
są używane przed nawiasami przechwytującymi, aby określić ramkę znacznika, w której przechwycony
tekst będzie przechowywany. Działa to tak samo jak przy imporcie z pliku/schowka.

Plik → Importuj z gnudb.org...
Importuj z serwera freedb.org za pomocą wyszukiwania albumów gnudb.org. Ta pozycja menu otwiera się
to samo okno importu co Import..., ale otwiera bezpośrednio okno dialogowe gnudb.org.

Plik → Importuj z TrackType.org...
Importuj z serwera TrackType.org. Ta pozycja menu otwiera to samo okno dialogowe importu, co
Importuj..., ale otwiera bezpośrednio okno dialogowe TrackType.org.

Plik → Importuj z Discogs...
Importuj z serwera Discogs. Ta pozycja menu otwiera to samo okno dialogowe importu, co
Importuj..., ale otwiera bezpośrednio okno dialogowe Z Discogs.

Plik → Importuj z Amazon...
Importuj z Amazona. Ta pozycja menu otwiera to samo okno dialogowe importu, co Importuj..., ale
otwiera bezpośrednio okno dialogowe Z Amazon.

Plik → Importuj z wersji MusicBrainz...
Importuj z bazy danych wersji MusicBrainz. Ta pozycja menu otwiera ten sam import
jako Import..., ale otwiera bezpośrednio okno dialogowe Z wydania MusicBrainz.

Plik → Importuj z odcisku palca MusicBrainz...
Importuj z serwera MusicBrainz. Ta pozycja menu otwiera to samo okno dialogowe importu, co
Importuj..., ale otwiera bezpośrednio okno dialogowe From MusicBrainz Fingerprint.

Plik → Automatyczny import...
Automatyczny import umożliwia importowanie informacji o wielu albumach z różnych stron internetowych
usługi. Jeśli na liście plików wybrane są katalogi, dane utworów dla wybranego
katalogi zostaną zaimportowane. Jeśli nie wybrano żadnego katalogu, wszystkie katalogi w pliku
lista zostanie zaimportowana.

Typ tagu (Tag 1, Tag 2, Tag 1 i Tag 2) można wybrać za pomocą miejsca docelowego
pole kombi.

Profile określają, z którymi serwerami skontaktujemy się w celu pobrania informacji o albumie. Trochę
profile są wstępnie zdefiniowane (All, MusicBrainz, Discogs, Cover Art), profile niestandardowe mogą być
dodane za pomocą przycisku Dodaj po prawej stronie pola kombi Profil.

Poniższa tabela pokazuje serwery, które zostaną użyte podczas importowania informacji o albumie
przy użyciu wybranego profilu. Proces importowania albumu jest zakończony, jeśli wszystkie
znaleziono wymagane informacje, więc kolejność wierszy w tabeli jest
ważny. Można go zmienić za pomocą przycisków Przenieś w górę i Przenieś w dół. Edycja może być
służy do zmiany istniejącego wpisu. Wybór serwera oferuje te same serwery, co can
być używane w funkcjach importu. Standardowe tagi, dodatkowe tagi, okładka określają
informacje, które mają być pobrane z serwera. Wreszcie, dokładność jest
minimalna dokładność, jaką należy osiągnąć, aby zaakceptować importowane dane. Jeśli dokładność
jest niewystarczający, zostanie wypróbowany następny serwer z listy. To samo okno dialogowe zawierające
właściwości serwera pojawiają się po kliknięciu przycisku Dodaj w celu dodania nowego wpisu serwera. Istniejący
wpisy można usunąć za pomocą opcji Usuń.

Aby uruchomić automatyczny import wsadowy z wybranym profilem, kliknij Start. Detale
informacje o trwającym imporcie są wyświetlane w górnej części okna dialogowego. Proces może być
przerwane przyciskiem Przerwij.

Plik → Przeglądaj okładki...
Okno dialogowe Przeglądaj okładki pomaga znaleźć okładkę albumu. Wykonawca/Album jest wypełniony
z tagów, jeśli to możliwe. Source oferuje różne strony internetowe z okładkami albumów.
Adres URL z parametrami wykonawcy i albumu można znaleźć pod nazwą. zakodowany URL
wartości dla wykonawcy i albumu można wstawić za pomocą %u{artysta} i %u{album}, inny
wartości z tagów są również możliwe, jak opisano w Konfiguracja Kid3, Działania użytkownika.
Więcej źródeł można wprowadzić po wpisie „Źródło niestandardowe”, zastępując „Niestandardowe
Source” z nazwą źródła, naciskając Enter, następnie wstawiając adres URL i na koniec
naciskając Zapisz ustawienia. Wynikowe polecenie przeglądarki jest wyświetlane w górnej części
i można go uruchomić, klikając Przeglądaj. Przeglądarka, którą można skonfigurować w
ustawienia, jest uruchamiany z wybranym źródłem. Obraz okładki można następnie przeciągnąć
z przeglądarki do okna Kid3 i zostanie ustawiony w ramce obrazu
wybrane pliki.

Ponieważ nie wszystkie przeglądarki obsługują przeciąganie i upuszczanie obrazów i zdjęć na stronach internetowych
często mają adres URL, w takich przypadkach Kid3 otrzyma adres URL, a nie obrazek. Jeśli
URL wskazuje na zdjęcie, zostanie ono pobrane. Jeśli jednak adres URL odnosi się do niektórych
inny zasób sieciowy, należy go przetłumaczyć na odpowiedni obraz. Taki
mapowania są zdefiniowane w wyodrębnianiu adresów URL tabeli. Lewa kolumna Dopasowanie zawiera
wyrażenie regularne, które jest porównywane z adresem URL. Jeśli pasuje, schwytany
wyrażenia w nawiasach są wstawiane do wzorca właściwego adresu URL obrazu
kolumna (w miejscach oznaczonych \1 itd.). Zastąpione wyrażenie regularne
zawiera adres URL zdjęcia. W ten sposób okładki można importować z Amazon,
Obrazy Google itp. za pomocą metody drag'n'drop. Możliwe jest również zdefiniowanie własnego
mapowania.

Plik → Eksportuj...
Okno dialogowe eksportu służy do przechowywania danych z tagów w pliku lub schowku. ten
edytor u góry pokazuje podgląd danych do wyeksportowania. Jeśli eksportowane dane zawierają:
znaków tabulatora, eksport jest wyświetlany w tabeli. Dane zostaną wygenerowane
ze znaczników w bieżącym katalogu zgodnie ze skonfigurowanym formatem.

Ustawienia formatu są podobne jak w oknie dialogowym Importuj: Najwyższe pole zawiera
tytuł (np. „CSV bez cytowania”), a następnie nagłówek, który zostanie wygenerowany w
początek pliku. Następują dane toru; jest używany do każdego utworu. Wreszcie,
przyczepa może być użyta do wygenerowania tekstu wykończeniowego.

Pola formatu nie zawierają wyrażeń regularnych, jak w oknie dialogowym Importuj, a jedynie
wyjściowe wyrażenia formatujące ze specjalnymi wyrażeniami %, które zostaną zastąpione wartościami
z tagów. Całość działa jak format nazwy pliku, a te same kody są
używane plus kilka dodatkowych kodów. Nie tylko kody wymienione poniżej, ale wszystkie ramki tagów
można używać nazw.

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} Utwór (np. 01)

· %t %{track.n} Ścieżka o szerokości pola n (np. 001 dla %{track.3})

· Ścieżka %T %{tracknumber} (bez wiodących zer, np. 1)

· %g %{genre} Gatunek

· %f %{file} Nazwa pliku

· Ścieżka %p %{filepath}

· %u %{url} adres URL

· %d %{duration} Czas trwania w minutach:sekundach

· %D %{seconds} Czas trwania w sekundach

· %n %{tracks} Liczba utworów w albumie

· %e %{extension} Rozszerzenie pliku

· %O %{tag1} Format tagu 1 (ID3v1.1 lub pusty, jeśli nie istnieje)

· %o %{tag2} Format tagu 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF lub pusty, jeśli nie istnieje)

· %b %{bitrate} Szybkość transmisji w kbit/s

· %v %{vbr} VBR lub pusty (tylko dla ID3v2.3 z id3lib)

· %r %{samplerate} Częstotliwość próbkowania w Hz

· %m %{mode} Tryb kanału (Stereo lub Joint Stereo)

· %h %{channels} Liczba kanałów (1 lub 2)

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

Kilka formatów jest wstępnie zdefiniowanych. „CSV bez cytowania” oddziela pola tabulatorami. Dane w
ten format można ponownie zaimportować do Kid3 przy użyciu tego samego formatu importu
Nazwa. „CSV cytowany” dodatkowo otacza pola podwójnymi cudzysłowami, co ułatwia
importować do aplikacji arkusza kalkulacyjnego. Pola nie mogą jednak zawierać żadnych podwójnych
cudzysłowy, gdy używany jest ten format. „Extended M3U” i „Extended PLS” generują listy odtwarzania
z rozszerzonymi atrybutami i bezwzględnymi nazwami ścieżek. "HTML" może być użyty do wygenerowania
Strona HTML z hiperłączami do utworów. "Kover XML" tworzy plik, który można
importowane przez program do drukowania okładek Kover. „Szczegóły techniczne” zawierają informacje
o przepływności, częstotliwości próbkowania, kanałach itp. Na koniec, "Format niestandardowy" pozostaje pusty dla
definicja niestandardowego formatu. Możesz zdefiniować więcej własnych formatów, dodając linie
w pliku kid3rc w katalogu konfiguracyjnym. Inne formaty można dostosować do
Twoje potrzeby.

Można wybrać źródło tagów do generowania danych eksportu (Tag 1 lub Tag 2)
z polem kombi. Funkcja Pchanie do pliku lub do schowka przechowuje dane w pliku lub w
schowek. OK i Anuluj zamykają okno, podczas gdy OK akceptuje bieżące okno dialogowe
ustawienia.

Plik → Utwórz listę odtwarzania
Tworzy listę odtwarzania. Format i zawartość listy odtwarzania można ustawić za pomocą różnych
opcje.

Nazwa listy odtwarzania może być taka sama jak nazwa katalogu lub użyć formatu z wartościami
z tagów, np. "%{artist} - %{album}", aby nazwa wykonawcy i albumu była
nazwa pliku listy odtwarzania. Kody formatu są takie same jak w przypadku eksportu. Rozszerzenie zależy od
w formacie listy odtwarzania.

Lokalizacja wygenerowanej listy odtwarzania jest określona przez wybór opcji Utwórz w
pole kombi.

Aktualny katalog
Lista odtwarzania jest tworzona w bieżącym katalogu i zawiera tylko pliki
bieżący katalog.

Każdy katalog
Lista odtwarzania jest tworzona w każdym katalogu zawierającym wymienione pliki, a każdy
lista odtwarzania zawiera pliki tego katalogu.

Katalog najwyższego poziomu
Tylko jedna lista odtwarzania jest tworzona w katalogu najwyższego poziomu (tzn. w katalogu
lista plików) i zawiera wymienione pliki katalogu najwyższego poziomu i wszystkie
jego podkatalogi.

Format listy odtwarzania może być M3U, PLS lub XSPF.

Jeśli opcja Uwzględnij tylko wybrane pliki jest zaznaczona, tylko wybrane pliki będą
zawarte na liście odtwarzania. Jeśli wybrany jest katalog, wszystkie jego pliki są zaznaczone.
Jeśli to pole wyboru nie jest aktywne, wszystkie pliki audio są zawarte na liście odtwarzania.

Sortuj według nazwy pliku wybiera zwykły przypadek, w którym pliki są uporządkowane według nazwy pliku.
Pole Sortuj według tagu umożliwia sortowanie według ciągu formatu z wartościami ze znacznika
pola. Na przykład "%{track.3}" może być użyty do sortowania według numeru ścieżki (".3" to
używany do uzyskania trzech cyfr z wiodącymi zerami, ponieważ łańcuchy są używane do sortowania). Ono
możliwe jest również użycie wielu pól, np. "%{genre}%{year}" do sortowania za pomocą ciągu znaków
składa się z gatunku i roku.

Wpisy listy odtwarzania będą miały względne lub bezwzględne ścieżki do plików w zależności od tego, czy:
Ustawiono opcję Użyj ścieżki względnej dla plików na liście odtwarzania lub Użyj pełnej ścieżki dla plików na liście odtwarzania.

Gdy ustawiona jest opcja Tylko zapisz listę plików, lista odtwarzania będzie zawierać tylko ścieżki do
pliki. Aby wygenerować rozszerzoną listę odtwarzania z dodatkowymi informacjami, ciąg formatujący
można ustawić za pomocą opcji Zapisz informacje za pomocą kontrolki.

Plik → Zakończ (Ctrl+Q)
Zamyka aplikację.

Połączenia Edytuj Menu
Edycja → Zaznacz wszystko (Alt+A)
Zaznacza wszystkie pliki.

Edycja → Odznacz (Ctrl+Shift+A)
Odznacza wszystkie pliki.

Edytuj → Zaznacz wszystko w katalogu
Wybiera wszystkie pliki w bieżącym katalogu.

Edycja → Poprzedni plik (Alt+Up)
Wybiera poprzedni plik.

Edycja → Następny plik (Alt+Dół)
Wybiera następny plik.

Edycja → Znajdź... (Ctrl+F)
Znajdź ciągi w nazwach plików i tagach. Okno dialogowe Znajdź jest podzbiorem
Zamień okno dialogowe, które opisano poniżej.

Edycja → Zamień... (Ctrl+R)
Ta funkcja otwiera okno dialogowe, w którym można znaleźć i zamienić ciągi w nazwach plików oraz
Tagi. Zestaw ramek, w których przeprowadzane jest wyszukiwanie, może być ograniczony przez:
odznaczenie pola wyboru Zaznacz wszystko i zaznaczenie ramek, które mają być przeszukiwane.
Dostępne są również opcje wyszukiwania do wyszukiwania wstecz, z uwzględnieniem wielkości liter i do
używaj wyrażeń regularnych.

W zależności od liczby plików wyszukiwanie może zająć trochę czasu, dlatego może być
przerwane przez zamknięcie okna.

Połączenia Tools Menu
Narzędzia → Zastosuj format nazwy pliku
Gdy opcja Formatuj podczas edycji jest wyłączona dla formatu nazwy pliku w konfiguracji
okno dialogowe, ta pozycja menu może być użyta do zastosowania skonfigurowanego formatu do nazw
wybrane pliki. Można to również wykorzystać do sprawdzenia, czy nazwy plików są zgodne z
skonfigurowany format poprzez zastosowanie formatu do wszystkich zapisanych plików, a następnie sprawdzenie, czy istnieje
pliki zostały zmienione (i dlatego zostały oznaczone symbolem dysku w polu listy plików).

Narzędzia → Zastosuj format znacznika
Gdy opcja Formatuj podczas edycji jest wyłączona dla formatu tagu w konfiguracji
okno dialogowe, ta pozycja menu może być użyta do zastosowania skonfigurowanego formatu do tagów
wybrane pliki. Można to również wykorzystać do sprawdzenia, czy tagi są zgodne z
skonfigurowany format poprzez zastosowanie formatu do wszystkich zapisanych plików, a następnie sprawdzenie, czy istnieje
pliki zostały zmienione (i dlatego zostały oznaczone symbolem dysku w polu listy plików).

Narzędzia → Zastosuj kodowanie tekstu
Ustawia kodowanie tekstu wybrane w Ustawienia/Konfiguruj Kid3.../Tags/Tag 2 dla wszystkich
wybrane pliki. Jeśli wybrano UTF8, UTF16 będzie używany dla tagów ID3v2.3.0, ponieważ
UTF8 nie jest obsługiwany w tym formacie.

Narzędzia → Zmień nazwę katalogu...
To okno dialogowe oferuje możliwość automatycznej zmiany nazwy aktualnie otwartego
katalog zgodnie z tagami w plikach. Kilka formatów jest wstępnie skonfigurowanych do
zawierać informacje o wykonawcy, albumie i roku w nazwie katalogu. To jest również
możliwe ustawienie niestandardowego formatu, do wstawienia tagu używane są następujące specjalne kody
wartości do nazwy katalogu:

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} Utwór (np. 01)

· %t %{track.n} Ścieżka o szerokości pola n (np. 001 dla %{track.3})

· Ścieżka %T %{tracknumber} (bez wiodących zer, np. 1)

· %g %{genre} Gatunek

Jeśli w formacie zostanie znaleziony separator katalogów „/”, tworzonych jest wiele katalogów.
Jeśli chcesz utworzyć nowy katalog zamiast zmieniać nazwę bieżącego katalogu,
wybierz Utwórz katalog zamiast Zmień nazwę katalogu. Źródło informacji o tagu
można wybrać pomiędzy Od tagu 1 i od tagu 2, od tagu 1 i od tagu 2. Podgląd dla
operację zmiany nazwy wykonaną na pierwszym pliku można zobaczyć w Od i Do
sekcje okna dialogowego.

Wiele katalogów można zmienić, wybierając je.

Narzędzia → Ścieżki liczbowe...
Jeśli numery ścieżek w tagach nie są ustawione lub mają nieprawidłowe wartości, ta funkcja
może automatycznie numerować utwory w kolejności rosnącej. Numer startowy można ustawić w
okno dialogowe. Jeśli tylko część utworów ma być ponumerowana, należy je wybrać.

Po zaznaczeniu opcji Całkowita liczba utworów, liczba utworów zostanie również ustawiona w
tagi.

Możliwe jest numerowanie utworów w wielu katalogach. Foldery muszą być
rozwinięte i wybrane.

Jeśli zaznaczony jest licznik Reset dla każdego katalogu, numerowanie ścieżek jest uruchamiane ponownie za pomocą przycisku
podany numer dla każdego katalogu, gdy wybrano wiele folderów.

Okno dialogowe numerowania utworów może być również używane do formatowania istniejących numerów utworów bez
zmiana wartości, gdy pole wyboru pozostawione do Numer początkowy jest nieaktywne. Suma
liczba utworów zostanie dodana, jeśli odpowiednie pole wyboru jest aktywne, co może być
służy do ustawiania sumy dla wszystkich wybranych utworów. Jeśli tylko formatowanie istniejącego
numery są pożądane, to pole wyboru również musi być nieaktywne.

Narzędzia → Filtruj...
Filtr może służyć do wyświetlania tylko tych plików, które spełniają określone kryteria. Ten
przydaje się, jeśli chcesz zorganizować dużą kolekcję i edytować tylko te pliki, które
nie są w pożądanym schemacie. Wyrażenie określające, które pliki wyświetlić, używa
te same kody formatu, które są używane w formacie nazwy pliku, imporcie i eksporcie.

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} Utwór (np. 01)

· %t %{track.n} Ścieżka o szerokości pola n (np. 001 dla %{track.3})

· Ścieżka %T %{tracknumber} (bez wiodących zer, np. 1)

· %g %{genre} Gatunek

· %f %{file} Nazwa pliku

· %p %{filepath} Bezwzględna ścieżka do pliku

· %e %{extension} Rozszerzenie pliku

· %O %{tag1} Format tagu 1 (ID3v1.1 lub pusty, jeśli nie istnieje)

· %o %{tag2} Format tagu 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF lub pusty, jeśli nie istnieje)

· %b %{bitrate} Szybkość transmisji w kbit/s

· %v %{vbr} VBR lub pusty (tylko dla ID3v2.3 z id3lib)

· %r %{samplerate} Częstotliwość próbkowania w Hz

· %m %{mode} Tryb kanału (Stereo lub Joint Stereo)

· %h %{channels} Liczba kanałów (1 lub 2)

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

· %1a %1{artist}, ... Użyj prefiksu 1, aby uzyskać wartości znacznika 1

· %2a %2{artist}, ... Użyj prefiksu 2, aby uzyskać wartości znacznika 2

Kody te są zastępowane wartościami pliku, a wynikowe ciągi mogą:
porównać z następującymi operacjami:

· s1 równa się s2: prawda, jeśli s1 i s2 są równe.

· s1 zawiera s2: prawda, jeśli s1 zawiera s2, tj. s2 jest podłańcuchem s1.

· s pasuje do re: prawda, jeśli s pasuje do wyrażenia regularnego re.

Wyrażenia prawdziwe są zastępowane przez 1, fałszywe przez 0. Prawdziwe wartości są reprezentowane przez 1,
prawda, wł i tak, fałsz wartości od 0, fałsz, wył i nie. Operacje logiczne nie są,
i, lub (w tej kolejności) i mogą być pogrupowane w nawiasy.

Niektóre reguły filtrowania są wstępnie zdefiniowane i mogą służyć jako przykłady dla własnych wyrażeń:

Wszystkie kategorie
Kiedy lista plików jest filtrowana — jest to pokazane jako „[filtrowane]” w tytule okna
- i wszystkie pliki zostaną wyświetlone ponownie, filtrowanie można cofnąć za pomocą tego
filtr. Używa pustego wyrażenia, ale prawdziwa wartość miałaby ten sam efekt.

Niezgodność tagu nazwy pliku
nie (%{ścieżka pliku} zawiera "%{artysta} - %{album}/%{utwór} %{tytuł}")

Sprawdza, czy ścieżka pliku jest zgodna z formatem nazwy pliku. Ta zasada to
automatycznie dostosowywane w przypadku zmiany formatu nazwy pliku.

Brak tagu 1
%{tag1} równa się ""

Wyświetla tylko pliki, które nie mają znacznika 1.

Brak tagu 2
%{tag2} równa się ""

Wyświetla tylko pliki, które nie mają znacznika 2.

Tag ID3v2.3.0
%{tag2} równa się „ID3v2.3.0”

Wyświetla tylko pliki, które mają tag ID3v2.3.0.

Tag ID3v2.4.0
%{tag2} równa się „ID3v2.4.0”

Wyświetla tylko pliki, które mają tag ID3v2.4.0.

Etykieta 1 ! = Etykieta 2
nie (%1{tytuł} równa się %2{tytuł} i %1{album} równa się %2{album} i %1{artysta}
równa się %2{artysta} i %1 komentarz} równa się %2 komentarz} i %1 rok} równa się %2 rok}
i %1{utwór} równa się %2{utwór} i %1{gatunek} równa się %2{gatunek})

Wyświetla pliki z różnicami między tagiem 1 a tagiem2.

Etykieta 1 == Etykieta 2
%1{tytuł} równa się %2{tytuł} i %1{album} równa się %2{album} i %1{artysta} równa się
%2{artysta} i %1 komentarz} równa się %2 komentarz} i %1 rok} równa się %2 rok} i
%1{utwór} równa się %2{utwór} i %1{gatunek} równa się %2{gatunek}

Wyświetla pliki z identycznym znacznikiem 1 i znacznikiem 2.

Niekompletny
%{tytuł} równa się "" or %{artysta} równa się "" or %{album} równa się "" or %{rok} równa się
"" or %{numer utworu} równa się "" or %{gatunek muzyczny} równa się ""

Wyświetla pliki z pustymi wartościami w standardowych tagach (tytuł, wykonawca, album, data,
numer utworu, gatunek).

Brak zdjęcia
%{zdjęcie} równa się ""

Wyświetla tylko pliki, które nie mają obrazu.

Filtr niestandardowy
Aby dodać własny filtr, wybierz ten wpis. Na przykład, jeśli chcesz mieć
filtr dla artystów zaczynających się od „The”, zastąp „Filtr niestandardowy” nazwą „The
Bands” i naciśnij Enter. Następnie wstaw następujące wyrażenie do edycji wiersza:

%{artysta} zapałki "Ten.*"

Następnie kliknij Zapisz ustawienia. Kliknij Zastosuj, aby przefiltrować pliki. Wszystkie przetwarzane pliki są
wyświetlane w widoku tekstu, z „+” dla tych, którzy pasują do filtra i „-”
dla innych. Po zakończeniu tylko pliki z wykonawcą zaczynającym się od „The”
są wyświetlane, a tytuł okna jest oznaczony „[filtrowane]”.

Narzędzia → Konwertuj ID3v2.3 na ID3v2.4
Jeśli w wybranych plikach znajdują się jakieś tagi ID3v2.3, zostaną one przekonwertowane na ID3v2.4
Tagi. Ramki, które nie są obsługiwane przez TagLib, zostaną odrzucone. Tylko pliki bez
niezapisane zmiany zostaną przekonwertowane.

Narzędzia → Konwertuj ID3v2.4 na ID3v2.3
Jeśli w wybranych plikach znajdują się jakieś tagi ID3v2.4, zostaną one przekonwertowane na ID3v2.3
Tagi. Tylko pliki bez niezapisanych zmian zostaną przekonwertowane.

Narzędzia → Odtwórz
Spowoduje to otwarcie prostego paska narzędzi do odtwarzania plików audio. Zawiera przyciski do podstawowych
operacje (odtwórz/wstrzymaj, zatrzymaj odtwarzanie, poprzedni utwór, następny utwór, zamknij), suwaki dla
pozycja i głośność oraz wyświetlanie aktualnej pozycji. Jeśli wiele plików jest
wybrany, wybrane utwory będą odtwarzane, w przeciwnym razie wszystkie pliki zostaną odtworzone.

Połączenia Ustawienia Menu
Ustawienia → Pokaż pasek narzędzi
Przełącza wyświetlanie paska narzędzi.

Ustawienia → Pokaż pasek stanu
Przełącza wyświetlanie paska stanu, który wyświetla dłuższe akcje, takie jak otwieranie lub
zapisywanie katalogu.

Ustawienia → Pokaż obraz
Przełącza wyświetlanie obrazu podglądu okładki albumu.

Ustawienia → Automatyczne ukrywanie tagów
Puste tagi są automatycznie ukrywane, jeśli ta opcja jest aktywna. Plik, znacznik 1 i znacznik
2 sekcje można ręcznie zwinąć i rozwinąć, klikając odpowiednie -/+
przyciski.

Ustawienia → Konfiguracja Kid3...
Otwiera okno konfiguracji, które składa się ze stron dla tagów, plików, działań użytkownika,
i ustawienia sieciowe.

Opcje specyficzne dla tagów można znaleźć na stronie Tagi, która sama w sobie jest podzielona na
trzy zakładki dla Tag 1, Tag 2 oraz Tag 1 i Tag 2.

Jeśli zaznaczono opcję Oznacz obcięte pola, obcięte pola ID3v1.1 będą oznaczone na czerwono. ten
pola tekstowe tagów ID3v1.1 mogą mieć tylko 30 znaków, komentarz tylko 28
postacie. Również gatunek i numery utworów są ograniczone, więc pola mogą być
obcinane podczas importowania lub przenoszenia z ID3v2. Obcięte pola i plik będzie
być oznaczone na czerwono, a znak zostanie usunięty po edycji pola.

Dzięki kodowaniu tekstu dla ID3v1 można ustawić zestaw znaków używany w ID3v1
Tagi. To kodowanie powinno być zgodne z ISO-8859-1, więc zaleca się zachowanie tego
domyślna wartość. Istnieją jednak znaczniki z innym kodowaniem, więc może być
ustaw tutaj, a tagi ID3v1 można następnie skopiować do ID3v2, które obsługuje Unicode.

Pole wyboru Użyj formatu utworu/całkowitej liczby utworów określa, czy utwór
pole number tagów ID3v2 zawiera po prostu numer utworu lub dodatkowo sumę
liczba utworów w katalogu.

Gdy zaznaczona jest opcja Gatunek jako tekst zamiast ciągu numerycznego, wszystkie gatunki ID3v2 będą
przechowywane jako ciąg tekstowy, nawet jeśli istnieje odpowiedni kod dla gatunków ID3v1. Gdyby
ta opcja nie jest ustawiona, gatunki, dla których istnieje kod ID3v1 są przechowywane jako liczba
kodu gatunku (w nawiasach dla ID3v2.3). W ten sposób gatunek Metal jest przechowywany jako
„Metal” lub „(9)” w zależności od tej opcji. Gatunki, których nie ma na liście ID3v1
gatunki są zawsze przechowywane jako ciąg tekstowy. Ulepszono cel tej opcji
kompatybilność z urządzeniami, które nie interpretują poprawnie kodów gatunkowych.

Kodowanie tekstu określa domyślne kodowanie używane dla ramek ID3v2 i można je ustawić na
ISO-8859-1, UTF16 lub UTF8. UTF8 nie jest prawidłowy dla ramek ID3v2.3.0; jeśli jest ustawiony,
Zamiast tego zostanie użyty kod UTF16. W przypadku ramek ID3v2.4.0 możliwe są wszystkie trzy kodowania.

Wersja używana dla nowych tagów określa, czy nowe tagi ID3v2 są tworzone jako wersja
2.3.0 lub 2.4.0. W pierwszym przypadku id3lib jest używany tak jak we wcześniejszych wersjach
Kid3 i TagLib są stosowane tylko w przypadku napotkania tagu ID3v2.4.0. W sekundę
case, ID3v2.4.0 (TagLib), TagLib jest zwykle używany do plików MP3; zmieniony lub nowo
utworzone tagi zostaną następnie zapisane w wersji 2.4.0. Po wybraniu ID3v2.3.0 (TagLib),
TagLib jest również używany do tagów ID3v2.3.0.

Cyfry numeru ścieżki to liczba cyfr w polach Numer ścieżki. Wiodące zera to
używane do padania. Na przykład przy wartości 2 numer ścieżki 5 jest ustawiony na „05”.

Pole kombi Nazwa pola komentarza dotyczy tylko plików Ogg/Vorbis i FLAC oraz
ustawia nazwę pola używanego do komentarzy. Wydaje się, że używane są różne aplikacje
różne nazwy, na przykład "KOMENTARZ" jest używany przez xmms, podczas gdy amaroK używa
"OPIS".

Format obrazów w plikach Ogg/Vorbis jest określony przez nazwę pola obrazu, które
może być METADATA_BLOCK_PICTURE lub COVERART. Pierwszy to oficjalny standard i zastosowania
taki sam format jak zdjęcia w tagach FLAC. COVERART to wcześniejszy nieoficjalny sposób na
dołączać zdjęcia do komentarzy Vorbis. Może być używany w celu zapewnienia zgodności ze starszymi
gracze.

Jeśli zaznaczone jest pole wyboru Oznacz, jeśli większe niż, pliki zawierające osadzony album
okładki przekraczające podany rozmiar w bajtach są zaznaczone na czerwono. Można to wykorzystać do znalezienia
pliki zawierające zbyt duże zdjęcia, które nie są akceptowane przez niektóre aplikacje i
gracze. Wartość domyślna to 131072 bajty (128 KB).

Gatunki niestandardowe mogą służyć do definiowania gatunków, które nie są dostępne w standardzie
lista gatunków, np. „Gothic Metal”. Takie niestandardowe gatunki pojawią się w polu kombi Gatunek
tagu 2. W przypadku tagów ID3v1.1 można używać tylko predefiniowanych gatunków.

Listę gatunków niestandardowych można również wykorzystać do zmniejszenia liczby gatunków dostępnych w
pole kombi Gatunek do tych, które są zwykle używane. Jeśli Twoja kolekcja zawiera głównie muzykę
w gatunkach Metal, Gothic Metal, Ancient i Hard Rock można wprowadzić te gatunki
i zaznacz Pokaż tylko gatunki niestandardowe. Pole kombi Tag 2Genre będzie wtedy zawierało tylko
te cztery gatunki i nie będziesz musiał przeszukiwać pełnej listy gatunków w poszukiwaniu
im. W tym przykładzie tylko Metal i Hard Rock zostaną wymienione w gatunkach tagu 1
listy, ponieważ te dwa wpisy dotyczące gatunków niestandardowych są gatunkami standardowymi. Jeśli pokaż tylko niestandardowe
Gatunki nie są aktywne, niestandardowe gatunki można znaleźć na końcu listy gatunków.

Ramki szybkiego dostępu określają, które typy ramek są zawsze wyświetlane w sekcji Etykieta 2.
Takie ramki można następnie dodać bez uprzedniego użycia przycisku Dodaj. Kolejność tych
ramki szybkiego dostępu można zmieniać, przeciągając i upuszczając elementy.

Format tagu zawiera opcje dotyczące formatu tagów. Gdy Formatuj podczas edycji jest
zaznaczone, konfiguracja formatu jest automatycznie używana podczas edycji tekstu w linii
zmiany. Konwersję wielkości liter można ustawić na Bez zmian, Wszystkie małe litery, Wszystkie wielkie litery,
Wielka pierwsza litera lub Wszystkie pierwsze litery wielkimi literami. Aby użyć konwersji uwzględniającej ustawienia regionalne
między małymi a wielkimi literami, w polu rozwijanym można wybrać ustawienia regionalne
poniżej. Listę zamiany ciągów można ustawić na dowolne odwzorowania ciągów. Aby dodać
nowe mapowanie, wybierz komórkę Od wiersza i wstaw tekst do zastąpienia, a następnie przejdź do
do kolumny Do i wprowadź tekst zastępczy. Aby usunąć mapowanie, ustaw komórkę Od na
pustą wartość (np. wpisując najpierw spację, a następnie backspace). Wstawianie i usuwanie
wiersze jest również możliwe za pomocą menu kontekstowego, które pojawia się po naciśnięciu prawego przycisku myszy
zostanie kliknięty. Zastąpienie jest aktywne tylko wtedy, gdy zaznaczone jest pole Zastąpienie ciągu.

Na stronie Pliki można zaznaczyć pole wyboru Załaduj ostatnio otwierane pliki, dzięki czemu Kid3 będzie
otwórz i wybierz ostatni wybrany plik, gdy zostanie uruchomiony następnym razem. Utrzymywać
znacznik czasu pliku można sprawdzić, aby zachować znacznik czasu modyfikacji pliku. Nazwa pliku
for cover ustawia nazwę, która jest sugerowana, gdy osadzony obraz jest eksportowany do a
plik.

Jeśli opcja Zaznacz zmiany jest aktywna, zmienione pola są oznaczone jasnoszarą etykietą
tło.

Format nazwy pliku zawiera opcje dotyczące formatu nazw plików. Te same opcje, co
w formacie tagu są dostępne.

Strona Czynności użytkownika zawiera tabelę z poleceniami, które są dostępne w
menu kontekstowe listy plików. W przypadku krytycznych operacji, takich jak usuwanie plików, jest
wskazane jest zaznaczenie Potwierdź, aby wyświetlić okno dialogowe potwierdzenia przed wykonaniem
Komenda. Wyjście może byćoznaczone, aby zobaczyćwyjście zapisane za pomocą poleceń konsoli (standard
wyjście i błąd standardowy). Nazwa to nazwa wyświetlana w menu kontekstowym. Komenda
to wiersz poleceń do wykonania. Argumenty można przekazywać za pomocą następujących kodów:

· %F %{files} Ścieżki plików (lista, jeśli wybrano wiele plików)

· %f %{file} Ścieżka do pojedynczego pliku

· %uF %{urls} adresy URL (lista, jeśli wybrano wiele plików)

· %uf %{url} URL do pojedynczego pliku

· %d %{katalog} Katalog

· %s %{title} Tytuł (piosenka)

· %a %{artist} artysta

· Album %l %{album}

· %c %{comment} Komentarz

· %y %{rok} Rok

· %t %{track} Utwór (np. 01)

· %t %{track.n} Ścieżka o szerokości pola n (np. 001 dla %{track.3})

· Ścieżka %T %{tracknumber} (bez wiodących zer, np. 1)

· %g %{genre} Gatunek

· %b %{browser} Polecenie uruchomienia przeglądarki internetowej

· %q %{qmlpath} Katalog bazowy dostarczonych plików QML

Specjalny kod @separator można ustawić jako polecenie, aby wstawić separator do
menu kontekstowe działań użytkownika. Pozycje menu można umieścić w podmenu, załączając je
@rozpoczęciemenu i @menukońcowe polecenia. Nazwa podmenu jest określona przez Nazwę
kolumna @rozpoczęciemenu dowództwo.

Aby wykonać skrypty QML, @m_mr jest używany jako nazwa polecenia. Ścieżka do skryptu QML to
przekazany jako parametr. Dostarczone skrypty można znaleźć w folderze
%{qmlpath}/script/ (w Linuksie zazwyczaj /usr/share/kid3/qml/script/, w ​​Windows
qml/script/ w katalogu instalacyjnym, a w systemie OS X w folderze aplikacji
kid3.app/Contents/Resources/qml/script/). Skrypty niestandardowe można przechowywać w dowolnym
informator. Jeśli kod QML wykorzystuje komponenty GUI, @QMlview należy używać zamiast
@m_mr. Dodatkowe parametry są przekazywane do skryptu QML, gdzie będą dostępne
za pośrednictwem pobierz argumenty() funkcjonować. Przegląd niektórych funkcji i właściwości, które
są dostępne w QML można znaleźć w dodatku Interfejs QML.

Polecenie, które zostanie wstawione za pomocą %{browser}, można zdefiniować w przeglądarce internetowej
edytuj wiersz powyżej. Do pobierania informacji można użyć poleceń zaczynających się od %{browser}
na przykład o plikach audio z sieci

%{przeglądarka} http://lyricwiki.org/%u{wykonawca}:%u{tytuł}

zapyta o tekst aktualnej piosenki w LyricWiki[10]. "u" w %u{artist} i
%u{title} służy do kodowania adresu URL wykonawcy %{artist} i utworu %{title}. Ono
łatwo zdefiniować własne zapytania w ten sam sposób, np. wyszukiwanie grafiki za pomocą
Google[11]:

%{przeglądarka} http://images.google.com/images?q=%u{wykonawca}%20%u{album}

Aby dodać okładkę albumu do tagu 2, możesz wyszukać obrazy w Google lub Amazon, używając
polecenia opisane powyżej. Obraz można dodać do tagu metodą „przeciągnij i upuść”.
Możesz także dodać obraz za pomocą Dodaj, a następnie wybierz ramkę obrazu i zaimportuj obraz
plik lub wklej ze schowka. Ramki do zdjęć są obsługiwane dla ID3v2, MP4, FLAC,
Tagi Ogg i ASF.

Do dodawania i usuwania wpisów w tabeli można użyć menu kontekstowego.

Strona Sieć zawiera tylko pole do wstawienia adresu proxy i opcjonalnie
port, oddzielony dwukropkiem. Proxy będzie używane podczas importowania z Internetu
serwer, gdy pole wyboru jest zaznaczone.

Na stronie Wtyczki dostępne wtyczki można włączyć lub wyłączyć. Wtyczki są
podzielone na dwie sekcje. Lista wtyczek i priorytetów metadanych zawiera wtyczki
które obsługują formaty plików audio. Kolejność wtyczek jest ważna, ponieważ
są wypróbowywane od góry do dołu. Niektóre formaty są obsługiwane przez wiele wtyczek, więc pliki
zostaną otwarte z pierwszą wspierającą je wtyczką. TaglibMetadata obsługuje większość
formaty, jeśli znajduje się na górze listy, otworzy większość plików. Jeśli chcesz
aby użyć innej wtyczki dla formatu pliku, upewnij się, że jest ona wymieniona przed
Wtyczka TaglibMetadata. Szczegółowe informacje o wtyczce metadanych i dlaczego warto jej użyć
je zamiast TagLib są wymienione poniżej.

· Id3libMetadata: Zastosowania id3lib[12] dla tagów ID3v1.1 i ID3v2.3 w MP3, MP2, AAC
pliki. Obsługuje kilka innych typów ramek niż TagLib. Innym powodem, dla którego warto go używać, jest
że TagLib obsługuje tylko ID3v2.3 od wersji 1.8.

· OggFlacMetadata: Zastosowania Libogg[13], biblioteka, plik libvorbis[14] dla plików Ogg, oraz
dodatkowo bibliotekaFLAC++ i bibliotekaFLAC[15] dla plików FLAC. Powody, dla których warto ich używać, to
obrazy w plikach Ogg, które nie są obsługiwane przez TagLib i że są to
oficjalne biblioteki dla tych formatów.

· TaglibMetadata: Zastosowania TagLib[16], który obsługuje wiele formatów plików audio. Odkąd
wersja 1.8 obsługuje również ID3v2.3, dzięki czemu może być używana do wszystkich plików audio
obsługiwane przez Kid3.

· Mp4v2Metadane: mp4v2[17] był pierwotnie używany przez Kid3 do obsługi plików M4A.
Jednak nowsze wersje TagLib zapewniają dobrą obsługę M4A, więc ta wtyczka nie jest
zbudowany domyślnie.

Sekcja Dostępne wtyczki zawiera listę pozostałych wtyczek. Ich kolejność nie jest
ważne, ale można je włączyć lub wyłączyć za pomocą pól wyboru.

· AmazonImport: Używany do funkcji Importuj z Amazon....

· DiscogsImport: Używany do funkcji Importuj z Discogs....

· FreedbImport: używany do importu z gnudb.org... i importu z
TrackType.org... funkcje.

· MusicBrainzImport: Używany do importowania z funkcji MusicBrainz Release....

· AcousidImport: Używany do importu z funkcji MusicBrainz Fingerprint...,
co zależy od Chromadruk[18] i Libav[19] biblioteki.

Wyłączone wtyczki nie zostaną załadowane. Można to wykorzystać do optymalizacji zasobów
czas użytkowania i uruchamiania. Ustawienia na tej stronie zaczną obowiązywać dopiero po ponownym uruchomieniu
Dziecko3.

Ustawienia → Konfiguruj skróty...
Otwiera okno dialogowe, w którym można przypisać skróty klawiaturowe do większości funkcji programu. Tam
są nawet funkcje bez odpowiedniego menu lub przycisku, np. następny plik,
poprzedni plik, zaznacz wszystko.

Połączenia Pomoc Menu
Pomoc → Podręcznik Kid3
Otwiera ten podręcznik.

Pomoc → O Kid3
Wyświetla krótką informację o Kid3;.

KID3-CLI

Polecenia
kid3-cli oferuje interfejs wiersza poleceń dla Kid3. Jeśli używana jest ścieżka do katalogu,
katalog jest otwarty. Jeśli podano jedną lub więcej ścieżek do plików, otwierany jest wspólny katalog
i pliki są wybrane. Kolejne polecenia będą wtedy działać na tych plikach. Polecenia
są określone za pomocą -c opcje. W przypadku przekazania wielu poleceń są one wykonywane w
podane zamówienie. Jeśli pliki zostaną zmodyfikowane przez polecenia, zostaną zapisane na końcu. Jeśli nie
opcje poleceń są przekazywane, kid3-cli uruchamia się w trybie interaktywnym. Polecenia można wprowadzać
i będzie działać na bieżącym wyborze. Poniższe sekcje zawierają listę wszystkich dostępnych
Polecenia.

Pomoc
pomoc [POLECENIE-NAZWA]

Wyświetla pomoc dotyczącą parametrów POLECENIE-NAZWA lub o wszystkich poleceniach, jeśli nie ma polecenia
imię jest podane.

Timeout
Timeout [domyślnie | wyłączony | CZAS]

Zastąp domyślny limit czasu polecenia. Polecenia CLI są przerywane po konkretnym poleceniu
upłynął limit czasu. Ten limit czasu wynosi 10 sekund dla ls i okładka albumu, 60 sekund dla
automatyczny import i filtrowaći 3 sekundy dla wszystkich pozostałych poleceń. Jeśli ogromna liczba plików
musi zostać przetworzony, te limity czasu mogą być zbyt restrykcyjne, dlatego limit czasu dla wszystkich
polecenia można ustawić na CZAS ms, całkowicie wyłączone lub pozostawione domyślnie
wartości.

porzucić aplikacja
wyjście [zmuszać]

Wyjdź z aplikacji. Jeśli istnieją zmodyfikowane niezapisane pliki, siła parametr to
wymagane.

zmiana katalog
cd [KATALOG]

Jeśli nie KATALOG jest podany, przejdź do katalogu domowego. Jeśli podano katalog,
przejdź do katalogu. Jeśli podano jedną lub więcej ścieżek do plików, zmień ich wspólne
katalogu i wybierz pliki.

dotychczasowy aktualne pracujący katalog
Pwd

Wydrukuj nazwę pliku bieżącego katalogu roboczego.

Informator podstęp
ls

Wypisz zawartość bieżącego katalogu. Odpowiada to liście plików w
Kid3 GUI. Cztery znaki przed nazwami plików pokazują stan pliku.

· > Wybrano plik.

· * Plik został zmodyfikowany.

· 1 Plik ma znacznik 1, w przeciwnym razie wyświetlany jest znak '-'.

· 2 Plik ma znacznik 2, w przeciwnym razie wyświetlany jest znak '-'.

kid3-cli> ls
1- 01 Wstęp.mp3
> 12 02 Mamy tylko ten.mp3
*1- 03 Zakończenie.mp3

W tym przykładzie wszystkie pliki mają znacznik 1, drugi plik również ma znacznik 2 i jest
wybrany. Trzeci plik został zmodyfikowany.

Zapisz dotychczasowy zmieniony pliki
zapisać

Wybierz filet
wybierać [wszystkie | brak | pierwszy | poprzedni | następny | FILE...]

Aby wybrać wszystkie pliki, wprowadź wybierać cała kolekcja, aby odznaczyć wszystkie pliki, wprowadź wybierać Żaden, Do
przeszukuj pliki w bieżącym katalogu zaczynając od wybierać drugim, to idź dalej
za pomocą wybierać Następny lub wstecz za pomocą wybierać poprzedni. Określone pliki można dodać do
aktualny wybór, podając ich nazwy plików. Możliwe są symbole wieloznaczne, więc wybierać
* .mp3 wybierze wszystkie pliki MP3 w bieżącym katalogu.

kid3-cli> wybierać drugim
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Mamy tylko ten.mp3
*1- 03 Zakończenie.mp3
kid3-cli> wybierać Następny
kid3-cli> ls
1- 01 Wstęp.mp3
> 12 02 Mamy tylko ten.mp3
*1- 03 Zakończenie.mp3
kid3-cli> wybierać * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 Mamy tylko ten.mp3
>*1- 03 Outro.mp3

Wybierz etykieta
etykieta [NUMERY TAGÓW]

Wiele poleceń ma opcjonalny NUMERY TAGÓW parametr, który określa, czy
komenda działa na tagu 1 lub tagu 2. Jeśli ten parametr zostanie pominięty, tag domyślny
używane są numery, które można ustawić za pomocą tego polecenia. Przy starcie jest ustawiony na 12, który
oznacza, że ​​informacja jest odczytywana ze znacznika 2, jeśli jest dostępna, w przeciwnym razie ze znacznika 1; modyfikacje
są zrobione na etykiecie 2. NUMERY TAGÓW można ustawić na 1 or 2 działać tylko na
odpowiedni tag. Jeśli parametr zostanie pominięty, wyświetlone zostanie aktualne ustawienie.

Get etykieta rama
otrzymać [wszystkie | NAZWA-RAMKI] [NUMERY TAGÓW]

To polecenie może być użyte do odczytania wartości określonej ramki tagu lub uzyskania informacji
o wszystkich ramkach znaczników (jeśli argument jest pominięty lub cała kolekcja jest używany). Zmodyfikowane ramki są
oznaczony '*'.

kid3-cli> otrzymać
Plik: MPEG 1 Layer 3 192 kb/s 44100 Hz Joint Stereo
Nazwa: 01 Intro.mp3
Etykieta 1: ID3v1.1
Wprowadzenie do tytułu
Artysta Jeden Hit Cud
Album Let's Tag
Data 2013
Numer utworu 1
Gatunek Pop
kid3-cli> otrzymać tytuł
Intro

Aby zapisać zawartość ramki obrazu do pliku, użyj

otrzymać obraz:"/ścieżka/do/folderu.jpg"

Aby zapisać zsynchronizowane teksty w pliku LRC, użyj

otrzymać SYLT:"/ścieżka/do/teksty.lrc"

Zestaw etykieta rama
zestaw {NAZWA-RAMKI} {WARTOŚĆ RAMKI} [NUMERY TAGÓW]

To polecenie ustawia wartość określonej ramki znacznika.

kid3-cli> zestaw remixer "OH Zastanawiać się"

Aby ustawić zawartość ramki obrazu z pliku, użyj

zestaw obraz:"/ścieżka/do/folderu.jpg" "Zdjęcie Opis"

Aby ustawić zsynchronizowane teksty z pliku LRC, użyj

zestaw SYLT:"/ścieżka/do/teksty.lrc" "Tekst piosenki Opis"

Przywróć
przywrócić

Cofnij wszystkie modyfikacje w wybranych plikach (lub we wszystkich plikach, jeśli nie ma plików
wybrany).

import od filet or schowek
importować {FILE} {FORMAT-NAZWA} [NUMERY TAGÓW]

Tagi są importowane z pliku FILE (lub ze schowka, jeśli schowek jest używany do
FILE) w formacie z nazwą FORMAT-NAZWA (na przykład „CSV nie cytowany", zobacz Importowanie).

automatycznie importować
automatyczny import [NAZWA PROFILU] [NUMERY TAGÓW]

Import wsadowy za pomocą profilu NAZWA PROFILU (patrz Automatyczny import, "Wszystko" jest używany, jeśli
pominięty).

Do pobrania album pokrywa Praca plastyczna
okładka albumu {URL} [wszystko]

Ustaw okładkę albumu, pobierając obraz z URL. Zasady określone w
Okno dialogowe Przeglądaj okładki służy do przekształcania ogólnych adresów URL (np. z Amazon) na
adres URL obrazu. Aby ustawić okładkę albumu z lokalnego pliku obrazu, użyj polecenia set.

kid3-cli> okładka albumu
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Export do filet or schowek
eksport {FILE} {FORMAT-NAZWA} [NUMERY TAGÓW]

Tagi są eksportowane do pliku FILE (lub do schowka, jeśli schowek jest używany do FILE) w
format z nazwą FORMAT-NAZWA (na przykład „CSV nie cytowany", patrz Eksport).

Stwórz playlista
playlista

Utwórz listę odtwarzania w formacie ustawionym w konfiguracji, zobacz Tworzenie listy odtwarzania.

Aplikuj filename format
format nazwy pliku

Zastosuj format nazwy pliku ustawiony w konfiguracji, zobacz Zastosuj format nazwy pliku.

Aplikuj etykieta format
format tagu

Zastosuj format nazwy znacznika ustawiony w konfiguracji, zobacz Zastosuj format znacznika.

Aplikuj XNUMX kodowanie
kodowanie tekstu

Zastosuj kodowanie tekstu ustawione w konfiguracji, zobacz Stosowanie kodowania tekstu.

przemianować katalog
zmieniona nazwa_kier [FORMAT] [utwórz | zmień nazwę | próba] [NUMERY TAGÓW]

Zmień nazwę lub utwórz katalogi z wartości w tagach zgodnie z podanym FORMAT
(na przykład %{artysta} - %{album}, zobacz Zmień nazwę katalogu), jeśli nie podano formatu, format
zdefiniowane w oknie dialogowym Zmień nazwę katalogu. Tryb domyślny to przemianować; tworzyć
katalogi, Stwórz muszą być podane wyraźnie. Zostaną wykonane akcje zmiany nazwy
natychmiast, aby zobaczyć, co zostanie zrobione, użyj próba opcja.

Numer utworów
liczba utworów [NUMER UTWORU] [NUMERY TAGÓW]

Ponumeruj wybrane utwory zaczynając od NUMER UTWORU (1 jeśli pominięto).

FILTRY
filtrować [NAZWA FILTRA | FILTR-FORMAT]

Filtruj pliki tak, aby tylko pliki pasujące do FILTR-FORMAT są widoczne. ten
nazwa predefiniowanego wyrażenia filtrującego (np. "Nazwa pliku etykieta Niedopasowanie") może być użyty
zamiast wyrażenia filtrującego zobacz Filtr.

kid3-cli> filtrować '%{tytuł} zawiera „tro”
Rozpoczęty
/home/urs/Cud jednego przeboju - Let's Tag
+ 01 Wstęp.mp3
- 02 Mamy tylko ten.mp3
+ 03 Outro.mp3
Gotowy
kid3-cli> ls
1- 01 Wstęp.mp3
1- 03 Zakończenie.mp3
kid3-cli> filtrować Wszystkie kategorie
Rozpoczęty
/home/urs/Cud jednego przeboju - Let's Tag
+ 01 Wstęp.mp3
+ 02 Mamy tylko ten.mp3
+ 03 Outro.mp3
Gotowy
kid3-cli> ls
1- 01 Wstęp.mp3
12 02 Mamy tylko ten.mp3
1- 03 Zakończenie.mp3

konwertować ID3v2.3 do ID3v2.4
do24

konwertować ID3v2.4 do ID3v2.3
do23

Nazwa pliku od etykieta
z tagu [FORMAT] [NUMERY TAGÓW]

Ustaw nazwy plików wybranych plików z wartości w tagach, na przykład z tagu
"%{ścieżka} - %{tytuł}" 1. Jeśli nie określono formatu, używany jest format ustawiony w GUI.

etykieta od filename
tagować [FORMAT] [NUMERY TAGÓW]

Ustaw ramki znaczników z nazw plików, na przykład tagować "%{album artysty} -
%{album}/%{utwór} %{tytuł}" 2. Jeśli nie określono formatu, format ustawiony w GUI to
używany. Jeśli format nazwy pliku nie pasuje do tego wzorca, kilka innych często
używane formaty są wypróbowywane.

etykieta do inny etykieta
synchronizować {NUMER ZNACZNIKA}

Skopiuj ramki tagów z jednego tagu do drugiego tagu, np. aby ustawić tag ID3v2 z
Tag ID3v1, użyj synchronizować 2.

Skopiuj
kopia [NUMER ZNACZNIKA]

Skopiuj ramki znaczników wybranego pliku do wewnętrznego bufora kopiowania. Mogą wtedy być
ustawić na innym pliku za pomocą makaron dowództwo.

makaron
makaron [NUMER ZNACZNIKA]

Ustaw ramki znaczników z zawartości kopia bufor w wybranych plikach.

Usunąć
usunąć [NUMER ZNACZNIKA]

Usuń tag.

Grać
grać [pauza | przestań | poprzedni | Następny]

Rozpocznij odtwarzanie dźwięku. Po uruchomieniu można nim sterować za pomocą pauza
(wstrzymać i wznowić), Zatrzymaj się, poprzedni i Następny opcje.

Przykłady
Ustaw okładkę albumu we wszystkich plikach katalogu za pomocą funkcji importu wsadowego:

kid3-cli -c „autoimport” "Okładka Sztuka"' /ścieżka/do/katalogu

Usuń ramki komentarzy i zastosuj format znaczników w obu znacznikach wszystkich plików MP3 w
katalog:

kid3-cli -c 'ustawić komentarz "" 1' -c 'ustawić komentarz "" 2' \
-c „format tagu” 1' -c „format tagu” 2' /ścieżka/do/katalogu/*.mp3

Automatycznie importuj tag 2, synchronizuj z tagiem 1, ustaw nazwy plików z tagu 2 i na koniec
utwórz listę odtwarzania:

kid3-cli -c automatyczny import -c 'syncto' 1' -c z tagu -c playlista \
/ścieżka/do/katalogu/*.mp3

Dla wszystkich plików z tagiem ID3v2.4.0, przekonwertuj do ID3v2.3.0 i usuń ramkę aranżera:

kid3-cli -c "filtr „ID3v2.4.0” Etykietka'" -c "Wybierz wszystko" -c do23 \
-c "ustawić zorganizować """ /ścieżka/do/katalogu

Ten skrypt Pythona używa kid3-cli do generowania ramek iTunes Sound Check iTunNORM z
odtwarzać informacje o zysku.

#!/usr/bin/env pyton
# Wygeneruj kontrolę dźwięku iTunes z ReplayGain.
z __future__ zaimportuj print_function
importuj system operacyjny, sys, podproces

def rg2sc(ścieżka katalogowa):
dla root, dirs, plików w os.walk(dirpath):
dla nazwy w plikach:
if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join(root, nazwa)
rg = podproces.check_output([
'kid3-cli', '-c', 'get "replaygain_track_gain"',
fn]).rozbieranie()
if rg.endswith(b'dB'):
rg = rg[:-3]
spróbuj:
rg = zmiennoprzecinkowa(rg)
z wyjątkiem ValueError:
print('Wartość %s z %s nie jest liczbą zmiennoprzecinkową' % (rg, fn))
kontynuować
sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
podproces.call([
'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])

jeśli __name__ == '__main__':
rg2sc(sys.argv[1])

KREDYTY ROLNICZE LICENCJA

Kid3

Program napisany przez Urs Fleisch

LDF[20]

LPG[21]

PORADY

W jaki sposób do uzyskać Kid3
Kid3 można znaleźć na http://kid3.sourceforge.net.

wymagania
Dziecko3 potrzeby Qt[22]. KDE[23] jest zalecane, ale nie konieczne, ponieważ Kid3 może być również skompilowany
jako aplikacja Qt. Kid3 można skompilować dla systemów, w których znajdują się te biblioteki
dostępne, np. dla GNU/Linux, Windows i Mac OS X. Aby oznaczyć pliki Ogg/Vorbis, Libogg[13],
biblioteka i plik libvorbis[14] są wymagane, dla plików FLAC bibliotekaFLAC++ i bibliotekaFLAC[15].
id3lib[12] służy do plików MP3. Te cztery formaty są również obsługiwane przez TagLib[16],
który obsługuje również pliki Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
i moduły śledzące. Aby zaimportować z akustycznych odcisków palców, Chromadruk[18] i Libav[19]
są używane.

Kid3 jest dostępny dla większości dystrybucji Linuksa, Windows i Mac OS X. Można znaleźć linki
on http://kid3.sourceforge.net.

Kompilacja i Instalacja
Możesz skompilować Kid3 z lub bez KDE. Bez KDE Kid3 jest prostą aplikacją Qt i
brakuje niektórych funkcji konfiguracyjnych i sesji.

W przypadku wersji KDE przejdź do głównego katalogu i wpisz

% cmake .
% robić
% robić zainstalować

Aby skompilować dla różnych wersji Qt lub KDE, ustaw odpowiedni cmake opcje.

Jeśli nie wszystkie biblioteki są obecne, Kid3 jest zbudowany ze zmniejszoną funkcjonalnością. Więc powinieneś
zadbaj o zainstalowanie wszystkich pożądanych pakietów rozwojowych. Z drugiej strony,
cmake-opcje kontrolują, które biblioteki są kompilowane. Domyślnie jest to -D
WITH_TAGLIB:BOOL=WŁ -D WITH_MP4V2:BOOL=WYŁ -D WITH_ID3LIB:BOOL=WŁ -D
WITH_CHROMAPRINT:BOOL=WŁ -D WITH_VORBIS:BOOL=WŁ -D Z_FLAC: BOOL=WŁ . Te opcje mogą:
być wyłączone za pomocą OFF.

Aby zbudować Kid3 jako aplikację Qt bez KDE, użyj cmake opcja -DWITH_APPS=Kt, Do
zbuduj zarówno aplikację KDE, jak i Qt, ustaw -DWITH_APPS="Qt;KDE".

Można użyć Qt 4 lub Qt 5. Aby wymusić użycie Qt 4, ustaw -DWITH_QT4=WŁ, aby wymusić użycie
Qt 5, zestaw -DWITH_QT5=WŁ, jeśli obie te opcje są wyłączone (domyślne), preferowane jest Qt 4, jeśli
obie wersje są zainstalowane. Aby użyć określonej instalacji Qt, ustaw
-DQT_QMAKE_EXECUTABLE=/ścieżka/do/qmake. Jeśli budowanie aplikacji KDE jest włączone, ustawienie
Qt 4 użyje KDE 4, podczas gdy ustawienie Qt 5 użyje KDE 5.

Generowanie pakietów RPM jest obsługiwane przez plik kid3.spec, dla pakietów Debiana,
dostępny skrypt build-deb.shis.

Aplikację Qt można również skompilować dla systemów Windows i Mac OS X. Skrypty w
foldery win32 i macosx mogą być używane do budowania i tworzenia pakietów. Biblioteki mogą być
zainstalowany przy użyciu buildlibs.sh.

systemu
W KDE filtr i format nazwy pliku, formaty importu, nazwa pliku i ID3
formaty, ustawienia paska narzędzi i paska stanu oraz rozmiar okna zostaną zapisane w
standardowa lokalizacja w pliku kid3rc. Jako aplikacja Qt ten plik jest w
.config/Kid3/Kid3.conf. W systemie Windows konfiguracja jest przechowywana w rejestrze.

D-BUS INTERFACE

autobus D Przykłady
Wersje Qt 4 i KDE 4 w systemie Linux oferują interfejs D-Bus do sterowania Kid3 za pomocą skryptów.
Skrypty mogą być pisane w dowolnym języku z powiązaniami D-Bus (np. w Pythonie) i mogą być
dodane do akcji użytkownika w celu rozszerzenia funkcjonalności Kid3.

Artysta w tagu 2 bieżącego pliku można ustawić na wartość „One Hit Wonder” za pomocą
następujący kod:

Powłoka

dbus-send --dest=net.sourceforge.kid3 --print-reply=literał \
/Kid3 net.sourceforge.Kid3.setFrame int32:2 string:'Artysta' \
string:'Cud jednego uderzenia'

lub łatwiej z Qt qdbus (przeglądarka qdbus może być użyty do eksploracji interfejsu w GUI):

qdbus net.sourceforge.kid3 /Kid3 setFrame 2 Wykonawca \
'Artysta jednego przeboju'

Python

importuj dbus
dzieciak3 = dbus.SessionBus().get_object(
„net.sourceforge.dziecko3”, „/Dziecko3”)
kid3.setFrame(2, 'Artysta', 'Cud jednego uderzenia')

Perl

użyj Net::DBus;
$dziecko3 = Net::DBus->sesja->get_service(
"net.sourceforge.kid3")->get_object(
"/Kid3", "net.sourceforge.Kid3");
$kid3->setFrame(2, "Artysta", "Cud jednego uderzenia");

autobus D API
Interfejs API D-Bus jest określony w net.sourceforge.Kid3.xml. Interfejs Kid3 ma
następujące metody:

Otwarte filet or katalog
boolean openDirectory(ciąg znaków ścieżka);

ścieżka
ścieżka do pliku lub katalogu

Zwraca prawdę, jeśli OK.

Zapisz cała kolekcja zmodyfikowano pliki
boolean zapisz (unieważnij);

Zwraca prawdę, jeśli OK.

Get a szczegółowe błąd wiadomość pod warunkiem, by kilka metody
ciąg getErrorMessage(nieważne);

Zwraca szczegółowy komunikat o błędzie.

Przywróć zmiany in dotychczasowy wybrany pliki
cofnij (unieważnij);

Start an automatyczny partia importować
boolean Import partii (int32 tagMaska, ciąg Nazwa profilu);

tagMaska
maska ​​tagu (bit 0 dla tagu 1, bit 1 dla tagu 2)

Nazwa profilu
nazwa profilu importu partii do użycia

import tagi od a filet
boolean import z pliku (int32 tagMaska, ciąg ścieżka, intxnumx fmtIdx);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

ścieżka
ścieżka pliku

fmtIdx
indeks formatu

Zwraca prawdę, jeśli OK.

Do pobrania album pokrywa sztuka
pobierzArtykułAlbumu(string url, boolean allFilesInDir);

url
URL pliku obrazu lub zasobu okładki albumu

allFilesInDir
true dodać obraz do wszystkich plików w katalogu

Export tagi do a filet
boolean eksport do pliku (int32 tagMaska, ciąg ścieżka, intxnumx fmtIdx);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

ścieżka
ścieżka pliku

fmtIdx
indeks formatu

Zwraca prawdę, jeśli OK.

Stwórz a playlista
boolean utwórzlistęodtwarzania(unieważnij);

Zwraca prawdę, jeśli OK.

porzucić dotychczasowy aplikacja
zakończ (unieważnij);

Wybierz cała kolekcja pliki
wybierzWszystko(nieważne);

Odznacz cała kolekcja pliki
odznacz wszystko (unieważnij);

Zestaw dotychczasowy drugim filet as dotychczasowy aktualne filet
boolean pierwszyPlik(nieważny);

Zwraca prawdę, jeśli istnieje pierwszy plik.

Zestaw dotychczasowy poprzedni filet as dotychczasowy aktualne filet
boolean poprzedniPlik(nieważny);

Zwraca prawdę, jeśli istnieje poprzedni plik.

Zestaw dotychczasowy Następny filet as dotychczasowy aktualne filet
boolean następnyPlik(nieważny);

Zwraca prawdę, jeśli istnieje następny plik.

Wybierz dotychczasowy drugim filet
boolean wybierzPierwszyPlik(nieważny);

Zwraca prawdę, jeśli istnieje pierwszy plik.

Wybierz dotychczasowy poprzedni filet
boolean wybierzPoprzedniPlik(nieważny);

Zwraca prawdę, jeśli istnieje poprzedni plik.

Wybierz dotychczasowy Następny filet
boolean wybierzNastępnyPlik(nieważne);

Zwraca prawdę, jeśli istnieje następny plik.

Wybierz dotychczasowy aktualne filet
boolean wybierzBieżącyPlik (nieważny);

Zwraca prawdę, jeśli istnieje bieżący plik.

Rozszerzać or upadek dotychczasowy aktualne filet pozycja if it is a katalog
boolean rozwińKatalog(unieważnij);

Elementem listy plików jest katalog, jeśli getFileName() zwraca nazwę z „/” jako ostatnią
znaków.

Zwraca prawdę, jeśli bieżący element pliku jest katalogiem.

Aplikuj dotychczasowy filet Nazwa format
ApplyFilenameFormat(void);

Aplikuj dotychczasowy etykieta format
zastosuj FormatTag(unieważnij);

Aplikuj XNUMX kodowanie
zastosuj kodowanie tekstu (nieważne);

Zestaw dotychczasowy katalog Nazwa od dotychczasowy tagi
boolean setDirNameFromTag(int32 tagMaska, ciąg format, boolean Stwórz);

tagMaska
maska ​​tagu (bit 0 dla tagu 1, bit 1 dla tagu 2)

format
format nazwy katalogu

Stwórz
prawda do stworzenia, fałsz do zmiany nazwy

Zwraca true, jeśli OK, w przeciwnym razie komunikat o błędzie jest dostępny za pomocą funkcji getErrorMessage().

Zestaw kolejny śledzić z naszej in dotychczasowy wybrany pliki
liczba utworów (int32 tagMaska, intxnumx pierwszyTrackNr);

tagMaska
maska ​​tagu (bit 0 dla tagu 1, bit 1 dla tagu 2)

pierwszyTrackNr
numer do użycia w pierwszym pliku

FILTRY dotychczasowy pliki
filtr (ciąg wyrażenie);

wyrażenie
wyrażenie filtrujące

konwertować ID3v2.3 tagi do ID3v2.4
konwertuj naId3v24 (nieważne);

konwertować ID3v2.4 tagi do ID3v2.3
konwertuj naId3v23 (nieważne);

Zwraca prawdę, jeśli OK.

Get ścieżka of katalog
ciąg pobierzNazwaKatalogu(unieważnij);

Zwraca bezwzględną ścieżkę katalogu.

Get Nazwa of aktualne filet
ciąg pobierzNazwęPliku(unieważnij);

Zwraca prawdziwą bezwzględną nazwę pliku, kończącą się na „/”, jeśli jest to katalog.

Zestaw Nazwa of wybrany filet
setNazwaPliku(string Nazwa);

Nazwa
Nazwa pliku

Nazwa pliku zostanie zmieniona po zapisaniu katalogu.

Zestaw format do posługiwać się jeśli chodzi o komunikację i motywację ustawienie dotychczasowy filename od dotychczasowy tagi
setFileNameFormat (string format);

format
format nazwy pliku

Zestaw dotychczasowy filet Nazwy of dotychczasowy wybrany pliki od dotychczasowy tagi
ustawNazwęPlikuZTag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Get wartość of rama
ciąg pobierzFrame(int32 tagMaska, ciąg Nazwa);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Nazwa
nazwa kadru (np. „artysta”)

Aby uzyskać dane binarne, takie jak obraz, nazwę pliku do zapisu można dodać po
Nazwa, np. „Obraz:/ścieżka/do/pliku”. W ten sam sposób zsynchronizowane teksty mogą być:
eksportowane, np. "SYLT:/ścieżka/do/pliku".

Zwraca wartość ramki.

Zestaw wartość of rama
boolean ustaw ramkę(int32 tagMaska, ciąg Nazwa, ciąg wartość);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Nazwa
nazwa kadru (np. „artysta”)

wartość
wartość ramki

Dla tagu 2 (tagMaska 2), jeśli nie ma ramki z Nazwa istnieje, dodawana jest nowa ramka, jeśli wartość is
pusty, ramka jest usuwana. Aby dodać dane binarne, takie jak obraz, można dodać plik
po Nazwa, np. „Obraz:/ścieżka/do/pliku”. „SYLT:/ścieżka/do/pliku” może służyć do
importuj zsynchronizowane teksty.

Zwraca prawdę, jeśli OK.

Get cała kolekcja Ramy of a etykieta
szyk of ciąg pobierzTag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Zwraca listę z naprzemiennymi nazwami ramek i wartościami.

Get techniczny Informacja O Varso Invest filet
szyk of ciąg pobierz informacje (nieważne);

Właściwości to Format, Bitrate, Samplerate, Kanały, Czas trwania, Tryb kanału, VBR, Tag
1, Tag 2. Niedostępne właściwości są pomijane.

Zwraca listę z naprzemiennymi nazwami i wartościami właściwości.

Zestaw etykieta od filet Nazwa
setTagFromFileName(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Zestaw etykieta od inny etykieta
setTagFromOtherTag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Skopiuj etykieta
kopiujTag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

makaron etykieta
wklejTag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Usunąć etykieta
usuń tag(int32 tagMaska);

tagMaska
bit tagu (1 dla tagu 1, 2 dla tagu 2)

Przeanalizuj dotychczasowy konfiguracja
reparseConfiguration (unieważnienie);

Zautomatyzowane zmiany konfiguracji są możliwe poprzez modyfikację pliku konfiguracyjnego i
następnie ponowne parsowanie konfiguracji.

Odtwarza dotychczasowy wybrany pliki
playAudio (nieważne);

QML INTERFACE

QML Przykłady
Skrypty QML można wywoływać za pomocą menu kontekstowego listy plików i można je ustawić w zakładce
Działania użytkownika w oknie dialogowym ustawień. Skrypty, które są tam ustawione, mogą być używane jako
przykłady programowania niestandardowych skryptów. QML wykorzystuje JavaScript, tutaj jest obowiązkowy "Hello
Świat":

importuj Kid3 1.0

Kid3Script {
w biegu: {
console.log("Witaj świecie, katalog jest", app.dirName)
Qt.zakończ()
}
}

Jeśli ten skrypt zostanie zapisany jako /ścieżka/do/Przykład.qml, polecenie użytkownika można zdefiniować jako @m_mr
/ścieżka/do/Przykład.qml z imieniem QML Testowanie i Wyjście sprawdzone. Następnie można go uruchomić za pomocą
element QML Test w menu kontekstowym listy plików, a wynik będzie widoczny w
okno.

Alternatywnie, skrypt mógłby zostać uruchomiony niezależnie od Kid3 przy użyciu narzędzi QML.

qmlviewer -I /usr/lib/kid3/plugins/imports /ścieżka/do/Przykład.qml

W przypadku Qt 5 polecenia

qml -apptype widget -I /usr/lib/kid3/plugins/imports /path/to/Example.qml

or

qmlscene -I /usr/lib/kid3/plugins/imports /ścieżka/do/Przykład.qml

może być użyty. W systemach Windows i OS X ścieżka importu musi być dostosowana do folderu importów
wewnątrz katalogu instalacyjnego. Skrypty uruchomione poza Kid3 będą używać bieżącego
katalog, więc należy go wcześniej zmienić.

Aby wyświetlić tytuły w znacznikach 2 wszystkich plików w bieżącym katalogu, wykonaj następujące czynności:
można użyć skryptu:

importuj Kid3 1.0

Kid3Script {
w biegu: {
aplikacja.firstFile()
zrobić {
if (app.selectionInfo.tagFormatV2)
console.log(app.getFrame(tagv2, "tytuł"))
} podczas (app.nextFile())
}
}

Jeśli katalog zawiera wiele plików, taki skrypt może zablokować interfejs użytkownika dla
czasami. W przypadku dłuższych operacji powinien więc mieć od czasu do czasu przerwę. ten
alternatywna implementacja poniżej przenosi pracę dla pojedynczego pliku do funkcji.
Ta funkcja wywołuje się z limitem czasu 1 ms na końcu, biorąc pod uwagę, że więcej plików ma
do przetworzenia. Zapewni to, że GUI pozostanie responsywny, gdy skrypt jest
uruchomiony.

importuj Kid3 1.0

Kid3Script {
w biegu: {
funkcja doPracuj() {
if (app.selectionInfo.tagFormatV2) {
console.log(app.getFrame(tagv2, "tytuł"))
}
if (!app.nextFile()) {
Qt.zakończ()
} Else {
setTimeout(doWork, 1)
}
}

aplikacja.firstFile()
wykonać pracę()
}
}

Więcej przykładowych skryptów jest dostarczanych z Kid3 i są już zarejestrowane jako polecenia użytkownika.

· ReplayGain do SoundCheck (ReplayGain2SoundCheck.qml): Utwórz iTunNORM SoundCheck
informacje z ramek wzmocnienia odtwarzania.

· Resize Album Art (ResizeAlbumArt.qml): Zmień rozmiar osadzonych okładek, które są
większy niż 500x500 pikseli.

· Wyodrębnij okładki albumu (ExtractAlbumArt.qml): Wyodrębnij wszystkie osadzone zdjęcia okładek
unikanie duplikatów.

· Osadź okładkę albumu (EmbedAlbumArt.qml): Osadź okładkę znalezioną w plikach graficznych w audio
pliki w tym samym folderze.

· Osadź teksty (EmbedLyrics.qml): Pobierz niezsynchronizowane teksty z serwisu internetowego.

· Kodowanie tekstu ID3v1 (ShowTextEncodingV1.qml): Pomaga znaleźć kodowanie tagów ID3v1
pokazując tagi bieżącego pliku we wszystkich dostępnych kodowaniach znaków.

· Export CSV (ExportCsv.qml): Eksportuj rekursywnie wszystkie tagi wszystkich plików do pliku CSV.

· Konsola QML (QmlConsole.qml): Prosta konsola do zabawy z API QML Kid3.

QML API
Interfejs API można łatwo przeglądać za pomocą konsoli QML, która jest dostępna jako przykład
skrypt z interfejsem użytkownika.

Kid3Script
Kid3Script to zwykły komponent QML znajdujący się w katalogu wtyczek. Mógłbyś
równie dobrze użyj innego komponentu QML. Korzystanie z Kid3Script ułatwia rozpoczęcie
funkcja skryptu za pomocą onRun obsługa sygnału. Ukrywa również różnice między
wersje QtQuick, aby skrypty były kompatybilne zarówno z Qt 4, jak i Qt 5.
Ponadto oferuje kilka funkcji:

onRun: moduł obsługi sygnału, który jest wywoływany podczas uruchamiania skryptu
tagv1, tagv2, tagv2v1: Stałe parametrów tagów
skrypt: Dostęp do funkcji skryptowych
configs: Dostęp do obiektów konfiguracyjnych
getArguments(): Lista argumentów skryptu
isStandalone(): prawda, jeśli skrypt nie został uruchomiony z Kid3
setTimeout(callback, delay): Rozpoczyna wywołanie zwrotne po opóźnieniu ms

Scripting Funkcje
Ponieważ JavaScript, a co za tym idzie również QML, ma tylko ograniczony zestaw funkcji do tworzenia skryptów,
dotychczasowy scenariusz obiekt ma kilka dodatkowych metod, na przykład:

script.properties(obj): Ciąg znaków z właściwościami Qt
script.writeFile(filePath, data): Zapisz dane do pliku, prawda, jeśli OK
script.readFile(filePath): Odczytaj dane z pliku
script.removeFile(filePath): Usuń plik, prawda, jeśli OK
script.fileExists(filePath): prawda, jeśli plik istnieje
script.renameFile(staraNazwa, nowaNazwa): zmień nazwę pliku, prawda, jeśli OK
script.tempPath(): ścieżka do katalogu tymczasowego
script.listDir(ścieżka, [nazwaFiltry], [klasyfikacja]): Lista wpisów katalogu
script.system(program, [args], [msecs]): Synchronicznie uruchom polecenie systemowe,
[kod wyjścia, standardowe wyjście, standardowy błąd] jeśli nie przekroczono limitu czasu
script.getEnv(varName): Pobierz wartość zmiennej środowiskowej
script.setEnv(varName, value): Ustaw wartość zmiennej środowiskowej
script.getQtVersion(): ciąg wersji Qt, np. „5.4.1”
script.getDataMd5(data): Uzyskaj ciąg szesnastkowy z hasza MD5 danych
script.getDataSize(data): Pobierz rozmiar tablicy bajtów
script.dataToImage(data, [format]): Utwórz obraz z bajtów danych
script.dataFromImage(img, [format]): Pobierz bajty danych z obrazu
script.loadImage(filePath): Załaduj obraz z pliku
script.saveImage(img, filePath, [format]): Zapisz obraz do pliku, prawda, jeśli OK
script.imageProperties(img): Pobierz właściwości obrazu, mapy zawierającej
"width", "height", "depth" i "colorCount", puste, jeśli obraz jest nieprawidłowy
script.scaleImage(img, width, [height]): Skaluje obraz, zwraca przeskalowany obraz
script.selectFileName(caption, dir, filter, saveFile): Otwórz okno dialogowe pliku, aby
Wybierz plik

Zastosowanie Kontekst
Używając QML, dostępna jest duża część funkcji Kid3. API jest podobne do
ten używany do D-Bus. Szczegółowe informacje znajdują się w odpowiednich uwagach.

app.openDirectory(ścieżka): Otwórz katalog
app.saveDirectory(): Zapisz katalog
app.revertFileModifications(): Przywróć
app.importTags(znacznik, ścieżka, fmtIdx): Importuj plik
app.downloadImage(url, allFilesInDir): Pobierz obraz
app.exportTags(tag, path, fmtIdx): Eksportuj plik
app.writePlaylist(): Napisz listę odtwarzania
app.selectAllFiles(): Zaznacz wszystko
app.deselectAllFiles(): Odznacz
app.firstFile([wybierz]): Do pierwszego pliku
app.nextFile([wybierz]): Do następnego pliku
app.previousFile([wybierz]): Do poprzedniego pliku
app.selectCurrentFile([wybierz]): Wybierz bieżący plik
app.requestExpandFileList(): Rozwiń wszystko
app.applyFilenameFormat(): Zastosuj format nazwy pliku
app.applyTagFormat(): Zastosuj format tagu
app.applyTextEncoding(): Zastosuj kodowanie tekstu
app.numberTracks(nr, total, tag, [options]): Liczba utworów
app.applyFilter(expr): Filtr
app.convertToId3v23(): Konwertuj ID3v2.4.0 na ID3v2.3.0
app.convertToId3v24(): Konwertuj ID3v2.3.0 na ID3v2.4.0
app.getFilenameFromTags(tag): Nazwa pliku z tagów
app.getTagsFromFilename(tag): Nazwa pliku do tagów
app.getAllFrames(tag): Pobierz obiekt ze wszystkimi ramkami
app.getFrame(tag, nazwa): Pobierz ramkę
app.setFrame(tag, nazwa, wartość): Ustaw ramkę
app.getPictureData(): Pobierz dane z ramki obrazu
app.setPictureData(data): Ustaw dane w ramce obrazu
app.copyToOtherTag(tag): Tagi do innych tagów
app.copyTags(tag): Kopiuj
app.pasteTags(tag): Wklej
app.removeTags(tag): Usuń
app.playAudio(): Odtwórz
app.readConfig(): Odczytaj konfigurację
app.applyChangedConfiguration(): Zastosuj konfigurację
app.dirName: nazwa katalogu
app.selectionInfo.fileName: Nazwa pliku
app.selectionInfo.filePath: Bezwzględna ścieżka do pliku
app.selectionInfo.detailInfo: Szczegóły formatu
app.selectionInfo.tagFormatV1: Format tagu 1
app.selectionInfo.tagFormatV2: Format tagu 2
app.selectionInfo.formatString(tag, format): Zastąp kody w ciągu formatu

W przypadku operacji asynchronicznych wywołania zwrotne mogą być połączone z sygnałami.

function AutomaticImport(profil) {
funkcja onAutomaticImportFinished() {
app.batchImporter.finished.disconnect(onAutomaticImportFinished)
}
app.batchImporter.finished.connect(onAutomaticImportFinished)
app.batchImport(profil, tagv2)
}

funkcja zmień nazwęKatalog(format) {
funkcja onRenameActionsScheduled() {
app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
app.performRenameActions()
}
app.renameActionsScheduled.connect(onRenameActionsScheduled)
app.renameDirectory(tagv2v1, format, false)
}

systemu Obiekty
Różne sekcje konfiguracyjne są dostępne za pomocą metod configs. Ich
właściwości można wyświetlić w konsoli QML.

skrypt.properties(configs.networkConfig())

Właściwości można ustawić:

configs.networkConfig().useProxy = fałsz

configs.batchImportConfig()
konfiguracje.exportConfig()
configs.plikConfig()
configs.nazwaplikuFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
konfiguracje.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
konfiguracje.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()

Korzystaj z kid3-core online, korzystając z usług onworks.net