Postfader

Geben Sie Ihrem KI-Assistenten Augen und Hände in FL Studio

Erkunden Sie das bereits geöffnete Projekt, nehmen Sie sorgfältig geprüfte Änderungen vor und vergleichen Sie exportierte Mixes – alles aus einem MCP-kompatiblen KI-Client.

Funktionen · KI-Clients · Schnellstart · Unterstützte Versionen · Sicherheit · Dokumentation

[!NOTE] Postfader ist ein inoffizielles Community-Projekt. Es wurde nicht von Image-Line entwickelt und steht in keiner Verbindung zu Image-Line.

Postfader verbindet einen lokalen KI-Client über ein kleines Controller-Skript mit FL Studio. Sie können Fragen zum aktuellen Projekt stellen, unterstützte Regler ändern, eine Note anhören oder Audiodateien messen, ohne eine eigene FL-Studio-Integration zu entwickeln.

Es enthält 37 gezielte Werkzeuge:

• 12 Werkzeuge zum Lesen des geöffneten FL-Studio-Projekts;

• 19 Werkzeuge zum Ändern unterstützter Projekteinstellungen und zur Überprüfung des Ergebnisses;

• eine Sitzungssteuerung zum Aktivieren oder Deaktivieren dieser Änderungen ohne Neustart von FL Studio;

• ein kurzes Live-Noten-Anhörwerkzeug; und

• vier Werkzeuge zur Analyse exportierter Audiodateien.

Funktioniert mit Ihrem KI-Client

Postfader ist modell- und anbieterunabhängig. Es verwendet den standardmäßigen lokalen stdio-MCP-Transport und funktioniert daher mit jedem MCP-kompatiblen Desktop- oder Coding-Client, der einen lokalen Prozess starten kann.

Diese Kompatibilität gilt für lokale Clients, die Postfader auf demselben Computer wie FL Studio starten können. Eine reine Browser-Chat-Oberfläche benötigt eine eigene lokale MCP- oder Plug-in-Laufzeitumgebung, bevor sie eine Verbindung herstellen kann.

Related MCP server: FL Studio MCP Server

Was Sie tun können

Postfader kann auch Parameter von nativen FL-Effekten, VST/VST3/AU-Effekten und Channel-Rack-Generatoren prüfen und steuern. Die Plug-in-Unterstützung wird zur Laufzeit von FL Studio erkannt und ist nicht auf eine feste Liste beschränkt.

Beispielanfragen

“Show me every used mixer track and where it routes.”

“Which Channel Rack instruments are not assigned to a mixer insert?”

“Rename insert 4 to Lead Vocal, set its pan to 10% left, and confirm both changes.”

“Set the tempo to 128 BPM while the project is stopped.”

“Enable write mode for this session, then rename insert 4 to Lead Vocal.”

“Compare my latest bounce with the reference and summarize the loudness,
stereo, dynamics, and frequency-band differences.”

Warum Postfader?

• Bleiben Sie im kreativen Fluss. Fragen Sie nach Projektinformationen oder Routineänderungen, ohne in mehreren FL-Studio-Fenstern zu suchen.

• Wissen Sie, ob eine Änderung angekommen ist. Postfader liest unterstützte Regler nach einer Änderung erneut aus und meldet den Zustand davor, den Zustand danach und das Ergebnis.

• Starten Sie sicher. Postfader verbindet sich im Nur-Lese-Modus. Wenn Sie bereit sind, bitten Sie Ihren KI-Client, Schreibzugriff für die aktuelle Sitzung zu aktivieren – ohne Neustart von FL Studio.

• Nutzen Sie die Plug-ins, die Sie bereits besitzen. Postfader erkennt die Parameteroberfläche, die FL Studio bereitstellt, anstatt ein benutzerdefiniertes Profil für jedes Plug-in zu benötigen.

• Bleiben Sie lokal. Postfader hat keinen gehosteten Dienst, kein Konto, keine Telemetrie und keinen Projekt-Upload-Schritt.

Was „verifiziert“ bedeutet

Für eine unterstützte Änderung führt Postfader Folgendes aus:

1. Es prüft Ziel, Wert, aktuelle Sitzung und einen etwaigen angegebenen Vorher-Zustand;

2. es fordert FL Studio auf, die Änderung vorzunehmen;

3. es wartet auf ein späteres FL-Studio-Update und liest den Regler erneut; und

4. es meldet, ob der angeforderte Zustand tatsächlich beobachtet wurde.

Dies fängt einen häufigen Automatisierungsfehler ab: FL Studio oder ein Plug-in akzeptiert einen Befehl, ignoriert aber den Wert.

[!IMPORTANT] Ein verifiziertes Ergebnis bedeutet, dass der Regler auf der angeforderten Einstellung beobachtet wurde. Es bedeutet nicht, dass die musikalische Wahl gut klingt. Schreibvorgänge wirken sich sofort auf das geöffnete Projekt aus und werden nicht automatisch zurückgesetzt. Postfader speichert das Projekt nie für Sie.

So funktioniert es

flowchart LR
    A["Your AI client<br/>(MCP)"] --> B["Postfader<br/>runs locally"]
    B -->|"Virtual MIDI"| C["Universal Bridge<br/>inside FL Studio"]
    C --> D["Your open project"]
    B -->|"Files you choose"| E["Exported audio<br/>measurements"]

MCP ist die Verbindung, über die ein KI-Client die benannten Werkzeuge von Postfader aufrufen kann. Die Live-Kommunikation mit FL Studio läuft über einen lokalen virtuellen MIDI-Endpunkt. Die Audioanalyse liest exportierte Dateien von der Festplatte, da die Skript-API von FL Studio keine Live-Audiopuffer bereitstellt.

Unterstützte Versionen

Python 3.13/3.14 und Windows ARM64 benötigen möglicherweise einen nativen Compiler für python-rtmidi. Das aktuelle Windows-CI läuft auf x64.

Schnellstart

1. Virtuellen MIDI-Endpunkt vorbereiten

• macOS: Aktivieren Sie einen IAC-Bus in Audio-MIDI-Setup.

• Windows: Erstellen Sie einen bidirektionalen Endpunkt mit der virtuellen MIDI-Software Ihrer Wahl.

Postfader installiert oder konfiguriert keine virtuelle MIDI-Software. Sie verwenden denselben Endpunkt für den MIDI-Eingang und -Ausgang von FL Studio.

Starten Sie FL Studio einmal, bevor Sie Postfader installieren, damit es seine Benutzerdatenordner erstellt, und beenden Sie FL Studio dann.

2. Postfader installieren

macOS

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
cd postfader-fl-studio-mcp
./scripts/install.sh

Windows PowerShell

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
Set-Location postfader-fl-studio-mcp
.\scripts\install.ps1 -DryRun
.\scripts\install.ps1

Die Installationsprogramme erstellen ein lokales .venv, installieren Postfader und kopieren Universal Bridge in den Controller-Skript-Ordner von FL Studio. Sie ändern die Konfiguration Ihres KI-Clients nicht.

Sie können auch das veröffentlichte Python-Paket installieren:

pip install postfader-fl-studio-mcp
postfader-install-bridge

3. FL Studio verbinden

Öffnen Sie in FL Studio Optionen → MIDI-Einstellungen:

1. Aktivieren Sie Ihren virtuellen Endpunkt unter Eingang.

2. Setzen Sie seinen Controller-Typ auf Universal Bridge.

3. Geben Sie dem Eingang eine FL-Studio-Portnummer.

4. Aktivieren Sie denselben Endpunkt unter Ausgang und geben Sie ihm dieselbe Portnummer.

5. Öffnen Sie Ansicht → Skriptausgabe und laden Sie das Skript neu.

Das Skript sollte ready: MIDI SysEx melden.

4. Verbindung prüfen

macOS

./.venv/bin/postfader-doctor --midi-port "IAC Driver Bus 1" --json

Windows PowerShell

.\.venv\Scripts\postfader-doctor.exe --midi-port "Exact Virtual MIDI Endpoint Name" --json

Eine gesunde Verbindung meldet:

• overall: "pass";

• eine aktive FL-Studio-Verbindung;

• ein Controller-Skript, das der installierten Postfader-Version entspricht;

• bridge_mode: "read_only"; und

• verified_writes_enabled: false; und

• runtime_write_mode_control: true.

5. Postfader zu Ihrem KI-Client hinzufügen

Verwenden Sie den enthaltenen Konfigurationsgenerator, damit Interpreterpfade, Repository-Pfade und Endpunktnamen explizit sind:

./.venv/bin/python scripts/generate_mcp_config.py --help

.\.venv\Scripts\python.exe scripts\generate_mcp_config.py --help

Er kann einen Codex-Befehl, Codex-TOML oder standardmäßiges mcpServers-JSON erzeugen, das von Claude-kompatiblen Clients, Cursor und vielen anderen MCP-Clients verwendet wird. Vollständige macOS- und Windows-Beispiele finden Sie im Client-Konfigurationsleitfaden.

Claude-Desktop-Benutzer können die Release-.mcpb-Datei öffnen, aber die Erweiterung installiert weder das FL-Studio-Controller-Skript noch erstellt sie den virtuellen MIDI-Endpunkt. Führen Sie zuerst die Schritte 1–4 aus.

Sicherheitsstandard

Nur-Lese-Modus

Ein normaler FL-Studio-Start hält Postfader im Nur-Lese-Modus: Die Projektprüfung funktioniert, aber projektändernde Werkzeuge nicht. Die Audiodateianalyse funktioniert auch ohne aktive FL-Studio-Verbindung. Dies ist der empfohlene Modus zum Erkunden einer echten Sitzung.

Schreibmodus

Wenn Sie möchten, dass Postfader Änderungen vornimmt, bitten Sie Ihren verbundenen KI-Client:

“Enable write mode for this session.”

Ihr Client ruft fl_set_write_mode auf und muss eine explizite Bestätigung durch den anwesenden Benutzer mitführen. Postfader prüft dann das laufende Controller-Skript, ändert nur diese aktive Sitzung und führt einen zweiten Handshake durch, bevor es meldet, dass Schreibvorgänge verfügbar sind. FL Studio muss nicht neu gestartet werden.

Bitten Sie den Client, den „Schreibmodus zu deaktivieren“, wenn Sie fertig sind. Die Einstellung wird nie in Ihrem Projekt oder Ihrer KI-Client-Konfiguration gespeichert, und ein normaler Neustart des Controller-Skripts oder ein neuer FL-Studio-Prozess startet wieder im Nur-Lese-Modus. Verwenden Sie beim ersten Ausprobieren von Schreibvorgängen ein leeres oder Wegwerf-Projekt.

Weitere Sicherheitsvorkehrungen umfassen:

• Das Aktivieren von Schreibvorgängen erfordert eine ausdrückliche Benutzeranfrage und wird MCP-Clients als destruktive Fähigkeitsänderung angezeigt;

• Schreibvorgänge auf den Master-Track erfordern eine ausdrückliche Genehmigung;

• wenn das installierte Controller-Skript und die Postfader-Version nicht übereinstimmen, werden Schreibvorgänge blockiert;

• Schreibvorgänge werden nach einer verlorenen oder mehrdeutigen Antwort niemals automatisch wiederholt;

• bereitgestellte Sitzungs- und Vorher-Zustands-Prüfungen können veraltete Entscheidungen ablehnen;

• nur eine lokale Postfader-Verbindung kann den ausgewählten virtuellen MIDI-Bus gleichzeitig verwenden; und

• das Controller-Skript ruft niemals die save-project-Funktion von FL Studio auf.

Siehe Tool-Verträge für das genaue Verhalten jedes Schreibvorgangs.

Plug-in-Unterstützung

Postfader kann mit jedem Mixer-Effekt oder Channel-Rack-Generator arbeiten, dessen Parameter FL Studio für Controller-Skripte bereitstellt. Dazu gehören native Image-Line-Plug-ins und viele VST-, VST3- und AU-Plug-ins.

Die Kompatibilität ist bewusst ehrlich:

• ein unbekanntes Plug-in kann untersucht werden, ohne es zuvor zu Postfader hinzuzufügen;

• ein Parameter, den FL nicht bereitstellt, kann nicht gesteuert werden;

• sehr große Parameterzuordnungen werden mit expliziten Grenzen gescannt;

• ein Schreibvorgang, den FL akzeptiert, aber ignoriert, wird als unverifiziert gemeldet; und

• benannte Optionen müssen die genaue Bezeichnung verwenden, die FL Studio meldet, wobei die Groß-/Kleinschreibung ignoriert wird.

Siehe Plug-in-Unterstützung für Parametererkennung, Optionssuchen, Scan-Grenzen, Fehlerbehebung und das Format für Community-Nachweise.

Wichtige Einschränkungen

Postfader kann derzeit nicht:

• Plug-ins hinzufügen, entfernen oder neu anordnen;

• den Bypass oder den Wet/Dry-Mix eines Effekt-Slots zuverlässig steuern;

• die Live-Ausgabe von FL Studio hören;

• ein Projekt rendern, exportieren oder speichern;

• entscheiden, ob ein Mix gut klingt; oder

• rohe Playlist-Auswahl-Endpunkte in einen sicheren automatischen Renderbereich umwandeln.

Audio-Tools analysieren Dateien, die Sie explizit auswählen, oder aktuelle Bounces, die in begrenzten FL-Studio-Ordnern gefunden werden. Sie liefern Messungen und Vergleiche, keine Audio-Samples oder künstlerische Urteile.

Der lokale virtuelle MIDI-Bus wird gemeinsam genutzt und ist nicht authentifiziert. Verwenden Sie Postfader auf einer vertrauenswürdigen Arbeitsstation mit einem einzelnen Benutzer.

Datenschutz

Postfader selbst läuft lokal und verfügt über keine Telemetrie oder Cloud-Dienste. Es speichert Ihre Projekte, Aufnahmen, Stems, Presets, Exporte oder Live-Sitzungs-Nachweise nicht in diesem Repository.

Ihr KI-Client ist eine separate Anwendung und kann Tool-Argumente und -Ergebnisse an seinen Modellanbieter senden. Audio-Ergebnisse können Dateipfade, Hashes und Messungen enthalten, aber niemals Audio-Samples. Prüfen Sie die Datenschutzrichtlinie Ihres KI-Clients und die Sicherheitsrichtlinie von Postfader, bevor Sie sensible Projekte verwenden.

Dokumentation

Entwicklung

Führen Sie die sichere, hardwarefreie Testsuite aus dem Quellcode-Checkout aus:

./.venv/bin/python scripts/run_safe_tests.py

.\.venv\Scripts\python.exe scripts\run_safe_tests.py

Die sichere Suite verhindert echten MIDI-Zugriff, selbst wenn Umgebungsvariablen ihn anfordern. Jeder Live-Hardware-Test muss ein leeres, nicht gespeichertes Projekt verwenden, und seine Protokolle, Screenshots und Ausführungsnotizen müssen außerhalb des öffentlichen Repositorys bleiben.

Lizenz

Postfader ist unter der Apache-Lizenz 2.0 verfügbar. Siehe NOTICE für Details zur Namensnennung.