Petrichor：macOS 离线音乐播放器

项目简介

Petrichor 是一款面向 macOS 的离线音乐播放器，使用 Swift 与 SwiftUI 编写，部分功能借助 AppKit 实现以贴合 macOS 原生体验。它面向拥有大量本地音乐文件的用户：把存放音乐的文件夹添加进来，应用会扫描并提取元数据，建立可在应用内浏览的曲库，同时不修改任何原始音频文件或目录结构。

作者开发它的动机是：手上有多年积累的本地音乐收藏，却找不到一款既简洁、又具备流媒体应用常见功能的 macOS 离线播放器。

主要功能

• 支持 46 种音频文件扩展名，涵盖 MP3、AAC、ALAC、FLAC、Ogg Vorbis、Opus、WAV、AIFF、APE、WavPack、TTA、DSD、WMA、AC-3、DTS、AMR、CAF、MKA 等，无损与有损格式兼备。应用读取文件的实际编码而非按扩展名猜测，因此曲目上的 Lossless 标记可信。
• 映射本地音乐文件夹，以整理好的视图浏览曲库；需要时也可切换到文件夹视图。
• 收听网络电台，并把收藏的电台整理成集合。
• 播放曲目时显示同步歌词（若有），并可下载缺失的歌词。
• 创建、导入与导出播放列表（M3U）；支持带条件、否定与正则规则智能播放列表。
• 通过拖放在播放队列中进行交互式管理。
• 几乎任何内容都可固定到侧边栏，快速访问常听的音乐。
• 右键曲目即可跳转到其专辑、艺术家、年份等。
• 与 macOS 原生集成：菜单栏与 Dock 播放控制、深色模式、Miniplayer 与沉浸模式。
• 无缝播放、Crossfade、ReplayGain 音量标准化、均衡器、空间音频与 AirPlay 2 输出。
• 支持 Last.fm 记录播放（scrobbling）。
• 支持 Shortcuts、Automation API 与 Siri。
• 可流畅处理含数千首歌曲的大型曲库。

支持的格式范围较广，但以下类型不被支持：DRM 保护文件（.m4p、.aa、.aax）、有声书容器（.m4b）、tracker 模块（.mod、.it、.s3m、.xm）、RealAudio（.ra、.ram）以及 MIDI（.mid、.midi）。从 1.7 起，1.6.x 中支持的 tracker 模块格式已不再支持或导入。

安装与使用

系统要求：macOS 14 或更高版本，Apple Silicon 或 Intel 均可。

手动安装：

1. 前往 Releases 下载最新的 .dmg。
2. 打开后把应用图标拖入「应用程序」文件夹。
3. 在「应用程序」中右键点击 Petrichor > 打开。

使用 Homebrew 安装：

brew install --cask petrichor

使用说明可参考 Petrichor User Guide，更多界面截图见官网。

注意事项

• Petrichor 的许多功能高度依赖曲目具备良好的元数据，元数据完整时体验最佳。
• 应用经过沙盒化并由 Apple 公证，仅有读写与网络两类权限：读写权限用于访问用户选择的文件与文件夹，写入仅用于导出 M3U 播放列表。
• 网络访问用于：检查与安装应用更新；从在线来源获取艺术家图片与简介（默认关闭）；下载曲目歌词（默认关闭）；播放网络电台（默认关闭）；Last.fm scrobbling（默认关闭）；在应用内提交问题报告（仅用户主动发起时）。
• 启用 Last.fm 时，应用可能请求将会话信息存入 macOS 钥匙串；应用不保存你的 Last.fm 用户名与密码，只保留用于记录播放的会话密钥。
• 应用不包含任何使用行为分析，始终不会修改你的音频文件或文件夹结构，曲库数据始终保留在本地。
• 实现上，曲目搜索由 SQLite FTS5 处理，播放与元数据读取由 CrescendoKit 负责，底层使用 FFmpeg 与 TagLib 以支持广泛格式。

本作品整理自 GitHub 开源项目 kushalpandya/Petrichor，原作者 @kushalpandya，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。