FreeRadio - dodatek dla NVDA

FreeRadio to dodatek radia internetowego dla czytnika ekranu NVDA. Jego głównym celem jest łatwy dostęp do tysięcy internetowych stacji radiowych. Cały interfejs i wszystkie funkcje zaprojektowano z myślą o pełnej dostępności w NVDA.

Katalog Radio Browser

FreeRadio używa otwartej bazy Radio Browser jako katalogu stacji. Radio Browser to bezpłatny katalog zarządzany przez społeczność, zawierający ponad 50 000 internetowych stacji radiowych z całego świata. Nie wymaga rejestracji ani konta, a jego API jest otwarte dla wszystkich. Każda stacja zawiera adres, kraj, gatunek, język i informacje o przepływności; stacje są sortowane również według głosów użytkowników. FreeRadio łączy się z API przez serwery lustrzane w Niemczech, Holandii i Austrii; jeśli jeden serwer jest niedostępny, automatycznie przełącza się na następny.

Dodawanie stacji do Radio Browser

Jeśli szukanej stacji nie ma w katalogu Radio Browser, możesz dodać ją samodzielnie na stronie https://www.radio-browser.info/add. Konto nie jest potrzebne.

Wypełnij formularz na tej stronie:

• Stream URL (wymagane) - bezpośredni adres URL strumienia audio, kończący się na przykład na .mp3, .aac, .ogg lub podobnie. Nie jest to adres strony internetowej stacji, tylko surowy adres strumienia, który można wkleić do odtwarzacza multimedialnego. Większość stacji publikuje go na swojej stronie albo w sekcji "Słuchaj na żywo".
• Station name (wymagane) - nazwa stacji, która ma pojawić się w katalogu.
• Homepage - adres strony internetowej stacji.
• Country and language - wybierz kraj i język nadawania z list rozwijanych.
• Tags - słowa kluczowe gatunku lub tematu, rozdzielone przecinkami, na przykład news, jazz, classical. Są używane do wyszukiwania i filtrowania.
• Logo URL - bezpośredni link do obrazu logo stacji, jeśli jest dostępny.

Po wysłaniu stacja zostanie sprawdzona i dodana do publicznego katalogu. Po zaakceptowaniu pojawi się automatycznie w wyszukiwaniu i listach krajów FreeRadio, ponieważ katalog jest odświeżany z aktywnego API.

Wymagania

• NVDA 2024.1 lub nowszy
• Windows 10 lub nowszy
• Połączenie z internetem

Instalacja

Pobierz plik .nvda-addon, naciśnij na nim Enter i uruchom NVDA ponownie, gdy pojawi się taka prośba.

Skróty klawiszowe

Wszystkie skróty można zmienić w menu NVDA -> Preferencje -> Zdarzenia wejścia -> FreeRadio. Skróty działają z dowolnego miejsca, niezależnie od aktywnego okna.

Skróty następnej i poprzedniej stacji poruszają się tylko po liście ulubionych; nie działają z listą wszystkich stacji. Gdy fokus znajduje się na liście w oknie przeglądarki, lewa i prawa strzałka pełnią tę samą funkcję - zobacz Skróty w oknie dialogowym.

Przeglądarka stacji

FreeRadio dodaje też podmenu FreeRadio do menu Narzędzia NVDA. Można z niego bezpośrednio otworzyć przeglądarkę stacji i ustawienia FreeRadio.

Okno otwierane skrótem Ctrl+Win+R zawiera pięć kart: Wszystkie stacje, Ulubione, Nagrywanie, Timer i Polubione utwory. Między kartami można przełączać się skrótem Ctrl+Tab.

Po otwarciu karty Wszystkie stacje automatycznie ładowanych jest 1000 najczęściej głosowanych stacji z Radio Browser. Wybranie kraju z listy rozwijanej aktualizuje listę i pokazuje stacje z tego kraju. Pisanie w polu wyszukiwania natychmiast uruchamia pełne wyszukiwanie w całej bazie Radio Browser, jednocześnie po nazwie, kraju i gatunku.

Lista Urządzenie wyjściowe na dole okna przeglądarki, poza kartami, zawiera wszystkie urządzenia audio rozpoznane przez BASS. Wybranie urządzenia natychmiast przekierowuje na nie dźwięk i zapisuje wybór na stałe; to samo urządzenie będzie użyte automatycznie w następnej sesji. Jeśli wybrane urządzenie nie jest podłączone, dodatek sam wraca do domyślnego urządzenia systemowego. Ta kontrolka działa tylko wtedy, gdy aktywny jest backend BASS.

Kontrolki Głośność (0-200) i Efekty w tym samym obszarze można zmieniać w dowolnej chwili, gdy okno jest otwarte. Z listy efektów można jednocześnie włączyć Chorus, Kompresor, Przesterowanie, Echo, Flanger, Gargle, Pogłos, EQ: wzmocnienie basu, EQ: wzmocnienie sopranów i EQ: wzmocnienie wokalu; zmiany są natychmiast stosowane do aktywnego strumienia. Te kontrolki działają w pełni tylko przy aktywnym backendzie BASS.

Gdy włączony jest co najmniej jeden efekt EQ, dla każdego aktywnego pasma pojawia się kontrolka wzmocnienia. Wzmocnienie można ustawić od -15 dB do +15 dB; wartości domyślne to bas +9 dB, soprany +9 dB i wokal +6 dB. Kontrolki są widoczne tylko dla aktualnie zaznaczonych pasm EQ i znikają automatycznie po odznaczeniu efektu. Wartości wzmocnienia są zapisywane globalnie i przywracane w następnej sesji.

Przycisk Odtwórz/Wstrzymaj również znajduje się na dole okna. Jeśli nic nie gra, uruchamia zaznaczoną stację; jeśli stacja już gra, wstrzymuje odtwarzanie.

Po zaznaczeniu stacji na liście przycisk Szczegóły stacji pokazuje informacje takie jak kraj, język, gatunek, format, przepływność, strona internetowa i adres URL strumienia w osobnym oknie. Każde pole znajduje się w osobnym, tylko do odczytu, polu tekstowym; można przechodzić między nimi Tabem i skopiować wszystkie informacje naraz przyciskiem Kopiuj wszystko do schowka. Ten przycisk jest dostępny na kartach Wszystkie stacje i Ulubione.

Skróty w oknie dialogowym

Poniższe klawisze działają tylko wtedy, gdy aktywne jest okno Przeglądarka stacji.

Klawisze funkcyjne

Skróty listy i nawigacji

Skróty głośności

Skróty Alt

Ulubione

Lista ulubionych to osobista kolekcja stacji zapisywana na stałe. Aby dodać stację, zaznacz ją na liście i naciśnij przycisk Dodaj do ulubionych albo użyj skrótu Alt+V. Ten sam skrót usuwa stację, która już jest na liście.

Ulubione można odtwarzać skrótami Ctrl+Win+-> i Ctrl+Win+<-; działają one nawet wtedy, gdy okno przeglądarki nie jest otwarte.

Aby usunąć stację z listy ulubionych, zaznacz ją i naciśnij przycisk Usuń stację albo klawisz Delete. Po usunięciu fokus i zaznaczenie automatycznie przechodzą na następną stację na liście. Jeśli usunięto ostatnią stację, fokus przechodzi na poprzednią. Jeśli lista stanie się pusta, fokus przechodzi na przycisk Odtwórz.

Eksportowanie i importowanie ulubionych

Karta Ulubione zawiera dwa przyciski do tworzenia kopii zapasowej listy stacji i jej przywracania:

Eksportuj ulubione… — zapisuje całą listę ulubionych do pliku. Okno dialogowe zapisu umożliwia wybór jednego z dwóch formatów: - JSON (.json) — pełna kopia zapasowa zachowująca nazwy stacji, adresy URL strumieni i wszystkie metadane. Zalecany do późniejszego przywrócenia listy lub przeniesienia jej na inny komputer. - Lista odtwarzania M3U (.m3u) — standardowy format listy odtwarzania zgodny z większością odtwarzaczy multimedialnych i aplikacji radiowych. Należy pamiętać, że format M3U nie przechowuje wszystkich metadanych stacji, więc przywracanie z pliku M3U może skutkować mniejszą ilością szczegółów niż kopia zapasowa JSON.

Importuj ulubione… — ładuje stacje z wcześniej wyeksportowanego pliku JSON lub M3U. Po wybraniu pliku pojawi się pytanie o sposób dodania stacji: - Tak (Scal) — dodaje importowane stacje do istniejącej listy bez usuwania bieżących ulubionych. Zduplikowane stacje nie są dodawane dwukrotnie. - Nie (Zastąp) — całkowicie usuwa bieżącą listę ulubionych i zastępuje ją zawartością importowanego pliku. - Anuluj — powraca do przeglądarki bez wprowadzania żadnych zmian.

Po udanym imporcie lista ulubionych, lista stacji zaplanowanych nagrań i lista stacji timera są odświeżane automatycznie.

Zmiana kolejności ulubionych

Po zaznaczeniu stacji na karcie Ulubione naciśnij przecinek, aby wejść w tryb przenoszenia - usłyszysz sygnał. Przejdź strzałkami do pozycji docelowej, a następnie naciśnij przecinek ponownie. Stacja zostanie umieszczona w wybranym miejscu, a nowa kolejność zapisana natychmiast. Ponowne naciśnięcie przecinka w tej samej pozycji anuluje przenoszenie.

Bezpośrednie skróty klawiszowe do ulubionych stacji

Każda stacja z listy ulubionych jest zarejestrowana jako osobny skrypt w oknie Zdarzeń wejścia NVDA, w kategorii FreeRadio Stations. Możesz przypisać dowolny skrót klawiszowy do dowolnej stacji i nacisnąć go z dowolnego miejsca — bez konieczności otwierania okna przeglądarki.

Aby przypisać skrót:

1. Otwórz menu NVDA -> Preferencje -> Zdarzenia wejścia.
2. Rozwiń kategorię FreeRadio Stations.
3. Znajdź stację po nazwie, zaznacz ją i naciśnij Dodaj.
4. Naciśnij żądaną kombinację klawiszy i potwierdź.

Po naciśnięciu skrótu stacja uruchamia się natychmiast. Jeśli stacja zostanie usunięta z ulubionych, jej wpis zniknie z kategorii, a przypisany skrót zostanie automatycznie wyczyszczony przez NVDA. Po dodaniu nowej stacji do ulubionych pojawia się ona w kategorii od razu — nie trzeba ponownie otwierać okna Zdarzeń wejścia.

Dodawanie własnej stacji

Aby dodać stację, której nie ma w Radio Browser, użyj przycisku Dodaj własną stację. W wyświetlonym dialogu wpisz nazwę stacji i adres URL strumienia, aby dodać ją bezpośrednio do ulubionych. Własne stacje można odtwarzać i przenosić tak samo jak pozostałe ulubione.

Profil audio stacji

Karta Ulubione zawiera dwa przyciski do zarządzania ustawieniami audio dla konkretnej stacji:

Zapisz profil audio dla tej stacji - zapisuje bieżący poziom głośności, aktywne efekty (chorus, EQ itd.) oraz wartości wzmocnienia EQ jako profil przypisany do konkretnej stacji. Za każdym razem, gdy ta stacja zacznie grać, zapisane ustawienia głośności, efektów i wzmocnień zostaną zastosowane automatycznie, zastępując ustawienia globalne.

Wyczyść profil audio - usuwa zapisany profil audio zaznaczonej stacji. Po wyczyszczeniu stacja wraca do globalnych ustawień głośności, efektów i wzmocnień EQ. Przycisk jest aktywny tylko wtedy, gdy zaznaczona stacja ma zapisany profil.

Oba przyciski znajdują się pod listą ulubionych i są aktywne tylko po zaznaczeniu stacji na liście.

Rozpoznawanie muzyki

Trzykrotne naciśnięcie Ctrl+Win+I uruchamia rozpoznawanie muzyki przez Shazam dla aktualnie odtwarzanego strumienia. Rozpoznawanie zaczyna się tylko wtedy, gdy nie są dostępne metadane ICY, czyli informacje o utworze nadawane przez stację; jeśli metadane są dostępne, zostaną zamiast tego skopiowane do schowka.

Rozpoznawanie działa tak: krótka próbka audio jest przechwytywana ze strumienia przy użyciu ffmpeg, stosowany jest algorytm odcisku audio Shazama, a wynik wysyłany jest na serwery Shazama. Jeśli rozpoznawanie się powiedzie, NVDA odczyta tytuł utworu, wykonawcę, album i rok wydania oraz automatycznie skopiuje je do schowka. Jeśli opcja Zapisuj polubione utwory do pliku tekstowego jest włączona, wynik zostanie też dopisany do likedSongs.txt.

Informacja dźwiękowa: dwa rosnące sygnały oznaczają start rozpoznawania, a dwa opadające sygnały jego koniec. Krótki sygnał jest odtwarzany co 2 sekundy, gdy proces trwa.

Wymaganie: potrzebny jest ffmpeg.exe. Plik ffmpeg.exe umieszczony w folderze dodatku zostanie użyty automatycznie; jeśli znajduje się gdzie indziej, ścieżkę można ustawić w Ustawieniach. Pobierz ffmpeg ze strony ffmpeg.org.

Kopia dźwięku

Skrót Ctrl+Win+M kopiuje aktualnie odtwarzany strumień na drugie urządzenie wyjściowe audio równocześnie z głównym odtwarzaniem. Przydaje się to do słuchania na dwóch różnych urządzeniach jednocześnie, na przykład przez głośniki i słuchawki.

Po pierwszym naciśnięciu pojawia się dialog wyboru z listą dostępnych urządzeń wyjściowych. Po wybraniu urządzenia rozpoczyna się kopiowanie, a główne odtwarzanie trwa bez przerwy. Ponowne naciśnięcie skrótu zatrzymuje kopiowanie.

Przykłady użycia:

• Głośniki + słuchawki - pozwól drugiej osobie słuchać tej samej audycji w słuchawkach, podczas gdy Ty słuchasz przez głośniki komputera.
• Konfiguracja nagrywania - skieruj główne wyjście na głośniki, a drugie na zewnętrzny rejestrator albo interfejs audio.
• Kilka pomieszczeń - odtwarzaj równocześnie przez głośnik Bluetooth i wbudowany głośnik; bez dodatkowego oprogramowania.
• Monitorowanie zdalne - podczas udostępniania ekranu albo pracy przez zdalny pulpit strumień może być słyszany po obu stronach.

Uwaga: kopia dźwięku jest dostępna tylko wtedy, gdy aktywny jest backend BASS. Zmiana głośności podczas aktywnego kopiowania aktualizuje oba wyjścia jednocześnie.

Nagrywanie

Nagrania są domyślnie zapisywane w Documents\FreeRadio Recordings\. Nazwa pliku zawiera nazwę stacji albo tytuł utworu w trybie nagrywania utworu oraz czas rozpoczęcia nagrywania. Folder nagrań można w dowolnej chwili zmienić w menu NVDA -> Preferencje -> Ustawienia -> FreeRadio -> Folder nagrań. Ponieważ silnik nagrywania łączy się bezpośrednio ze strumieniem, dźwięk jest zapisywany na dysku tak, jak został odebrany - bez przetwarzania i ponownego kodowania; jakość nagrania jest identyczna z jakością nadawania.

Nagrywanie natychmiastowe: podczas odtwarzania stacji naciśnij Ctrl+Win+E raz. Naciśnij ponownie, aby zatrzymać. Odtwarzanie trwa bez przerwy.

Nagrywanie utworu: naciśnij Ctrl+Win+E dwa razy szybko, gdy gra stacja nadająca metadane ICY. Nagrywanie rozpoczyna się natychmiast i otrzymuje nazwę bieżącego tytułu. Po zmianie utworu nagrywanie zatrzymuje się automatycznie, a NVDA ogłasza zapisaną nazwę pliku. Jeśli chcesz zakończyć wcześniej, naciśnij Ctrl+Win+E dwa razy ponownie. Jeśli bieżąca stacja nie nadaje metadanych ICY, nagrywanie utworu jest niedostępne i NVDA o tym poinformuje.

Nagrywanie zaplanowane: otwórz kartę Nagrywanie w przeglądarce. Wybierz stację z ulubionych, wpisz godzinę rozpoczęcia w formacie GG:MM i czas trwania w minutach, wybierz jeden lub więcej aktywnych dni, a następnie ustaw tryb powtarzania i tryb nagrywania:

Aktywne dni: Zaznacz jeden lub więcej dni tygodnia. W trybie jednorazowym dla każdego wybranego dnia tworzona jest osobna pozycja, ustawiona na najbliższe wystąpienie tego dnia. W trybie cyklicznym nagrywanie powtarza się tylko w zaznaczonych dniach. Jeśli nie zaznaczono żadnych dni, nagrywanie nie jest ograniczone do konkretnych dni.

Tryb powtarzania: - Nagraj raz — tworzy jednorazowe nagranie dla każdego wybranego dnia. Każda pozycja jest ustawiona na najbliższe wystąpienie tego dnia; jeśli dzisiejsza godzina już minęła, pozycja jest automatycznie przenoszona na następny tydzień. - Powtarzaj co tydzień — powtarza się co tydzień w wybranych aktywnych dniach, dopóki nie zostanie usunięte z listy harmonogramu.

Tryb nagrywania: - Nagrywaj podczas słuchania — odtwarza i nagrywa jednocześnie. Backend odtwarzania uruchamiany jest w kolejności priorytetów BASS → VLC → PotPlayer → Windows Media Player. - Tylko nagrywaj — nagrywa cicho w tle bez wyjścia audio; silnik nagrywania łączy się bezpośrednio ze strumieniem.

NVDA ogłasza rozpoczęcie i zakończenie nagrywania. Jeśli NVDA zostanie uruchomione ponownie podczas aktywnego zaplanowanego nagrywania, nagrywanie zostanie automatycznie wznowione po uruchomieniu.

Time-shift (cofanie radia na żywo)

Time-shift pozwala cofnąć aktualnie słuchaną stację jak DVR lub kaseta magnetofonowa — zatrzymaj chwilę, cofnij się kilka minut i dogońcie live, kiedy chcesz. Odtwarzanie nie musi się zatrzymywać: cofanie i przewijanie do przodu odbywają się natychmiastowo na tym samym strumieniu audio.

Funkcja jest domyślnie wyłączona. Włącz ją w Menu NVDA → Preferencje → Ustawienia → FreeRadio → Włącz bufor time-shift (cofanie radia na żywo, ~10 minut) lub przełącz natychmiast w dowolnym momencie za pomocą Ctrl+Win+T.

Jak to działa

Po włączeniu FreeRadio ciągle przechwytuje aktualnie odtwarzaną stację do lokalnego, obracającego się bufora w tle. Bufor przechowuje mniej więcej ostatnie 10 minut audio; starsze audio jest automatycznie usuwane z przodu wraz z napływaniem nowego, dzięki czemu bufor zawsze reprezentuje „niedawną przeszłość" względem krawędzi na żywo.

• Ctrl+Win+J — Cofnij o 15 sekund. Pierwsze naciśnięcie przełącza z odtwarzania na żywo na odtwarzanie z time-shiftem, zaczynając 15 sekund za krawędzią na żywo. Każde kolejne naciśnięcie cofa o kolejne 15 sekund.
• Ctrl+Win+K — Przewiń do przodu o 15 sekund w trybie time-shift. Po osiągnięciu krawędzi na żywo odtwarzanie automatycznie przełącza się z powrotem do strumienia na żywo, a NVDA ogłasza „Powrót do transmisji na żywo".
• Ctrl+Win+T — Włącza lub wyłącza całą funkcję. Wyłączenie w trybie time-shift natychmiast wraca do live i zatrzymuje przechwytywanie w tle dla bieżącej stacji.

Przechwytywanie w tle działa przez cały czas, gdy jesteś w time-shifcie, więc krawędź na żywo przesuwa się do przodu, nawet gdy słuchasz czegoś sprzed kilku minut — dokładnie jak prawdziwy DVR.

Włączenie i rozgrzewanie bufora

Bufor zaczyna się wypełniać, gdy tylko stacja zaczyna grać (po włączeniu funkcji) lub w momencie, gdy włączasz funkcję już podczas słuchania stacji. Dlatego cofanie jest możliwe dopiero po rzeczywistym przechwyceniu kilku sekund audio — jeśli naciśniesz Ctrl+Win+J natychmiast po przełączeniu stacji, NVDA poinformuje, że w buforze nie ma jeszcze wystarczająco dużo audio. Poczekaj kilka sekund i spróbuj ponownie.

Przełączenie na inną stację zawsze restartuje bufor dla nowej stacji; zbuforowane audio poprzedniej stacji jest odrzucane.

Obsługiwane strumienie

Time-shift działa z tą samą gamą strumieni, które FreeRadio już obsługuje:

• Zwykłe strumienie HTTP/HTTPS (MP3, AAC, OGG itd.), w tym serwery w stylu Shoutcast/Icecast.
• Strumienie HLS (.m3u8) — FreeRadio rozwiązuje główną playlistę stacji, śledzi playlistę mediów i pobiera segmenty w tle, aby bufor był stale wypełniony.

W rzadkim przypadku, gdy playlista stacji nie może zostać w ogóle odczytana (np. uszkodzony lub niedostępny manifest .m3u8), NVDA poinformuje, że cofanie nie jest dostępne dla tej konkretnej stacji.

Wymagania i ograniczenia

• Wymaga backendu BASS. Time-shift nie jest dostępny, gdy BASS jest wyłączony.
• Bufor wynosi około 10 minut; nie można cofnąć się dalej.
• Bufor jest per-stacja: zmiana stacji, zatrzymanie odtwarzania lub restart NVDA czyści go i zaczyna od nowa.
• Odtwarzanie z time-shiftem używa własnego lokalnego pliku bufora i nie tworzy zapisanego nagrania — jeśli chcesz trwale zachować audio, użyj również Nagrywania natychmiastowego (Ctrl+Win+E).

Timer

Otwórz kartę Timer w przeglądarce stacji (Alt+4). Można dodać dwa typy timerów:

Alarm - uruchom radio: automatycznie zaczyna odtwarzać wybraną stację z ulubionych o wskazanej godzinie. Wybierz stację i wpisz czas w formacie GG:MM.

Uśpienie - zatrzymaj radio: zatrzymuje odtwarzanie o wskazanej godzinie. Po uruchomieniu timera głośność jest stopniowo zmniejszana przez 60 sekund, zanim odtwarzanie zostanie zatrzymane. Nie trzeba wybierać stacji; wystarczy wpisać czas.

Dla obu typów, jeśli podana godzina już minęła, akcja zostanie zaplanowana na następny dzień. Jeśli o tej samej godzinie istnieje już timer (niezależnie od typu), dodanie nowego jest zablokowane; użytkownik jest informowany o konflikcie i proszony o usunięcie istniejącej pozycji. Oczekujące timery są widoczne na karcie; zaznacz jeden i naciśnij przycisk Usuń wybrany timer, aby go anulować.

Ustawienia

Poniższe opcje można skonfigurować w menu NVDA -> Preferencje -> Ustawienia -> FreeRadio:

Wyciszanie powiadomień

Gdy w ustawieniach włączone jest Wycisz powiadomienia, NVDA wycisza następujące automatyczne komunikaty:

• nazwa stacji po rozpoczęciu odtwarzania nowej stacji;
• zmiany stanu odtwarzania: odtwórz, pauza, stop;
• zdarzenia nagrywania: rozpoczęte, zatrzymane, zakończone (nagrania natychmiastowe, utworów i zaplanowane);
• komunikaty o zmianie utworu ICY, nawet gdy włączone jest też Automatycznie ogłaszaj zmiany utworów.

Celowo nie są wyciszane: komunikaty błędów, informacje o ulubionych (dodano / już na liście), wyniki rozpoznawania muzyki i powiadomienia aktualizacji.

Ustawienie można przełączyć w menu NVDA -> Preferencje -> Ustawienia -> FreeRadio albo natychmiast w dowolnym momencie przez nieprzypisane zdarzenie wejścia (przypisz je w menu NVDA -> Preferencje -> Zdarzenia wejścia -> FreeRadio). Po przełączeniu NVDA odczyta raz "Powiadomienia wyciszone" albo "Powiadomienia włączone", aby potwierdzić zmianę.

Automatyczne ogłaszanie zmian utworów

Gdy w ustawieniach włączona jest opcja Automatycznie ogłaszaj zmiany utworów, FreeRadio sprawdza w tle strumień metadanych ICY aktywnej stacji mniej więcej co 5 sekund. Po zmianie utworu nowy tytuł jest automatycznie odczytywany przez NVDA - bez naciskania klawiszy.

Po przełączeniu na nową stację pierwsza informacja o utworze jest ogłaszana zaraz po nawiązaniu połączenia. Jeśli przełączysz na stację, która nie nadaje metadanych ICY, system pozostanie cichy, a informacje z poprzedniej stacji nie będą powtarzane.

Funkcja jest domyślnie wyłączona i można ją przełączyć w menu NVDA -> Preferencje -> Ustawienia -> FreeRadio.

Polubione utwory

Gdy włączona jest opcja Zapisuj polubione utwory do pliku tekstowego, informacje o utworze skopiowane do schowka trzykrotnym naciśnięciem Ctrl+Win+I są także dopisywane w kolejnych wierszach do Documents\FreeRadio Recordings\likedSongs.txt.

Na stacjach nadających metadane ICY tytuł utworu i wykonawca są zapisywane bezpośrednio. Na stacjach bez metadanych ICY do tego samego pliku zapisywany jest wynik rozpoznawania przez Shazam - oba źródła używają jednej listy. Plik jest tworzony automatycznie, jeśli nie istnieje; każdy wpis jest dopisywany na końcu, a poprzednie wpisy nie są usuwane.

Karta Polubione utwory

Karta Polubione utwory w przeglądarce stacji wyświetla wszystkie ścieżki zapisane w likedSongs.txt. Lista jest automatycznie przeładowywana z pliku za każdym razem, gdy karta jest otwierana.

Pole Filtr nad listą pozwala zawęzić wyświetlane utwory w czasie rzeczywistym. Wpisz dowolną część tytułu piosenki lub nazwy wykonawcy, a lista zaktualizuje się natychmiast po każdym naciśnięciu klawisza. NVDA ogłasza liczbę pasujących wyników po każdej zmianie. Naciśnij strzałkę w dół w polu filtru, aby przenieść fokus bezpośrednio do listy.

Wybranie ścieżki z listy włącza następujące działania:

• Odtwórz na Spotify: Próbuje bezpośrednio otworzyć aplikację komputerową Spotify. Jeśli aplikacja nie jest zainstalowana, otwiera witrynę Spotify i automatycznie odtwarza pierwszy wynik.
• Odtwórz na YouTube (Alt+O): Wyszukuje wybraną ścieżkę na YouTube i otwiera wyniki w domyślnej przeglądarce.
• Pokaż tekst: Pobiera i wyświetla tekst wybranego utworu. Teksty są pobierane z lrclib.net (bezpłatnie, bez konta). Krótki komunikat „Pobieranie tekstu…" jest ogłaszany, gdy wyszukiwanie odbywa się w tle. Jeśli tekst zostanie znaleziony, otworzy się w oknie dialogowym tylko do odczytu, gdzie możesz go przeczytać za pomocą NVDA i skopiować do schowka. Jeśli tekst nie zostanie znaleziony, NVDA to ogłosi. Przycisk jest tymczasowo wyłączony podczas trwającego pobierania, aby zapobiec powielaniu żądań.
• Usuń (Alt+M): Usuwa wybraną ścieżkę z likedSongs.txt i aktualizuje listę. Klawisz Delete również aktywuje ten przycisk, gdy lista jest sfokusowana.
• Odśwież (Alt+E): Przeładowuje listę z pliku.

Przyciski Spotify, YouTube, Pokaż tekst i Usuń są aktywne tylko wtedy, gdy na liście wybrany jest prawdziwy utwór.

Serwis tekstów piosenek

FreeRadio używa lrclib.net do pobierania tekstów piosenek — bezpłatna, otwarta baza danych niewymagająca klucza API ani konta. Proces wyszukiwania analizuje ciąg ścieżki zapisany w likedSongs.txt i próbuje coraz luźniejszych zapytań, aż do znalezienia tekstu:

1. Dokładne dopasowanie przy użyciu pełnej nazwy wykonawcy i oczyszczonego tytułu (szumowe przyrostki takie jak „Remastered", „Live" lub tagi roku są usuwane przed wyszukiwaniem).
2. Dokładne dopasowanie przy użyciu pełnej nazwy wykonawcy i oryginalnego tytułu (jeśli czyszczenie go zmieniło).
3. Dokładne dopasowanie przy użyciu tylko pierwszej nazwy wykonawcy i oczyszczonego tytułu (dla ciągów z wieloma wykonawcami, np. „Wykonawca A & Wykonawca B").
4. Wyszukiwanie rozmyte przy użyciu pierwszej nazwy wykonawcy i oczyszczonego tytułu.
5. Wyszukiwanie rozmyte przy użyciu surowego ciągu ścieżki jako ostatnia deska ratunku.

Gdy dostępne są zwykłe teksty, są wyświetlane tak jak są. Gdy dostępne są tylko zsynchronizowane czasowo teksty LRC, znaczniki czasu są usuwane i wyświetlany jest zwykły tekst. Ścieżki instrumentalne są zgłaszane jako nieznalezione.

Odtwarzanie

Dodatek wybiera backend odtwarzania w następującej kolejności priorytetów:

1. BASS - domyślny i główny backend. Nie wymaga osobnej instalacji; jest dołączony do dodatku. BASS wysyła dźwięk bezpośrednio do stosu audio Windows i pojawia się w mikserze głośności Windows jako niezależne źródło audio o nazwie "pythonw.exe", oddzielone od NVDA. Oznacza to, że dźwięk FreeRadio płynie całkowicie osobnym kanałem niż mowa NVDA: radio nie zanika, nie miesza się i nie jest zależne od ustawień audio NVDA, gdy NVDA mówi. Użytkownik może regulować głośność radia niezależnie od NVDA w mikserze głośności Windows. Obsługuje HTTP, HTTPS i większość osadzonych formatów strumieni. Kopia dźwięku jest dostępna tylko z tym backendem.
2. VLC - przejmuje odtwarzanie, jeśli BASS zawiedzie. Jest automatycznie szukany w typowych lokalizacjach instalacji, folderach profilu użytkownika i w systemowym PATH.
3. PotPlayer - używany, jeśli VLC nie zostanie znaleziony. Jest automatycznie szukany w typowych lokalizacjach instalacji.
4. Windows Media Player - używany jako ostatnia możliwość; wymaga zainstalowanego komponentu WMP w systemie.

Sprawdzanie aktualizacji

FreeRadio automatycznie sprawdza nowe wersje przez GitHuba.

Sprawdzanie automatyczne: działa cicho w tle 15 sekund po starcie NVDA. Jeśli zostanie znaleziona nowa wersja, pojawi się powiadomienie; jeśli nie, nie pojawia się żaden komunikat.

Sprawdzanie ręczne: można uruchomić na żądanie z menu NVDA -> Narzędzia -> FreeRadio -> Sprawdź aktualizacje.... Przy ręcznym uruchomieniu wynik jest ogłaszany nawet wtedy, gdy wersja jest aktualna.

Gdy znajdzie się aktualizacja: pojawia się dialog z numerem nowej wersji i wersją zainstalowaną.

• Jeśli w wydaniu GitHuba jest dostępny bezpośrednio pobieralny plik .nvda-addon, pojawia się przycisk Pobierz i zainstaluj. Po potwierdzeniu plik jest pobierany w tle, NVDA ogłasza rozpoczęcie pobierania, a następnie automatycznie otwiera własny ekran instalacji NVDA.
• Jeśli nie ma bezpośredniego linku pobierania, pojawia się przycisk Otwórz stronę, który otwiera stronę wydania GitHuba w domyślnej przeglądarce.

Aby wyłączyć automatyczne sprawdzanie: wyłącz opcję Sprawdzaj aktualizacje automatycznie w menu NVDA -> Preferencje -> Ustawienia -> FreeRadio.

Licencja

GPL v2