一个在 macOS 菜单栏显示实时音频频谱可视化的应用程序。
- 🎵 实时音频可视化：在菜单栏中显示实时频谱分析
- 🎨 精美动画：流畅的彩色频率柱状图，性能影响极小
- 🔊 系统音频捕获：使用 ScreenCaptureKit 直接捕获所有系统音频输出
- ⚡ 高性能：利用 Apple Accelerate 框架进行高效的 FFT 处理
- 🎯 菜单栏集成：驻留在菜单栏中，保持 Dock 栏整洁
- ⚙️ 可自定义设置：调整频谱条数量 (8-64) 和颜色方案
- 🎨 多种颜色方案：彩虹、绿到红、蓝到红、单色、自定义
应用程序由几个核心组件组成：
-
AudioCaptureManager：使用 ScreenCaptureKit 处理系统音频捕获
- 使用 ScreenCaptureKit API 进行原生系统音频捕获
- 自动请求屏幕录制权限
- 实时处理音频缓冲区
-
SpectrumAnalyzer：使用 Accelerate 框架执行 FFT 分析
- 使用 vDSP 进行高效的快速傅里叶变换（4096 采样大小）
- 将频率分组为 32 个对数频带（20Hz - 20kHz）
- 应用 Blackman-Harris 窗函数和智能平滑算法以获得更好的视觉效果
-
SpectrumVisualizerView：用于渲染频谱的 SwiftUI 视图
- 显示 32 个动画频率柱
- 基于频率和强度的动态渐变着色
- 针对菜单栏显示进行了优化
-
MenuBarController：管理状态栏集成
- 创建和配置菜单栏项目
- 提供开始/停止控制
- 集成所有组件
-
SettingsManager：管理用户偏好设置
- 存储和加载设置（使用 UserDefaults）
- 支持 5 种颜色方案
- 可配置频带数量 (8-64)
-
SettingsView：设置窗口界面
- SwiftUI 界面，用于自定义频谱
- 实时预览更改
- 自动保存设置
- macOS 13.0 或更高版本
- Xcode 15.0 或更高版本
- Swift 5.9 或更高版本
# 克隆仓库
git clone https://github.com/Yixi/y-music-spectrogram.git
cd y-music-spectrogram
# 构建应用程序
swift build -c release
# 运行应用程序
.build/release/YMusicSpectrogram- 在 Xcode 中打开项目目录
- 创建一个新的 macOS App 项目并导入源文件
- 确保 Info.plist 配置正确
- 构建并运行 (⌘R)
✅ 原生系统音频：本应用使用 ScreenCaptureKit 直接捕获所有系统音频输出！
- 首次启动：应用将请求屏幕录制权限
- 授予权限：前往 系统设置 > 隐私与安全性 > 屏幕录制
- 启用应用：勾选 Y Music Spectrogram 旁边的复选框
- 重启：退出并重新启动应用以使权限生效
- 所有系统音频输出（音乐、视频、游戏等）
- 无需 BlackHole 等虚拟音频驱动
- 适用于任何播放音频的应用程序
- 原生 macOS 13+ 集成
如果您不想授予屏幕录制权限，则需要修改代码以使用麦克风输入并通过 BlackHole 路由音频。当前版本针对 ScreenCaptureKit 进行了优化。
- 启动应用程序
- 出现提示时授予屏幕录制权限（用于系统音频）
- 频谱可视化器将出现在您的菜单栏中
- 右键单击菜单栏项目可以：
- 打开设置窗口 (或按 ⌘,)
- 开始/停止音频捕获
- 退出应用程序
- 在设置窗口中，您可以：
- 调整频谱条数量 (8-64)
- 选择颜色方案（彩虹、绿到红、蓝到红、单色、自定义）
- 自定义颜色（色调、饱和度、亮度）
- 在 Mac 上播放任何音频即可看到可视化效果！
- FFT 大小：4096 采样（高分辨率）
- 采样率：48 kHz (ScreenCaptureKit)
- 缓冲区大小：4096 帧
- 频带数量：32（20Hz - 20kHz 对数分布）
- 窗函数：Blackman-Harris 窗（更好的信号清晰度）
- 使用 Accelerate 框架的 vDSP 进行硬件加速 FFT
- 极低的 CPU 占用率（~2-5%）
- 通过 SwiftUI 实现流畅的 60 FPS 动画
- 菜单栏宽度：150 点
- 高度：22 点（标准菜单栏高度）
- 柱间距：1.0 点
- 配色方案：基于频率和强度的动态渐变（绿 -> 黄 -> 红）
y-music-spectrogram/
├── Package.swift
├── README.md
├── ARCHITECTURE.md # 架构文档
├── SETTINGS_GUIDE.md # 设置指南
└── YMusicSpectrogram/
├── Sources/
│ ├── YMusicSpectrogramApp.swift # 应用入口点
│ ├── MenuBarController.swift # 菜单栏集成
│ ├── AudioCaptureManager.swift # 音频输入处理
│ ├── SpectrumAnalyzer.swift # FFT 处理
│ ├── SpectrumVisualizerView.swift # UI 可视化
│ ├── SettingsManager.swift # 设置管理 ✨
│ └── SettingsView.swift # 设置界面 ✨
└── Resources/
└── Info.plist # 应用配置
- ScreenCaptureKit 集成用于原生系统音频捕获
- 可自定义配色方案（5种方案可选）
- 可调节频带数量（8-64可调）
- 峰值保持指示器
- 音频设备选择
- 预设可视化样式
- 导出/导入设置
MIT License - 随意使用和修改。
欢迎贡献！请随时提交 Pull Request。
- 检查 系统偏好设置 > 安全性与隐私 > 麦克风
- 确保应用拥有麦克风权限
- 对于系统音频，验证 BlackHole 安装和音频 MIDI 设置配置
- 检查 Info.plist 中 LSUIElement 是否设置为 YES
- 验证应用是否正在运行（检查活动监视器）
- 减少 SpectrumAnalyzer 中的频带数量
- 增加平滑因子以减少更新频率
使用 Swift、SwiftUI 和 Apple Accelerate 框架构建 ❤️。