[[Vorlage(Getestet, focal, jammy)]] {{{#!vorlage Wissen [:Pakete_installieren: Installation von Programmen] [:Programme_kompilieren: Pakete aus dem Quellcode erstellen] (optional) [:Terminal: Ein Terminal öffnen] [:Editor: Einen Editor öffnen] }}} [[Inhaltsverzeichnis(2)]] [[Bild(Wiki/Icons/rss.png, 75, left)]] [https://newsboat.org/ newsboat] {en} ist ein [:Feedreader:RSS-Feedreader] für die Konsole der auf allen unixartigen Betriebssystemen wie Linux, BSD oder MacOS X läuft. Es handelt sich dabei um eine Weiterentwicklung des Feedreaders [github:akrennmair/newsbeuter:newsbeuter], der nicht mehr aktiv entwickelt wird. Er unterstützt Filter, das Setzen von Tags und Flags, das Abrufen von Newsfeeds über einen Proxy-Server, Podcasts, den Abgleich mit OMPL-Abonements und vieles mehr. Was ihn ebenfalls auszeichnet ist dass newsboat sich durch sehr viele Optionen den eigenen Wünschen anpassen lässt. Es können eigene Tastenbelegungen definiert werden, das Aussehen lässt sich von der Farbe bis zur Formatierung der Darstellung ändern und es können noch hunderte andere Kleinigkeiten vom Nutzer festgelegt werden. = Installation = newsboat befindet sich in den Paketquellen und kann durch folgendes Paket installiert [1] werden: {{{#!vorlage Paketinstallation newsboat, universe }}} = Benutzung = newsboat kann nach der Installation im Terminal[3] durch den Befehl: {{{#!vorlage Befehl newsboat }}} gestartet werden. Vor dem ersten Start empfiehlt es sich allerdings, zunächst Feeds hinzuzufügen. == Feeds hinzufügen == === Von Hand === Um Feeds von Hand hinzuzufügen öffnet man mit einem Editor[4] die Datei '''~/.newsboat/urls''' und fügt dort die Adressen der Feeds ein, in jede Zeile einen. Wenn newsboat gerade läuft, lässt sich die Konfigurationsdatei über [[Vorlage(Tasten, strg+r)]] neu einlesen (siehe [#shortcuts Tastenbelegungen]). === Aus anderen Programmen importieren === newsboat bietet unzählige Möglichkeiten Feedlisten aus einem anderen Programm heraus zu importieren. Einige stehen unter [#param Konfiguration durch Startparameter] wieder andere stehen in der sehr ausführlichen offiziellen Dokumentation, die auf der Internetseite des Projektes zu finden ist. Wer zuvor `newsbeuter` nutzte, muss nichts importieren, da automatisch alle Konfigurationen übernommen werden. Hier sei nur auf folgenden Shellbefehl verwiesen mit dem man sehr einfach Feedlisten im opml-Format zur newsboat URL-Liste hinzufügen kann. Wenn ein anderes Programm seine Feedliste zum Beispiel in der Datei '''feedlist.opml''' speichert kann man sie mit folgendem Befehl nach newsboat portieren: {{{#!vorlage Befehl newsboat -i feedliste.opml }}} === In newsboat === Hat newsboat schon gestartet, lässt sich die Datei '''~/.newsboat/urls''' durch die Betätigung der Tasten [[Vorlage(Tasten, Shift+E)]] im Standardeditor öffnen und bearbeiten. Nachher wird sie neu eingeladen. [[Anker(shortcuts)]] == Tastenbelegung == Die grundlegende Benutzung ist recht simpel. Mit [[Vorlage(Tasten, shift+r)]] kann man alle Feeds auf einmal aktualisieren und mit [[Vorlage(Tasten, r)]] nur den momentan ausgewählten Feed. Mit [[Vorlage(Tasten, enter)]] kann man einen Feed und dort dann die einzelnen Nachrichten betreten und lesen. Mit [[Vorlage(Tasten, q)]] kommt man immer wieder zum Hauptmenü zurück. Mit [[Vorlage(Tasten, up)]] und [[Vorlage(Tasten, down)]] kann man innerhalb der Listen navigieren. Eine vollständige Liste der Tastenbelegung kann man dieser Tabelle entnehmen: {{{#!vorlage Tabelle Tastenkürzel Funktion Tastenkürzel Funktion +++ <:>[[Vorlage(Tasten, Enter)]] Öffnet den momentan ausgewählten Feed oder die Nachricht. <:>[[Vorlage(Tasten, q)]] Beendet newsboat oder wechselt zum nächst höheren Menü. +++ [[Vorlage(Tasten, n)]] Geht zum nächsten ungelesenen Artikel. [[Vorlage(Tasten, p)]] Geht zum vorherigen ungelesenen Artikel. +++ <:>[[Vorlage(Tasten, r)]] Aktualisiert den momentan ausgewählten Feed. <:>[[Vorlage(Tasten, shift+r)]] Aktualisiert alle Feeds. +++ [[Vorlage(Tasten, shift+A)]] Markiere alle Nachrichten im momentan ausgewählten oder betretenen Feed als gelesen. [[Vorlage(Tasten, shift+c)]] Markiere sämtliche Nachrichten in newsboat als gelesen. +++ <:>[[Vorlage(Tasten, s)]]||Speichert die momentane Nachricht in eine Datei. <:>[[Vorlage(Tasten, shift+sz)]] Zeigt die Hilfe an. +++ [[Vorlage(Tasten, strg+u)]] Schaltet zwischen HTML-Ansicht und Quellcode-Ansicht innerhalb eines Artikels um. [[Vorlage(Tasten, shift+n)]] Setzt einen ausgewählten Artikel als gelesen/ungelesen. +++ <:>[[Vorlage(Tasten, l)]] Verbirgt oder zeigt Feeds die nur gelesene Nachrichten enthalten im Hauptmenü. <:>[[Vorlage(Tasten, u)]] Zeigt alle URLs eines Artikels in einer Liste. +++ [[Vorlage(Tasten, strg+t)]] Entferne Tag von Feed. [[Vorlage(Tasten, t)]] Wähle einen Tag aus. +++ <:>[[Vorlage(Tasten, shift+7)]] Öffnet den Such-Dialog. <:>[[Vorlage(Tasten, e)]] Füge die Podcast Downloadurl, wenn eine gefunden wurde in die Podcast-Download-Warteschlange. +++ [[Vorlage(Tasten, strg+r)]] Liest die '''~/.newsboat/urls'''-Datei neu ein. [[Vorlage(Tasten, strg+l)]] Zeichnet den Bildschirm neu. +++ <:>[[Vorlage(Tasten, shift+.)]] Öffnet eine Kommandozeile innerhalb von newsboat, womit man ua. Ruby-Makros laden kann. <:>[[Vorlage(Tasten, shift+f)]] Setzt einen neuen Filter. +++ [[Vorlage(Tasten, f)]] Wählt einen bereits definierten Filter aus. [[Vorlage(Tasten, strg+f)]] Entfernt einen gesetzten Filter. +++ <:>[[Vorlage(Tasten, strg+b)]] Fügt einen Artikel oder eine ausgewählte Url zu den Lesezeichen hinzu. <:>[[Vorlage(Tasten, strg+e)]] Setze eine Flag des ausgewählten Artikels. +++ [[Vorlage(Tasten, strg+n)]] Geht zum nächsten Feed mit ungelesenen Artikel. Funktioniert nur aus einer Artikelübersicht eines anderen Feeds heraus. [[Vorlage(Tasten, strg+p)]]||Geht zum vorherigen Feed mit ungelesenen Artikel. Funktioniert nur aus einer Artikelübersicht eines anderen Feeds heraus. +++ <:>[[Vorlage(Tasten, up)]] Geht in einer Auswahl eins nach oben. <:>[[Vorlage(Tasten, down)]] Geht in einer Auswahl eins nach unten. }}} == Tags setzten == Tags erlauben einem seine Feeds zu kategorisieren. Man kann in der Übersicht einzelne Tags auswählen und dann nur die Feeds anzeigen lassen, die diesen Tag besitzen. Man setzt Tags in der '''~/.newsboat/urls''' indem man sie einfach von Leerzeichen von einander getrennt in der Zeile des Feeds ans Ende anfügt. Folgende Zeile zum Beispiel: {{{https://ikhaya.ubuntuusers.de/feeds/full/10/ Ubuntu Linux }}} weist den Ikhaya-News die beiden Tags ``Ubuntu`` und ``Linux`` zu. Innerhalb von newsboat kann man durch Drücken von [[Vorlage(Tasten, t)]] zwischen den einzelnen Tags auswählen. Wenn man einen Tag benutzen möchte der selbst Leerzeichen beinhaltet muss man ihn in Anführungszeichen setzen wie zum Beispiel: {{{https://ikhaya.ubuntuusers.de/feeds/full/10/ "Ubuntu Linux" }}} Dies setzt nur einen einzigen Tag für die Ikhaya-News mit dem Namen ``Ubuntu Linux``. = Konfiguration = [[Anker(param)]] == Durch Start-Parameter == Einige wenige Einstellungen lassen sich durch Kommandozeilen Parameter vornehmen, die man beim Start von newsboat an den Befehl dranhängt. Wie sie heißen und ihre Bedeutung kann man dieser Tabelle entnehmen: {{{#!vorlage Tabelle Parameter Bedeutung +++ <:>`-r` Überprüft alle Feeds beim Start von newsboat. +++ `-e` Exportiert die Feeds von newsboat ins opml-Format und schreibt sie auf den Screen. +++ <:>`-i DATEI` Importiert eine Feedliste aus DATEI im opml-Format nach newsboat. +++ `-u DATEI` Importiert eine Url-Liste aus `DATEI` nach newsboat. +++ <:> `-c DATEI` Wählt DATEI als alternativen Cache. +++ `-C Datei` Wählt DATEI als alternative Konfigurationsdatei. +++ <:> `-X` Leert den Cache. +++ `-h` Zeigt eine Hilfe. }}} == Durch eine Konfigurationsdatei == Um newsboat durch eine Konfigurationsdatei einstellen zu können muss diese erstmal erstellt werden. Standardmäßig wird die Datei '''config''' im Ordner '''~/.newsboat''' gelesen welche man mit folgendem Befehl erstellen kann: {{{#!vorlage Befehl touch ~/.newsboat/config }}} Mögliche Werte für die Konfigurationsdatei kann man dieser Tabelle entnehmen. Die Werte die in der Spalte "Standard" stehen müssen nicht eingetragen werden, da sie wie der Name bereits sagt standardmäßig benutzt werden auch wenn sie nicht eingestellt sind. Eine vollständige Liste der sehr zahlreichen Einstellungsmöglichkeiten kann man der offiziellen Dokumentation entnehmen. {{{#!vorlage Tabelle < rowclass="kopf">Option Werte Standard Bedeutung Beispiel +++ `always-display-description` true/false `false` Zeigt immer die Beschreibung eines Feeds an. `always-display-description true` +++ `browser` Befehl Standardbrowser Damit kann man festlegen, mit welchem Befehl/Browser Links geöffnet werden sollen. `browser firefox -new-tab` +++ `auto-reload` yes/no `no` Wenn aktiviert werden alle Feeds beim Start von newsbeuter aktualisiert und dann innerhalb eines regelmäßigen Zeitintervals, dass man mit `reload-time` einstellen kann. `auto-reload yes` +++ `reload-time` Zahl `60` Alle wieviel Minuten die Feeds aktualisiert werden sollen. `reload-time 30` +++ `max-items` Zahl `0` Wieviele Artikel pro Feed gleichzeitig gespeichert werden sollen. `0` bedeutet unendlich viele. `max-items 70` +++ `proxy` server:port keine Standardeinstellung Hier kann man einen Proxy angeben über den die Feeds aktualisiert werden sollen, wenn `use-proxy` aktiviert ist. `proxy localhost:8123` +++ `use-proxy` yes/no `no` Benutzt den angegebenen Proxy `use-proxy yes` +++ `user-agent` String `""` Benutzt den angegebenen User-Agent beim holen von Artikeln. `user-agent "Lynx/2.8.5rel.1 libwww-FM/2.14"` }}} === Farben einstellen === Man kann die Farben selber einstellen. Dazu trägt man die gewünschten Farben in der Syntax {{{ color [Bereich] [Vordergrundfarbe] [Hintergrundfarbe] }}} in der '''~/.newsboat/config''' ein. Folgende Bereiche können verstellt werden: * listnormal * listfocus * info * background * article Als Farben verwendet man: * black * red * green * yellow * blue * magenta * cyan * white * default = Podcasts = newsboat unterstützt das Speichern und Herunterladen von Podcasts. Ein Podcast ist ein RSS-Feed der Medieninhalte, meist in einem Audioformat in einem Artikel durch ``enclosure``-Tags definiert hat. Hat man solch einen Feed abonniert kann man in dem jeweiligen Artikel durch Drücken von [[Vorlage(Tasten, e)]] den Podcast zur Downloadwarteschlange hinzufügen, welche sich standardmäßig in '''~/.newsboat/queue''' befindet. Den Download kann man dann mit dem Programm podboat starten. podboat wird automatisch mit newsboat mitinstalliert und wird durch den Befehl: {{{#!vorlage Befehl podboat }}} gestartet. Die Tastenbelegung für podboat kann man folgender Tabelle entnehmen: {{{#!vorlage Tabelle < rowclass="kopf">Tastenkürzel Funktion Tastenkürzel Funktion +++ <:>[[Vorlage(Tasten, q)]] Beendet podboat. <:>[[Vorlage(Tasten, d)]] Lädt den markierten Podcast herunter. +++ <: rowclass="highlight">[[Vorlage(Tasten, c)]] Bricht den gewählten Download ab. <: rowclass="highlight">[[Vorlage(Tasten, shift+d)]] Löscht einen Podcast aus der Warteschlange. +++ <:>[[Vorlage(Tasten, shift+p)]] Aktualisiert die Übersicht und Warteschlange und entfernt fertige Downloads. <:>[[Vorlage(Tasten, a)]] Lädt sämtliche Podcasts in der Liste automatisch herunter. +++ <: rowclass="highlight">[[Vorlage(Tasten, p)]] Öffnet den heruntergeladenen Podcast bzw. spielt ihn ab. <: rowclass="highlight">[[Vorlage(Tasten, shift+sz)]] Zeigt eine Hilfe an. }}} podboat teilt sich die Konfigurationsdatei '''~/.newsboat/config''' mit newsboat. Man kann folgende Einstellungen in dieser Datei für podboat vornehmen: {{{#!vorlage Tabelle Option Werte Standard Bedeutung Beispiel +++ `download-path` Pfad `~/` Legt einen Downloadordner fest. `download-path "~/Downloads"` +++ `max-downloads` Zahl `1` Wenn man alle Podcasts automatisch herunterladen lässt, legt man hiermit die maximale Anzahl gleichzeitiger Downloads fest. `max-downloads 3` +++ `player` Befehl `""` Gibt den Befehl an mit dem ein heruntergeladener Podcast geöffnet werden soll. `player "mp3blaster"` +++ `podcast-auto-enqueue` yes/no `yes` Alle Podcasts, die newsboat in Artikeln findet werden automatisch zur Warteschlange hinzugefügt. `podcast-auto-enqueue yes` }}} == Player-Skript == Wie man sieht kann man nur einen generellen Player auswählen. Dies ist problematisch, wenn man Podcasts hat, die mal als Audio, mal als Video und manchmal auch nur als PDF daherkommen und man die unterschiedlichen Formate mit unterschiedlichen Programmen von podboat aus öffnen bzw. abspielen möchte. Um dieses Problem zu beseitigen kann man sich mit einem Skript helfen, zum Beispiel indem man folgendes [:Ruby:]-Skript nutzt (Ruby muss installiert sein): [attachment:newsboat/openmyfile:klick] {dl} und ausführbar machen mit: {{{#!vorlage Befehl chmod +x openmyfile }}} Danach verschiebt man es entweder nach '''/usr/local/bin/''' oder '''~/bin/''' und gibt es in der newsboat-Konfigurationsdatei als Player an: {{{player "openmyfile" }}} Jetzt wird podboat immer dieses Skript aufrufen, welches dann Anhand der Dateiendung entscheidet mit welchem Programm der Podcast geöffnet werden soll. Durch editieren des Skriptes kann man einstellen mit welchesm Programm, welche Dateiendung geöffnet werden soll. = Links = * [http://newsboat.org Offizielle Webseite mit umfangreicher Dokumentation] {en} # tag: Internet, Shell