Postfader

AI 어시스턴트에게 FL Studio 안에서 눈과 손을 주세요

이미 열려 있는 프로젝트를 탐색하고, 신중하게 검증된 변경을 수행하고, 내보낸 믹스를 비교하세요—MCP 호환 AI 클라이언트에서 모두 가능합니다.

기능 · AI 클라이언트 · 빠른 시작 · 지원 버전 · 안전성 · 문서

[!NOTE] Postfader는 비공식 커뮤니티 프로젝트입니다. Image-Line이 만들었거나 관련된 프로젝트가 아닙니다.

Postfader는 작은 컨트롤러 스크립트를 통해 로컬 AI 클라이언트를 FL Studio에 연결합니다. 현재 프로젝트에 대해 질문하고, 지원되는 컨트롤을 변경하고, 노트를 미리 들어보거나, 오디오 파일을 측정할 수 있습니다—커스텀 FL Studio 통합을 구축할 필요 없이 말이죠.

37개의 집중된 도구가 포함되어 있습니다:

• 열려 있는 FL Studio 프로젝트를 읽기 위한 도구 12개;

• 지원되는 프로젝트 설정을 변경하고 결과를 확인하는 도구 19개;

• FL Studio를 재시작하지 않고 변경 사항을 활성화/비활성화하는 세션 컨트롤 1개;

• 짧은 라이브 노트 미리 듣기 도구 1개;

• 내보낸 오디오 파일을 분석하는 도구 4개.

AI 클라이언트와 함께 사용하기

Postfader는 모델 및 벤더에 독립적입니다. 표준 로컬 stdio MCP 전송을 사용하므로, 로컬 프로세스를 실행할 수 있는 모든 MCP 호환 데스크톱 또는 코딩 클라이언트에서 작동합니다.

이 호환성은 FL Studio와 같은 컴퓨터에서 Postfader를 시작할 수 있는 로컬 클라이언트에 적용됩니다. 브라우저 전용 채팅 인터페이스는 연결 전에 자체 로컬 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는 읽기 전용 모드로 연결됩니다. 준비가 되면 AI 클라이언트에게 현재 세션에 대한 쓰기를 활성화하도록 요청하세요—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는 AI 클라이언트가 Postfader의 명명된 도구를 호출할 수 있게 하는 연결입니다. 실시간 FL Studio 통신은 하나의 로컬 가상 MIDI 엔드포인트를 통해 이루어집니다. 오디오 분석은 FL Studio의 스크립팅 API가 라이브 오디오 버퍼를 제공하지 않으므로 디스크에서 내보낸 파일을 읽습니다.

지원 버전

Python 3.13/3.14 및 Windows ARM64는 python-rtmidi용 네이티브 컴파일러가 필요할 수 있습니다. 현재 Windows CI는 x64에서 실행됩니다.

빠른 시작

1. 가상 MIDI 엔드포인트 준비

• macOS: Audio MIDI Setup에서 IAC 버스를 활성화합니다.

• Windows: 선택한 가상 MIDI 소프트웨어로 양방향 엔드포인트를 하나 생성합니다.

Postfader는 가상 MIDI 소프트웨어를 설치하거나 구성하지 않습니다. FL Studio의 MIDI 입력과 출력에 동일한 엔드포인트를 사용하게 됩니다.

Postfader를 설치하기 전에 FL Studio를 한 번 실행하여 사용자 데이터 폴더를 생성한 다음 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의 컨트롤러 스크립트 폴더에 복사합니다. AI 클라이언트의 구성은 변경하지 않습니다.

게시된 Python 패키지를 설치할 수도 있습니다:

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

3. FL Studio 연결

FL Studio에서 Options → MIDI settings를 엽니다:

1. Input 아래에서 가상 엔드포인트를 활성화합니다.

2. 컨트롤러 유형을 Universal Bridge로 설정합니다.

3. 입력에 FL Studio Port 번호를 지정합니다.

4. Output 아래에서 동일한 엔드포인트를 활성화하고 동일한 Port 번호를 지정합니다.

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. AI 클라이언트에 Postfader 추가

인터프리터 경로, 저장소 경로, 엔드포인트 이름이 명시되도록 포함된 구성 생성기를 사용하세요:

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

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

Codex 명령, Codex TOML, 또는 Claude 호환 클라이언트, Cursor 및 기타 여러 MCP 클라이언트에서 사용하는 표준 mcpServers JSON을 생성할 수 있습니다. 완전한 macOS 및 Windows 예시는 클라이언트 구성 가이드를 참조하세요.

Claude Desktop 사용자는 릴리스 .mcpb를 열 수 있지만, 확장 프로그램은 FL Studio 컨트롤러 스크립트를 설치하거나 가상 MIDI 엔드포인트를 생성하지 않습니다. 먼저 1~4단계를 완료하세요.

기본적으로 안전

읽기 전용 모드

일반적인 FL Studio 실행은 Postfader를 읽기 전용으로 유지합니다: 프로젝트 검사는 작동하지만 프로젝트 변경 도구는 작동하지 않습니다. 오디오 파일 분석도 활성 FL Studio 연결 없이 작동합니다. 실제 세션을 탐색할 때 권장되는 모드입니다.

쓰기 모드

Postfader가 변경을 수행하도록 하려면 연결된 AI 클라이언트에게 요청하세요:

“Enable write mode for this session.”

클라이언트는 fl_set_write_mode를 호출하며 명시적인 사용자 확인이 필요합니다. 그러면 Postfader는 실행 중인 컨트롤러 스크립트를 확인하고, 해당 라이브 세션만 변경하며, 쓰기가 가능하다고 보고하기 전에 두 번째 핸드셰이크를 수행합니다. FL Studio를 재시작할 필요는 없습니다.

작업이 끝나면 클라이언트에게 "쓰기 모드 비활성화"를 요청하세요. 이 설정은 프로젝트나 AI 클라이언트 구성에 저장되지 않으며, 일반적인 컨트롤러 스크립트 다시 로드나 새 FL Studio 프로세스는 다시 읽기 전용으로 시작됩니다. 처음 쓰기를 시도할 때는 빈 프로젝트나 일회용 프로젝트를 사용하세요.

추가 안전 장치에는 다음이 포함됩니다:

• 쓰기 활성화는 명시적인 사용자 요청을 필요로 하며 MCP 클라이언트에 파괴적 기능 변경으로 노출됩니다;

• Master 트랙에 대한 쓰기는 명시적 권한이 필요합니다;

• 설치된 컨트롤러 스크립트와 Postfader 버전이 일치하지 않으면 쓰기가 차단됩니다;

• 손실되거나 모호한 응답 후에는 쓰기가 자동으로 반복되지 않습니다;

• 제공된 세션 및 이전 상태 검사는 오래된 결정을 거부할 수 있습니다;

• 한 번에 하나의 로컬 Postfader 연결만 선택한 가상 MIDI 버스를 사용할 수 있습니다; 그리고

• 컨트롤러 스크립트는 FL Studio의 프로젝트 저장 기능을 호출하지 않습니다.

모든 쓰기의 정확한 동작은 Tool contracts를 참조하세요.

플러그인 지원

Postfader는 FL Studio가 컨트롤러 스크립트에 노출하는 파라미터를 가진 모든 믹서 효과 또는 Channel Rack 생성기와 함께 작동할 수 있습니다. 여기에는 네이티브 Image-Line 플러그인과 많은 VST, VST3, AU 플러그인이 포함됩니다.

호환성은 의도적으로 정직합니다:

• 익숙하지 않은 플러그인은 Postfader에 먼저 추가하지 않고도 검사할 수 있습니다;

• FL이 노출하지 않는 파라미터는 제어할 수 없습니다;

• 매우 큰 파라미터 맵은 명시적 한도로 스캔됩니다;

• FL이 수락하지만 무시하는 쓰기는 검증되지 않음으로 보고됩니다; 그리고

• 명명된 옵션은 FL Studio가 보고하는 정확한 라벨을 사용해야 하며, 대소문자는 무시합니다.

파라미터 검색, 옵션 검색, 스캔 한도, 문제 해결 및 커뮤니티 증거 형식은 Plug-in support를 참조하세요.

중요 제한 사항

Postfader는 현재 다음을 수행할 수 없습니다:

• 플러그인을 추가, 제거 또는 재정렬;

• 이펙트 슬롯의 바이패스 또는 wet/dry 믹스를 안정적으로 제어;

• FL Studio의 라이브 출력을 듣기;

• 프로젝트를 렌더링, 내보내기 또는 저장;

• 믹스가 좋게 들리는지 결정; 또는

• 원시 Playlist 선택 엔드포인트를 안전한 자동 렌더 범위로 전환.

오디오 도구는 명시적으로 선택한 파일이나 제한된 FL Studio 폴더에서 찾은 최근 바운스를 분석합니다. 오디오 샘플이나 예술적 판단이 아닌 측정값과 비교 결과를 반환합니다.

로컬 가상 MIDI 버스는 공유되며 인증되지 않습니다. 신뢰할 수 있는 단일 사용자 워크스테이션에서 Postfader를 사용하세요.

개인정보 보호

Postfader 자체는 로컬에서 실행되며 텔레메트리나 클라우드 서비스가 없습니다. 이 저장소에 프로젝트, 녹음, 스템, 프리셋, 내보내기 또는 라이브 세션 증거를 저장하지 않습니다.

AI 클라이언트는 별도의 애플리케이션이며 도구 인수와 결과를 모델 제공자에게 보낼 수 있습니다. 오디오 결과에는 파일 경로, 해시 및 측정값이 포함될 수 있지만 오디오 샘플은 절대 포함되지 않습니다. 민감한 프로젝트를 사용하기 전에 AI 클라이언트의 개인정보 보호 정책과 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를 참조하세요.