Streemr/Dokumentation

Funktionen

Live-Badge

Das Herzstück von Streemr. Deine Profilseite erkennt automatisch, ob du gerade streamst — und passt sich entsprechend an.


Wie es funktioniert

Streemr fragt regelmäßig die Twitch Helix API ab, um deinen Live-Status zu prüfen:

GET https://api.twitch.tv/helix/streams?user_login={username}
  • Gibt die API ein Stream-Objekt zurück → du bist LIVE
  • Ist das Array leer → du bist OFFLINE
Hinweis: Der Live-Status wird alle 60 Sekunden neu abgerufen. Es kann also bis zu einer Minute dauern, bis deine Seite nach Stream-Start oder -Ende wechselt. Eine Echtzeit-Verbindung (WebSocket) ist für die meisten Anwendungsfälle nicht notwendig.

Sofortaktualisierung bei Einstellungsänderungen

Während der Live-Status per Polling aktualisiert wird, sind alle manuellen Einstellungsänderungen — Vorlage, Links, Bio, Monetarisierung, Impressum — sofort sichtbar, sobald du im Dashboard auf Speichern klickst.

Dafür nutzt Streemr die native BroadcastChannel-API des Browsers: Alle offenen Tabs mit deiner Profilseite erhalten die Änderungen in unter einer Millisekunde — ohne WebSocket, ohne Reload.

MechanismusWofürLatenz
Twitch API PollingLive-Status (Stream an/aus)bis 60 s
BroadcastChannelAlle Dashboard-Änderungen nach Speichern< 1 ms
Supabase RealtimeGeräteübergreifende Updates< 1 s

Live-Zustand

Wenn du live bist, zeigt deine Streemr-Seite:

  • Pulsierendes rotes LIVE Badge im Hero-Bereich
  • Aktuelle Zuschauerzahl (direkt aus dem Twitch API viewer_count Feld)
  • Prominenter „Jetzt zuschauen"-Button, der direkt zu deinem Twitch-Kanal führt
  • Visuelle Hervorhebung je nach gewählter Vorlage

Offline-Zustand

Wenn du offline bist, zeigt die Seite stattdessen:

  • „Folgen"- oder „Abonnieren"-Button als primären CTA
  • Neuestes VOD (nur bei aktivierter Option und Pro-Abonnement) — abgerufen via GET /helix/videos?type=archive
  • Dezentere visuelle Behandlung — kein roter Badge

Vorschau-Modus

Du kannst den Live-Zustand simulieren, ohne tatsächlich zu streamen — zum Beispiel, um das Layout zu überprüfen. Aktiviere dazu den Schalter „Live-Vorschau" in deinen Dashboard-Einstellungen.

Alternativ funktioniert auch der URL-Parameter:

https://streemr.site/deinname?preview=live
Wichtig: Der Vorschau-Modus ist für alle sichtbar, solange er aktiv ist. Deaktiviere ihn nach dem Testen wieder im Dashboard.