Erster Start

Systemvoraussetzungen

Unterstützt wird Windows, MacOs und Linux. Das Programm benötigt eine aktuelle Java-VM ab Version: 17 (Java17 oder höher, die darüber hinaus benötigten JavaFX-Runtimes sind im Programm bereits für alle Betriebssysteme enthalten).
Zum Abspielen werden geeignete Zusatzprogramme benötigt. P2Radio ist vorbereitet für die Verwendung des VLC Media Player.
Beim ersten Start von P2Radio wird bereits ein Programmset mit dem Hilfsprogramm VLC Media Player angelegt. Damit können alle Sendungen abgespielt werden.

Alle Versionen:

Ein Media-Player muss immer installiert sein. Der VLC-Media-Player ist im Programm vorbereitet. Wird ein anderer Player ausgewählt, muss er dann beim ersten Start (oder später in den Einstellungen) ausgewählt werden.

Windows:

Nur der VLC Media Player.

MacOs:

Nur der VLC Media Player.

Linux:

Für Linux-Benutzer wird OpenJDK in der aktuellen Version empfohlen.
Der VLC Media Player (und evtl. auch die vlc-codecs ) müssen durch die Paketverwaltung installiert werden.
Wurden Alternativprogramme ausgewählt (z.B. avconv) müssen die beim ersten Start ausgewählt werden oder später in den Einstellungen angepasst werden (der Pfad dafür ist dann wahrscheinlich:"/usr/bin/avconv").

Installation

P2Radio muss nicht installiert werden, das Entpacken der heruntergeladenen ZIP-Datei ist quasi die Installation.

Das Programm wird in verschiedenen Paketen angeboten. Diese unterscheiden sich nur im “Zubehör”, das Programm selbst ist in allen Paketen identisch:

P2Radio-XX__Windows==SETUP__DATUM.exe
Mit diesem Programmpaket kann das Programm auf Windows installiert werden: Doppelklick und alles wird eingerichtet, auch ein Startbutton auf dem Desktop. Es muss auch kein Java auf dem System installiert sein. (Die Java-Laufzeitumgebung ist enthalten).
P2Radio-XX__DATUM.zip
Das Programmpaket bringt nur das Programm und die benötigten Hilfsprogramme aber kein Java mit. Auf dem Rechner muss eine Java-Laufzeitumgebung ab Java17 installiert sein. Dieses Programmpaket kann auf allen Betriebssystemen verwendet werden. Es bringt Startdateien für Linux und Windows mit. Zip entpacken und Programm Starten.
P2Radio-XX__Linux+Java__DATUM.zip
P2Radio-XX__Win+Java__DATUM.zip
Diese Programmpakete bringen die Java-Laufzeitumgebung mit und sind nur für das angegebene Betriebssystem: Linux oder Windows. Es muss kein Java auf dem System installiert sein. (Die Java-Laufzeitumgebung liegt im Ordner: “Java” und kommt von jdk.java.net). Zip entpacken und Programm starten.
P2Radio-XX__Mac=mit=Java__DATUM.dmg
Das ist ein Programmpaket für macOS (Apple Silicon). Es muss auch kein Java auf dem System installiert sein. (Die Java-Laufzeitumgebung ist enthalten).
P2Radio-XX__Raspberry__DATUM.zip
Das ist ein Programmpaket, das auf einem Raspberry verwendet werden kann. Java muss installiert sein und es muss ein aktueller Raspberry mit einer 64Bit CPU mit AArch64 Architektur sein. Zip entpacken und Programm Starten.

Windows

Die heruntergeladene ZIP-Datei entpacken und den entpackten Ordner “P2Radio” ins Benutzerverzeichnis verschieben
Den eben entpackten P2Radio-Ordner öffnen, die Datei: P2Radio__Windows.exe ansteuern und per Rechtsklick in “Senden an” eine Verknüpfung auf den Desktop legen. Von dort aus kann P2Radio dann jeweils gestartet werden (oder auch mit Doppelklick auf die Datei: P2Radio__Windows.exe im Programmordner.
Die heruntergeladene ZIP-Datei kann nach dem Entpacken gelöscht werden

MacOs

Die Mac-Version ist ein DMG-Image, das eingebunden wird (mit Doppelklick) Die enthaltene App wird dann ins Programmverzeichnis kopiert.

Linux

Die heruntergeladene ZIP-Datei entpacken und den entpackten Ordner “P2Radio” ins Benutzerverzeichnis verschieben
Mit einem Rechtsklick auf den Desktop eine neue Verknüpfung zu einem Programm anlegen und dort die Startdatei im eben entpackten P2Radio-Ordner: P2Radio__Linux.sh auswählen. Mit dieser Verknüpfung (oder direkt mit Klick auf die Datei: P2Radio__Linux.sh kann dann das Programm P2Radio gestartet werden (der Vorgang kann sich für unterschiedliche Distributionen etwas unterscheiden).
Die heruntergeladene ZIP-Datei kann nach dem Entpacken gelöscht werden

Update

Das Update von P2Radio geschieht dadurch, dass man mit dem Inhalt der heruntergeladene ZIP-Datei die alten Dateien im Programmordner ersetzt. Die Einstellungen der vorhergehenden Programmversion werden von der neuen Version verwendet, es gibt also keinen neuen Einrichtungsdialog und die Einstellungen gehen nicht verloren.

Deinstallation

Es muss nur der Programmordner z.B. P2Radio und der Ordner mit den Einstellungen gelöscht werden. Die Einstellungen liegen im Ordner:

Linux:  
/home/USER/.p2Radio  

MacOs:  
/Users/USER/.p2Radio  

Windows:  
C:\Users\USER\p2Radio

Die Ordner werden als versteckte Ordner angelegt. Die Anzeige versteckter Ordner muss also im Dateimanager eingeschaltet sein. Es werden keine weiteren Änderungen am System vorgenommen. Werden dieser Einstellungsordner und der Programmordner gelöscht, ist das Programm wieder komplett entfernt.

Starten

Für Linux (P2Radio__Linux.sh) und Windows (P2Radio__Windows.exe) sind eigene Startdateien enthalten, mit denen P2Radio direkt gestartet werden kann.

Ansonsten kann man das Programm auch aus der Konsole (im Programmordner) starten:

Linux:  
java -jar ./P2Radio.jar  
/PFAD_ZU_JAVA/java -jar ./P2Radio.jar

Windows:  
java -jar P2Radio.jar  
PFAD_ZU_JAVA\java.exe -jar P2Radio.jar

Starten im portablen Modus

Für den portablen Einsatz z.B. auf einem USB-Stick stehen im Ordner “Portable” entsprechende Startdateien zur Verfügung (z.B. P2Radio__Windows__Portable.exe für Windows). Diese Startdateien müssen in den P2Radio-Programmordner verschoben werden. Beim portablen Start wird der Ordner “Einstellungen” im P2Radio-Programmordner angelegt. Da hinein können, falls gewünscht, die bisherigen Einstellungen aus dem Ordner “p2Radio” oder “.p2Radio” kopiert werden.

Starten mit zusätzlichen Parametern

java -jar P2Radio.jar [Pfad] [Parameter]  
java -jar P2Radio.jar c:\temp  
java -jar P2Radio.jar Einstellungen

Im ersten Fall (c:\temp) verwendet das Programm für die Einstellungen den absoluten Ordner “c:\temp”, im zweiten Fall wird der Ordner “Einstellungen” relativ zum Programmorder verwendet. (Damit kann man auch zwei Versionen des Programms parallel verwenden oder es kann auf einem USB-Stick verwendet werden.)

java -jar P2Radio.jar -h

Das Programm gibt eine Hilfe mit möglichen Parametern aus.

Parameter, die die Einstellungen der JavaVM ändern

java -jar -Dhttp.proxyHost=proxyserver -Dhttp.proxyPort=8080 P2Radio.jar

Es wird ein Proxyserver verwendet.

java -Xms128M -Xmx2G -jar P2Radio.jar  
java -Xmx2G -jar P2Radio.jar

Die Parameter “-Xms128M” für Mindestspeicher und “-Xmx2G” für Maximalspeicher helfen bei geringem Arbeitsspeicher. Wenn dem Programm zu wenig Speicher vom Betriebssystem zugewiesen wird, kann der Parameter “-Xmx2G” helfen.

java -Djava.net.preferIPv4Stack=true -jar P2Radio.jar  
java -Djava.net.preferIPv6Addresses=true -jar P2Radio.jar

Die Parameter “-Djava.net.preferIPv4Stack=true” und “-Djava.net.preferIPv6Addresses=true” ermöglichen eine Verbindung zum Internet, wenn der verwendete Netzwerk-Stack von Java nicht automatisch richtig erkannt wird, wodurch die Senderliste nicht geladen werden könnte.