EHRE OVERLAY  -  Kurzanleitung
===================================

Sammelkarten deiner Gaeste fliegen per Chat-Befehl ins Bild.
Die ausfuehrliche Anleitung: Ehre-Anleitung.dc.html
(einfach im Browser oeffnen).


IN FUENF MINUTEN FERTIG
-----------------------

1) Diesen Ordner irgendwohin legen. Alles bleibt zusammen.
   Nutzt du noch weitere Overlays (z. B. Dalli-Klick, Say-Cheese)?
   Jedes braucht seinen EIGENEN Ordner - Dateien verschiedener
   Overlays niemals in einen gemeinsamen Ordner mischen (gleiche
   Dateinamen wuerden sich sonst gegenseitig ueberschreiben).
   Die Ordner nebeneinander liegen zu haben ist kein Problem.

2) Kartenbilder in  medien/friends  legen.
   Dateiname = Kanalname, z. B.  beispielkanal.png
   Hochkant, am besten 1000 x 1480 px.

3) Server starten:
   Windows -> Doppelklick auf  Server-starten.vbs
              Laeuft unsichtbar im Hintergrund, kein Fenster, nichts
              zu installieren (die noetige Laufzeit liegt schon im
              Ordner  runtime  bei). Zum Beenden: Doppelklick auf
              Server-beenden.bat
   macOS   -> Einmalig Node.js (LTS) von https://nodejs.org installieren.
              Dann Rechtsklick auf  Server-starten-Mac.command  -> Oeffnen
              -> Oeffnen (nur beim ersten Mal, danach reicht Doppelklick).
              Das Fenster muss offen bleiben.

4) In OBS eine BROWSER-Quelle anlegen:
   - "Lokale Datei" NICHT anhaken
   - Breite 1920, Hoehe 1080
   - "Quelle beim Unsichtbarwerden abschalten" AUS
   - URL (DEINKANAL ersetzen):

     http://localhost:8080/Ehre-Overlay.dc.html?channel=DEINKANAL&demo=0&status=0

   Zum Einrichten  &demo=0&status=0  weglassen: dann laeuft die
   Animation von allein und die Statuszeile zeigt die Kartenzahl.

5) Im Chat testen:
   !ehre        drei zufaellige Karten mit Mischen
   !sk kanalname     eine bestimmte Karte, mittig

   Ohne Chat: Rechtsklick auf die Quelle -> Interagieren,
   dann Taste G (drei Karten) oder S (Einzelkarte).


WENN ETWAS NICHT KLAPPT
-----------------------

Bild bleibt leer          -> Server nicht gestartet oder ueber
                             Server-beenden.bat beendet, oder in OBS
                             war "Lokale Datei" angehakt.
"keine Karten gefunden"   -> medien/friends ist leer oder liegt woanders.
Port 8080 belegt          -> ein anderes Programm blockiert den Port;
                             es einmal beenden und Server neu starten.
"runtime\node.exe fehlt"  -> Ordner unvollstaendig entpackt, ZIP-Datei
                             erneut komplett entpacken (Windows).
Node.js nicht gefunden    -> nur auf macOS relevant: Node.js (LTS) von
                             https://nodejs.org installieren, Skript
                             erneut starten.
Chat-Befehl tut nichts    -> ?channel= in der URL pruefen; ggf. laeuft
                             noch der 20-Sekunden-Cooldown.

Das Overlay liest den Chat anonym mit. Kein Login, kein Token,
keine Bot-Anbindung. Es sendet keine Daten ins Internet.


NUTZUNG
-------

Dieses Overlay ist kostenlos. Nutzen, anpassen und weitergeben ist
ausdruecklich erlaubt - gern mit einem Hinweis auf die Herkunft.
Keine Garantie, kein Support-Anspruch. Fuer die Bilder in deinem
Kartenordner bist du selbst verantwortlich.
