Media Library Grundlagen

Media Library Grundlagen

Die Media Library ist deine zentrale Asset-Verwaltung in Chatlix. Alle Bilder, Sounds und kurzen Videos, die du in Overlays, Automations, Alerts oder Pro-Editor-Widgets nutzt, liegen hier. Pro Account, mit Tags, Kategorien und Such-Funktion.

Das Dashboard erreichst du unter /dashboard/media. Der React-Component-Name ist MediaLibrary. Backend-seitig steckt das in Chatlix\Service\MediaService und unter Chatlix\Service\Media\* (11 Service-Dateien für Storage, CDN, Transcoding, Asset-Management).

Unterstützte Formate

• Bilder: PNG, JPG/JPEG, WebP, GIF (animierte GIFs werden als Animation gespeichert).
• Audio: MP3, OGG, WAV.
• Video: MP4, WebM. Für längere Aufzeichnungen (Stream-Mitschnitte) ist Clip-Studio das richtige Tool, nicht die Media Library.

Max. Dateigröße standardmäßig 50 MB pro Asset. Bilder werden serverseitig auf Web-tauglichen Formaten gehalten (PNG/JPEG/WebP, GIF bleibt GIF); Audio wird ggf. transcodiert, damit Browser-Wiedergabe konsistent läuft.

Kategorien und Tags

Jedes Asset hat zwei Ordnungs-Dimensionen:

• Kategorie (eine pro Asset): Sound, Sticker, Alert, Background. Hilft beim schnellen Filtern, wenn du z.B. nur Alert-Sounds suchst.
• Tags (mehrere pro Asset, freitext): air-horn, funny, intro, outro, coffee. Tags sind dein eigenes Suchsystem.

Die Suche oben in der Library greift auf Dateiname, Kategorie und Tags zu.

Plan-Limits

Die Library hat ein Quota pro Account. Beispielwerte (in der Web-App genauer angezeigt):

• Free: ~500 MB Gesamtspeicher.
• Pro: deutlich mehr, je nach Plan.
• Bei Erreichen: Upload schlägt fehl mit MEDIA_QUOTA_EXCEEDED.

Im Dashboard siehst du oben rechts den belegten/verfügbaren Speicher als Balken. Wenn du nah am Limit bist, lösch zuerst alte/ungenutzte Assets oder upgrade den Plan.

API-Routen

Zwei Route-Familien:

• /v1/media/ für die Verwaltung:
  • POST /v1/media/upload — neues Asset hochladen.
  • DELETE /v1/media/<id> — Asset löschen.
  • GET /v1/media/<id>/proxy — Asset über Chatlix-CDN streamen (mit Auth, falls nötig).
• /v1/media-engine/ für Asset-Operationen:
  • POST /v1/media-engine/play — vom Server aus ein Sound-Asset in ein Overlay routen.
  • POST /v1/media-engine/probe — Metadaten extrahieren (Dauer, Codec, Auflösung).
  • POST /v1/media-engine/reprocess — Transcoding erneut anstoßen, z.B. nach Codec-Update.

CDN und Caching

Assets werden über ein CDN ausgeliefert. Beim Upload bekommst du eine Public-URL (signed, falls die Library privat ist). Im Overlay/Editor läuft das transparent.

Wenn du ein Asset austauscht (z.B. Logo neu hochladen mit gleichem Namen), bekommt es eine neue ID — du musst die alte Referenz manuell ersetzen. Direktes „Überschreiben“ gibt es nicht; das verhindert, dass Live-Streams plötzlich kaputtes Audio bekommen, weil im Hintergrund eine Datei geändert wurde.

Sichtbarkeit

Assets sind standardmäßig privat, also nur in deinen Overlays/Automations zugreifbar (über Signaturen). Public-Sharing einzelner Assets ist möglich, aber selten nötig.

Wo verwendet?

Assets werden referenziert in:

• Automations als Action „Sound abspielen“ oder „Bild einblenden“.
• Pro Editor (Overlay-Builder) als Image-, Audio- oder Video-Widget.
• StoryQuest-Nodes als Hintergrund/Sound.
• Alerts als Alert-Sound oder Alert-Image.
• StreamDeck-Buttons als „Sound abspielen“-Aktion.

Wenn du ein Asset löschen willst, das noch irgendwo referenziert wird, zeigt die Library eine Warn-Liste mit allen Verwendungs-Stellen. Das hilft, kaputte Verweise zu vermeiden.