Dokumentacja Biblioteka
Skanowanie biblioteki
Znajdź nowe, zmienione i usunięte pliki muzyczne oraz zaktualizuj bibliotekę Rainy.
Rainy prowadzi bazę danych utworów z Twojego folderu z muzyką. Skanowanie czyta ten folder i aktualizuje bazę, aby się z nim zgadzała: nowe pliki są dodawane, zmienione pliki odczytywane ponownie, a pliki, które już nie istnieją, są usuwane. Skanowania uruchamia administrator. Pozostałe konta nie widzą elementów sterujących skanowaniem.

Skanowanie biblioteki w Ustawieniach, w sekcji Konserwacja. Liczba utworów i czas ostatniego skanowania aktualizują się po każdym uruchomieniu.
Szybkie skanowanie i pełne skanowanie
Rainy oferuje dwa rodzaje skanowania. Oba dodają nowe pliki i usuwają utwory, których pliki zniknęły. Różnią się tym, które pliki czytają.
| Szybkie skanowanie | Pełne skanowanie | |
|---|---|---|
| Jakie pliki czyta | Tylko nowe pliki oraz pliki, których data modyfikacji zmieniła się od ostatniego skanowania | Każdy plik w folderze |
| Dobre do | Wykrywania plików, które skopiowałeś | Odświeżenia tagów po edycji wielu plików naraz |
| Szybkość | Szybkie, nawet przy dużych bibliotekach | Wolne, bo każdy plik jest otwierany ponownie |
Jeśli zmieniłeś tagi pliku, a data modyfikacji się nie zmieniła, Szybkie skanowanie nie zobaczy nowych tagów. Zamiast tego uruchom Pełne skanowanie.
Aby uruchomić skanowanie:
- Otwórz Ustawienia z menu konta i przejdź do Konserwacja.
- Sprawdź Stan biblioteki i Ostatnie skanowanie na karcie Skanowanie biblioteki.
- Kliknij Szybkie skanowanie albo Pełne skanowanie.
- Poczekaj, aż przycisk zostanie wyłączony, a wyświetlany będzie komunikat o postępie.
- Odczytaj wynik: liczbę znalezionych, dodanych, zaktualizowanych i usuniętych plików.
W danym momencie może działać tylko jedno skanowanie. Jeśli skanowanie już trwa, Rainy to zgłasza zamiast uruchamiać kolejne.Note: Ponowne skanowania zachowują identyfikator każdego utworu. Polubienia, playlisty i historia pozostają przypisane do utworu tak długo, jak jego plik zostaje w tej samej ścieżce w folderze z muzyką.
Skanowane są też podfoldery. Gdy skanowanie ponownie odczyta plik, którego tagi są puste, Rainy zachowuje tytuł, wykonawcę, album, gatunek i rok, które dany utwór już ma.
Obsługiwane formaty
Skanowanie zwraca uwagę tylko na pliki z tymi rozszerzeniami. Pozostałe pliki w folderze są ignorowane.
| Format | Rozszerzenie |
|---|---|
| MP3 | .mp3 |
| FLAC | .flac |
| WAV | .wav |
| OGG Vorbis | .ogg |
| Opus | .opus |
| MPEG-4 audio | .m4a |
| AAC | .aac |
| Windows Media Audio | .wma |
| Matroska z dźwiękiem | .mkv |
Pliki MKV odczytuje się przez ffmpeg i ffprobe, więc serwer musi mieć zainstalowane ffmpeg. Konfiguracja Dockera je zawiera. Samodzielna instalacja wymaga, by ffmpeg był w ścieżce systemowej. Zobacz Instalacja.
Okładki z plików
Gdy skanowanie znajdzie osadzony obraz w pliku, Rainy zapisuje go jako okładkę utworu. Okładki są odczytywane z plików MP3, WAV, FLAC, M4A, AAC, OGG, Opus i MKV. Pliki WMA są skanowane pod kątem tagów, ale ich osadzone obrazy nie są odczytywane.
Rainy zapisuje każdą okładkę w folderze covers wewnątrz folderu z muzyką:
- Nazwa pliku to skrót ścieżki utworu, więc każdy utwór ma własną okładkę.
- Rozszerzenie zależy od typu obrazu:
.jpg,.png,.webplub.gif. Wszystko inne zapisywane jest jako.jpg. - Jeśli ten sam obraz jest już zapisany, Rainy zostawia istniejący plik w spokoju.
Rainy serwuje okładki wyłącznie z folderu covers. Zostaw go na miejscu. Utwory bez osadzonego obrazu pokazują symbol zastępczy. Aby zmienić tagi lub okładkę utworu po skanowaniu, zobacz Metadane i okładki.
Przenoszenie i zmiana nazw plików
Rainy rozpoznaje utwór po jego ścieżce w folderze z muzyką. Jeśli przeniesiesz lub przemianujesz plik, kolejne skanowanie potraktuje go jako nowy utwór i usunie stary wpis. Polubienia, miejsca na playlistach i historia odtworzeń starego wpisu znikają razem z nim.
Zmieniaj nazwy lub przenoś pliki tylko wtedy, gdy możesz stracić oceny, miejsca na playlistach i historię starego utworu. Aby zachować jedną z dwóch kopii utworu, użyj duplikatów.
Przerwane skanowania
Jeśli Rainy zatrzyma się w trakcie skanowania, na przykład podczas ponownego uruchamiania, skanowanie może pozostać oznaczone jako trwające. Kolejne skanowania zgłoszą wtedy, że skanowanie jest już w toku.