Potok importu

Import zamienia folder plików we wpis w katalogu bez modyfikowania bajtu plików. Ta strona stanowi potok umożliwiający przepływ opisany w przewodniku użytkowania.

Skanowanie

Obserwowane foldery są monitorowane przez zdarzenia systemu plików platformy, odszumiane i ponownie skanowane po zmianie; skany uzgadniają się z istniejącą listą kandydatów zamiast zaczynać od zera. Skaner klasyfikuje folder jako jedno wydanie (audio bezpośrednio wewnątrz albo podfoldery w kształcie płyt, takie jak CD1/CD2) albo wchodzi do niego rekurencyjnie jako kolekcji. Pliki są klasyfikowane według rozszerzenia jako audio, grafiki i dokumenty, a potem audio jest sondowane: liczy się kodek znaleziony przez FFmpeg w bajtach, nie rozszerzenie pliku. Foldery zawierające znaczniki częściowego pobierania są wykluczane do zakończenia pobierania.

Arkusz CUE zamienia jeden obraz audio w listę utworów. Parser obsługuje pregapy i postgapy, wykonawców i ISRC per utwór oraz układy CUE z obrazem jednoplikowym i z jednym plikiem na utwór. Granice utworów są konwertowane z ramek CUE (1/75 sekundy) na dokładne pozycje próbek, które później stają się oknami bajtów i próbek używanymi przez odtwarzanie.

Szkice metadanych

Każdy kandydat przechowuje jeden edytowalny szkic metadanych i opcjonalne pochodzenie. Szkic może być pusty, wypełniony bezpośrednio, wypełniony z zewnętrznego wydania lub wypełniony z przechowywanej migawki znacznika pliku. Rejestry pochodzenia, gdzie rozpoczął się bieżący szkic; późniejsze edycje nie usuwają go. Bezpośrednie wprowadzenie i wyczyszczony szkic nie mają pochodzenia.

Górne gniazdo metadanych wyświetla albo wersję roboczą, przeglądarkę Znajdź online lub przeglądarkę Tagi plików.Otwarcie lub zamknięcie przeglądarki nie powoduje przepisania wersji roboczej. Zastosujing źródła zastępuje wersję roboczą, jej pochodzenie i wybraną okładkę źródła w jednej transakcji bazy danych przy zachowaniu ról plików, powiązań CUE, przydziałów dysków i innych decyzji dotyczących mapowania.

Znajdź online

Znajdź online jest jedyną ścieżką, która uruchamia identyfikację. Oblicza DiscID z dziennika zgrywania lub arkusza CUE, rozpoznaje kody kreskowe i tekst katalogu za pomocą OCR, zapytania MusicBrainz i Discogs i dopasowuje wyniki.

Ustawienie Domyślne źródło metadanych ma trzy wartości. Brak tworzy pustą wersję roboczą i nie rozpoczyna pracy z metadanymi. Tagi plików odczytują i stosują migawkę tagów. Znajdź online otwiera proces online. Domyślny tryb Znajdź online wybiera Automatycznie, które ustawia w kolejce pozyskiwanie dowodów, zapytania do dostawców i dopasowywanie, albo Wyszukaj ręcznie, które nie rozpoczyna identyfikacji. Znajdź online używa wybranego trybu dla każdego kandydata; Automatycznie nie uruchamia ponownie aktywnego ani zakończonego procesu.

Tagi plików

Tagi plików odczytuje osadzone znaczniki audio i metadane CUE leniwie, chyba że jest to skonfigurowane domyślnie dla nowo odkrytego kandydata. Podgląd przechowuje migawkę z pieczęcią generowania skanowania kandydata, wersji edycji pliku i obserwowanych plików audio. Zastosuj zastępuje wersję roboczą z tej dokładnej migawki. Import zużywa tę samą migawkę i kończy się niepowodzeniem, zanim biblioteka zapisuje, jeśli zmieni się jej pieczęć lub obserwacje; nie odczytuje innej odpowiedzi.

Wprowadzanie bezpośrednie nie wykonuje żadnych operacji I/O metadanych. Pola wydania i śledzenia pustej wersji roboczej można edytować natychmiast, a wersja robocza staje się importowalna po zatwierdzeniu wymaganych pól i mapowania. Lista kandydatów nie traktuje brakujących źródeł jako błędu lub prośby o uwagę.

Źródła

MusicBrainz jest odpytywany anonimowo w ścisłym tempie jednego żądania na sekundę. Discogs uwierzytelnia się osobistym tokenem użytkownika z pęku kluczy, mieści się w limitach i ponawia w ich ramach, a odrzucony token jest zgłaszany jako taki, żeby interfejs mógł go oznaczyć zamiast po cichu psuć wyszukiwania. Odpowiedzi są cache’owane per sesja, a surowy JSON źródła, które wygrało, jest archiwizowany w bazie danych do przyszłej ponownej interpretacji.

Zapis

Potwierdzenie importu uruchamia po kolei:

1. Weryfikację dekodowania: każdy utwór jest dekodowany od początku do końca; rip, którego nie da się w pełni zdekodować, przerywa import, zanim cokolwiek zostanie zapisane (flaga konfiguracji może to wyłączyć).
2. Analizę głośności: zintegrowana głośność i true peak są mierzone dla utworu i dla albumu podczas tego samego przebiegu dekodowania, przechowywane do użycia przez replay gain.
3. Wybór okładki: wybrana grafika (zdalna, obraz z folderu albo osadzona) jest ponownie renderowana do miniatury wyświetlania; oryginał zostaje wśród plików wydania, jeśli pochodził z folderu.
4. Atomowy zapis: wydanie, utwory, przypisania, tożsamości, formaty, segmenty, pliki i okładka zapisują się w jednej transakcji. Nie istnieje stan częściowo zaimportowany.

Wydanie trafia do biblioteki, wskazując pliki użytkownika na miejscu. Jeśli użytkownik wybrał zarządzanie w chmurze, wysyłanie odbywa się po zapisie jako przejście przechowywania, a oryginalne bajty plików pozostają źródłem prawdy przez cały czas; nic, co użytkownik dał bae, nie jest nigdy usuwane ani zmieniane.

Rozpoznawanie ripów

Każde wydanie zapisuje hash treści struktury importowanego folderu (ścieżki względne i rozmiary, niezależne od lokalizacji). Ponowne skany używają go, aby oznaczyć foldery już obecne w bibliotece, a ponowne importy tego samego ripu znajdują i zastępują wcześniejsze wydanie zamiast je duplikować.