Dein erstes Livedeck-Widget: vom Starter-Kit zum Upload

Starter-Kit herunterladen, anpassen, als ZIP hochladen und im Editor testen.

6 Min. Lesezeit Aktualisiert 4. Nov. 2026

Das Starter-Kit ist ein fertiges Widget namens „Live Feed“: Es zeigt Geschenke, Follows und Chat als Karten und zählt die Likes. Von dort aus baust du dein eigenes.

Was im Paket steckt

manifest.json

Name, Version, Größe, Rechte und Einstellungen des Widgets

index.html

Die Startseite. Sie bindet das SDK und deine Dateien ein.

style.css

Das Aussehen

app.js

Die Logik: reagiert auf Ereignisse

README.md

Kurzanleitung

Die Startseite

Jede Startseite bindet das SDK über den Pfad /sdk/v1.js ein. Livedeck liefert es an der Adresse deines Widgets aus, du packst es nicht selbst ins Paket. Alle anderen Dateien bindest du mit relativen Pfaden ein.

html
<!doctype html>
<html lang="de">
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="style.css">
  <!-- Das SDK liefert Livedeck aus. Alles andere liegt in deinem Paket. -->
  <script src="/sdk/v1.js"></script>
</head>
<body>
  <div id="feed"></div>
  <script src="app.js"></script>
</body>
</html>

Auf Ereignisse reagieren

js
function show(text) {
  const line = document.createElement("p");
  line.textContent = text; // textContent, nie innerHTML: Namen sind Zuschauertext
  document.getElementById("feed").prepend(line);
}

livedeck.on("gift", (e) => {
  // "@" + e.user.handle (Benutzername), e.gift.name, e.count, e.totalDiamonds
  show("@" + e.user.handle + " schickt " + e.count + "× " + e.gift.name);
});

livedeck.on("follow", (e) => {
  show("@" + e.user.handle + " folgt dir jetzt");
});

livedeck.ready(() => {
  // Das Overlay ist verbunden, die Einstellungen sind da.
  document.body.style.color = livedeck.settings.accent;
});

Ein Widget bekommt nur die Ereignisse, die es in manifest.json unter permissions anfragt. Für das Beispiel oben sind das events.gift und events.follow.

Packen und hochladen

  1. Erhöhe in manifest.json die version (zum Beispiel von 1.0.0 auf 1.0.1), dann hältst du deine Versionen später auseinander.
  2. Packe die Dateien als ZIP. manifest.json muss oben im ZIP liegen oder in dem einen Ordner, der alles enthält. Windows: Dateien markieren › Rechtsklick › Senden an › ZIP-komprimierter Ordner. Mac: Dateien markieren › Rechtsklick › Komprimieren.
  3. Im Dashboard: Editor › Meine Widgets › „Eigenes hochladen“. Beim ersten Mal legst du ein Entwicklerprofil an und bestätigst die Regeln.
  4. Nach etwa einer Minute ist die Prüfung fertig. Nicht bestanden? Du siehst jeden Grund mit Datei und Zeile oder mit dem gemessenen Wert. Behebe ihn und lade eine neue ZIP-Datei hoch.
  5. Setze das Widget auf die Leinwand und probiere es mit den Test-Knöpfen in seinen Einstellungen aus (Geschenk, Chat, Likes und mehr).
Tipp: Nenne deine Dateien nur mit a bis z, Ziffern, Bindestrich und Unterstrich. Systemdateien wie __MACOSX, .DS_Store oder Thumbs.db ignoriert Livedeck.
Hinweis: Test-Ereignisse aus dem Editor und dem Marketplace kommen mit livedeck.context.test = true und erfundenen Zuschauern. Im OBS-Link ist der Wert false.

War dieser Artikel hilfreich?