无论你是第一次安装 FineTune 的新用户，还是想挖掘 URL Scheme 自动化能力的进阶玩家，都能在这里找到清晰的步骤说明与最佳实践。
FineTune 提供两种官方安装方式：通过 Homebrew Cask 一行命令安装（推荐），或从官网下载 dmg 安装包手动安装。Homebrew 方式的优势在于后续升级与卸载都能通过 brew 命令统一管理，避免版本碎片化。
# Homebrew 安装（推荐）
brew install --cask finetune
# 升级到最新版
brew upgrade --cask finetune
# 卸载
brew uninstall --cask finetune如果你选择手动安装，请从下载中心获取最新 dmg 安装包，双击挂载后将 FineTune 拖入「应用程序」文件夹，然后从 Launchpad 或「应用程序」中启动即可。
首次启动 FineTune 时，系统会弹出权限请求对话框，提示需要授予「屏幕与系统音频录制」权限。这个权限是 macOS 按应用捕获音频流的必要条件，没有它 FineTune 就无法识别每个应用的音频并独立调节音量。请按以下步骤授权：
所有音频处理均在本地完成，FineTune 不会上传任何音频数据到云端，权限仅用于按应用捕获音频流。
授权完成后，菜单栏顶部会出现 FineTune 图标。点击图标展开弹窗，你会发现 macOS 当前正在播放音频的应用会自动出现在列表中，每个应用都有独立的音量滑块、静音按钮和路由选择。试着拖动滑块、点击静音、切换输出设备，体验按应用独立控制的便利。
除了基本控制，弹窗里还有几个隐藏功能：点击应用行右侧的展开按钮可以打开该应用的 EQ 面板；点击编辑模式（铅笔图标）可以置顶或隐藏应用；点击设备行的信息按钮可以查看采样率、传输方式等设备详情。
安装完成后，建议按以下顺序完成初次配置，让 FineTune 真正融入你的日常工作流：
AutoEQ 是一个开源项目，目标是让所有耳机都能接近哈曼目标曲线的理想频响。它通过测量数千款主流耳机的频响特性，为每副耳机生成一套参数 EQ 校正曲线，让低价耳机也能拥有接近高端 Hi-Fi 耳机的听感。FineTune 把这套校正能力直接集成到了菜单栏里。
FineTune 内置了 AutoEQ 项目的完整耳机数据库。在 FineTune 弹窗中展开任意应用的 EQ 面板，点击「AutoEQ」标签，输入你的耳机品牌与型号关键字（例如「Sennheiser HD600」），下拉列表会自动匹配数据库中的对应条目，选中后即时应用校正曲线。
# 在 EQ 面板的 AutoEQ 标签中：
1. 输入耳机品牌或型号
2. 从下拉列表选择匹配项
3. 自动应用 ParametricEQ 校正曲线
4. 校正结果对该 App 永久生效如果你使用的耳机不在内置数据库中，或者你想使用自定义的测量数据，可以导入 EqualizerAPO 格式的 ParametricEQ.txt 文件。这类文件可以从 autoeq.app 在线生成，或自己用 AutoEQ 项目源码生成。
# ParametricEQ.txt 示例格式
Filter 1: ON PK Fc 30 Hz Gain -5.6 dB Q 0.9
Filter 2: ON PK Fc 100 Hz Gain -3.2 dB Q 1.2
Filter 3: ON PK Fc 1000 Hz Gain 2.1 dB Q 0.8
...导入方法：在 EQ 面板的 AutoEQ 标签中点击「导入文件」按钮，选择本地 ParametricEQ.txt 文件即可。导入后曲线会与该 App 永久关联，下次启动时自动加载。
人耳对不同频率的敏感度会随音量变化，这就是著名的等响度曲线（ISO 226:2023）。在低音量下，低频与高频会被显著"压缩"，导致音乐听起来单薄无力。FineTune 的响度补偿功能会根据当前音量自动补偿低频与高频，让任何音量下都能保持平衡的听感。
启用方法：在「设置 → EQ」中开启「响度补偿」开关。补偿强度可根据个人喜好调整，建议从默认的 50% 开始尝试。补偿启用后会自动管理整体电平，避免削波失真。
FineTune 提供了完整的 URL Scheme 自动化接口，可以通过终端、快捷指令、Raycast 脚本或任何支持 URL 调用的工具来控制音量、静音、设备路由等所有功能。URL Scheme 的前缀为 finetune://。
# 调节指定应用的音量（0-100，支持小数）
finetune://volume?app=Safari&level=65
# 切换指定应用静音
finetune://mute?app=Spotify&state=toggle
# 切换默认输出设备
finetune://output?device=AirPods%20Pro
# 应用 EQ 预设
finetune://eq?app=QuickTime%20Player&preset=Vocal%20Clarity
# 切换菜单栏弹窗显隐
finetune://popup/toggle最直接的调用方式是在终端中通过 open 命令触发 URL Scheme。这种方式适合写 shell 脚本，例如连接 AirPods Max 时自动切换到高清输出并应用 AutoEQ：
#!/bin/bash
# ~/.config/finetune/airpods-max.sh
# 等待设备连接
sleep 2
# 切换输出到 AirPods Max
open "finetune://output?device=AirPods%20Max"
# 应用 Hi-Fi 预设
open "finetune://eq?app=Spotify&preset=Hi-Fi"
# 把 Spotify 音量设到 50%
open "finetune://volume?app=Spotify&level=50"在 macOS「快捷指令」App 中创建新快捷指令，添加「打开 URL」动作，URL 填入 finetune:// 开头的命令即可。可以为每个常用配置创建一个快捷指令，再用 Spotlight 或 Raycast 直接调用。
Raycast 用户可以创建 Script Command，用 bash 调用 open 触发 URL Scheme，并配合 Raycast 的参数输入实现更灵活的自动化。例如创建一个"调低当前应用音量 10%"的 Script Command：
# Raycast Script Command
#!/bin/bash
# @raycast.title Volume Down 10%
# @raycast.mode silent
open "finetune://volume?app=current&delta=-10"完整的 URL Scheme 参数表与高级用法请参考 GitHub 仓库的 官方文档。所有 URL 参数均经过 URL 编码，特殊字符（如空格）需使用 %20 等转义。
在「设置 → 快捷键」中可以为以下全局动作绑定自定义快捷键。这里的"应用"指的是当前正在发声的应用，如果没有任何声音，快捷键会回退到最前台的应用。
| 动作 | 推荐快捷键 | 说明 |
|---|---|---|
| App Volume Up | ⌥ + ↑ |
当前发声应用音量加 |
| App Volume Down | ⌥ + ↓ |
当前发声应用音量减 |
| App Mute | ⌥ + M |
切换静音，按音量加自动取消 |
| Toggle Popup | ⌥ + Space |
从任何地方唤起弹窗，含全屏应用 |
弹窗打开后，可以用键盘完整操作所有功能，无需鼠标。焦点行会自动滚动到中央，方便在长列表中定位。
| 按键 | 功能 |
|---|---|
↑ / ↓ | 在应用行之间移动焦点 |
← / → | 调节焦点行音量（Shift = 2 倍步长） |
M | 切换焦点行静音 |
Tab | 在「输出」与「输入」设备标签间切换 |
Return / Space | 激活焦点行（展开 EQ 或打开设备详情） |
Esc | 关闭弹窗 |
在「设置 → 快捷键 → Volume Step」中可以选择四档音量步长，同时控制 F10–F12 媒体键、全局快捷键与弹窗方向键导航的步进精度：