
================================================================================
 English Quick Guide
================================================================================
INSTALL   Run copy.bat — it copies "Remote Scripts" (both Behringer_AQ64L and
          _Behringer folders are required) into:
          %USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\
          (Alternative manual location: C:\ProgramData\Ableton\
          Live <version>\Resources\MIDI Remote Scripts\.) Restart Live.
          macOS: run install_mac.command (first time: right-click > Open;
          or Terminal: bash install_mac.command). It installs to
          ~/Music/Ableton/User Library/Remote Scripts/. Custom User Library
          location: bash install_mac.command "/path/to/User Library".
LOCATION  The installer finds your User Library by itself: command-line path >
          Live's own settings (Library.cfg, newest Live version) > default
          folder > folder-picker dialog. It shows the path and asks to confirm
          (Enter = install, n = pick another folder, q = quit). Windows with a
          custom location: copy.bat "D:\path\to\User Library".
SETUP   Preferences > Link/Tempo/MIDI: Control Surface = "Behringer AQ64L",
          Input/Output = the FIRST "AQ64L" port. In the MIDI Ports list
          enable Track for "MIDIIN2 (AQ64L)" (USER-mode playing goes through
          it). On the device: SET menu > MK2 compatibility OFF.
          The device auto-enters SESSION within ~1 s; quitting Live returns
          it to USER1.
SESSION   8x8 grid = Session View clips (column = track, row = scene), pads
          show clip colors and launch/stop clips. Green pulse = playing,
          green blink = triggered, red pulse = recording. Right FUNC column
          launches scenes. Nav keys move the session ring (red frame follows
          in Live).
MIXER     Combo view rows match the silk print: STOP = clip stop, TRACK =
          select, SOLO = solo, ARM = record-arm; nav keys bank by 8 tracks.
          Short-press FUNC 1-8 for sub-modes: VOL / PAN / SND A / SND B
          fader pages, STOP page (pad row stops tracks, FUNC column stops
          whole scenes; LED = scene has a playing track), TRACK / SOLO / ARM
          pages. Press the same FUNC again (or MIXER) to return.
USER      USER1/USER2 stay available while connected; notes reach Live via
          the second MIDI port (enable Track on "MIDIIN2 (AQ64L)").
MK2       When using Apollo Studio / MK2 ecosystem software, disable the
          AQ64L Control Surface in Live to avoid LED conflicts.
TROUBLE   No connect: Control Surface not set, wrong ports, or MK2 switch on.
          No LEDs: wrong output port. USER notes silent: MIDIIN2 Track off.
          Live frozen >45 s: device grays out and auto-recovers.
================================================================================


================================================================================
 AQ64L — Ableton Live 控制脚本（MIDI Remote Script）使用说明 / Usage Guide
 适用 Requires: Ableton Live 10 及以上（开发验证基于 Live 12）
================================================================================

【本文件夹内容】
  copy.bat                             一键安装脚本
  Remote Scripts\Behringer_AQ64L\      AQ64L 控制脚本（控制界面主体）
  Remote Scripts\_Behringer\           共享框架组件（必须与上面一起拷贝）

--------------------------------------------------------------------------------
一、安装
--------------------------------------------------------------------------------
1. 双击运行 copy.bat —— 自动把整个 Remote Scripts 拷贝到 Ableton 用户库：
   %USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\
   （手动安装的另一个可选位置——放到 Live 程序资源目录，二选一即可：
     C:\ProgramData\Ableton\Live <版本>\Resources\MIDI Remote Scripts\ ）
   注意：Behringer_AQ64L 和 _Behringer 两个文件夹必须都在，缺一不可。
   安装程序会自己找用户库，不必手动指定，查找顺序：
     命令行参数 → Live 自己的配置（Library.cfg，取最近使用的 Live 版本）
     → 默认位置（含被 OneDrive 重定向的"文档"）→ 弹出文件夹选择框。
   找到后会显示路径并让你确认：直接回车 = 安装；n = 换一个文件夹；q = 退出。
   用户库在非默认位置又没被识别时，可手动指定：
     copy.bat "D:\你的路径\User Library"
   （copy.bat 只是启动器，实际工作由同目录的 install.ps1 完成，请勿删除它。）
2. 重启 Ableton Live。

macOS 安装：
1. 运行 install_mac.command（首次请右键 > 打开，以通过 Gatekeeper；
   或在"终端"执行：bash install_mac.command），自动安装到：
   ~/Music/Ableton/User Library/Remote Scripts/
   （用户库不在默认位置时：bash install_mac.command "/你的/User Library 路径"；
     路径可在 Live > 设置 > Library 查看。）
2. 重启 Ableton Live。
   说明：若双击提示"没有权限"，在终端执行 chmod +x install_mac.command 一次即可，
   或直接用 bash install_mac.command 运行。
   macOS 下设备会显示为 USB MIDI 设备，端口名可能与 Windows 不同——
   Control Surface 仍选 "Behringer AQ64L"，Input/Output 选第一个 AQ64L 端口，
   第二个端口的 Track 开关照常打开。

--------------------------------------------------------------------------------
二、Live 首选项设置（Options > Preferences > Link/Tempo/MIDI）
--------------------------------------------------------------------------------
  Control Surface：选 "Behringer AQ64L"
  Input / Output ：都选第一个 "AQ64L" 端口（不要选 MIDIIN2/MIDIOUT2）
  下方 MIDI Ports 列表：把 "MIDIIN2 (AQ64L)" 的 Track 打开——
                        USER 模式弹奏经这个口进 Live 轨道
  设备端：SET 菜单里 MK2 兼容开关必须关闭

  设置完成后设备约 1 秒内自动进入 SESSION 模式；退出 Live 时设备自动回 USER1。

--------------------------------------------------------------------------------
三、SESSION 模式（Live Session View 触发）
--------------------------------------------------------------------------------
  8×8 pad     对应 Session 视图 clip 格：列 = 轨道、行 = scene（与 Live 同向）。
              pad 显示 clip 颜色；按下 = 触发/停止该 clip。
  动画        绿色呼吸 = 播放中；绿色闪烁 = 已触发待播；红色呼吸 = 录音中。
  右侧 FUNC 列  scene launch：触发整行 scene。
  方向键      移动 8×8 选择框（session ring），Live 里红框实时跟随；
              LED 亮 = 该方向还能移动。

--------------------------------------------------------------------------------
四、MIXER 模式（按设备 MIXER 模式键进入）
--------------------------------------------------------------------------------
组合视图（进入时的默认画面）四行，与丝印一致：
  STOP  行    停止该轨正在播的 clip
  TRACK 行    选中轨道
  SOLO  行    独奏开关
  ARM   行    预备录音开关
  ◄ ► ▲ ▼    轨道 bank 移动（8 轨一屏）

短按 FUNC 1-8 进入子模式（再按同一键或 MIXER 键返回组合视图）：
  FUNC 1  VOL    音量推子（8 列）
  FUNC 2  PAN    声像推子
  FUNC 3  SND A  发送 A 推子
  FUNC 4  SND B  发送 B 推子
  FUNC 5  STOP   停止页：pad 行停单轨；FUNC 列 = 按 scene 停
                 （FUNC 列灯亮 = 该 scene 有轨在播）
  FUNC 6  TRACK  选轨页
  FUNC 7  SOLO   独奏页
  FUNC 8  ARM    预备录音页

--------------------------------------------------------------------------------
五、USER 模式与共存说明
--------------------------------------------------------------------------------
  USER1/USER2   连接期间随时可切换（不会被弹回 SESSION）；弹奏音符经第二个
                MIDI 口（MIDIIN2）进入 Live 轨道，LED 反馈同口返回。
  MK2 兼容模式  与 Apollo Studio 等 MK2 生态软件配合使用时，请在 Live 里
                禁用 AQ64L 的 Control Surface，避免两边抢灯光。

--------------------------------------------------------------------------------
六、故障排查
--------------------------------------------------------------------------------
  不自动连接        → Control Surface 未选 / Input、Output 选错口 /
                      设备 MK2 兼容开关没关
  灯光全无          → Output 端口没选第一个 AQ64L
  USER 模式弹不出声 → MIDIIN2 (AQ64L) 的 Track 开关没开，或轨道没布防
  Live 卡死 >45 秒  → 设备变灰属正常保护，Live 恢复后自动重连并整面重画
  强杀 Live 后      → 45 秒内重开 Live 会自动重新进入 SESSION

