RadioRec je přehrávač a plánovací rekordér internetového rádia na počítači s pokročilou analýzou programového průvodce z webových stránek.

Klíčové vlastnosti

• Přehrávání streamu: Poslouchejte svá oblíbená internetová rádia (MP3).
• Živé a plánované nahrávání: Nahrávejte živé streamy nebo si naplánujte nahrávání na konkrétní datum a čas.
• Správa stanic: Snadno přidávejte, upravujte a spravujte seznam rozhlasových stanic.
• Pokročilá analýza programů: Unikátní funkce, která umožňuje načítat a analyzovat programové průvodce (EPG) přímo z webových stránek stanice.
• Používá XPath a CSS selektory k cílení na konkrétní prvky na stránce.
• Obsahuje vestavěný prohlížeč zdrojového kódu HTML se zvýrazněním syntaxe, který vám pomůže s tvorbou selektorů.
• Obsahuje kartu Testovací analýza pro ověření pravidel analýzy před uložením.
• Multiplatformní: Funguje na Windows 10/11 a různých distribucích Linuxu.
• Moderní motivy uživatelského rozhraní: Vytvořeno s vzhledem a chováním FlatLaf a nabízí Světlý i Tmavý režim.
• Vícejazyčná podpora: Rozhraní aplikace podporuje více jazyků, což lze změnit v nastavení. Aktuálně podporované jazyky: angličtina, čeština.
• Dodávané JRE: Instalační program/balíček obsahuje vlastní běhové prostředí Java, takže není nutná samostatná instalace Javy.

Je napsaná v Javě (s využitím Apache NetBeans) s grafickým uživatelským rozhraním založeným na Swingu a nabízí uživatelsky přívětivé rozhraní, možnosti plánovaného nahrávání a výkonný nástroj pro analýzu programových průvodců stanic přímo z webových stránek.

Plánované funkce

• Podpora dalších formátů nad rámec MP3.
• Možnosti ukládání specifické pro stanici: ukládání nahrávek podle streamu nebo podle programu.
• Vylepšená analýza programu v dialogovém rozhraní.
• Náhled programu a položek nahrávky před zahájením nahrávání.
• Úprava tagů MP3 pro nahrané soubory.

Tyto funkce jsou ve vývoji a budou přidány v budoucích verzích.

Stažení

Verze na GitHub obsahuje standardní archiv zdrojového kódu spolu s odkazy na všechna externí umístění pro stahování.

Instalační balíčky byly vytvořeny pomocí farmy instalátorů Java aplikací. Více informací najdete v repozitáři na GitHub.

Další místa

Descargatic

AlternativeTo

SLUNEČNICE.cz

Instalace

Požadavky

• Operační systém: Windows 10/11 nebo distribuce Linuxu (např. Ubuntu, Fedora, Debian, openSUSE).
• Java: Není vyžadována samostatná instalace Javy. Aplikace je dodávána s vlastním běhovým prostředím Java.

Windows 10/11

Možnost 1: Instalační program (doporučeno)

1. Stáhněte si soubor radiorec-1.0-install.exe.
2. Přejděte do složky Stažené soubory a dvojitým kliknutím na soubor jej spusťte.
3. Windows Defender SmartScreen může zobrazit varování („Windows chránil váš počítač“), protože se jedná o novou aplikaci. To je normální.
4. Klikněte na „Další informace“.
5. Poté klikněte na tlačítko „Spustit přesto“, které se zobrazí.
6. Postupujte podle jednoduchých pokynů na obrazovce v průvodci instalací.
7. Po dokončení můžete spustit RadioRec z nového zástupce na ploše nebo v nabídce Start.

Možnost 2: Přenositelná (.zip)

Tuto verzi není nutné instalovat. Můžete ji spustit z libovolné složky, včetně USB disku.

1. Stáhněte si soubor radiorec-1.0-image.zip.
2. Přejděte do složky Stažené soubory.
3. Klikněte pravým tlačítkem myši na soubor .zip a vyberte „Rozbalit vše…“.
4. Vyberte umístění pro složku (stačí složka Stažené soubory) a klikněte na „Rozbalit“.
5. Vytvoří se nová složka s názvem radiorec-1.0-image. Otevřete tuto složku.
6. Uvnitř otevřete podsložku RadioRec.
7. V této složce dvojitým kliknutím na soubor RadioRec.exe (nebo RadioRec) spustíte aplikaci.

Linux

Možnost 1: Balíček .deb (Ubuntu, Mint, Debian)

Metoda A: Grafická (Snadná instalace balíčku deb)

• Stáhněte si soubor radiorec_1.0-1_amd64.deb.
• Otevřete správce souborů (ikona „Soubory“) a přejděte do složky Stažené soubory.
• Dvakrát klikněte na soubor radiorec_1.0-1_amd64.deb.
• Otevře se systémová aplikace „Software“ (může se nazývat „Instalace softwaru“ nebo „GDebi“) a zobrazí se vám podrobnosti o aplikaci RadioRec.
• Klikněte na tlačítko Instalovat«.
• Budete požádáni o heslo pro autorizaci instalace. Toto je běžný bezpečnostní krok v Linuxu.
• Po dokončení najdete „RadioRec“ v hlavní nabídce aplikací, stejně jako jakoukoli jinou aplikaci!

Co když dvojité kliknutí nefunguje? Žádný problém.

• Klikněte pravým tlačítkem myši na soubor radiorec_1.0-1_amd64.deb.
• Vyberte možnost „Otevřít v jiné aplikaci“ (nebo podobný název).
• Vyberte ze seznamu „Instalace softwaru“, „Discover“ nebo „Instalační program balíčku GDebi“ a klikněte na „Vybrat“.

Metoda B: Terminál (Alternativní instalace deb balíčku)

Pokud dáváte přednost použití příkazového řádku. Otevřete terminál (můžete vyhledat „Terminál“ nebo stisknout klávesy Ctrl+Alt+T).

Přejděte do složky Stažené soubory:

cd ~/Downloads

cd ~/Downloads

Spusťte následující příkaz. apt automaticky zpracuje všechny chybějící závislosti.

sudo apt install ./radiorec_1.0-1_amd64.deb

sudo apt install ./radiorec_1.0-1_amd64.deb

Po zobrazení výzvy zadejte heslo a stiskněte Y pro potvrzení.

Možnost 2: Balíček .rpm (Fedora, openSUSE, Rocky)

RPM balíčky jsou podepsány GPG klíčem, aby bylo možné ověřit jejich původ a integritu. Před první instalací je vhodné importovat veřejný podpisový klíč.

Nejprve si můžete ověřit oficiální fingerprint podpisového klíče:

curl https://marelis.cz/keys/RPM-GPG-KEY-marelis.fingerprint.txt

curl https://marelis.cz/keys/RPM-GPG-KEY-marelis.fingerprint.txt

Očekávaný výstup:

8C68903EEC127F01731487EAB550D460A925D295

8C68903EEC127F01731487EAB550D460A925D295

Pro kontrolu, že stahujete správný veřejný klíč:

curl https://marelis.cz/keys/RPM-GPG-KEY-marelis.asc

curl https://marelis.cz/keys/RPM-GPG-KEY-marelis.asc

Výstup musí začínat:

-----BEGIN PGP PUBLIC KEY BLOCK-----

-----BEGIN PGP PUBLIC KEY BLOCK-----

Import veřejného klíče

sudo rpm --import https://marelis.cz/keys/RPM-GPG-KEY-marelis.asc

sudo rpm --import https://marelis.cz/keys/RPM-GPG-KEY-marelis.asc

• Tento krok stačí provést pouze jednou.
• Importem klíče umožníte systému ověřovat pravost všech budoucích RPM balíčků vydaných projektem Marelis.
• Po importu klíče lze balíček instalovat běžným způsobem
• Systém při instalaci automaticky ověří digitální podpis balíčku.

Metoda A: Grafická (Snadná instalace balíčku rpm)

• Stáhněte si soubor radiorec-1.0-1.x86_64.rpm.
• Otevřete správce souborů a přejděte do složky Stažené soubory.
• Dvakrát klikněte na soubor radiorec-1.0-1.x86_64.rpm.
• Otevře se systémová aplikace „Software“ (například GNOME Software nebo YaST).
• Klikněte na tlačítko Instalovat a zadejte heslo pro autorizaci instalace.
• Hotovo! RadioRec bude k dispozici v nabídce aplikací.

Co když dvojité kliknutí nefunguje? Žádný problém.

• Klikněte pravým tlačítkem myši na soubor radiorec-1.0-1.x86_64.rpm.
• Vyberte „Otevřít v jiné aplikaci“.
• Vyberte ze seznamu „Software“ (nebo „YaST Software“).
• Klikněte na „Instalovat“.

Metoda B: Terminál (Alternativní instalace balíčku rpm)

Pokud dáváte přednost použití příkazového řádku.

Otevřete terminál. Přejděte do složky Stažené soubory:

cd ~/Downloads

cd ~/Downloads

Spusťte příkaz, který odpovídá vaší distribuci:

Pro Fedoru nebo Rocky Linux (s použitím dnf):

sudo dnf install ./radiorec-1.0-1.x86_64.rpm

sudo dnf install ./radiorec-1.0-1.x86_64.rpm

Pro openSUSE (s použitím zypper):

sudo zypper install ./radiorec-1.0-1.x86_64.rpm

sudo zypper install ./radiorec-1.0-1.x86_64.rpm

Zadejte heslo a stiskněte tlačítko „Y“ pro potvrzení.

Možnost 3: Přenosný .tar.gz / .zip (všechny systémy Linux)

„Přenosná“ aplikace nevyžaduje instalaci. Stačí rozbalit složku a spustit programový soubor uvnitř.

• Stáhněte si soubor radiorec-1.0-image.tar.gz (nebo radiorec-1.0-image.zip).
• Přejděte do složky Stažené soubory.
• Klikněte pravým tlačítkem myši na soubor a vyberte možnost Rozbalit zde.
• Tím se vytvoří nová složka, pravděpodobně s názvem radiorec-1.0-image.
• Otevřete tuto novou složku.
• Uvnitř otevřete podsložku RadioRec a poté podsložku bin.
• V této složce najděte hlavní soubor programu s názvem RadioRec.
• Dvojitým kliknutím na soubor RadioRec spusťte aplikaci!

Pomoc! Nespustí se to, když dvakrát kliknu!

Pokud dvojité kliknutí nic nezmění, soubor pravděpodobně potřebuje „povolení ke spuštění“. Toto je běžná bezpečnostní funkce systému Linux. Je to snadná oprava:

• Klikněte pravým tlačítkem myši na soubor RadioRec (ten, který jste se pokusili spustit).
• Přejděte do Vlastnosti.
• Vyhledejte kartu Oprávnění.
• Zaškrtněte políčko „Povolit spuštění souboru jako programu“ nebo „Je spustitelný“.
• Zavřete okno vlastností.
• Nyní zkuste znovu dvakrát kliknout na soubor RadioRec. Měl by se spustit!

Použití a základní komponenty

Hlavní okno

Hlavní rozhraní RadioRec, zobrazující seznam stanic a programového průvodce.

Hlavní rozhraní je rozděleno na dvě části:

1. Seznam stanic: Vlevo najdete seznam stanic. Každá položka zobrazuje název stanice, odkaz na stream a tlačítko pro rychlý přístup k funkci Přehrát.
2. Seznamy programů a nahrávek: Vpravo se na kartách zobrazuje naplánovaný programový průvodce (načtený z webu) a seznam nadcházejících nebo dokončených nahrávek. Každá položka zobrazuje název, komentář, časy zahájení/ukončení a ukazatel průběhu aktivních položek.

Aplikace dokáže současně nahrávat z více stanic a přehrávat z jiné, než je ta, která se aktuálně nahrává.

Hlavní panel nástrojů

Vysvětlení ikon hlavního panelu nástrojů:

Ikona	Akce	Popis
	Přidat stanici	Otevře dialogové okno pro vytvoření nové stanice. Můžete zadat její název, URL streamu a poté ji uložit jako soubor.
	Otevřít stanici	Umožňuje načíst jeden nebo více dříve uložených souborů stanic (.radiorec-station) z počítače.
	Upravit stanici	Otevře dialogové okno pro úpravu vlastností aktuálně vybrané stanice v seznamu.
	Smazat stanici	Trvale odstraní vybranou stanici ze seznamu.
	Přehrát / Zastavit	Spustí živé přehrávání vybrané stanice. Během přehrávání se ikona zbarví do zelena. Dalším kliknutím přehrávání zastavíte.
	Nastavení	Otevře okno nastavení aplikace (např. kam ukládat nahrávky atd.).
	Nápověda	Tato ikona je momentálně neaktivní.

Panel nástrojů programu

Vysvětlení ikon panelu nástrojů programu:

Ikona	Akce	Popis
	Aktualizace programu	Stáhne nejnovější vysílací program (EPG) pro vybranou stanici. Chvíli počkejte, než se stáhne celá stránka.
	Vymazat program	Odstraní všechny položky ze zobrazeného seznamu programů. To je užitečné, když chcete načíst zcela nový program.
	Naplánovat nahrávání	Vyberte jeden nebo více pořadů v seznamu a kliknutím na tuto ikonu se automaticky vytvoří úlohy pro jejich nahrávání.

Panel nástrojů pro nahrávání

Vysvětlení ikon panelu nástrojů pro nahrávání:

Ikona	Akce	Popis
	Přidat ruční nahrávání	Otevře dialogové okno, kde můžete ručně nastavit nahrávání pro konkrétní datum a čas.
	Smazat nahrávku	Smaže vybranou úlohu nahrávání ze seznamu. Pokud nahrávání probíhá, zobrazí se dotaz, zda jej chcete zastavit.

Editor stanice

Stanice se ukládají jako soubor do adresáře na disku.

Přidáním nebo úpravou stanice se otevře dialogové okno „Stanice“. Zde můžete nastavit:

• Název stanice: Popisný název stanice.
• Stránka stanice: Přímá URL adresa k audio streamu (např. .mp3).
• Metoda nahrávání: (Manuální, Stream, Program – v současné době je manuální nahrávání primární metodou plánování).

Kliknutím na Nastavení programu (Program Settings) v tomto dialogovém okně se otevře pokročilý analyzátor.

Pokročilý analyzátor programového průvodce

Toto je nejvýkonnější funkce RadioRec, která vám umožňuje získávat data programu z webových stránek jakékoli stanice. Dialogové okno „Nastavení programu“ má tři záložky:

1. Nastavení

Definujte pravidla parsování.

• URL stránky programu: URL webové stránky, která zobrazuje programový plán.
• Časové pásmo stránky: Časové pásmo časů programu uvedených na webu.
• Kořenový XPath: Výraz XPath pro výběr seznamu všech položek programu (např. //li[@class='program-item']).
• Dotazy CSS: Použijte selektory CSS k nalezení Názvu a Komentáře v každé kořenové položce.
• Atributy času: Zadejte názvy atributů HTML (např. data-start, data-end) a formát času (např. rrrr-MM-dd'T'HH:mm:ss) pro extrakci časů zahájení a ukončení.

Tip: Více o XPath se můžete dozvědět zde: W3Schools – XPath Tutorial

2. Hledat

• Klikněte na Získat zdrojový kód (Get Source) a stáhnete HTML kód stránky programu.
• Zdrojový kód se zobrazí se zvýrazněním syntaxe, které vám pomůže najít správné prvky a atributy pro vaše pravidla. Můžete dokonce změnit barevné téma editoru.

3. Analýza

• Klikněte na „Analyzovat“ (Parse) a otestujte pravidla na kartě „Nastavení“ ve staženém HTML.
• Výsledky se zobrazí v tabulce, která přesně ukazuje, jaká data budou importována. To vám umožní doladit selektory, dokud nebudou perfektní.

Dialogové okno nahrávání

Nahrávání můžete naplánovat ručně pomocí dialogového okna „Nahrávání“, které je přístupné přes ikonu plus na kartě Nahrávání. To je ideální pro pořady, které nejsou v programovém průvodci, nebo pro nahrávání v určitých časech. Můžete nastavit:

• Název souboru: (Volitelné) Vlastní název souboru.
• Název a komentář: Podrobnosti o nahrávce.
• Čas zahájení a ukončení: Přesný výběr data a času pro začátek a konec nahrávky.

Podporované zástupné symboly v názvech vlastních souborů:

Nastavení aplikace

Hlavní „dialogové okno nastavení“ nabízí rozsáhlé možnosti přizpůsobení, je uspořádáno do čtyř karet a je přístupné kliknutím na ikonu ozubeného kola v pravém horním rohu.

1. Soubor

• Adresář stanic: Kam ukládat konfigurační soubory stanice.
• Adresář záznamů: Hlavní složka pro všechny vaše zvukové nahrávky.
• Vytvořit podsložky: Automaticky uspořádat nahrávky do podsložek.
• Formát podsložky: Definuje strukturu podsložek (např. {station}/{year}/{month}).
• Formát názvu souboru: Definuje konvenci pojmenování souborů nahrávek (např. {year}{month}{day} {station} - {title}).
• Dočasný adresář: Složka pro dočasné soubory během nahrávání.

Dostupné zástupné symboly pro názvy složek a souborů:

2. Čas

• Časové pásmo: Časové pásmo, které bude vaše aplikace používat k zobrazení všech časů.
• Formát času: Vlastní formát pro zobrazení data a časů.
• Přidat k času záznamu: Automaticky přidat vyrovnávací paměť (např. 00m05s) na konec naplánovaných nahrávek.

Formát času

Popis fragmentů:

Příklady výstupů pro různé formáty:

Uživatelé mohou tyto fragmenty volně kombinovat a definovat si vlastní formát zobrazení času.

3. Prohlížeč

• Cesta webového prohlížeče: Cesta k souboru spustitelného souboru vašeho webového prohlížeče (např. chrome.exe).
• Příkaz prohlížeče: (Důležité pro parsování) Argumenty příkazového řádku potřebné ke spuštění prohlížeče v headless režimu a výpisu HTML stránky (např. --headless --dump-dom).

4. Vzhled

• Jazyk: Vyberte jazyk zobrazení aplikace.
• Motiv: Přepínání mezi Světlým a Tmavým motivem uživatelského rozhraní.
• Velikost: Změna globální velikosti písma pro uživatelské rozhraní (Malé, Střední, Velké).

Dostupné rozhlasové stanice

• Toto jsou některé z rozhlasových stanic, které se aktuálně používají s RadioRec.
• Můžete si také vytvořit vlastní soubory stanic.
• Pokud chcete, můžete soubor stanice poslat autorovi adlatus@marelis.cz a může být přidán do oficiálního seznamu.

Země	Soubor stanice	Formát vysílání	Název stanice	Webové stránky
Česko		MP3	Český rozhlas Dvojka	dvojka.rozhlas.cz
Česko		MP3	Český rozhlas Vltava	vltava.rozhlas.cz

Použité technologie

Tento projekt je vytvořen v Java 17 a spravován pomocí Apache Maven. Kombinuje několik klíčových open-source knihoven pro zajištění svých funkcí:

Základní platforma a sestavení

• Java 17: Aplikace je sestavena pomocí sady Java Development Kit verze 17.
• Apache Maven: Spravuje životní cyklus sestavení a závislosti projektu.
• Plugin Maven Antrun: Používá se během procesu sestavení k dynamickému generování seznamu dostupných jazykových balíčků (available-bundles.txt).

Uživatelské rozhraní (GUI)

• Java Swing: Základní framework pro grafické uživatelské rozhraní desktopu.
• FlatLaf (od FormDev): Moderní knihovna s plochým vzhledem a chováním pro Java Swing, která poskytuje Světlá a Tmavá témata aplikace.
• LGoodDatePicker: Uživatelsky přívětivá a na funkce bohatá komponenta pro výběr data a času používaná v „Dialogu záznamu“ pro plánování.
• RSyntaxTextArea: Výkonný textový editor se zvýrazňováním syntaxe používaný pro prohlížeč zdrojového kódu HTML v nastavení „Analyzátor programového průvodce“.

Zpracování zvuku a dat

• Jsoup: Základní knihovna používaná k načítání, parsování a procházení HTML programových průvodců stanic.
• JLayer (od JavaZoom): Knihovna používaná pro dekódování a přehrávání audio streamů MP3 v reálném čase.
• mp3agic (od mpatric): Knihovna pro čtení a manipulaci s metadaty MP3 (ID3 tagy), která umožňuje aplikaci zpracovávat informace o skladbách.
• Apache Commons IO: Utilita, která zjednodušuje I/O operace, jako je manipulace se soubory a streamy.

Více informací najdete v repozitáři na GitHub.

• GitHub

Toto dílo podléhá licenci Apache 2.0