Postfader

Дайте вашему ИИ-ассистенту глаза и руки внутри FL Studio

Исследуйте уже открытый проект, вносите тщательно проверенные изменения и сравнивайте экспортированные миксы — всё из MCP-совместимого ИИ-клиента.

Возможности · ИИ-клиенты · Быстрый старт · Поддерживаемые версии · Безопасность · Документация

[!NOTE] Postfader — неофициальный проект сообщества. Он не создан Image-Line и не связан с ней.

Postfader подключает локальный ИИ-клиент к FL Studio через небольшой контроллер-скрипт. Вы можете задавать вопросы о текущем проекте, изменять поддерживаемые параметры, прослушивать ноту или измерять аудиофайлы без создания собственной интеграции с FL Studio.

В него входят 37 узконаправленных инструментов:

• 12 инструментов для чтения открытого проекта FL Studio;

• 19 инструментов для изменения поддерживаемых настроек проекта и проверки результата;

• один элемент управления сеансом для включения или отключения этих изменений без перезапуска FL Studio;

• один инструмент краткого живого прослушивания ноты; и

• четыре инструмента для анализа экспортированных аудиофайлов.

Работает с вашим ИИ-клиентом

Postfader не зависит от модели и поставщика. Он использует стандартный локальный транспорт stdio MCP, поэтому работает с любым MCP-совместимым настольным или кодовым клиентом, который может запускать локальный процесс.

Эта совместимость распространяется на локальные клиенты, которые могут запустить Postfader на том же компьютере, что и FL Studio. Только браузерный чат-интерфейс нуждается в собственном локальном MCP или плагин-рантайме, прежде чем сможет подключиться.

Related MCP server: FL Studio MCP Server

Что вы можете делать

Postfader также может проверять и управлять параметрами, которые открывают нативные эффекты FL, эффекты VST/VST3/AU и генераторы Channel Rack. Поддержка плагинов обнаруживается из FL Studio во время выполнения, а не ограничивается фиксированным списком.

Примеры запросов

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

Зачем использовать Postfader?

• Оставайтесь в творческом потоке. Запрашивайте информацию о проекте или рутинные изменения, не разыскивая нужные окна в нескольких разделах FL Studio.

• Знайте, применилось ли изменение. Postfader считывает поддерживаемые элементы управления после их изменения и сообщает состояние до, состояние после и результат.

• Начинайте безопасно. Postfader подключается в режиме только для чтения. Когда будете готовы, попросите свой ИИ-клиент включить запись для текущего сеанса — перезапуск FL Studio не требуется.

• Используйте уже имеющиеся у вас плагины. Postfader обнаруживает поверхность параметров, которую открывает FL Studio, вместо того чтобы требовать индивидуальный профиль для каждого плагина.

• Оставайтесь локально. У Postfader нет облачного сервиса, аккаунта, телеметрии или этапа загрузки проекта.

Что означает «проверено»

Для поддерживаемого изменения Postfader:

1. проверяет цель, значение, текущий сеанс и любое предоставленное состояние до;

2. просит FL Studio внести изменение;

3. ждёт последующего обновления FL Studio и снова считывает элемент управления; и

4. сообщает, было ли запрошенное состояние фактически зафиксировано.

Это позволяет выявить типичный сбой автоматизации: FL Studio или плагин принимает команду, но игнорирует значение.

[!IMPORTANT] Проверенный результат означает, что элемент управления был зафиксирован в запрошенном положении. Это не означает, что музыкальное решение звучит хорошо. Запись влияет на открытый проект немедленно и не откатывается автоматически. Postfader никогда не сохраняет проект за вас.

Как это работает

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 — это соединение, которое позволяет ИИ-клиенту вызывать именованные инструменты Postfader. Живая связь с FL Studio проходит через одну локальную виртуальную MIDI-точку. Анализ аудио читает экспортированные файлы с диска, поскольку скриптовый API FL Studio не предоставляет живые аудиобуферы.

Поддерживаемые версии

Для Python 3.13/3.14 и Windows ARM64 может потребоваться нативный компилятор для python-rtmidi. Текущий Windows CI работает на x64.

Быстрый старт

1. Подготовьте виртуальную MIDI-точку

• macOS: включите шину IAC в Audio MIDI Setup.

• Windows: создайте одну двунаправленную точку с помощью выбранного вами ПО для виртуального MIDI.

Postfader не устанавливает и не настраивает ПО для виртуального MIDI. Вы будете использовать одну и ту же точку для входа и выхода MIDI в FL Studio.

Запустите FL Studio один раз перед установкой Postfader, чтобы она создала свои папки пользовательских данных, затем закройте FL Studio.

2. Установите 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

Установщики создают локальный .venv, устанавливают Postfader и копируют Universal Bridge в папку контроллер-скриптов FL Studio. Они не изменяют конфигурацию вашего ИИ-клиента.

Вы также можете установить опубликованный Python-пакет:

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

3. Подключите FL Studio

Откройте Options → MIDI settings в FL Studio:

1. Включите вашу виртуальную точку в разделе Input.

2. Установите для неё тип контроллера Universal Bridge.

3. Присвойте входу номер порта FL Studio.

4. Включите ту же точку в разделе Output и присвойте ей тот же номер порта.

5. Откройте View → Script output и перезагрузите скрипт.

Скрипт должен сообщить ready: MIDI SysEx.

4. Проверьте подключение

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

Здоровое подключение сообщает:

• overall: "pass";

• живое подключение к FL Studio;

• контроллер-скрипт, соответствующий установленной версии Postfader;

• bridge_mode: "read_only"; и

• verified_writes_enabled: false; и

• runtime_write_mode_control: true.

5. Добавьте Postfader в свой ИИ-клиент

Используйте встроенный генератор конфигурации, чтобы пути интерпретатора, пути репозитория и имена точек были явными:

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

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

Он может создать команду Codex, TOML Codex или стандартный JSON mcpServers, используемый Claude-совместимыми клиентами, Cursor и многими другими MCP-клиентами. Полные примеры для macOS и Windows см. в руководстве по настройке клиента.

Пользователи Claude Desktop могут открыть релизный .mcpb, но расширение не устанавливает контроллер-скрипт FL Studio и не создаёт виртуальную MIDI-точку. Сначала выполните шаги 1–4.

Безопасно по умолчанию

Режим только для чтения

Обычный запуск FL Studio оставляет Postfader в режиме только для чтения: просмотр проекта работает, а инструменты, изменяющие проект, — нет. Анализ аудиофайлов также работает без живого подключения к FL Studio. Это рекомендуемый режим для изучения реальной сессии.

Режим записи

Когда вы хотите, чтобы Postfader вносил изменения, попросите подключённый ИИ-клиент:

“Enable write mode for this session.”

Ваш клиент вызывает fl_set_write_mode и должен нести явное подтверждение присутствия пользователя. Затем Postfader проверяет запущенный контроллер-скрипт, изменяет только этот живой сеанс и выполняет второе рукопожатие, прежде чем сообщить, что запись доступна. Перезапуск FL Studio не нужен.

Попросите клиент «отключить режим записи», когда закончите. Эта настройка никогда не сохраняется в вашем проекте или конфигурации ИИ-клиента, а обычная перезагрузка контроллер-скрипта или новый процесс FL Studio снова начинают в режиме только для чтения. При первом тестировании записи используйте пустой или одноразовый проект.

Дополнительные меры защиты включают:

• включение записи требует явного запроса пользователя и отображается для MCP-клиентов как разрушительное изменение возможностей;

• запись в Master-трек требует явного разрешения;

• если установленный скрипт контроллера и версия Postfader не совпадают, запись блокируется;

• запись никогда не повторяется автоматически после потерянного или неоднозначного ответа;

• предоставленные проверки сеанса и состояния до записи могут отклонять устаревшие решения;

• только одно локальное соединение Postfader может использовать выбранную виртуальную MIDI-шину одновременно; и

• скрипт контроллера никогда не вызывает функцию сохранения проекта FL Studio.

Точное поведение каждой записи описано в разделе Контракты инструментов.

Поддержка плагинов

Postfader может работать с любым эффектом микшера или генератором Channel Rack, параметры которых FL Studio предоставляет скриптам контроллеров. Это включает нативные плагины Image-Line и многие плагины VST, VST3 и AU.

Совместимость намеренно честная:

• незнакомый плагин можно проверить, не добавляя его сначала в Postfader;

• параметр, который FL не предоставляет, не может быть управляем;

• очень большие карты параметров сканируются с явными ограничениями;

• запись, которую FL принимает, но игнорирует, сообщается как непроверенная; и

• именованные опции должны использовать точную метку, которую сообщает FL Studio, игнорируя регистр.

См. Поддержка плагинов для обнаружения параметров, поиска опций, ограничений сканирования, устранения неполадок и формата доказательств сообщества.

Важные ограничения

Postfader в настоящее время не может:

• добавлять, удалять или изменять порядок плагинов;

• надежно управлять обходом слота эффекта или сухим/мокрым миксом;

• слышать живой вывод FL Studio;

• рендерить, экспортировать или сохранять проект;

• решать, хорошо ли звучит микс; или

• превращать необработанные конечные точки выбора Playlist в безопасный автоматический диапазон рендеринга.

Аудиоинструменты анализируют файлы, которые вы явно выбираете, или недавние отскоки, найденные в ограниченных папках FL Studio. Они возвращают измерения и сравнения, а не аудиосэмплы или художественные суждения.

Локальная виртуальная MIDI-шина является общей и неаутентифицированной. Используйте Postfader на доверенной однопользовательской рабочей станции.

Конфиденциальность

Сам Postfader работает локально и не имеет телеметрии или облачного сервиса. Он не хранит ваши проекты, записи, стемы, пресеты, экспорты или доказательства живых сессий в этом репозитории.

Ваш ИИ-клиент — это отдельное приложение, которое может отправлять аргументы и результаты инструментов своему поставщику моделей. Аудиорезультаты могут включать пути к файлам, хэши и измерения, но никогда аудиосэмплы. Изучите политику конфиденциальности вашего ИИ-клиента и политику безопасности Postfader перед использованием конфиденциальных проектов.

Документация

Разработка

Запустите безопасный набор тестов без оборудования из исходного кода:

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

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

Безопасный набор предотвращает реальный доступ к MIDI, даже если переменные окружения запрашивают его. Любой живой аппаратный тест должен использовать пустой, несохраненный проект, а его журналы, скриншоты и заметки о запуске должны оставаться вне публичного репозитория.

Лицензия

Postfader доступен по лицензии Apache License 2.0. См. NOTICE для сведений об авторстве.