用户指南

MACA是一款菜单栏应用。安装后，macOS菜单栏（屏幕右上角）会出现一个小图标。点击它打开主弹出窗口。

首次启动

首次启动时，设置向导将引导您完成：

1. 欢迎 — MACA所需权限的概述。
2. 音频权限 — MACA使用Core Audio Taps来控制每个应用的音频。一个按钮会打开系统设置，以便您在需要时授予访问权限。
3. 通知 — 可选。启用检测到音频问题或自动修复时的提醒。
4. 完成 — 您的选择摘要。您可以返回并更改任何步骤。

登��时启动

要在登录时自动启动MACA，请在设置 > 通用中启用"登录时启动"。

MACA位于菜单栏中。您可以在设置 > 通用中从四种图标样式中选择：

图标样式

电平表详情

电平表每秒更新10次，显示MACA控制的所有应用的总音频电平。

• 削波检测： — 当任一声道的音频峰值超过98%时，该条会完全闪红200毫秒。
• 节能优化： — 显示器休眠时电平表自动暂停，唤醒时干净地重置。

其他图标行为

• 动画 — 启用后，任何应用播放音频时图标都会动画。不适用于电平表样式。
• 自动隐藏 — 启用后，5分钟无音频活动后菜单栏图标将隐藏。任何应用开始播放音频时立即重新出现。

点击菜单栏图标打开主弹出窗口。它从上到下包含以下部分：

主音量

顶部的水平滑块控制系统主音量（0–100%）。滑块的左右两侧：

• 全部静音 — 一次性静音所有应用。再次按下取消静音。
• 专注模式 — 静音除通讯应用外的所有应用（见第7节）。
• 归一化器 — 自动平衡各应用间的音频电平。Pro

搜索和排序

• 搜索字段 — 输入以按名称筛选应用列表。最近使用但当前未活跃的应用也会显示"启动"按钮。
• 排序方式 — 在字母顺序（A-Z）和最近活动之间选择。

配置文件选择器

下拉菜单允许您激活、停用或管理已保存的音频配置文件（见第9节）。

应用列表

显示当前正在产生音频的所有应用。每个应用都有自己的一行，带有音量控制。

• 绿点表示应用正在播放音频。
• 红色扬声器划线标记表示应用已静音。

系统进程

标记为"系统服务"的可折叠部分显示系统级音频进程，如电话、通知和屏幕共享。默认隐藏——可在设置 > 通用中启用。

辅助设备

可折叠部分显示除默认设备外所有已连接输出设备的音量控制（见第10节）。

底栏

• 默认输出设备 — 更改系统级默认音频输出的下拉菜单。设备分为本地、蓝牙和AirPlay组。
• 设置 — （齿轮图标）— 打开设置窗口。
• 退出 — （电源图标）— 显示确认对话框，然后退出MACA。退出时清理所有音频Tap和虚拟设备。

列表中的每个应用显示：

工作原理

MACA使用Apple Core Audio Taps拦截每个应用的音频流。音量通过数字信号处理实时应用。所有音频通道不经修改地通过——只调整增益。

点击任意应用行上的扬声器/设备图标打开输出设备选择器。这允许您将单个应用的音频发送到与系统默认不同的输出设备。

设备选择器

• 使用系统默认 — 通过默认输出路由此应用。这是默认行为。
• 可用设备 — 列出所有已连接的输出设备：内置扬声器、USB音频接口、HDMI输出、蓝牙耳机等。
• 蓝牙部分 — 单独显示已配对的蓝牙音频设备。

点击任意应用行上的EQ按钮，打开该应用的独立EQ窗口。

EQ窗口控件

自定义EQ配置文件Pro

在设置 > 均衡器中创建自定义EQ配置文件。自定义配置文件出现在每个EQ窗口的预设选择器顶部。您可以在设置中重命名、编辑和删除自定义配置文件。

设置中的EQ

设置 > 均衡器显示所有自定义EQ配置文件和所有已配置EQ设置的应用的概述。从那里您可以打开任何应用的EQ窗口、重置应用的EQ或管理您的自定义配置文件。

专注模式静音除通讯应用外的所有音频。通过以下方式激活：

• 点击主弹出窗口主控区域中的电话图标。
• 使用键盘快捷键（默认：Option + Command + F）。

激活时，电话图标变为绿色。再次按下或使用快捷键停用。

归一化器自动平衡所有应用的音频电平，使没有任何应用明显比其他应用更响或更轻。Pro

点击主控区域中的归一化器开关来激活。当归一化器主动调整超过0.5 dB的电平时，开关旁边会出现一个小的增益指示器：

• 提升时（正dB）为橙色
• 衰减时（负dB）为青色

配置文件保存音频配置的快照——每个应用的音量、静音状态、输出设备分配和EQ设置——以便您可以一键切换设置。

创建配置文件

1. 打开设置 > 配置文件。
2. 点击"+"按钮。
3. 输入名称并从网格中选择图标（10个图标可用）。
4. 可选启用"捕获当前状态"将所有运行中应用的当前设置保存到新配置文件。

激活配置文件

• 从主弹出窗口中的配置文件选择器下拉菜单。
• 在设置 > 配置文件中悬停在配置文件上点击复选标记，或双击。
• 通过快捷指令应用："加载配置文件"操作。

自动保存

每个配置文件都有自动保存开关。启用后，在配置文件处于活动状态时进行的任何音量、静音、设备或EQ更改都会自动保存回配置文件。

编辑配置文件

在设置 > 配置文件中，选择一个配置文件并点击编辑按钮。详细视图显示：

• 图标选择器（带SF Symbols的下拉菜单）。
• 名称字段。
• 配置文件中所有应用的列表，每个都有：图标、名称、静音开关、音量滑块、输出设备选择器、EQ预设选择器和删除按钮。
• "添加应用"按钮用于从运行中或历史记录中包含其他应用。

主弹出窗口底部的辅助设备部分显示除当前默认设备外所有已连接输出设备的音量控制。

每个设备行包括：

• 设备图标（基于传输类型：内置、USB、蓝牙、HDMI等）。
• 设备名称。
• 音量滑块。
• 静音按钮。
• 信息按钮（打开包含设备详情的弹出框）。

MACA支持在任何应用中都能工作的全局键盘快捷键。在设置 > 快捷键中配置它们。

默认快捷键

自定义快捷键

点击任何快捷键旁的录制字段以分配新的键组合。按下您想要的快捷键，然后点击其他地方确认。使用"重置为默认值"按钮将所有快捷键恢复为原始值。

打开快捷指令应用，创建新的快捷指令并搜索"MACA"以找到以下操作：

从主弹出窗口底栏的齿轮图标打开设置，或右键点击菜单栏图标。

通用

应用可见性

控制哪些应用出现在主弹出窗口中。

• 切换单个应用的可见性（眼睛图标）。
• 按应用名称或包标识符搜索。
• 筛选仅显示隐藏的应用。
• "显示所有应用"将所有应用重置为可见。
• "清除历史记录"删除之前看到的应用记录。

设备可见性

控制哪些输出设备出现在辅助设备部分。

• 切换单个设备的可见性（眼睛图标）。
• 按设备名称搜索。
• 每个设备显示其传输类型和唯一标识符。
• "显示所有设备"将所有设备重置为可见。
• "清除历史记录"删除之前看到的设备记录。

系统

关于

• MACA版本和构建号。
• Pro或Free等级标记。
• Pro用户：感谢消息。Free用户："升级到Pro"按钮。
• MACA网站、支持邮箱、App Store页面和版本历史的链接。

MACA在后台每30秒自动运行一次健康检查。它会查找：

• 孤立的聚合设备 — 来自之前的崩溃或异常终止。
• 孤立的音频Tap — 不再连接到运行中应用的。
• 竞争应用 — 可能干扰MACA的。

发现问题时，MACA会尝试自动修复。您可以在设置 > 系统 > 修复历史中查看修复记录。

退出时清理

当您退出MACA（或进程被SIGTERM、SIGINT或SIGQUIT终止）时，所有音频Tap和聚合设备都会被销毁，使您的系统保持干净状态。

要升级，点击设置 > 关于中的"升级到Pro"按钮，或点击任何Pro限制功能上的锁定图标。购买通过App Store进行，可在使用相同Apple ID登录的任何设备上恢复。

有关详细的故障排除步骤，请访问我们的专用故障排除页面：

MACA 提供本地 REST API，让您可以以编程方式控制所有音频应用。非常适合自动化工作流、Stream Deck 集成、智能家居设置和自定义脚本。

curl http://127.0.0.1:59622/v1/status

{
  "app": "MACA",
  "version": "1.1.12",
  "build": "084",
  "apiVersion": "1",
  "features": {
    "perAppVolume": true,
    "perAppMute": true,
    "perAppRouting": true,
    "focusMode": true,
    "volumePreview": true,
    "masterVolume": true,
    "masterMute": true
  }
}

curl http://127.0.0.1:59622/v1/apps

curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_GENERAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Status
curl -s http://127.0.0.1:59622/v1/status | python3 -m json.tool

# List apps
curl -s http://127.0.0.1:59622/v1/apps | python3 -m json.tool

# Get single app
curl -s http://127.0.0.1:59622/v1/apps/com.spotify.client | python3 -m json.tool

# List output devices
curl -s http://127.0.0.1:59622/v1/output-devices | python3 -m json.tool

# Set volume (needs token)
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Mute an app
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/mute \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"muted": true}'

# Change default output device
curl -X PUT http://127.0.0.1:59622/v1/default-output-device \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"deviceUID": "BuiltInSpeakerDevice"}'

# Toggle focus mode
curl -X PUT http://127.0.0.1:59622/v1/focus-mode \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"active": true}'