Mit MediaTerm können im Terminal Filme aus den Mediatheken der öffentlich-rechtlichen
Fernsehsender gesucht, mit dem Mediaplayer mpv abgespielt sowie heruntergeladen werden.

VORAUSSETZUNGEN FUER DAS FUNKTIONIEREN DES SKRIPTS:
      ffmpeg, mpv, wget und xz bzw. xz-utils müssen installiert sein. Empfohlen wird außerdem
      eine aktuelle Version von yt-dlp.

AUFRUF:
      mediaterm [Optionen] [Suchbegriff(e)]
Suchbegriffe können ganze Wörter, aber auch Teilwörter sein.

INTERNE EINGABEZEILE:
      "mediaterm" ohne Optionen oder Argumente ausgeführt - aber auch jede erfolgreiche
      Suche aus dem Terminal - öffnet die interne Eingabezeile von MediaTerm. Auf ihr
      werden Suchanfragen nach obigem Muster OHNE einleitende Angabe des Befehls "mediaterm"
      ausgeführt. Das Abspielen, Anzeigen und Herunterladen der gefundenen Filme wird mit
      vorgegebenen Kommandos gesteuert. Eine Übersicht aller Kommando-Kürzel lässt sich per
      Eingabe von "k" in der internen Eingabe anzeigen.

ALLGEMEINE OPTIONEN:
      -b   Anzeige, Abspielen und Löschen der Bookmarks.
      -h   Zeigt diese Hilfe an.
      -k   Gibt die Ergebnisliste in kompakter Form ohne Filmbeschreibungen und
      Film-URLs aus.
      -n   Gibt die Ergebnisliste ohne interne Kommandozeile aus.
      -o   Gibt die Ergebnisliste ohne Farben aus.
      -u   Aktualisiert die Filmliste.
      -v   Zeigt die MediaTerm-Version, das Erstellungsdatum der Filmliste und die
      Anzahl der Filme.
      -w   Deaktiviert die worterhaltenden Zeilenumbrüche in der Ergebnisliste.

SUCHOPTIONEN (auch auf der internen Eingabezeile nutzbar):
   Mit Ausnahme der Option -l muss auf die folgenden Optionen mindestens ein Suchbegriff folgen.
      -A DATUM   Sucht nur Sendungen neuer als DATUM (und vom DATUM); DATUM muss im
      Format [[TT.]MM.]JJJJ eingegeben werden.
      -B DATUM   Sucht nur Sendungen älter als DATUM (und vom DATUM); DATUM muss im
      Format [[TT.]MM.]JJJJ eingegeben werden.
      -e   Entfernt Dubletten mit identischen Film-URLS aus den Suchergebnissen.
      -g   Unterscheidet bei der Suche zwischen Groß- und Kleinbuchstaben.
      -K MINUTEN   Sucht nur Filme, deren Dauer kürzer/gleich MINUTEN (ganze Zahl) ist.
      -L MINUTEN   Sucht nur Filme, deren Dauer länger/gleich MINUTEN (ganze Zahl) ist.
      -l   Listet alle Livestreams auf.
      -s   Sortiert Suchtreffer absteigend nach Sendedatum (neueste zuoberst).
      -t   Sortiert Suchtreffer aufsteigend nach Sendedatum (neueste zuunterst).

SUCH-OPERATOREN:
       +   Ein "+" unmittelbar vor einem Suchbegriff bewirkt, dass dieser als Einzelwort
       gesucht wird und NICHT als Zeichenfolge auch innerhalb von Wörtern.
       ~   Eine Tilde (~) unmittelbar vor einem Suchbegriff schließt diesen für die
       Suche gezielt aus. Dieser Operator kann nicht mit dem ersten Suchbegriff verwendet werden.
       " " Zwei oder mehr in Anführungszeichen gesetzte Wörter (z.B. "Thomas Mann")
       werden als exakte Wortfolge (Phrase) gesucht, d.h. die Wörter müssen in dieser
       Reihenfolge direkt aufeinander folgen.
       _   Ein Unterstrich (_) unmittelbar vor einem Suchbegriff bewirkt, dass dieser
       nur im Filmthema gesucht wird.

ANWENDUNGSBEISPIELE:
   mediaterm alpen klimawandel
      ... listet alle Filme auf, in deren Titel, Thema oder Beschreibung die Zeichenfolgen "alpen"
      und "klimawandel" vorkommen (unabhängig von Groß-/Kleinschreibung). Die gefundenen
      Filme können per Eingabe der jeweiligen Treffernummer gestreamt, heruntergeladen oder
      als Bookmark gespeichert werden.

   mediaterm -now alpen klimawandel
      ... liefert die gleiche Trefferliste in roher Form, d.h. ohne Kommandoeingabe (-n),
      ohne Farbe (-o) und ohne worterhaltende Zeilenumbrüche (-w). Dies ist sinnvoll, wenn
      die Liste weiterverarbeitet oder in eine Datei umgeleitet werden soll.

   mediaterm +gier
      ... sucht nur nach Treffern, in denen "gier" bzw. "Gier" als ganzes Wort vorkommt;
      beispielsweise bleiben "gierig", "Magier" oder "Passagiere" unberücksichtigt.

   mediaterm schlaf _"science talk"
      ... sucht nach Treffern mit dem Thema "Science Talk"", die den Suchbegriff "schlaf"
      enthalten.

   mediaterm -A 15.05.2015 -B 2016 alpen klimawandel
      ... beschränkt die Suche auf Sendungen aus dem Zeitraum 15.05.2015-31.12.2016.

   mediaterm -L 45 -K 120 alpen klimawandel
      ... beschränkt die Suche auf Filme, die länger oder gleich 45 Minuten sowie kürzer
      oder gleich 2 Stunden dauern.

   mediaterm python ~monty
      ... vermindert die Ergebnismenge der Suche nach "python" um alle Treffer, in denen die
      Zeichenfolge "monty" vorkommt.

ANPASSUNG:
   Mit der Variablen MT_PLAYER lässt sich ein alternativer Medienplayer (Standard =
   mpv) wählen, z.B.
      export MT_PLAYER="vlc --play-and-exit"

   Mit der Variablen MT_DLDIR lässt sich der Zielordner für Filmdownloads (Standard =
   aktuelles Arbeitsverz. $(pwd)) ändern, z.B.
      export MT_DLDIR="$HOME/Videos"

   Als dauerhafte Einstellung können die export-Befehle in die versteckte Datei ~/.bashrc
   eingefügt werden.