{{{#!vorlage Warnung
Die Verwendung dieses Howto geschieht auf eigene Gefahr. Bei Problemen mit der Anleitung melde dies bitte in der dazugehörigen Diskussion und wende dich zusätzlich an den Verfasser des Howtos.
}}}

{{{#!vorlage Hinweis
Diese Howto-Anleitung wurde zuletzt von [user:Kellerkind2009:] am 25.3.2021 unter '''Ubuntu 18.04''' und '''Ubuntu 20.10''' erfolgreich getestet.
}}}

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Programme_starten: Starten von Programmen]
[:Terminal: Ein Terminal öffnen]
[:mit Root-Rechten arbeiten:]
}}}

[[Inhaltsverzeichnis()]]

[https://github.com/Axel-Erfurt/LiveStream-TVPlayer-Deutsch TVPlayer2] ist ein Player zum Abspielen von TV Streams.

=== Voraussetzungen ===

 * [:Python/#Python-3-x:python3]
 * PyQt5
 * [:FFmpeg:] (zum Aufnehmen des TV Streams)
 * [:mpv:]
 

=== Paketquelle Freischalten ===

Um die erforderlichen Pakete zu erhalten muss die Paketquelle [https://wiki.ubuntuusers.de/Paketquellen/#universe/ universe] Freigeschaltet sein.

{{{#!vorlage Befehl
sudo add-apt-repository universe && sudo apt-get update 
}}}

Danach lassen sich die erforderlichen Pakete Installieren.

=== Abhängige Pakete Installieren  ===

Abhängige Pakete kann man über die Paketquellen installieren mit


{{{#!vorlage Befehl
sudo apt-get install python3-pyqt5 python3-pip gstreamer1.0-plugins-bad libmpv1 python3-mpv
}}} 

=== Installation TVPlayer2 ===

im Terminal folgenden Befehl ausführen:

{{{#!vorlage Befehl
wget 'https://raw.githubusercontent.com/Axel-Erfurt/LiveStream-TVPlayer-Deutsch/master/TVPlayerInstall.sh' -O ~/Downloads/TVPlayerInstall.sh && chmod +x ~/Downloads/TVPlayerInstall.sh && ~/Downloads/TVPlayerInstall.sh
}}}

Damit wird die aktuelle Version von github heruntergeladen und im Ordner ''~/.local/share/'' gespeichert.

Ein Starter (TVPlayer2.desktop) wird in ~/.local/share/applications erstellt


=== Programm starten ===

Aus dem Startmenu (TVPlayer2)

oder im [:Terminal:] mit

{{{#!vorlage Befehl
cd ~/.local/share/LiveStream-TVPlayer-master && python3 ./TVPlayer2mpv.py
}}}

=== Deinstallation ===

Dazu im [:Terminal:] folgende Befehle ausführen

{{{#!vorlage Befehl
cd ~/.local/share/ && rm -rf ./LiveStream-TVPlayer-master
}}}

{{{#!vorlage Befehl
cd ~/.local/share/applications && rm ./TVPlayer2.desktop
}}}

{{{#!vorlage Befehl
cd ~/.config && rm -rf ./TVPlayer2
}}}

=== Bedienung ===

Die Bedienung erfolgt über das Kontextmenu oder Shortcuts.

Im Menü '''''ARD / ZDF / ORF''''' erscheinen die Sender der öffentlich-rechtlichen Anstalten. Im Menüenu ''eigene Sender'' erscheinen die Sender die in der Datei ''mychannels.txt'' hinterlegt sind

Wenn [FFmpeg] vorhanden ist kann mit oder ohne Timer aufgenommen werden.

==== Fernsehprogramm ====

Im Menü '''''Fernsehprogramm''''' gibt es:

 * TV Programm des Tages	-> zeigt das Tagesprogramm des laufenden Senders
 * TV Programm jetzt	-> zeigt was gerade läuft (mherere Sender)
 * TV Programm danach	-> zeigt was danach läuft (mherere Sender)


'''Menü''' ''URL vom Clipboard''

Wenn man z.B. auf einer Webseite einen Link zu einer TV Station findet kopiert man den Link.

Wenn man dann ''URL vom Clipboard spielen'' benutzt oder einfach [[Vorlage(Tasten, U)]] drückt wird es abgespielt.

Damit kann man testen ob es funktioniert und ob es sich lohnt den Sender zu übernehmen.

Das kann man durch das Menü '''''aktuellen Sender hinzufügen''''' tun. Im Dialog einen Namen eingeben und [[Vorlage(Tasten, OK)]] drücken.

Das Abspielen funktioniert im Prinzip mit allen Links von Video/Audio Dateien die das Betriebssystem spielen kann (m3u8, mp4, ts, mp3 ...)

Man kann aber auch den Link vom Browser in das TVPlayer2 Fenster ziehen, ebenso Video/Audio Dateien aus dem Dateimanager.

Auch solche Links können übernommen werden.

'''Menu''' ''Bildeinstellungen''

Die Einstellungen für Farbe / Helligkeit / Kontrast.

{{{#!vorlage Hinweis
Ob diese Einstellungen nutzbar sind hängt von der Grafikkarte und dem Treiber ab.
}}}

=== Sender verwalten ===

Mit dem Menü  '''''Eigene Sender bearbeiten''''' öffnet man die Datei ''mychannels.txt'' in der die eigenen Sender eingetragen werden können.

Diese Format muss verwendet werden:

{{{
Name,Url
}}}


also z.B.

{{{
ARD,http://mcdn.daserste.de/daserste/de/master.m3u8
}}}


{{{#!vorlage Hinweis
Sender entfernen kann man durch Löschen der entsprechenden Zeile in der Datei ''mychannels.txt''.
}}}

==== eigene Listen ====

Im Ordner ~/.local/share/LiveStream-TVPlayer-master/ können Listen hinzugefügt oder entfernt werden.

Sie müssen die Dateiendung .txt haben.

Die .txt Datei sollte das übliche Format haben. Name,URL

Beispiel:

{{{
ARD,http://mcdn.daserste.de/daserste/de/master.m3u8
}}}

Der Dateiname wird zum Menupunkt, z.B. Favoriten.txt erscheint als Favoriten im Menu.

In diesem Menu liegen dann alle Sender die in der jeweiligen Datei gespeichert sind.


=== Shortcuts ===

{{{#!vorlage Tabelle
[[Vorlage(Tasten, q)]]
Beenden
+++
[[Vorlage(Tasten, e)]]
Info laufende Sendung (wenn verfügber)
+++
[[Vorlage(Tasten, j)]]
was gerade läuft (mehrere Sender)
+++
[[Vorlage(Tasten, d)]]
was danach läuft (mehrere Sender)
+++
[[Vorlage(Tasten, p)]]
nächste Sendungen (aktueller Sender, wenn verfügbar)
+++
[[Vorlage(Tasten, f)]]
Vollbild an / aus (auch mit Doppelklick möglich)
+++
[[Vorlage(Tasten, m)]]
Ton an / aus
+++
[[Vorlage(Tasten, c)]]
Einstellungen Farbe / Helligkeit / Kontrast
+++
[[Vorlage(Tasten, u)]]
URL aus der Zwischenablage abspielen
+++
[[Vorlage(Tasten, h)]]
Mauszeiger an / aus
+++
[[Vorlage(Tasten, r)]]
Aufnahme starten mit Zeitbegrenzung ('''90m''' bedeutet 90 Minuten Aufnahme)
+++
[[Vorlage(Tasten, w)]]
Aufnahme starten ohne Zeitbegrenzung
+++
[[Vorlage(Tasten, s)]]
Aufnahme stoppen
+++
[[Vorlage(Tasten, Pfeil hoch)]]
lauter
+++
[[Vorlage(Tasten, Pfeil runter)]]
leiser
+++
[[Vorlage(Tasten, Pfeil rechts)]]
nächstes Programm der Liste (ARD /ZDF / ORF)
+++
[[Vorlage(Tasten, Pfeil links)]]
vorheriges Programm der Liste (ARD /ZDF / ORF)
+++
[[Vorlage(Tasten, Plus)]]
nächstes Programm der Liste (eigene Sender)
+++
[[Vorlage(Tasten, Minus)]]
vorheriges Programm der Liste (eigene Sender)
+++
[[Vorlage(Tasten, 0)]] - [[Vorlage(Tasten, 9)]]
Sender 1 -10 der in der Datei ''mychannels.txt'' gespeicherten Sender.
}}}

=== Problembehebung ===

Es kann passieren das TVPlayer2 eine Fehlermeldung wegen fehlenden Gstreamer Plugins anzeigt.Hier kann folgender Befehl oftmals helfen 

{{{#!vorlage Befehl
sudo apt-get install --reinstall gstreamer1.0-plugins-bad
}}}


=== Links ===


[https://github.com/Axel-Erfurt/LiveStream-TVPlayer-Deutsch github Projektseite]  {de}


##tag: Howto,Multimedia, Streaming