> ## 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.

# $(clip)

> Erstellt automatisch einen Twitch-Clip und fügt die URL ein.

Erstellt automatisch einen Twitch-Clip vom aktuellen Stream und fügt die Clip-URL in die Antwort ein. Optional kannst du eine **Dauer** in Sekunden und/oder einen **Titel** mitgeben — beide Angaben sind optional und du kannst sie einzeln oder zusammen verwenden.

| Antwort-Text           | Wirkung                                                         |
| ---------------------- | --------------------------------------------------------------- |
| `$(clip)`              | Default: 30 Sekunden, Twitch-Auto-Titel                         |
| `$(clip 10)`           | 10 Sekunden, Twitch-Auto-Titel                                  |
| `$(clip ACE!)`         | 30 Sekunden, Titel **ACE!**                                     |
| `$(clip 10 ACE!)`      | 10 Sekunden, Titel **ACE!**                                     |
| `$(clip 5.5 Headshot)` | 5.5 Sekunden, Titel **Headshot**                                |
| `$(clip 5.123 Test)`   | 5.1 Sekunden (auf 0.1 gerundet), Titel **Test**                 |
| `$(clip 3)`            | 30 Sekunden, Titel **3** — `3` liegt außerhalb 5–60, wird Titel |
| `$(clip 100 Wow)`      | 30 Sekunden, Titel **100 Wow** — `100` liegt außerhalb 5–60     |

**Regeln für die Angaben:**

* Das **erste Wort** nach `$(clip` wird als Dauer interpretiert, wenn es eine Zahl zwischen **5 und 60** ist. Sonst gehört es zum Titel.
* Dauer mit bis zu **0.1 Sekunden** Genauigkeit (z.B. `12.3`). Höhere Präzision wird automatisch gerundet (`5.123` → `5.1`).
* Titel: maximal **100 Zeichen** — längere Titel werden automatisch gekürzt. Emojis zählen intern oft als 4–6 Zeichen, also etwas Puffer lassen.

<Warning>
  **Keine Klammern und keine weiteren Variablen im Titel.** `$(clip 5 Geiler (Ace))` wird am ersten `)` abgeschnitten, `$(clip 5 $(touser) gewonnen)` funktioniert nicht. Schreibe Titel ohne Klammern und ohne andere Variablen.
</Warning>

<Info>
  **Mehrfach-Verwendung:** Pro Command wird genau **ein** Clip erstellt — beim **ersten** `$(clip)` im Antwort-Text, mit dessen Angaben. Alle weiteren `$(clip)` werden durch leeren Text ersetzt.
</Info>

<Info>
  **Cooldown:** Commands mit `$(clip)` (in beliebiger Form) bekommen automatisch einen Cooldown von **45 Sekunden**, um die Twitch-API zu schonen und Spam zu vermeiden.
</Info>

<Info>
  **Clip-Länge & Bearbeitung:** Twitch nimmt automatisch rund **90 Sekunden** des Streams auf (ca. 85 Sekunden vor und 5 Sekunden nach dem Auslösen). Daraus wird der Clip in der gewählten Länge geschnitten — ohne Angabe **30 Sekunden**, mit `$(clip N)` zwischen **5 und 60 Sekunden**. Du hast danach **24 Stunden** Zeit, den Clip im Twitch-Editor zu bearbeiten — Titel ändern oder den Ausschnitt erneut anpassen.
</Info>

## Voraussetzungen

<CardGroup cols={2}>
  <Card title="Stream ist live" icon="signal-stream">
    Clips können nur während eines aktiven Streams erstellt werden.
  </Card>

  <Card title="Clipping für alle erlaubt" icon="scissors">
    Twitch Creator Dashboard → **Einstellungen → Stream → Clips** → „Wer kann Clips von deinem Kanal erstellen?" auf **Jeder** stellen.
  </Card>
</CardGroup>

## Wenn ein Clip nicht erstellt werden kann

Schlägt das Erstellen fehl, sendet der Bot eine der folgenden Nachrichten in den Chat:

<AccordionGroup>
  <Accordion title="Clips können nur erstellt werden, während der Stream live ist." defaultOpen={false}>
    **Ursache:** Der Stream ist offline.

    **Lösung:** Sobald du live bist, funktioniert der Command wieder.
  </Accordion>

  <Accordion title="Streame hat keine Berechtigung auf diesem Kanal zu clippen. Bitte Clipping für alle aktivieren." defaultOpen={false}>
    **Ursache:** Clipping ist deaktiviert oder nur für Follower/Subscriber erlaubt.

    **Lösung:** Twitch Creator Dashboard → **Einstellungen → Stream → Clips** → „Wer kann Clips von deinem Kanal erstellen?" auf **Jeder** stellen.
  </Accordion>

  <Accordion title="Clip konnte gerade nicht erstellt werden." defaultOpen={false}>
    **Ursache:** Allgemeiner Fehler (Probleme bei Twitch, zu viele Anfragen auf einmal oder ein kurzes Netzwerkproblem).

    **Lösung:** Den Command kurz später nochmal auslösen. Tritt der Fehler dauerhaft auf, beim Streame-Support melden.
  </Accordion>
</AccordionGroup>