Installation¶

Die Anwendung liegt in den offiziellen Paketquellen vor und kann über die folgenden Pakete installiert ^[1] werden:

• streamtuner2 (universe)

• streamripper (universe)

mit apturl

sudo apt-get install streamtuner2 streamripper 

sudo aptitude install streamtuner2 streamripper 

Optional sind verschiedene Abspielprogramme (AudioPlayer, siehe Konfiguration).

Es erscheint danach bei Ubuntu-Varianten mit einem Anwendungsmenü unter "Multimedia -> streamtuner2". Ansonsten kann es mit dem Befehl streamtuner2 gestartet werden ^[2].

python streamtuner2.pyz 

Konfiguration¶

Beim ersten Start öffnet sich ein Konfigurationsfenster (ansonsten F12 ), in dem Einstellungen angepasst werden können. Auf der Registerkarte "Player" lassen sich für verschiedenen Übertragungsformate geeignete Abspielprogramme für Audio- und Video-Daten getrennt festlegen. Inzwischen wird beim ersten Start automatisch nach verfügbaren Playern gesucht. Gedacht ist die Einstellung natürlich um sein Lieblingsprogramm festzulegen. (Wenn das eingegebene Programm gefunden wurde, wird vor dessen Namen ein "Play"-Symbol angezeigt, anderenfalls das "Stop"-Icon.). Es eignen sich zum Beispiel:

• AudioPlayer:

  • Audacious mit audacious2

  • XMMS2 mit xmms2 %m3u

  • Amarok mit amarok -l %pls

  • Exaile mit exaile

  • Parole mit parole

  • VLC mit vlc --one-instance

• VideoPlayer:

  • VLC für den Video-Eintrag mit vlc --one-instance

  • Totem ist ebenso geeignet: totem

Einen Platzhalter wie %m3u oder %pls kann man optional angeben. Das legt nur den Typ der übergebenen Abspiel-Liste ("playlist") fest. Und der ist mittlerweile weniger relevant, da die meisten Programme sowieso alle Varianten unterstützen. Für ganz moderne Player eignet sich das kryptische %xspf als Platzhalter, wodurch mehr Radio-Informationen mitgeliefert werden.

Außerdem kann der gewünschte Webbrowser für das Anzeigen von Sender-Homepages konfiguriert werden.

Im Abschnitt "Recording applications" wird definiert, welche Programme für das Aufnehmen von Streams verwendet werden. Der De-facto-Standard für Audiostreams ist streamripper, welches in verschiedenen Linux-Distributionen bereits vorinstalliert ist. Hier muss auch der Pfad angegeben werden, in dem die Aufnahmen gespeochert werden sollen. Der Aufnahmepfad muss absolut sein und mit dem Parameter -d angegeben werden, z.B. -d /home/<Benutzername>/Musik.

Auf der Registerkarte "Options" sind verschiedene Einstellungen zusammengefasst, die für das Programm Streamtuner2 allgemein gelten. Unter "Display" werden die Anzeigeoptionen für das Hauptfenster oder Darstellungsvarianten für die Radioliste festgelegt, unter "System" kann bei Bedarf das Debugging zur Fehlersuche aktiviert werden. Die Verzeichnisse für temporäre Dateien sowie die Konfigurationsdateien werden lediglich angezeigt. Sie können nicht geändert werden.

Die Registerkarten "Channels" und "Features" enthalten Einstellungen für die verschiedenen Streamtuner2-Plugins. Zu allen Einstellungen erscheinen Tooltips, wenn man mit der Maus über den entsprechenden Einträgen verweilt. (siehe Plugins).

Hinter der Registerkarte "Add" verbirgt sich der Plugin Manager II, mit dem sich optionale Plugins über das Internet installieren oder Aktualisierungen für bereits installierte Plugins herunterladen lassen.

Bedienung¶

Die Bedienung ist denkbar einfach: Im Hauptfenster zum gewünschten Sender navigieren und diesen anklicken. Es öffnet sich der eingestellte Player mit dem Sender. Aufnahmen erfolgen über die Aufnahme-Taste oben im Hauptfenster. Die Titel werden im angegebenen Verzeichnis – in Abhängigkeit von der Quelle – als MP3- oder OGG-Datei gespeichert.

Bevorzugte Sender lassen sich als "Bookmarks" speichern, um sie schnell wieder finden zu können. Dazu wird der Sender über "Station -> Add bookmark" (oder F8 ) ausgewählt.

Um Streamtuner2 mit einem Proxy-Server zu verwenden, muss das Programm mit der Umgebungsvariable http_proxy=... (bitte anpassen) gestartet werden. Beispiel ^[4]:

/usr/bin/env HTTP_PROXY="http://127.0.0.1:8118" && streamtuner2 

streamtuner2 play "top 100" 

streamtuner2 url "frequence3" 

streamtuner2 category "shoutcast" "Kategorie" 

Tastenkürzel¶

Problembehebung¶

• Leere Kategorien-Liste:
  Nicht alle Plugins stellen beim ersten Start eine komplette Liste der Kategorien/Genres bereit. Das Aktualisieren ist aus Geschwindigkeitsgründen nicht Standard, kann aber über den Menüeintrag Channel -> Reload Category Tree nachgeholt werden.

• Backup der Lesezeichen erstellen:
  Hierfür steht in erster Linie das Plugin Export Category zur Verfügung. Das Station-Menü enthält dann den zusätzlichen Eintrag "Extensions" - "Export all stations". Hiermit lässt sich jede beliebige Channels-Ansicht speichern.
  Streamtuner2 hält sich an den Freedesktop-Standard für Konfigurationsdateien. Alle Anwendungsdaten finden sich unter ~/.config/streamtuner2/. Will man die Favoriten sichern, kopiert man daher einfach die Datei bookmarks.json. Jedoch enthält die Datei alles, was in der Bookmarks-Ansicht angezeigt wird, also auch den Verlauf, die Gtk2-Themen, Timer-Events usw.
  Programmeinstellungen befinden sich in der Datei settings.json.
  Zum Sichern und Wiederherstellen der kompletten Streamtuner2-Konfiguration steht auch das Plugin Config save/import/reset zur Verfügung.

• Es werden keine Radios geladen:
  Oftmals ändern die Dienstebetreiber ihre Webseiten. Dann funktioniert das Auslesen nicht mehr. Bei einigen Plugins (SHOUTcast) kann man aber in den Optionen ( F12 ) zwischen verschiedenen Parsern wählen. Reguläre Ausdrücke sind schneller, aber der "[x] PyQuery parsing" mitunter verlässlicher. Startet nur eines der Channel-Plugins nicht richtig, kann man es ebenso einfach einzeln deaktivieren:

  streamtuner2 -d xiph

• Programm hängt beim Start:
  Generell kann man Streamtuner2 über ein Terminalfenster starten. Hier gibt es die Option -D für weitere Debug-Meldungen. Auf rot markierte Ausgaben achten.

  streamtuner2 -D

• Wiedergabe "falscher" Sender:
  Gerade die älteren Versionen (2.0.x) hatten einige Gtk-Fehler. Nach einer Sortierung der Radio-Listen wurden die falschen Sender abgespielt. Hier half nur F5 , um die Anzeige wieder in die richtige Reihenfolge zu bringen. Aktuelle Versionen erlauben das Umsortieren nicht mehr, wodurch dieser bekannte Fehler nicht mehr auftritt.

• Speicherpfad für Mitschnitte:
  Falls sich dieser nicht über die GUI ändern lässt, bearbeitet man die Datei ~/.config/streamtuner2/settings.json und passt folgende Zeile an:

  "audio/*": "lxterminal -e \"streamripper %srv -d /PFAD/ZUM/ORDNER\"",

  Wer ein anderes Terminalprogramm benutzt, ersetzt auch lxterminal durch das jeweilige Programm.

    @dbus.service.method('net.sourceforge.radiotray')
    def addRadio(self, title, url, group="root"):
        self.dataProvider.addRadio(title, url, group) 

Links¶

• Projektseite

  • Streamtuner2 auf SourceForge

• Quellcode/Dokumentation

  • Ankündigungen/Versionshistorie auf freshcode.club

• Diskussion im hiesigen Forum für Anregungen, Anfragen, Probleme und Support