
=====================================================================
MTPlayer
=====================================================================


Das Programm MTPlayer durchsucht die Online-Mediatheken verschiedener
Sender und listet die gefundenen Sendungen auf. Die Liste kann mit
verschiedenen Filtern nach Beiträgen durchsucht werden. Mit einem
Programm eigener Wahl können die Filme angesehen und aufgezeichnet
werden. Es lassen sich Abos anlegen und neue Beiträge automatisch
herunterladen.


Website: 	https://github.com/xaverW/MTViewer



=====================================================================
Systemvoraussetzungen
=====================================================================

* Unterstützt wird Windows und Linux. Das Programm
benötigt unter Windows und Linux 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).

* Für Windws und Linux gibt es auch ein Programmpaket das die benötigte
Java-Laufzeitumgebung bereits mitbringt. Damit muss also auch kein Java
mehr installiert sein.

* Zum Ansehen und Aufzeichnen werden geeignete Zusatzprogramme benötigt.
MTPlayer ist vorbereitet für die Verwendung von VLC Media Player (zum
Abspielen und Aufzeichnen) sowie FFmpeg (zum Aufzeichnen).

* Beim ersten Start von MTPlayer werden bereits zwei Programmsets mit
den Hilfsprogrammen VLC Media Player und FFmpeg
angelegt. Damit können alle Filme angesehen und aufgezeichnet werden.


Windows
--------
* Für Windows muss nur der VLC Media Player installiert sein, ffmpeg
wird mitgeliefert.

Linux
------
* Für Linux-Benutzer wird OpenJDK empfohlen (oder das Programmpaket
das Java bereits enthält und so ohne Java-Installation auskommt).

* Bei Linux muss der VLC Media Player, und FFmpeg (oder avconv) 
durch die Paketverwaltung installiert werden.
Bei OpenSuse müssen zusätzlich zum VLC Media Player auch die vlc-codecs
installiert werden.

* Wurden Alternativprogramme ausgewählt (avconv) müssen
beim ersten Start diese ausgewählt werden oder später in den
Einstellungen zum Download evtl. angepasst werden (der Pfad dafür ist
dann wahrscheinlich: “/usr/bin/avconv”).



=====================================================================
Installation
=====================================================================

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


Windows
--------
* die heruntergeladene ZIP-Datei entpacken und den entpackten Ordner
“MTPlayer...” ins Benutzerverzeichnis verschieben

* den eben entpackten MTPlayer-Ordner öffnen, die Datei
“MTPlayer__Windows.exe” ansteuern und per Rechtsklick in “Senden an”
eine Verknüpfung auf den Desktop legen. Von dort aus kann MTPlayer dann
jeweils gestartet werden (oder auch mit Doppelklick auf die Datei
“MTPlayer.exe” im Programmordner”). Wenn man die Datei
“MTPlayer__Windows.exe” in die Taskleiste zieht, wird ein Schnellstarter
eingerichtet.

* die ZIP-Datei kann nach dem Entpacken gelöscht werden


Linux
------
* die heruntergeladene ZIP-Datei entpacken und den entpackten Ordner
“MTPlayer...” ins Benutzerverzeichnis verschieben

* mit einem Rechtsklick auf den Desktop eine neue Verknüpfung zu einem
Programm anlegen und dort die Startdatei im eben entpackten
MTPlayer-Ordner: “MTPlayer__Linux.sh” auswählen. Mit dieser Verknüpfung
(oder direkt mit Klick auf die Datei “MTPlayer__Linux.sh” kann dann das
Programm MTPlayer gestartet werden (der Vorgang kann sich für
unterschiedliche Distributionen etwas unterscheiden).

* die ZIP-Datei kann nach dem Entpacken gelöscht werden


=====================================================================
Programmstart
=====================================================================

Gestartet wird das Programm dann mit einem Doppelklick auf
die Startdatei.

Windows:
MTPlayer__Windows.exe

Linux:
MTPlayer__Linux.sh


=====================================================================
Programmstart aus der Konsole
=====================================================================

Linux:
# java -jar ./MTPlayer.jar

Windows:
# java -jar MTPlayer.jar


---------------------------------------
bei den Programmpaketen mit Java
---------------------------------------

Linux:
# ./Java/bin/java -jar ./MTPlayer.jar

Windows:
# Java\bin\java.exe -jar MTPlayer.jar


---------------------------------------
Ist die Java-Laufzeitumgebung nicht 
richtig installiert oder soll eine 
andere verwendet werden, muss der 
Pfad dorthin mit angegeben werden:
---------------------------------------

Linux:
# /PFAD_ZU_JAVA/java -jar ./MTPlayer.jar

Windows:
# PFAD_ZU_JAVA\javaw.exe -jar MTPlayer.jar



=====================================================================
Java Startparameter
=====================================================================

Damit kann das Verhalten von Java geändert werden. Wenn das Programm
ein Problem hat, kann das vielleicht helfen.

:: Start mit mehr Speicher für das Programm
java -Xms128M -Xmx2G -jar "C:\Users\USER\PFAD\MTPlayer.jar"

:: Start mit einem Pfad zu Java
:: Linux:
PFAD_ZU_JAVA/java -jar /home/USER/PFAD/MTPlayer.jar
:: Windows:
PFAD_ZU_JAVA\javaw.exe -jar "C:\Users\USER\PFAD\MTPlayer.jar"

:: Es wird ein Proxyserver verwendet. Der kann aber auch in
:: den Programmeinstellungen angegeben werden.
java -Dhttp.proxyHost=proxyserver -Dhttp.proxyPort=8080 -jar "C:\Users\USER\PFAD\MTPlayer.jar"

:: Der Parameter "-Djava.net.preferIPv4Stack=true", "-Djava.net.preferIPv6Addresses=true"
:: ermöglicht eine Verbindung zum Internet, wenn der verwendete
:: Netzwerk-Stack von Java nicht automatisch richtig erkannt wird, 
:: wodurch die Filmliste nicht geladen werden könnte.
java -Djava.net.preferIPv4Stack=true -jar "C:\Users\USER\PFAD\MTPlayer.jar"
java -Djava.net.preferIPv6Addresses=true -jar "C:\Users\PFAD\MTPlayer.jar"

:: Wenn die Bildschirmauflösung nicht richtig erkannt wird, kann es
:: helfen, wenn ein Scale-Factor mitgegeben wird.
:: Linux
java -Dglass.gtk.uiScale=200% -jar /home/USER/PFAD/MTPlayer.jar
java -Dglass.gtk.uiScale=192dpi -jar /home/USER/PFAD/MTPlayer.jar
java -Dglass.gtk.uiScale=2.0 -jar /home/USER/PFAD/MTPlayer.jar
:: Windows
java -Dglass.win.uiScale=200% -jar "C:\Users\USER\PFAD\MTPlayer.jar"
java -Dglass.win.uiScale=2.0 -jar "C:\Users\USER\PFAD\MTPlayer.jar"




=====================================================================
MTPlayer startet nicht:
=====================================================================

* Java ist nicht oder nicht in der richtigen Version installiert
(Java17, Java17+). Zum Java-Download: https://jdk.java.net/

* ZIP-Datei nicht entpackt: Die Programmdatei wurde direkt im
ZIP-Archiv doppelgeklickt. Die ZIP-Datei muss erst entpackt werden, dazu
sind alle Dateien aus dem ZIP-Archiv in ein beliebiges Verzeichnis zu
kopieren. Dort kann dann die Programmdatei "MTPlayer__Windows.exe"
oder "MTPlayer__Linux.sh" doppelgeklickt werden.

* Benötigte Dateien wurden aus dem Programm-Ordner gelöscht:
	->dann eine Neuinstallation.

* Für Windows gibt's noch weitere Infos im Ordner "Windows"

* Auf der Website sind noch weitere Infos zu finden:
	Website: 	https://github.com/xaverW/MTViewer


=====================================================================
=====================================================================

