Glassy Music：毛玻璃风格音乐桌面客户端

项目简介

Glassy Music 是开发者 NanKill 基于 Pear Desktop 二次开发的个人化桌面音乐播放器。它把播放器做成带有毛玻璃（glassmorphism）质感的桌面客户端，并集成了增强歌词、背景着色器等视觉特效，默认外观由作者按个人审美高度定制，追求「开箱即用」的观感。

项目为独立、非营利的非官方扩展，与 Google LLC、YouTube 及其关联公司没有任何隶属或授权关系。

更多截图见这里。

主要功能

• Better Lyrics 集成：加入自定义主题与问题修复，提供增强的歌词显示体验。
• Better Lyrics Shader：带修复的视觉特效增强，包含背景着色器效果。
• 内置广告拦截：减少播放过程中的打扰。
• Non-Stop：绕过「Video paused. Continue watching?」暂停提示。
• 个性化调整：作者按自己的偏好加入了一批额外定制。
• 自定义主题：可在设置中调整外观，不必完全沿用默认样式。

安装与使用

稳定版（推荐）：直接到 Releases 页面下载对应平台的预编译版本，覆盖 Windows、macOS、Linux 的 x86-64 与 ARM64 架构。

最新实验版：可从 GitHub Actions 下载自动构建产物，或参照下方步骤自行从源码构建。

Arch Linux（AUR）：目前仅有实验包，可用 yay 或 paru 安装：

yay -S glassy-music-nankill-git
# 或
paru -S glassy-music-nankill-git

从源码构建（Linux / macOS / Windows）

前置依赖：Git、最新版 Node.js、pnpm。

git clone https://github.com/NanKillBro/glassy-music-nankill
cd glassy-music-nankill
pnpm install --frozen-lockfile

然后按目标系统执行对应命令：

• pnpm dist:win - Windows
• pnpm dist:linux - Linux (amd64)
• pnpm dist:linux:deb-arm64 - Linux (arm64 for Debian)
• pnpm dist:linux:rpm-arm64 - Linux (arm64 for Fedora)
• pnpm dist:mac - macOS (amd64)
• pnpm dist:mac:arm64 - macOS (arm64)

构建使用 electron-builder。

Windows 自动构建脚本：作者提供了 build.bat，下载后双击运行，按提示选择架构，脚本会自动检查/安装依赖、克隆仓库、安装依赖包并编译，产物位于 glassy-music-nankill/pack 文件夹。

devcontainer 构建：克隆仓库 → 在 VS Code 中打开 → 按提示在容器中重新打开 → 执行 pnpm build → 从 dist 目录取构建产物。

注意事项

• 硬件建议：该版本包含较重的视觉定制，不建议在老旧或低端硬件上使用。Windows/Linux 若想以 1080p60 流畅运行，建议至少 4 核 CPU 与尚可的显卡（Intel UHD/Iris Xe 或独立显卡）；双核 CPU 可能跑满系统资源。macOS 在 Apple Silicon（M1 以上）上运行良好。
• 窗口尺寸：应用默认锁定最小窗口为 1280x720，如需关闭，前往 Options → Advanced options → Disable Minimum Window Size。
• 菜单不见了：若开启了 Hide Menu，按 <kbd>Alt</kbd> 键可唤出菜单（使用 in-app-menu 插件时按 <kbd>`</kbd>）。
• 封面/媒体信息异常：若封面质量低或 MPRIS 中看不到正在播放的媒体，启用「Shortcuts (& MPRIS)」插件即可。
• 代码状态：项目大量依赖「vibe coding」与 AI 辅助，代码架构可能未充分优化，部分功能可能存在 bug 或偶发失效；欢迎提交 PR 修复与优化。
• 免责声明：本应用按「AS IS」提供，使用风险自负；开发者与贡献者不对使用本软件产生的任何索赔、损害或其他责任负责。
• 许可证：GPL-3.0，基于 pear-desktop（MIT）。

---

本作品整理自 GitHub 开源项目 NanKillBro/glassy-music-nankill，原作者 @NanKillBro，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。