Plugins & Erweiterungen

Plugins erweitern Sonodex um Tag-Regeln, Cue-Templates oder WebAssembly-Module, die isoliert laufen und nur prüfbare Vorschläge machen. Seit 2.0 kommen Erweiterungen mit eigenen Ansichten, Datenquellen und Effekten dazu, seit 2.2 mit einer eigenen Seite.

ProZuletzt aktualisiert:

Auf dieser Seite

Was ein Plugin kannLink zu „Was ein Plugin kann“

  • Tag-Regeln: neue Tracks nach Genre oder Metadaten taggen.
  • Cue-Templates: Cue-Anker für die Cue-Generierung.
  • WebAssembly-Module: lesen die ausgewählten Track-Metadaten und schlagen Änderungen an Tags und Feldern vor.

SicherheitLink zu „Sicherheit“

  • Module laufen isoliert, ohne Datei- und Netzwerkzugriff.
  • Sie bekommen keine Dateipfade, kein Audio, keine Fingerprints und keine Kontodaten.
  • Ein Lauf hat zwei Sekunden Zeit und höchstens 500 Tracks.
  • Jede Änderung erscheint zuerst in einer Vorschau; die Übernahme ist ein gemeinsamer Rückgängig-Schritt.

VerwendenLink zu „Verwenden“

Plugins importierst und steuerst du unter Einstellungen → Plugins. Ein Beispiel liefert „Warm-up Toolkit installieren“ mit.

Eigene Plugins bauenLink zu „Eigene Plugins bauen“

Ein Plugin ist ein JSON-Paket mit Manifest und optional einem WebAssembly-Modul. Den Vertrag und ein Beispiel beschreibt das Plugin-SDK im Sonodex-Repository (öffnet neues Fenster).

Paket bauen (im Sonodex-Quellcode)
node scripts/build-plugin.mjs manifest.json module.wat output.plugin.json

Erweiterungen (seit Sonodex 2.0)Link zu „Erweiterungen (seit Sonodex 2.0)“

Mit dem Extension SDK v2 können Erweiterungen deutlich mehr als Vorschläge machen:

  • Eigene Ansichten und Arbeitsbereiche, auch als eigenes Fenster oder angedockt.
  • Datenquellen für Metadaten und andere Informationen.
  • Werkzeuge zur Vorbereitung von Tracks.
  • Hardware über MIDI und OSC.
  • Audio-Verarbeitung, darunter Echtzeit-Effekte beim Auflegen.

Erweiterungen kommen aus signierten Verzeichnissen, mit Updates und einem Rücksprung auf die vorige Version. Ein Entwicklermodus hilft beim Bauen eigener Erweiterungen.

Die Seite „Erweiterungen“Link zu „Die Seite „Erweiterungen““

Seit 2.2 haben Erweiterungen eine eigene Seite in der Leiste, im Menü „Gehe zu“ und mit Strg/⌘+Umschalt+X; die Plugins von oben stehen getrennt unter „Legacy-Plugins“. Seit 2.2.1 zeigt die Seite jede Erweiterung als Karte mit Detail-Tabs. Dazu kommen:

  • Installation als .cfext-Datei oder aus Verzeichnissen, mit Vertrauen und Lebenszyklus je Erweiterung, Abhängigkeiten und Aktivität.
  • Setup-Export, eigene Tastenkürzel und Themes, Dateien und Drag & Drop sowie Hintergrunddienste.
  • Anbindungen an Stream Deck, Bitfocus Companion, den lokalen MCP-Server und die lokale API, dazu eine Brücke zu Auflegen und zu den Exporten.
  • Websites, die eine Erweiterung erreichen will, erlaubst du einzeln; auch eingefügte Links kann eine Erweiterung übernehmen. Die Detailseite zeigt die Netzwerk-Grenzen einer Erweiterung und den aktuellen Stand.
  • Seit 2.1 dürfen Erweiterungen – nur mit deiner Freigabe – Sonodex' eigene Anmeldungen bei Beatport, SoundCloud, TIDAL, Last.fm, AcoustID und SonoVault mitnutzen. Zugangsdaten sehen sie nie; unter Integrationen siehst und widerrufst du, wer welches Konto nutzt.

Neu im SDKLink zu „Neu im SDK“

  • Seit 2.2: größere und binäre Antworten, eigene Anfragegrenzen innerhalb fester Obergrenzen und Anmeldungen mit Sitzungs-Cookies, die Sonodex hält.
  • Seit 2.2.1: eine Download-Warteschlange mit Stapeln, Benennungsvorlagen, eine bessere Version eines verlinkten Tracks holen, Feeds und Neuerscheinungen beobachten, HLS und Tagging.
  • Abgleich per Audio-Fingerabdruck: Sonodex berechnet den Fingerabdruck selbst; an die Erweiterung gehen nur Fingerabdruck und Dauer, nie die Audiodatei.

Etwas fehlt oder stimmt nicht? Sag uns Bescheid. Die Oberfläche gibt es auch auf Englisch; die Docs nennen die deutschen Bezeichnungen.

Originale Sonodex-App · Demo-Bibliothek