Postfader

Dale ojos y manos a tu asistente de IA dentro de FL Studio

Explora el proyecto que ya tienes abierto, realiza cambios cuidadosamente verificados y compara mezclas exportadas, todo desde un cliente de IA compatible con MCP.

Características · Clientes de IA · Inicio rápido · Versiones compatibles · Seguridad · Documentación

[!NOTA] Postfader es un proyecto comunitario no oficial. No está hecho por Image-Line ni afiliado a ella.

Postfader conecta un cliente de IA local a FL Studio mediante un pequeño script de control. Puedes hacer preguntas sobre el proyecto actual, cambiar controles compatibles, probar una nota o medir archivos de audio sin necesidad de crear una integración personalizada de FL Studio.

Incluye 37 herramientas enfocadas:

• 12 herramientas para leer el proyecto de FL Studio abierto;

• 19 herramientas para cambiar configuraciones compatibles del proyecto y verificar el resultado;

• un control de sesión para habilitar o deshabilitar esos cambios sin reiniciar FL Studio;

• una herramienta breve de prueba de notas en vivo; y

• cuatro herramientas para analizar archivos de audio exportados.

Funciona con tu cliente de IA

Postfader es independiente del modelo y del proveedor. Utiliza el transporte MCP local estándar stdio, por lo que funciona con cualquier cliente de escritorio o de codificación compatible con MCP que pueda lanzar un proceso local.

Esta compatibilidad se aplica a clientes locales que puedan iniciar Postfader en el mismo ordenador que FL Studio. Una interfaz de chat solo de navegador necesita su propio MCP local o un entorno de ejecución de plug-in antes de poder conectarse.

Related MCP server: FL Studio MCP Server

Lo que puedes hacer

Postfader también puede inspeccionar y controlar parámetros expuestos por efectos nativos de FL, efectos VST/VST3/AU y generadores del Channel Rack. El soporte de plug-ins se descubre desde FL Studio en tiempo de ejecución, no se limita a una lista fija.

Ejemplos de solicitudes

“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.”

¿Por qué usar Postfader?

• Mantente en el flujo creativo. Solicita información del proyecto o cambios rutinarios sin buscar entre varias ventanas de FL Studio.

• Sabe si un cambio se aplicó. Postfader lee los controles compatibles después de cambiarlos y reporta el estado anterior, el estado posterior y el resultado.

• Comienza de forma segura. Postfader se conecta en modo de solo lectura. Cuando estés listo, pide a tu cliente de IA que habilite la escritura para la sesión actual—sin reiniciar FL Studio.

• Usa los plug-ins que ya tienes. Postfader descubre la superficie de parámetros que FL Studio expone en lugar de requerir un perfil personalizado para cada plug-in.

• Mantén todo local. Postfader no tiene servicio alojado, cuenta, telemetría ni paso de carga de proyectos.

Qué significa "verificado"

Para un cambio compatible, Postfader:

1. comprueba el objetivo, el valor, la sesión actual y cualquier estado anterior proporcionado;

2. pide a FL Studio que realice el cambio;

3. espera una actualización posterior de FL Studio y vuelve a leer el control; y

4. informa si el estado solicitado se observó realmente.

Esto detecta un fallo común de automatización: FL Studio o un plug-in acepta un comando pero ignora el valor.

[!IMPORTANTE] Un resultado verificado significa que el control se observó en la configuración solicitada. No significa que la elección musical suene bien. Las escrituras afectan al proyecto abierto inmediatamente y no se revierten automáticamente. Postfader nunca guarda el proyecto por ti.

Cómo funciona

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 es la conexión que permite a un cliente de IA llamar a las herramientas nombradas de Postfader. La comunicación en vivo con FL Studio viaja a través de un único endpoint MIDI virtual local. El análisis de audio lee archivos exportados desde el disco porque la API de scripting de FL Studio no proporciona buffers de audio en vivo.

Versiones compatibles

Python 3.13/3.14 y Windows ARM64 pueden necesitar un compilador nativo para python-rtmidi. El CI actual de Windows se ejecuta en x64.

Inicio rápido

1. Prepara un endpoint MIDI virtual

• macOS: habilita un bus IAC en Audio MIDI Setup.

• Windows: crea un endpoint bidireccional con el software de MIDI virtual que prefieras.

Postfader no instala ni configura software de MIDI virtual. Usarás el mismo endpoint para la entrada y salida MIDI de FL Studio.

Inicia FL Studio una vez antes de instalar Postfader para que cree sus carpetas de datos de usuario, luego cierra FL Studio.

2. Instala Postfader

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

Los instaladores crean un .venv local, instalan Postfader y copian Universal Bridge en la carpeta de scripts de control de FL Studio. No cambian la configuración de tu cliente de IA.

También puedes instalar el paquete de Python publicado:

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

3. Conecta FL Studio

Abre Options → MIDI settings en FL Studio:

1. Habilita tu endpoint virtual en Input.

2. Establece su tipo de controlador en Universal Bridge.

3. Asigna un número de puerto de FL Studio a la entrada.

4. Habilita el mismo endpoint en Output y asígnale el mismo número de puerto.

5. Abre View → Script output y recarga el script.

El script debería informar ready: MIDI SysEx.

4. Comprueba la conexión

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

Una conexión saludable informa:

• overall: "pass";

• una conexión en vivo con FL Studio;

• un script de control que coincida con la versión instalada de Postfader;

• bridge_mode: "read_only"; y

• verified_writes_enabled: false; y

• runtime_write_mode_control: true.

5. Añade Postfader a tu cliente de IA

Usa el generador de configuración incluido para que las rutas de intérprete, las rutas de repositorio y los nombres de endpoint sean explícitos:

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

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

Puede producir un comando de Codex, TOML de Codex o JSON estándar de mcpServers usado por clientes compatibles con Claude, Cursor y muchos otros clientes MCP. Consulta la guía de configuración de clientes para ver ejemplos completos de macOS y Windows.

Los usuarios de Claude Desktop pueden abrir el .mcpb de la versión, pero la extensión no instala el script de control de FL Studio ni crea el endpoint MIDI virtual. Completa primero los pasos 1–4.

Seguro por defecto

Modo de solo lectura

Un inicio normal de FL Studio mantiene Postfader en modo de solo lectura: la inspección del proyecto funciona, pero las herramientas que cambian el proyecto no. El análisis de archivos de audio también funciona sin una conexión en vivo con FL Studio. Este es el modo recomendado para explorar una sesión real.

Modo de escritura

Cuando quieras que Postfader haga cambios, pide a tu cliente de IA conectado:

“Enable write mode for this session.”

Tu cliente llama a fl_set_write_mode y debe llevar una confirmación explícita presente del usuario. Postfader entonces comprueba el script de control en ejecución, cambia solo esa sesión en vivo y realiza un segundo apretón de manos antes de informar que las escrituras están disponibles. FL Studio no necesita reiniciarse.

Pide al cliente que "desactive el modo de escritura" cuando termines. La configuración nunca se almacena en tu proyecto ni en la configuración del cliente de IA, y una recarga normal del script de control o un nuevo proceso de FL Studio vuelve a comenzar en modo de solo lectura. Usa un proyecto en blanco o desechable la primera vez que intentes escrituras.

Las salvaguardas adicionales incluyen:

• Habilitar escrituras requiere una solicitud explícita del usuario y se expone a los clientes MCP como un cambio de capacidad destructivo;

• las escrituras a la pista Master requieren permiso explícito;

• si el script de controlador instalado y la versión de Postfader no coinciden, las escrituras se bloquean;

• las escrituras nunca se repiten automáticamente después de una respuesta perdida o ambigua;

• las comprobaciones de sesión y estado previo proporcionadas pueden rechazar decisiones obsoletas;

• solo una conexión local de Postfader puede usar el bus MIDI virtual seleccionado a la vez; y

• el script de controlador nunca llama a la función de guardar proyecto de FL Studio.

Consulte Contratos de herramientas para conocer el comportamiento exacto de cada escritura.

Soporte de complementos

Postfader puede funcionar con cualquier efecto de mezclador o generador de Channel Rack cuyos parámetros FL Studio exponga a los scripts de controlador. Eso incluye complementos nativos de Image-Line y muchos complementos VST, VST3 y AU.

La compatibilidad es intencionalmente honesta:

• un complemento desconocido se puede inspeccionar sin añadirlo primero a Postfader;

• un parámetro que FL no expone no se puede controlar;

• los mapas de parámetros muy grandes se escanean con límites explícitos;

• una escritura que FL acepta pero ignora se informa como no verificada; y

• las opciones con nombre deben usar la etiqueta exacta que informa FL Studio, ignorando mayúsculas y minúsculas.

Consulte Soporte de complementos para descubrimiento de parámetros, búsquedas de opciones, límites de escaneo, solución de problemas y el formato de evidencia comunitaria.

Limitaciones importantes

Postfader actualmente no puede:

• añadir, eliminar o reordenar complementos;

• controlar de forma fiable el bypass o la mezcla wet/dry de una ranura de efecto;

• escuchar la salida en vivo de FL Studio;

• renderizar, exportar o guardar un proyecto;

• decidir si una mezcla suena bien; o

• convertir los endpoints de selección de Playlist en bruto en un rango de renderizado automático seguro.

Las herramientas de audio analizan archivos que seleccionas explícitamente o rebotes recientes encontrados en carpetas acotadas de FL Studio. Devuelven mediciones y comparaciones, no muestras de audio ni juicios artísticos.

El bus MIDI virtual local es compartido y no autenticado. Usa Postfader en una estación de trabajo confiable y de un solo usuario.

Privacidad

Postfader se ejecuta localmente y no tiene telemetría ni servicio en la nube. No almacena tus proyectos, grabaciones, stems, presets, exportaciones ni evidencia de sesiones en vivo en este repositorio.

Tu cliente de IA es una aplicación separada y puede enviar argumentos y resultados de herramientas a su proveedor de modelos. Los resultados de audio pueden incluir rutas de archivo, hashes y mediciones, pero nunca muestras de audio. Revisa la política de privacidad de tu cliente de IA y la política de seguridad de Postfader antes de usar proyectos sensibles.

Documentación

Desarrollo

Ejecuta la suite de pruebas segura y sin hardware desde el checkout del código fuente:

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

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

La suite segura evita el acceso MIDI real incluso cuando las variables de entorno ambientales lo solicitan. Cualquier prueba de hardware en vivo debe usar un proyecto en blanco y sin guardar, y sus registros, capturas de pantalla y notas de ejecución deben permanecer fuera del repositorio público.

Licencia

Postfader está disponible bajo la Licencia Apache 2.0. Consulta NOTICE para detalles de atribución.