OSC Panel

面向 Open Stage Control 1.31.1 的拟物 MIDI 控制面板。当前布局包含 2 个推子、8 个按钮、2 个监听按钮、3 个旋钮、全局快捷键，以及经过实测标定的 CC 与 dB 双向换算。

功能

• 原始 MIDI CC 控制，默认发送到 midi:StudioPro。
• 推子和旋钮按照实测曲线显示、输入 dB 数值。
• 按钮支持 toggle、反转端点和全局快捷键。
• 每次打开或刷新面板时，可由自定义模块恢复默认值并发送 13 条初始化 CC。
• 配置、几何和文字分离，构建后生成可直接导入 O-S-C 的会话文件。
• 提供浏览器原型和自动一致性、标定检查。

环境

• Open Stage Control 1.31.1
• Python 3.10 或更高版本
• Node.js 18 或更高版本
• Windows 下已验证；MIDI 端口可由 rtpMIDI、虚拟 MIDI 驱动或真实设备提供

快速开始

直接导入

在 Open Stage Control 中加载 panel/面板-live.json。该会话默认使用目标 midi:StudioPro，需在 O-S-C 启动参数中把 StudioPro 映射到实际 MIDI 端口。

Windows 启动脚本

powershell -ExecutionPolicy Bypass -File .\scripts\start-panel.ps1 `
  -OpenStageControlDir "C:\path\to\open-stage-control_1.31.1_win32-x64" `
  -MidiPorts "StudioPro:laptopMIDI,laptopMIDI"

然后访问 http://127.0.0.1:8787。

MidiPorts 遵循 O-S-C 的 名称:输入端口,输出端口 格式。示例把面板使用的 StudioPro 别名映射到 laptopMIDI。请按自己的端口名称修改。

Caution

startup_sync.js 会在每次打开或刷新面板时，把控件恢复为配置中的默认值，并向 MIDI 设备发送一轮 13 条 CC。这会覆盖接收端当时的对应参数。

默认 MIDI 映射

全部使用通道 1。

控件	CC	默认值	快捷键
说话推子	1	0	9
唱歌推子	7	100	0
左、右监听	36、37	0、0	1、2
六个效果按钮	30–35	0	3–8
三个旋钮	40–42	49、32、32	Q、W、E

映射与默认值的唯一配置来源是 panel/components.json。

修改与构建

日常配置主要位于：

• panel/components.json：CC、默认值、范围、反转、快捷键和名称
• panel/labels.json：文字、位置和样式
• panel/geometry.json：面板几何与素材位置

修改后执行：

python scripts/build_session.py
python scripts/check_consistency.py
node scripts/check_midi_calibration.js
node scripts/check_startup_sync.js

生成产物包括：

• panel/面板-live.json：正式会话
• panel/面板.json：烘焙备份
• panel/startup-defaults.json：启动初始化清单
• preview/labels.js 等浏览器原型配置

不要直接编辑生成产物。

目录

panel/       正式配置、会话和运行素材
preview/     浏览器原型
scripts/     生成器、自定义模块和校验脚本
assets/      原始设计素材

说明

本项目是独立社区项目，与 Open Stage Control、Fender 或 Studio Pro 8 的开发者和厂商没有隶属或背书关系。产品名称仅用于说明兼容场景。

许可证

MIT License