Kopuz：Rust 编写的现代音乐播放器

项目简介

Kopuz 是一个用 Rust 和 Dioxus 构建的现代轻量音乐播放器，适合想在一个界面里统一管理本地与在线音乐的用户。它可以扫描本地目录、连接 Jellyfin 或 Subsonic 兼容服务器（如 Navidrome），也可以接入 YouTube Music、SoundCloud、Spotify 等流媒体后端，并把内容整理成可按艺术家、专辑、流派浏览的音乐库。音乐库、歌单、收藏和设置保存在本地 SQLite 数据库 kopuz.db 中，界面实时读取，改动立即生效。

播放器本身是一个守护进程，掌管音乐库、音频引擎、媒体源及其凭据；窗口只是它的客户端，两者通过本地 socket 上的 gRPC 接口通信，接口文档见仓库的 docs/api.md。kopuzd 以无窗口方式运行同一内核，kopuzctl 可以在终端或脚本中控制播放、配置音乐源、启动库任务。

主要功能

• 多音乐源：本地文件夹、Jellyfin、Subsonic（Navidrome）、YouTube Music、SoundCloud、Spotify，以及作为音乐库的 SMB 2/3 共享或子文件夹；所有源统一在 MediaSource 层暴露，界面按各源能力自适应。
• YouTube Music：支持 Discover 推荐页、艺术家资料页、专辑与歌单浏览、mix 电台；登录后可访问个人库、Liked Music 和歌单，也可匿名使用公开内容。
• Spotify：访问已保存的歌曲、专辑和歌单，提供 Discover 页、搜索与 scrobbling，播放走官方 Web Playback SDK 或任意 Spotify Connect 设备。
• SoundCloud：搜索、播放（渐进式 MP3 与 Go+ AAC/HLS）、Liked tracks 收藏、只读歌单与点赞。
• 歌词：支持逐行同步歌词与纯文本歌词，并自动滚动跟随。
• 收藏与歌单：本地加星或与 Jellyfin/Subsonic 服务器同步收藏；创建管理歌单，可整张专辑批量加入并同步到服务器。
• 播放增强：内置 10 段均衡器与预设、交叉淡入淡出、Stereo/Mono/Left only/Right only/Swap L/R 声道模式。
• 桌面集成：支持 Linux MPRIS、macOS Now Playing、Windows 系统媒体控制，可最小化到托盘继续播放，内置 Discord RPC 与迷你播放器。
• YouTube 下载：粘贴 YouTube / YouTube Music 的歌曲、歌单或专辑链接即可下载，自动写入标题、艺术家、专辑与封面并归档到专辑文件夹。
• 其他：主题与自定义 UI 字体、按流派浏览、文件格式徽章、快速搜索浮层、本地播放次数统计、ListenBrainz scrobbling、重扫时自动清理缺失曲目，以及包括简体中文在内的多语言界面。

安装与使用

发布页提供各平台安装包：原生 GPUI 版 Kopuz 会同时安装 kopuzd 与 kopuzctl，Kopuz Legacy 是此前内置守护进程的 Dioxus 界面，两者读取同一份音乐库和设置。Android 版仍以 Kopuz 之名在 Google Play 提供，Linux 用户也可从 Flathub 安装。

通过 Cargo 安装：

cargo install --locked kopuz

Nix 用户可直接运行：

nix run github:temidaradev/kopuz

注意事项

• Spotify 后端需要 Premium 订阅，并进行一次性应用配置。
• SoundCloud 需要在隔离配置文件中完成一次浏览器登录。
• 下载并转换为 MP3、FLAC 或 WAV 需要安装 ffmpeg；选择 Best Audio 则保留原始流。
• Linux 上使用托盘功能需要 appindicator 库。
• 项目以 EUPL-1.2 许可证开源。

本作品整理自 GitHub 开源项目 Kopuz-org/kopuz，原作者 @Kopuz-org，许可证 EUPL-1.2。中文介绍由 AI 根据项目 README 整理，以原仓库为准。