Dokumentacja Importy i metadane
Znajdowanie metadanych i okładek
Popraw tytuł, wykonawcę, album i okładkę utworu na podstawie YouTube Music oraz uzupełnij cechy dźwięku, tagi i podobnych wykonawców z darmowych baz danych.
Zaimportowane i zeskanowane utwory mają tagi, które były już w ich plikach, a często są niekompletne lub błędne. Rainy daje dwa narzędzia do ich poprawy. Znajdź metadane wyszukuje utwór w YouTube Music i kopiuje wybrane dane do Twojej biblioteki. Analizuj utwór mierzy sam dźwięk i wyszukuje tagi oraz podobnych wykonawców w darmowych bazach danych.
Znajdowanie metadanych utworu
Znajdź metadane jest dostępne dla administratorów. Pozostałe konta nie widzą tej opcji.
- Otwórz menu utworu w swojej bibliotece.
- Najedź na Narzędzia utworu, a następnie kliknij Znajdź metadane.
- Rainy od razu szuka w YouTube Music frazy „tytuł wykonawca”. Jeśli wyniki nie są właściwe, zmień tekst wyszukiwania i naciśnij przycisk szukania.
- Kliknij Zastosuj przy wybranym wyniku.

Znajdź metadane. Wyniki pokazują okładkę, tytuł, wykonawcę, album i długość.
Gdy zastosujesz wynik, Rainy aktualizuje tytuł, wykonawcę i album, rok, jeśli wynik go zawiera, oraz okładkę. Z pola wykonawcy usuwane są powtórzone nazwy, więc „A, A” staje się „A”.
Utwór jest zapisany raz dla całego serwera. Zmiany, które tutaj zastosujesz, widzi każde konto, które może odtwarzać ten utwór.
Okładki
Okładka jest pobierana do folderu covers wewnątrz folderu z muzyką. Jej nazwa to skrót ścieżki pliku utworu, więc każdy utwór ma własny plik. Rainy prosi YouTube Music o większy obraz, jeśli jest dostępny. Nowa okładka od razu zastępuje starą w bibliotece.
Czego Znajdź metadane nie zmienia
Gatunek nie jest uzupełniany na podstawie wyników wyszukiwania, więc Znajdź metadane nie może go ustawić. Etykiety gatunków pochodzą z poniższej analizy albo z tagów samego pliku.
Analizowanie utworu
Analiza mierzy dźwięk jednego utworu i zbiera o nim informacje. Aby ją uruchomić:
- Otwórz menu utworu, najedź na Narzędzia utworu i kliknij Ustawienia utworu.
- Otwórz kartę Metadane.
- Kliknij Analizuj utwór. Gdy utwór zostanie już przeanalizowany, przycisk brzmi Przeanalizuj utwór ponownie.
Karta pokazuje wtedy:
- Profil audio: tempo, tonację i tryb, głośność, taneczność, energię i barwę dźwięku.
- Tagi i gatunek: etykiety z klasyfikatora działającego na urządzeniu, Last.fm i MusicBrainz.
- Podobne do…: wykonawców, których Last.fm wskazuje jako zbliżonych do wykonawcy utworu.
- Identyfikator MusicBrainz: identyfikator nagrania w bazie MusicBrainz.

Karta Metadane. Po uruchomieniu analizy pokazuje te same sekcje.
Każda część analizy wymaga czegoś innego od Ciebie:
| Część | Czego potrzebuje | Co konfigurujesz |
|---|---|---|
| Profil audio | Nic. Jest obliczany na serwerze z pliku audio. | Nic. |
| Etykiety gatunków | Model klasyfikatora, około 18 MB, pobierany raz przy pierwszym użyciu ze strony essentia.upf.edu. | Dostęp do internetu przy pierwszym uruchomieniu. |
| Tagi Last.fm, podobni wykonawcy i biogramy | Bezpłatny klucz API Last.fm. | Ustaw LASTFM_API_KEY w pliku .env i uruchom Rainy ponownie. Bez klucza ten krok jest pomijany. |
| Identyfikator i tagi MusicBrainz | Dostęp do internetu. Bez klucza. | Nic. Rainy rozkłada zapytania do MusicBrainz w odstępach około 1,5 sekundy, więc duże uzupełnianie trwa długo. |
| Wyszukiwanie w Znajdź metadane | Dostęp do internetu do YouTube Music. Bez klucza. | Nic. |
Bezpłatny klucz Last.fm uzyskasz pod adresem last.fm/api/account/create. Zajmuje to około trzydziestu sekund.
Etykiety gatunków
Klasyfikator słucha utworu i przypisuje mu etykiety stylów Discogs, na przykład „Rock” lub „Electronic”. Najwyższa etykieta staje się gatunkiem utworu tylko wtedy, gdy obecny gatunek wygląda na symbol zastępczy, na przykład „Music” z słabo otagowanego pliku. Prawdziwy tag gatunku jest zachowywany.
Analizowanie wielu utworów
Analiza działa też w tle. Każdy nowy utwór zeskanowany lub zaimportowany przez Rainy jest automatycznie dodawany do kolejki analizy. Aby przeanalizować utwory, którym wciąż brakuje danych, przejdź do Ustawienia → Zadania i znajdź kartę Analizuj metadane utworów:
- Kliknij Uruchom. Rainy analizuje tylko utwory, które nie były jeszcze analizowane.
- Obserwuj postęp na liście pod kartą albo zobacz, jak działa kolejka, w Kolejce importu.
Administratorzy widzą też przycisk Wymuś. Ponownie analizuje on całą bibliotekę od początku, co na dużej bibliotece zajmuje bardzo dużo czasu.
Analiza to nie to samo co Znajdź metadane. Uruchomienie analizy nie zmienia tytułów, wykonawców ani okładek.