pear-desktop 离线安装包

简介

pear-desktop 是一个开源的 YouTube Music 桌面客户端，把网页播放器封装成原生应用，解决浏览器标签页播放易中断、缺少系统级媒体控制的问题。它内置广告拦截、下载器、主题切换与音频处理，并提供插件机制，可在播放器内部扩展能力。项目在 GitHub 上以 pear-devs/pear-desktop 开源，覆盖 Windows、macOS、Linux 三类桌面系统，适合希望用媒体键、托盘常驻、歌词与 Discord/Last.fm 状态同步来听歌的人，也适合想把播放能力接入直播点歌或小组件的进阶用户。具体版本、产物命名与校验信息以官方页面为准。

核心功能

• 内置广告拦截（ad blocking）：播放过程中跳过贴片与横幅广告，无需再装浏览器扩展，开关可在设置中查看。
• 内置下载器（downloader）：可从当前播放曲目取回音频文件，实际可用性受上游与服务端限制，以官方页面为准。
• 主题切换与自定义主题：提供多套界面配色并支持导入自定义主题，可按系统深浅色切换观感。
• 音频处理能力：内置 audio processing，可对输出做处理与调节，具体参数项以官方页面为准。
• 桌面级媒体控制：支持系统媒体键与通知、托盘图标常驻、后台播放，切走窗口后播放不中断。
• 歌词与社交状态：显示歌词，并支持 Discord presence 与 Last.fm 状态同步，让好友看到当前曲目。
• 插件体系：可加载扩展，例如 6K Labs 文档描述的 Amuse 小组件连接，以及 Twitch 聊天点歌 addon。
• 跨平台分发：同一项目面向 Windows、macOS、Linux，Arch Linux 用户另有 AUR 包可选。

使用场景

• 桌面日常听歌：把播放器收进托盘后台运行，用键盘媒体键切歌、调音量，不占用浏览器标签。
• 低干扰聆听：开启内置广告拦截，播放时不出现贴片与横幅广告，适合长时间挂机播放。
• 直播点歌：为 Pear Desktop 加载点歌 addon，让 Twitch 聊天直接请求 YouTube Music 曲目并在直播中播出。
• 接入 Amuse 小组件：按 6K Labs 文档把 Pear Desktop 连接到 Amuse widget，作为播放端使用。
• 状态同步与展示：开启 Discord presence 或 Last.fm 同步，把正在播放的曲目展示在社交资料上。
• Arch Linux 环境：通过 AUR 的 pear-desktop-bin 获取二进制包，纳入常规的软件包管理流程。

安装与获取步骤

1. 打开 GitHub 仓库 https://github.com/pear-devs/pear-desktop，在 Releases 或下载区选择与系统匹配的 Windows、macOS 或 Linux 产物；产物命名、体积与哈希以官方页面为准。
2. Arch Linux 用户可访问 https://aur.archlinux.org/packages/pear-desktop-bin ，用惯用的 AUR 助手构建 pear-desktop-bin；注意上游已把项目从 youtube-music 更名为 pear-desktop。
3. 若 pear-desktop-bin 构建过程中报 PNPM 相关错误（上游正在迁移到 PNPM v9），可临时改用 AUR 上的 youtube-music-bin 作为过渡方案。
4. 首次启动后进入设置，逐项确认广告拦截、托盘与后台播放、媒体键、通知是否已开启，并按需选择主题。
5. 需要连接 Amuse 小组件时，参照 https://docs.6klabs.com/docs/connections/youtube-music/pear-desktop 完成连接配置，字段与授权方式以该文档为准。
6. 需要直播点歌时，参照教程 https://www.youtube.com/watch?v=39BjPJvhGE8 为 Pear Desktop 添加对应 addon，并在直播软件中确认音频输出正常。

与同类方案的区别

• 相对浏览器直接打开 YouTube Music：桌面客户端提供托盘常驻、媒体键、系统通知与跨平台一致的快捷键，浏览器方案的控制受限于标签页与扩展权限。
• 相对纯浏览器扩展：pear-desktop 把广告拦截、下载、主题、音频处理与插件都做进同一个播放器进程，配置入口集中，不必在多个扩展之间排查冲突。
• 相对 AUR 上的 youtube-music-bin：两者同源，差别主要在包名与维护跟进速度；pear-desktop-bin 对应更名后的新包，检索与依赖查询建议统一用 pear-desktop。

注意事项

• 项目曾用名 youtube-music，AUR 上新旧包名并存，查询与反馈时以 pear-desktop / pear-desktop-bin 为准，避免找到同名无关项目。
• 上游依赖 PNPM 版本迁移期间，AUR 包可能出现构建失败，可先用 youtube-music-bin 过渡，或等维护者同步依赖后重试。
• 本页不列出版本号、文件大小与哈希值，任何具体参数均以官方页面为准，下载前请自行核对。
• 离线包来源建议限定在 GitHub 仓库 Releases 与 AUR 源，第三方转载的重打包产物可能被改动，存在被替换的风险。
• 下载器、音频处理等能力受上游实现与地区服务影响，若某项功能不可用，先确认当前版本的官方说明。
• Discord presence 与 Last.fm 同步需要在设置中填入对应账号，未授权时状态不会更新。