https://github.com/schulle4u/sewira-py
A self-made Wifi Radio.
https://github.com/schulle4u/sewira-py
python radio shell
Last synced: about 2 months ago
JSON representation
A self-made Wifi Radio.
- Host: GitHub
- URL: https://github.com/schulle4u/sewira-py
- Owner: schulle4u
- License: mit
- Created: 2024-09-25T11:17:20.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-09T19:43:05.000Z (5 months ago)
- Last Synced: 2026-02-09T23:13:34.752Z (5 months ago)
- Topics: python, radio, shell
- Language: Python
- Homepage:
- Size: 6.42 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-de.md
- License: LICENSE
Awesome Lists containing this project
README
# SeWiRa
Ein Selfmade Wifi Radio.
## Hintergrund
Wie einfach kann es sein, ein WLAN-Radio zu bauen, ohne auf Lötkolben, 3d-Drucker oder ein Informatikstudium angewiesen zu sein? Ausgehend von solchen Fragen ist dieses Projekt entstanden. Mein WLAN-Radio besteht aus einem Raspberry Pi mit Raspberry Pi OS Lite, dazu eine externe Soundkarte, ein Ziffernblock als Fernbedienung sowie ein beliebiger Aktivlautsprecher oder HiFi-Verstärker. SeWiRa ist die Softwarekomponente für das Radio, und kann beliebig eingesetzt werden. Es ist ein Programm für die Shell, welches aus einem Verzeichnis mit M3u-Dateien ein Sendermenü erstellt. Die einzelnen Sender werden nummeriert und lassen sich über den Ziffernblock ansteuern. Das Prinzip ähnelt alten Kurzwellenempfängern, bei denen man nur die richtige Frequenz eingeben musste. Das Radio kann daher völlig ohne einen Bildschirm genutzt werden, lediglich für das Bearbeiten der Senderliste ist natürlich ein Zugang notwendig. Auf die von normalen WLAN-Radios gewohnte Senderdatenbank mit tausenden von Programmen muss man allerdings verzichten, bekommt mit diesem Projekt aber ein zuverlässig funktionierendes Radio, das einem keine bösen Überraschungen bereitet, wenn der Portalbetreiber den Datenbankzugang abschaltet. Und sollte der Senderbetreiber seinen Stream ändern, ist es eine Frage von Minuten, die neue Adresse im Sendermenü zu hinterlegen.
Dies ist die Python-Version des ursprünglichen SeWiRa, welche eine bessere Konfiguration bietet, und nicht nur auf Linux/Unix-artigen Systemen lauffähig ist. Wer das Original bevorzugt, [hier ist das Bash-Script](https://github.com/schulle4u/sewira).
## Einrichtung
### Voraussetzungen
* Python3 (erstellt mit Version 3.12, es sollte vermutlich auch mit allen anderen Python3-Installationen laufen)
* [MPV](https://mpv.io/) für die Wiedergabe der Streams. Der Player ist in den Paketquellen vieler Distributionen bereits vorhanden. Natürlich kann mit wenigen Handgriffen eine andere Software konfiguriert werden, sie sollte nur in der Lage sein, Radiostreams abzuspielen.
### Aus dem Quellcode starten
* Das Repository clonen oder alle Dateien herunterladen und in einem beliebigen Ordner entpacken, z. B. nach `/home/Benutzer/sewira-py`.
* Optional: `sewira.ini.dist` als `sewira.ini` speichern und mit eigenen Einstellungen anpassen.
* Weitere M3U-Dateien im Streams-Ordner ablegen. In jeder M3U-Datei sollte nur eine URL hinterlegt sein.
* Optional: Falls Stationsansagen gewünscht sind, lege eine virtuelle Umgebung an und installiere die pyttsx3-Abhängigkeit mit folgendem Befehl: `pip install -e .`
* Script aufrufen: `python ./run_sewira.py`
## Verwendung
Nach dem Aufruf von `sewira.py` erscheint ein Menü mit nummerierten Sendern. Der gewünschte Sender wird durch Eingabe der dargestellten Nummer und Enter aktiviert. Ist ein Sender nicht vorhanden, erfolgt eine entsprechende Fehlermeldung. Die ziffer 0 beendet das Menü. Die Sortierung der Sender erfolgt anhand des Dateinamens, also in der Regel alphabetisch. Durch das Voranstellen einer Ziffer am Dateinamen kann die Sortierung wie in einer Playliste beeinflusst werden. Die Dateinamen sollten das Muster `nnn-Station.m3u` verwenden, damit unnötige Zeichen automatisch aus der Stationsliste entfernt werden können. Das Muster `nnn` entspricht hierbei der bis zu dreistelligen Indexnummer im Dateinamen. Für die Wiedergabe wird standardmäßig MPV verwendet, jedoch ist der Player nur im Hintergrund aktiv, damit das Sendermenü immer für die nächste Eingabe geöffnet bleiben kann. Eine Steuerung des Players ist daher nicht vorgesehen.
## Konfiguration
Die folgenden Optionen sind in der Datei `sewira.ini` verfügbar:
`player` = das für die Streamwiedergabe zu verwendende Programm als absoluter Pfad oder Umgebungspfad (Standard: `mpv`)
`player_options` = eine durch Leerzeichen getrennte Liste von Optionen für den gewählten Player
`autoplay` = spiele automatisch einen der verfügbaren Streams bei Programmstart ab (Nummer des Menüeintrags)
`directory` = das Verzeichnis in welchem nach M3U-Dateien gesucht wird (Standard: `streams`)
`language` = überschreibt die automatische Erkennung der Programmsprache, normalerweise für Windows notwendig (Beispiel: `de_DE.UTF-8`)
`debug` = aktiviert eine ausführlichere Programmausgabe (Standard: False)
`tts_enabled` = Stationsansagen einschalten (Standard: True)
`tts_engine` = Überschreibt die automatische Treiberauswahl. Unterstützte Werte: espeak, sapi5, nsss oder ein benutzerdefinierter Pyttsx-Treiber.
`tts_voice` = Hier kann optional der Name einer Stimme eingegeben werden, das Programm versucht sie anhand des Substrings auszuwählen (Beispiel: Hedda)
`tts_rate` = Sprechgeschwindigkeit (Standard: 0)
`tts_volume` = Sprachlautstärke (Standard: -1)
Einige Optionen können auch als Kommandozeilenparameter übergeben werden. Starte sewira mit der Option `--help`, um alle verfügbaren Parameter anzuzeigen.
## Weitere Informationen und Projekte
* [RadioBrowser](https://radio-browser.info): Eine Datenbank zum Auffinden direkter Streamadressen für eure Favoritenliste.
* [Terminal Radio](https://github.com/shinokada/tera): Ein weiteres Internetradio im Textmodus, jedoch sehr viel umfangreicher und mit RadioBrowser-Zugriff.
## Entwicklung
Steffen Schultz. Nutzung auf eigene Gefahr, euer Haus könnte explodieren! 😁