> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streame.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Watchtime

> Zähle, wie lange deine Zuschauer bei dir zuschauen, und zeige es mit !watchtime und !top im Chat.

## Was ist Watchtime?

Watchtime zeigt, wie lange deine Zuschauer insgesamt bei dir zugeschaut haben. Gezählt wird nur, solange dein Chatbot aktiv ist und du live bist. Es zählt, wer im Chat verbunden ist, egal ob jemand schreibt oder nur zuschaut.

<Note>
  Watchtime braucht einen [aktiven Chatbot](/chatbot/settings). Ist er aus, wird nicht gezählt. Die gesammelte Watchtime bleibt dabei immer erhalten.
</Note>

***

## Wie wird gezählt?

Solange du live bist, schaut Streame **alle 5 Minuten** nach, wer in deinem Chat verbunden ist, und schreibt allen die vergangene Zeit gut. Wer zwischen zwei Durchgängen kommt und wieder geht, wird nicht erfasst. Auf eine Stunde gerechnet liegt die Abweichung bei wenigen Minuten.

Nicht gezählt werden:

* **Du selbst** und der **Streame-Bot**.
* **Bekannte Bots**, die Streame zentral ausschließt.
* **Ausgeschlossene Zuschauer**, die du unter Einstellungen einträgst, gedacht für eigene Bots in deinem Chat.

***

## Einschalten

<Steps>
  <Step title="Watchtime einschalten">
    Im Tab **Einstellungen** den Schalter **Watchtime** umlegen. Sobald du live bist, wird für alle im Chat gezählt.
  </Step>

  <Step title="Status prüfen">
    Oben auf der Seite steht der Status: **aktiv**, **pausiert** oder **ausgeschaltet**. Bei "aktiv" siehst du, wann zuletzt gezählt wurde.
  </Step>
</Steps>

### Warum steht da "pausiert"?

Streame fragt die Zuschauerliste mit deiner Twitch-Verbindung ab. Ist der Chatbot aus, fehlt eine Berechtigung oder ist die Verbindung abgelaufen, kann nicht gezählt werden. Die Seite sagt dir, was fehlt. Nach einer erneuten Anmeldung bei Twitch läuft Watchtime von selbst wieder an.

<Info>
  Erneut bei Twitch anmelden kann nur der Inhaber des Profils. Mods sehen den Hinweis, können die Verbindung aber nicht erneuern.
</Info>

***

## Commands im Chat

Mit eingeschalteter Watchtime sind zwei [Default Commands](/chatbot/default-commands) automatisch aktiv. Schaltest du Watchtime aus, fallen beide weg.

| Command              | Wer darf | Was er macht                                                                              |
| -------------------- | -------- | ----------------------------------------------------------------------------------------- |
| `!watchtime` (`!wt`) | **Alle** | Zeigt, wie lange jemand insgesamt zugeschaut hat. Mit `!watchtime @Name` auch für andere. |
| `!top`               | **Alle** | Zeigt die 10 Zuschauer mit der meisten Watchtime.                                         |

Die Antwort-Vorlagen passt du unter **Chatbot → Commands → Tab „Default"** an:

| Command      | Vorlage                                | Platzhalter                                                                                           |
| ------------ | -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `!watchtime` | `@{touser} hat {watchtime} zugeschaut` | `{touser}` ist der gefragte Zuschauer, `{watchtime}` seine Zeit                                       |
| `!top`       | `Top 10 Watchtime: {list}`             | `{list}` ist die nummerierte Liste, zum Beispiel `1. Anna (3 Tage 4 Std), 2. Ben (5 Std 12 Min), ...` |

<Note>
  Wer noch keine Watchtime hat, bekommt eine kurze Meldung statt einer Zahl. In der Top-Liste stehen keine `@`-Erwähnungen, sonst würde jedes `!top` zehn Leute anpingen.
</Note>

<Tip>
  Mit eingeschalteter Watchtime antwortet der Streame Chatbot auf `!watchtime` und `!top`, auch wenn die Befehle auf deiner [Ignore-Liste](/chatbot/ignore) stehen. Nutzt du parallel einen anderen Bot mit denselben Befehlen, schalte sie dort ab, sonst antworten beide.
</Tip>

***

## Format

Im Tab **Einstellungen** wählst du, wie `!watchtime`, `!top` und die Seite **Zuschauer** die Zeit anzeigen:

| Format                    | Beispiel       | Hinweis                                                   |
| ------------------------- | -------------- | --------------------------------------------------------- |
| **Formatiert** (Standard) | `3 Tage 4 Std` | Die zwei größten Einheiten aus Tagen, Stunden und Minuten |
| **Stunden**               | `76.38`        | Stunden mit zwei Nachkommastellen, ohne Einheit           |
| **Minuten**               | `4583`         | Ganze Minuten, ohne Einheit                               |

Stunden und Minuten kommen ohne Einheit. Die setzt du im Text deines Commands selbst, zum Beispiel `hat {watchtime} Stunden zugeschaut`.

***

## Zuschauer

Der Tab **Zuschauer** zeigt die **Top 10** deines Kanals und ein Feld **Zuschauer nachschlagen**: Twitch-Namen eingeben, Enter drücken, und du siehst die Watchtime dieses Zuschauers.

An jedem Eintrag kannst du:

* **Ausschließen** - Der Account wird ab jetzt nicht mehr gezählt, sein bestehender Eintrag wird gelöscht.
* **Eintrag löschen** - Die Watchtime dieses Zuschauers wird auf null gesetzt. Das lässt sich nicht rückgängig machen.

Einträge aus einem Import tragen die Markierung **importiert**, ausgeschlossene Accounts die Markierung **ausgeschlossen**.

<Info>
  Ausschließen und Löschen darf nur der Inhaber des Profils.
</Info>

***

## Ausgeschlossene Zuschauer

Im Tab **Einstellungen** trägst du Accounts ein, für die in deinem Kanal keine Watchtime gezählt werden soll, zum Beispiel deinen eigenen Bot. Bis zu 50 Accounts sind möglich, Änderungen wirken nach spätestens 5 Minuten.

Beim Ausschließen wird ein bestehender Eintrag des Accounts gelöscht. Hebst du den Ausschluss später auf, beginnt der Account wieder bei null.

***

## Watchtime importieren

Kommst du von einem anderen Bot, kannst du dessen Watchtime im Tab **Import** übernehmen. Die Zeit landet als importierte Zeit beim Zuschauer, die vom Chatbot gezählte Zeit kommt oben drauf.

<Steps>
  <Step title="Datei vorbereiten">
    Eine CSV- oder Textdatei mit zwei Spalten: Twitch-Name und Wert, zum Beispiel `whyscarface,1737.58`. Komma, Semikolon und Tab als Trennzeichen gehen, eine Kopfzeile wird erkannt. Höchstens 2 MB und 50.000 Zeilen.
  </Step>

  <Step title="Einheit und Modus wählen">
    Manche Bots exportieren Stunden (Streamlabs, z.B. 1737.58), andere Minuten (StreamElements, z.B. 212170). Wähle die passende Einheit, die Vorschau zeigt die größten Werte als Dauer, eine falsche Einheit fällt dort sofort auf. Als Modus wählst du **Wert übernehmen** oder **Bereits bei uns gezählte Zeit abziehen**, falls beide Bots eine Weile parallel liefen.
  </Step>

  <Step title="Datei hochladen oder Text einfügen">
    Die Vorschau erscheint direkt nach der Auswahl: Zeilen gesamt, gültig, ungültig, Duplikate, übersprungen und die größten Werte.
  </Step>

  <Step title="Import starten">
    Der Import läuft im Hintergrund in Blöcken. Jeder Name wird bei Twitch aufgelöst, damit die Zeit am richtigen Account hängt. Namen, die es bei Twitch nicht mehr gibt (gelöscht oder umbenannt), werden nicht importiert. Am Ende siehst du, wie viele Einträge importiert wurden, wie viele zusammengelegt und wie viele nicht zuordenbar waren.
  </Step>
</Steps>

<Warning>
  Pro Kanal gibt es einen Import. Mit **Import zurücksetzen** werden alle importierten Sekunden auf 0 gesetzt, die vom Chatbot gezählte Zeit bleibt. Danach kannst du neu importieren.
</Warning>

<Info>
  Importieren und Zurücksetzen darf nur der Inhaber des Profils.
</Info>

***

## Gut zu wissen

* **Nur live** - Gezählt wird nur, solange du live bist und der Chatbot aktiv ist.
* **Ausschalten löscht nichts** - Es wird nur nicht mehr weitergezählt. Schaltest du wieder ein, geht es beim alten Stand weiter.
* **Gleiche Zahl überall** - `!watchtime`, `!top` und die Seite Zuschauer zeigen dieselbe Zeit im gewählten Format.
* **Inhaber-Aktionen** - Ausschließen, Löschen, Import und die erneute Twitch-Anmeldung sind dem Inhaber des Profils vorbehalten.