Hörer-Karte Stream-Edition
Die Premium-Erweiterung zur Hörer-Karte: zeigt zusätzlich die echten Stream-Hörer aus deinem SHOUTcast/Icecast/AzuraCast/DGNCast-Server.
Die Free-Hörer-Karte sieht nur Webseite-Besucher. Wer den Stream-Link direkt in Winamp, VLC oder einer Mobile-Radio-App öffnet, erscheint dort nie. Die Stream-Edition schließt diese Lücke: sie liest die Listener-IPs direkt aus der Admin-API deines Stream-Servers und zeigt zusätzlich Pins für deine echten Stream-Hörer auf der Welt-Karte. DSGVO-konform mit gesalzenem Hash, keine Klartext-IP-Speicherung.
Was du konkret bekommst
Echte Stream-Hörer auf der Karte
Pins für alle aktiven Stream-Hörer in Echtzeit, unterschieden von Webseite-Besuchern durch eigene Pin-Farbe. Wenn deine Sponsoren oder du selbst sehen wollen wer wirklich aktiv mithört (nicht nur kurz auf der Seite war), liefert die Stream-Edition genau das.
Premium-Dashboard mit Live-Daten
Eigenes Backend-Dashboard mit:
- Live-Hörer-Zähler in Echtzeit
- Stream-Server-Status-LEDs (online/offline pro Server)
- 7-Tage-Aktivitäts-Heatmap (Wochentag × Stunde)
- Liste aller gerade verbundenen Hörer mit Standort und Player-Erkennung
- Top-Länder-Ranking mit Live-Anzeige
Player-Erkennung
Pro Hörer wird der genutzte Player erkannt: Winamp, VLC, foobar2000, iTunes, mpv, MPlayer, TuneIn, Radio Garden, XiiaLive (Android), Transistor (Android), Browser. Hilft dir bei der Frage "auf welcher Plattform sitzen meine Hörer".
Mehrere Stream-Server gleichzeitig
Hast du mehrere Streams (Hauptkanal, Chillout, Comedy)? Lege beliebig viele Stream-Server-Konfigurationen an, jeder mit eigener Pin-Farbe. Auf einer Karte siehst du sofort wo welcher Sender gehört wird.
Unterstützte Stream-Server
| Server | Was gelesen wird |
|---|---|
| SHOUTcast v1 | Admin-XML mit Einzel-IPs und Connection-Time |
| SHOUTcast v2 | viewxml-Endpoint plus Fallback auf /statistics und /stats |
| Icecast2 | /admin/listclients.xsl pro Mount-Point |
| AzuraCast | /api/nowplaying (nur Zähler, ohne Admin-Token keine Einzel-IPs) |
| DGNCast | /api/listeners mit Einzel-IPs (DACH-Komplett-Lösung) |
DSGVO und Datenschutz
Die Stream-Edition ist DSGVO-konform aufgesetzt:
- Kein Klartext-IP-Speichern: Sobald eine IP angekommen ist, wird sie mit einem geheimen Salt gehasht. Nur der Hash und die geolokalisierten Koordinaten landen in der Datenbank.
- Granulare Aufbewahrungs-Frist: Standard 90 Tage, konfigurierbar zwischen 1 und 3650 Tagen.
- Auto-Cleanup: ältere Einträge werden automatisch entfernt.
- Geo-Lookup: nutzt den gleichen anonymisierten Dienst wie die Free-Hörer-Karte (ip-api.com, kein Tracking).
Datenschutz-Hinweis-Vorlage zum Kopieren liegt im Admin-Bereich des Plugins.
Installation und Aktivierung
Voraussetzung: RadioCMS Community Edition 2.2.0 oder neuer. Die Free-Hörer-Karte muss nicht installiert sein, ist aber empfohlen, weil dann die Karte beide Hörer-Gruppen (Webseite + Stream) auf einer einzigen Ansicht zeigt.
Schritt 1: Plugin im Marketplace laden
Admin → Plugins → Tab Marketplace → "Hörer-Karte Stream-Edition" finden (lila PRO-Badge) → "Lizenz-Schlüssel eingeben" → "Plugin laden" → Plugin lädt direkt → in der Plugin-Liste "Aktivieren".
Schritt 2: Stream-Server anlegen
Sidebar → Hörer-Karte Stream → Stream-Server öffnen. "Neuen Stream-Server anlegen" mit:
- Name (frei wählbar, z.B. "Hauptkanal Icecast")
- Server-Typ aus der Liste
- Host und Port (ohne Pfad)
- Admin-Benutzer und Admin-Passwort (für SHOUTcast/Icecast) oder API-Key (für AzuraCast/DGNCast)
- Pin-Farbe für die Karte
"Verbindung testen"-Knopf prüft sofort ob der Server antwortet.
Schritt 3: Polling läuft automatisch
Sobald aktiv, pollt das Plugin alle 60 Sekunden (einstellbar) jeden konfigurierten Stream-Server und aktualisiert die Hörer-Liste. Du musst nichts weiter tun.
Schritt 4: Widget einbauen
Im klassischen Widget-Editor oder im Page-Builder Pro v2 das "Hörer-Karte Stream-Edition"-Widget einfügen. Unter Einstellungen kannst du wählen ob die Karte allein steht oder mit der Free-Hörer-Karte kombiniert wird.
Premium-Optik im Frontend
Das Widget hat einen subtilen Gold-Akzent (Gradient-Border, Premium-Badge), pulsende Live-Pins für aktuell verbundene Hörer und kleinere Schimmer-Pins für kürzlich aktive Standorte. Wenn die Kombi-Karte aktiv ist, zeigen Webseite-Besucher cyan, Stream-Hörer in deiner gewählten Pin-Farbe. So sieht der Besucher auf einen Blick: "wir haben sowohl Webseite- als auch Stream-Reichweite".
Häufige Fragen
Funktioniert das ohne Stream-Server-Admin-Zugang?
Bei AzuraCast geht es ohne Admin-Token, dann siehst du aber nur die Hörer-Zahl, keine Einzel-IPs (Karte bleibt leer). Bei SHOUTcast, Icecast und DGNCast brauchst du Admin-Zugang. Ohne Admin-Zugang ist die Stream-Edition deshalb nicht voll nutzbar.
Wie unterscheidet sich die Stream-Edition von der Free-Karte?
Free: zeigt nur Webseite-Besucher (Browser-Ping). Stream-Edition: zeigt zusätzlich die echten Stream-Hörer aus der Server-API plus Premium-Dashboard mit Live-Zahlen, LEDs, Heatmap und Player-Erkennung. Beide Plugins lassen sich kombinieren, ist die empfohlene Konfiguration.
Wie hoch ist die Server-Last durch das Polling?
Das Polling läuft via Cron einmal pro Minute und stellt eine HTTP-Anfrage pro Stream-Server. Mit 1-3 Streams ist die Last vernachlässigbar. Der Geo-Lookup wird pro IP nur einmal gemacht (Cache in der DB), nicht bei jedem Poll.
Können Stream-Hörer "anonymisiert" wieder rückwärts identifiziert werden?
Nein. Es wird nur der SHA-256-Hash der IP gespeichert (gesalzen). Aus dem Hash kann die IP nicht zurückgerechnet werden. Auf der Karte siehst du nur das Land und die Stadt, nicht den Hörer selbst.
Preis
4,99 EUR Einmalzahlung. Lebenslange Updates. Pro Lizenz auf maximal 2 Domains aktivierbar (z.B. dein Sender plus eine Test-Subdomain).
Voraussetzungen
RadioCMS Community Edition ab 2.2.0. Geo-Lookup über ip-api.com (kostenfrei, automatisch). Mindestens eine Admin-Zugriffs-fähige Stream-Server-API (SHOUTcast v1/v2 mit Admin-Passwort, Icecast2 mit Admin-Passwort, DGNCast mit API-Key oder ohne). Free-Hörer-Karte empfohlen aber nicht zwingend.