Skip to content

marianwolf/oidarwave

Repository files navigation

🎵 Oidarwave

Project Status Datenschutz License Version

Oidarwave ist ein minimalistisches und werbefreies Webradio für Desktop und Browser — elegant, schnell und respektvoll mit deiner Privatsphäre.

🎧 Live Demo · 📖 Dokumentation · ❓ Issues


📖 Inhaltsverzeichnis

🚀 Über das Projekt

Oidarwave ist ein minimalistisches und werbefreies Webradio, das ein reibungsloses Hörerlebnis direkt im Browser ermöglicht. Das Projekt wurde mit dem Ziel entwickelt, eine einfache und ablenkungsfreie Möglichkeit zu bieten, eine handverlesene Auswahl deutscher Radiosender und Fernsehprogramme zu hören und zu sehen.

Durch die Nutzung moderner Browser-APIs, einer schlanken Architektur und der strikten Fokussierung auf Privatsphäre bietet Oidarwave eine Alternative zu kommerziellen Streaming-Plattformen — ohne Tracking, ohne Werbung, ohne Kompromisse.

✨ Hauptfunktionen

  • HTML5-Audio & -Video: Die Anwendung nutzt https-Adressen, um Audio- und Videoinhalte abzurufen und wiederzugeben.
  • HLS-Unterstützung: hls.js ermöglicht die Wiedergabe von HTTP Live Streaming (HLS) Inhalten in kompatiblen Webbrowsern.
  • Echtzeit-Statusanzeige: Visuelle Indikatoren informieren sofort über den aktuellen Wiedergabe- und Verbindungsstatus.
  • Live-TV Streams: Unterstützung für öffentlich-rechtliche deutsche Fernsehsender.
  • Verlauf & Download: Wiedergabeverlauf wird lokal gespeichert und kann als JSON heruntergeladen werden.
  • Hosting: Dieses Projekt wird auf Vercel gehostet.

📻 Verfügbare Streams

Radio

Sender Livestream Metadaten
Deutschlandfunk Livestream Metadaten
Deutschlandfunk Nova Livestream Metadaten
NDR 1 Livestream Metadaten
NDR 2 Livestream Metadaten
NDR Info Livestream Metadaten
NDR Kultur Livestream Metadaten
N-JOY Livestream Metadaten
80s80s Livestream Metadaten
90s90s Livestream -
BBG Radio Livestream -

Fernsehen

Sender Livestream
Das Erste Livestream
ZDF Livestream
ARTE Livestream
Tagesschau24 Livestream

🛡️ Datenschutz

Oidarwave wurde von Grund auf so konzipiert, dass es die Privatsphäre der Nutzer respektiert und den EU-Richtlinien sowie der DSGVO entspricht.

  • Keine Tracking-Cookies: Das Projekt verwendet keine persistenten Cookies zur Verfolgung von Nutzeraktivitäten.
  • Lokale Speicherung: Einstellungen werden lokal im Browser (localStorage) gespeichert, was die Privatsphäre der Nutzer schützt. Diese Daten werden gespeichert:
    Attribut Wert
    Cookie ja od. nein
    Cookie-Datum Datum
    Letzer Radiosender URL
    Letzer Fernsehsender URL
    Datensparmodus ja od. nein
  • Transparente Einwilligung: Externe Skripte (wie z. B. für Web-Analytics) werden nur mit Ihrer expliziten Zustimmung geladen, sodass Sie stets die volle Kontrolle über Ihre Daten haben.

💾 Installation und Nutzung

Da Oidarwave eine statische Webseite ist, ist keine serverseitige Installation erforderlich.

  1. Repository klonen: Öffne dein Terminal und führe folgenden Befehl aus:
git clone https://github.com/marianwolf/oidarwave.git
  1. Datei öffnen: Navigiere in das neu geklonte Verzeichnis und öffne die index.html-Datei in deinem bevorzugten Webbrowser. Alternativ kannst du die Live-Version jederzeit hier nutzen: https://oidarwave.vercel.app

  2. Entwicklung & Tests

Für die Ausführung der Tests ist eine Python-Virtuelle Umgebung erforderlich:

# Virtuelle Umgebung erstellen und Abhängigkeiten installieren
python3 -m venv .venv
source .venv/bin/activate  # Auf Windows: .venv\Scripts\activate
pip install playwright pytest
playwright install chromium
  1. Tests ausführen (z.B.):
python tests/test_syntax.py

🤝 Mitwirken

Beiträge sind jederzeit willkommen! Ob es sich um Fehlerberichte, Funktionsvorschläge oder Code-Verbesserungen handelt, wir freuen uns über deine Beteiligung.

  1. Fehler melden: Erstelle ein Issue im GitHub-Repository.
  2. Funktionen vorschlagen: Nutze ebenfalls die Issues, um neue Ideen zu diskutieren.
  3. Code beitragen: Sende einen Pull Request mit deinen Änderungen. Bitte beachte, dass dein Code den Projektstandards entspricht.

🚀 Roadmap

  • Speichern des zuletzt gehörten Senders im localStorage (0.9.3)
  • Wiedergabe von Metadaten (0.9.4)
  • Verkürze die Latenz zum Datensparmodus (0.9.5)
  • neues Design (0.9.6)
  • verbessertes Design und Video Vor- und Rückspulen (0.9.7)
  • Verlauf im localStorage als .json (0.9.8)
  • Download des Verlaufs mit Ctrl + S (0.9.9)
  • Erweiterte Video-Fehlerdiagnose, PWA-Vorbereitung (0.9.10)
  • PWA, Design Optimierung, Download mit Ctrl + S gefixt (0.9.11)
  • Wiedergabeanzeige (0.9.12)
  • Aktualisierung des Design-Systems und Verbesserung der JavaScript-Fehlerbehandlung (0.9.13)
  • Elektron Build und npm (0.9.14)
  • Entwicklerdokumentation, Elektron Fehlerbehebungen und Renovate Bot (0.9.15)
  • Integration weiterer Sender
  • Umschaltung zwischen Dunkel- und Hellmodus
  • Favoriten
  • Nutzerprofile

Releases

Packages

Used by

Contributors

Languages