Instrukcja obsługi

Instrukcja po polsku

1. Wersja i przeznaczenie

2. Wymagania i uruchomienie

Wymagania

• Windows 10 w wersji 2004 (build 19041) lub nowszy; zalecany Windows 11, system 64-bitowy.
• Kompletny katalog programu. Nie uruchamiaj samego HPLMusicWinUI.exe po skopiowaniu bez bibliotek, folderu Assets oraz narzędzi FFmpeg.
• Prawo zapisu w katalogu programu, potrzebne do zapisywania indeksu, ustawień, stacji radiowych i okładek.
• Połączenie z Internetem tylko dla okładek online, radia oraz Chromecast. INTERNET

Pierwsze uruchomienie

1. Rozpakuj cały folder aplikacji w wybrane miejsce.
2. Uruchom HPLMusicWinUI.exe.
3. Przy pierwszym starcie nie ma jeszcze indeksu; wybierz folder z muzyką i wykonaj indeksowanie.
4. Przy kolejnych uruchomieniach istniejący plik hpl_music_index.sqlite zostanie wczytany automatycznie.

3. Główne okno programu

Poniższy schemat pokazuje układ programu bez prywatnych ścieżek i nazw plików.

Znaczenie pasów

• Górny pasek: język PL/EN, styl GUI, przełącznik jasny/ciemny i logo.
• Pasek folderu: ścieżka biblioteki, wybór folderu oraz przycisk Indeksuj.
• Pasek narzędzi: okładki, odtwarzanie, Chromecast, radio, Bluetooth, wyszukiwanie, filtr typu, duplikaty i czyszczenie filtrów.
• Panel lewy: drzewo folderów z liczbą plików. Panel prawy: tabela nagrań.
• Pasek dolny: status i postęp indeksowania oraz wskazówka o dwukliku.

4. Indeksowanie biblioteki

Indeksowanie odczytuje tytuł, wykonawcę, album, rok, gatunek, czas, format, rozmiar i ścieżkę. Foldery bez uprawnień są pomijane bez zatrzymywania całego skanu. Wynik trafia do lokalnej bazy SQLite.

Obsługiwane rozszerzenia podczas skanowania

.aac .ac3 .aiff .dts .flac .m4a .mp3 .ogg .opus .wav .wma

5. Przeglądanie, wyszukiwanie i porządkowanie

Foldery i tabela

Kliknij dowolny folder w lewym drzewie. Lista po prawej pokaże pliki z wybranej gałęzi wraz z jej podfolderami. Kliknięcie nagłówka Format, Tytuł, Artysta, Album, Rok, Gatunek, Czas lub Plik sortuje kolumnę; kolejne kliknięcie odwraca kolejność.

Wyszukiwanie

1. Wpisz jedno lub kilka słów w pole wyszukiwania.
2. Naciśnij Enter albo kliknij Szukaj.
3. Każde wpisane słowo musi wystąpić w danych pliku. Przeszukiwane są m.in. tytuł, artysta, album, rok, gatunek, nazwa pliku, folder i pełna ścieżka.
4. Opcjonalnie wybierz rozszerzenie w polu Typ. Filtr typu może działać samodzielnie lub razem z tekstem.

Duplikaty

Duplikaty pokazują pliki mające tę samą nazwę i ten sam rozmiar. Program niczego automatycznie nie usuwa. Zweryfikuj ścieżki i usuń zbędny plik samodzielnie w Eksploratorze Windows.

Wyczyść usuwa tekst wyszukiwania, filtr typu i widok wyników, a następnie przywraca drzewo biblioteki.

6. Edycja metadanych

1. Kliknij plik prawym przyciskiem.
2. Wybierz Edytuj metadane.
3. Zmień tytuł, artystę, album, rok lub gatunek.
4. Kliknij Zapisz.

7. Pobieranie okładek INTERNET DLA ŹRÓDŁA 2

1. Kliknij Pobieranie okładek.
2. Wybierz folder z bazy indeksu.
3. Wybierz jedno ze źródeł:
   • Źródło 1: z plików - odczytuje grafikę osadzoną w tagach audio.
   • Źródło 2: online dla brakujących - wyszukuje wydanie w MusicBrainz i pobiera okładkę z Cover Art Archive.
4. Poczekaj na podsumowanie: zapisane, pominięte, brakujące i błędy.

Już przypisane okładki są pomijane. Pliki graficzne trafiają do folderu hpl_music_covers, a powiązania do hpl_music_covers.sqlite. Pomarańczowa kropka w odtwarzaczu oznacza, że znaleziono rzeczywistą okładkę; brak kropki oznacza obraz zastępczy.

8. Odtwarzacz

Uruchamianie

1. Wybierz folder albo wyniki wyszukiwania.
2. Zaznacz utwór.
3. Kliknij zielony PLAY lub wykonaj dwuklik na wierszu.

Lista widoczna w głównym oknie staje się playlistą odtwarzacza, a wybrany utwór jej punktem startowym. Główne okno zostaje ukryte; przycisk Pokaż GUI przywraca je bez zamykania odtwarzacza.

AC3 i DTS FFPLAY

Pliki .ac3 i .dts są uruchamiane przez ffplay.exe. W tym trybie czas może pozostać 0:00, przewijanie i klasyczna pauza nie są dostępne, a przycisk Play działa jako zatrzymanie/ponowne uruchomienie. Po naturalnym końcu program przechodzi do następnego utworu.

9. Equalizer i tryb mini

Typy wizualizacji

Dostępne są: Słupki, Neon LED z odbiciem, Tęczowe segmenty oraz Soundwave neon. Kolor można ustawić jako wielokolorowy albo jednolity: fioletowy, jasny fiolet, neonowy czerwony, turkus, cyjan, niebieski, zielony, żółty, pomarańczowy lub biały.

Wybór jest zapisywany i używany w pełnym oraz mini odtwarzaczu. Radio ma własne, niezależne ustawienia typu i koloru EQ.

Tryb mini

Kliknij Minimalizuj, aby przejść do szerokiego panelu z tytułem, sterowaniem, okładką i EQ. Przycisk GUI wraca do pełnego okna. Zamknięcie odtwarzacza zatrzymuje muzykę i ponownie pokazuje główne okno.

10. Chromecast SIEĆ LOKALNA

1. Połącz komputer i Chromecast z tą samą siecią.
2. Kliknij Chromecast. Wyszukiwanie trwa kilka sekund.
3. Jeśli jest kilka urządzeń, wybierz właściwe i potwierdź.
4. Po komunikacie o połączeniu wybierz utwór i uruchom go zwykłym przyciskiem PLAY.

MP3, WAV, FLAC, AAC i M4A są udostępniane bezpośrednio. Pozostałe obsługiwane formaty są w locie konwertowane do MP3 przez lokalny ffmpeg.exe. Program uruchamia tymczasowy serwer HTTP na komputerze, dlatego Zapora Windows może poprosić o zgodę dla sieci prywatnej.

W odtwarzaczu działają pauza, wznowienie, przewijanie, głośność i przejście do następnego nagrania. Aby zakończyć sesję, kliknij w głównym oknie Rozłącz Cast.

11. Radio internetowe INTERNET

Odtwarzanie

1. Kliknij Radio.
2. Wybierz stację z listy.
3. Kliknij Play albo wykonaj dwuklik.
4. Reguluj głośność i EQ niezależnie od odtwarzacza plików.

Przy braku własnej bazy program pokazuje zestaw stacji startowych. Pole wyszukiwania filtruje nazwę, kraj, gatunek i URL, a lista gatunków zawęża wyniki. Strumień może wskazywać bezpośrednio na audio albo na playlistę M3U, M3U8 lub PLS; program próbuje automatycznie odczytać pierwszy adres strumienia.

Dodawanie i edycja

Dodaj stację lub Edytuj otwiera pola: nazwa, URL, kraj, gatunek i URL logo. Nazwa i URL są wymagane. Usuń wymaga potwierdzenia i zapisuje zmianę w bazie użytkownika.

Import i eksport M3U

• Wczytaj M3U obsługuje .m3u i .m3u8. Stacje o URL już obecnym w bazie są pomijane.
• Eksportuj M3U zapisuje aktualnie widoczne stacje. Jeśli działa filtr, wyeksportowany zostanie tylko przefiltrowany zestaw.

Widok mini i playlista

Minimalizuj przełącza radio w szeroki panel mini. Ukryj/Pokaż playlistę działa w obu widokach. Zamknięcie okna radia zatrzymuje strumień.

12. Bluetooth i wyjście audio

Przycisk Bluetooth wybiera urządzenie wyjściowe dla odtwarzacza i radia. Nie wykonuje parowania Bluetooth.

1. Jeśli urządzenie nie jest sparowane, kliknij Otwórz ustawienia BT Windows i sparuj je w systemie.
2. Wróć do programu i kliknij Odśwież.
3. Zaznacz urządzenie lub pozycję Domyślne urządzenie Windows.
4. Kliknij Ustaw jako aktywne albo wykonaj dwuklik.

Wybrane wyjście jest zapisywane i natychmiast przekazywane do otwartego odtwarzacza oraz radia. Jeżeli urządzenie zniknie, wybierz domyślne wyjście Windows i odśwież listę.

13. Język, motyw i styl GUI

14. Pliki programu i obsługiwane formaty

15. Szybkie operacje

16. Rozwiązywanie problemów

Po uruchomieniu lista jest pusta

Wybierz poprawny folder, kliknij Indeksuj, a po zakończeniu kliknij folder w lewym drzewie. Samo wczytanie indeksu celowo nie pokazuje wszystkich plików do chwili wyboru folderu lub wyszukiwania.

Indeks lub ustawienia nie zapisują się

Program zapisuje dane obok EXE. Przenieś cały katalog do miejsca zapisywalnego przez użytkownika, np. poza Program Files, i uruchom ponownie indeksowanie. Nie uruchamiaj tylko pojedynczego EXE.

Plik nie jest widoczny

Sprawdź rozszerzenie na liście obsługiwanych formatów i wykonaj ponowne indeksowanie. Folder bez uprawnień mógł zostać pominięty.

Brak okładki online

Uzupełnij poprawnie artystę, album lub tytuł, sprawdź Internet i spróbuj ponownie. Nie każde wydanie ma okładkę w MusicBrainz/Cover Art Archive.

AC3 lub DTS nie działa

Sprawdź, czy ffplay.exe znajduje się w katalogu programu. Program potrafi też znaleźć ffplay w PATH i kilku typowych lokalizacjach, ale kopia obok EXE jest rozwiązaniem zalecanym.

Chromecast nie jest znaleziony albo nie odtwarza

Sprawdź wspólną sieć, wyłącz izolację klientów i VPN, zezwól aplikacji w Zaporze Windows dla sieci prywatnej oraz upewnij się, że ffmpeg.exe istnieje dla formatów wymagających konwersji.

Radio nie gra

Sprawdź Internet i URL stacji. Dostawca mógł zmienić adres lub zablokować strumień. Spróbuj innej stacji, a następnie popraw lub usuń niedziałający wpis.

Bluetooth nie pojawia się na liście

Sparuj urządzenie w ustawieniach Windows, włącz je, kliknij Odśwież i wybierz właściwy profil audio. Program nie paruje urządzeń samodzielnie.

Program zamknął się po błędzie

Sprawdź hpl_music_winui_crash.log w katalogu aplikacji. Plik można przekazać pomocy technicznej razem z opisem ostatniej wykonanej czynności.