KA Music

下载体验 · 问题反馈 · 查看截图 · 交流群

最好用、最轻量的酷狗音乐概念版播放器。

项目基于 .NET 10 + Avalonia 打造，尽量提供一致的全平台桌面体验，而不是浏览器套壳式客户端。因为作者长期使用 Arch Linux 和 Windows 双系统，而 Linux 上又缺少一款体验完整的酷狗音乐播放器，这个项目就这样诞生了。

注：“最好用、最轻量”是项目目标与设计方向。

• 下载地址：Releases
• 问题反馈：Issues
• 桌面客户端：KugouAvaloniaPlayer
• 终端播放器：KgTest
• 开发者入口：KuGou.Net / KgWebApi.Net / SimpleAudio / AvaloniaLyrics
• 安卓版正在开发中，项目地址

• 更轻：基于 Avalonia 原生桌面栈，不走 Electron 路线，安装包体积小
• 更像桌面播放器：托盘、桌面歌词、关闭行为、自动更新这些桌面交互是完整的
• 对 Linux 更友好，在Linux也能拥有和其他平台一样的托盘和歌词悬浮窗体验
• 酷狗生态能力完整：登录、推荐、榜单、歌单、搜索、歌词、VIP 状态都已接入
• 私有媒体库也能接入：支持导入 Jellyfin 音乐媒体库，按专辑生成本地歌单
• 搬家无压力：支持解析并导入网易云音乐、QQ 音乐歌单，轻松迁移歌单
• 播放控制更到位：播放队列、随机模式、热切音质、10 段均衡器都可用
• 智能过渡：在PC端也能体验到丝滑的智能过渡效果（点名批评网易云PC版甚至没这功能）

每日推荐、私人FM。

Apple Music风味的滚动歌词，支持在线歌词和本地歌词，歌词浮窗全平台体验一致。

请前往 Releases 下载最新版本。

• Windows x64：KugouAvaloniaPlayer-win-x64.exe
• Linux x64：KugouAvaloniaPlayer-linux-x64.AppImage
• Linux arm64（手动更新包）：KugouAvaloniaPlayer-linux-arm64.tar.gz
• macOS arm64 安装包：KugouAvaloniaPlayer-mac-arm64-Setup.pkg
• macOS arm64（手动更新包）：KugouAvaloniaPlayer-mac-arm64.app.zip
• macOS x64（手动更新包）：KugouAvaloniaPlayer-mac-x64.app.zip

项目通过 Velopack + GitHub Releases 提供更新能力。

• 支持自动更新的架构：
  • Windows x64（KugouAvaloniaPlayer-win-x64.exe）
  • Linux x64（KugouAvaloniaPlayer-linux-x64.AppImage）
  • macOS arm64（KugouAvaloniaPlayer-mac-arm64-Setup.pkg）
• 不支持自动更新的架构（仅手动更新）：
  • Linux arm64（KugouAvaloniaPlayer-linux-arm64.tar.gz）
  • macOS x64（KugouAvaloniaPlayer-mac-x64.app.zip）
• 手动更新方式：
  • 下载对应架构的新压缩包
  • 解压后覆盖旧程序目录，或迁移到新目录运行
  • 手动更新不会自动提示，请定期关注 Releases

当前 macOS 安装包未签名，如遇到 Gatekeeper 拦截，可执行：

xattr -dr com.apple.quarantine /Applications/KugouAvaloniaPlayer.app

如果 KugouAvaloniaPlayer-mac-arm64-Setup.pkg 无法安装，可以改用 KugouAvaloniaPlayer-mac-arm64.app.zip 解压运行；KugouAvaloniaPlayer-mac-x64.app.zip 本身就是手动更新包，不支持自动更新。

• 手机号验证码登录
• 二维码扫码登录
• 登录持久化与自动恢复
• 每日推荐
• 发现歌单与推荐内容
• 排行榜与榜单歌曲分页
• 歌手详情页
• 搜索歌曲、歌单、专辑
• 用户信息与 VIP 状态展示

• 本地音乐库首页，集中管理本地歌单、导入文件夹和 Jellyfin 媒体库
• 新建、编辑、删除本地歌单
• 向本地歌单追加本地歌曲文件
• 可导入本地音乐文件夹，上千首歌曲也能快速导入
• 支持刷新已导入的本地文件夹和 Jellyfin 媒体库
• 支持为本地歌单和本地歌曲设置封面
• 支持从 Jellyfin 导入音乐媒体库，按专辑同步为多个本地歌单
• Jellyfin 连接信息会本地保存，后续可直接刷新已导入媒体库
• 未登录可播放本地歌曲
• 支持 MP3、FLAC、WAV、OGG、M4A、AAC、WEBM、DSF、DFF 等音频格式
• 支持本地 KRC / LRC / VTT 歌词

• 桌面歌词浮窗
• 歌词逐字高亮与进度动画
• 系统托盘菜单
• 关闭行为可配置：退出程序 / 最小化到托盘
• 自动更新

• 在线歌曲播放
• 播放队列管理
• 下一首播放 / 随机模式
• 热切播放音质
• 10 段均衡器，支持预设与自定义
• 收藏当前歌曲、在线歌单增删改

• Windows、Linux、macOS 三端可运行
• Linux 提供 AppImage
• 桌面歌词鼠标穿透支持跨平台实现

很多音乐播放器对于Linux的支持很差，无法拥有和其他平台一样的体验。KA Music 的目标不是停留在能运行，而是尽量把 Linux 桌面用户真正会在意的体验补齐，托盘、桌面歌词、本地播放、基础设置和日常交互都要可用，歌词悬浮窗能像Windows平台一样鼠标穿透、置顶、透明。

自动更新依赖 Velopack 安装。若你通过 dotnet run 或手动复制文件运行，应用会跳过自动更新检查。请使用 Releases 安装包安装。

当前在线播放要求有效登录态。你可以先登录，也可以直接播放本地导入的歌曲。

这是为了兼容历史版本升级链路。应用显示名可以继续优化，但安装包标识保持稳定，能避免老版本升级断链。

当前支持在线 KRC，以及本地 KRC、LRC、VTT 歌词。

当前支持导入本地音乐文件夹、手动创建本地歌单并添加歌曲，也支持通过服务器地址、UserId 和 API Key 导入 Jellyfin 音乐媒体库。Jellyfin 会按专辑同步为本地歌单，之后可以在本地音乐库里刷新。

完整版本历史请查看 Releases。

• 支持倍速播放歌曲
• 支持Windows任务栏缩略图工具栏
• 修复验证码登录无法点击
• 优化添加歌曲进入歌单时选择歌单的加载
• 启用AOT发布，减少启动时间

• 优化大规模本地歌曲导入
• 优化本地歌曲图片加载

• 修复自定义均衡器出错导致启动失败
• 添加轻量级歌词滚动动画选项
• 添加主窗口状态保存与恢复功能
• 播放页添加全屏功能

这个仓库不只有播放器本体，也包含围绕酷狗能力做的几个底层项目。

• src/Apps/KugouAvaloniaPlayer：Avalonia 桌面客户端，也就是现在的 KA Music
• src/Apps/KgTest：终端 TUI 播放器
• src/Libraries/KuGou.Net：酷狗业务 SDK，封装登录、搜索、歌单、歌词、榜单、用户等能力
• src/Apps/KgWebApi.Net：基于 SDK 的 ASP.NET Core Web API 封装
• src/Libraries/SimpleAudio：基于 ManagedBass 的跨平台播放与音效层
• src/Libraries/AvaloniaLyrics：歌词控件库
• src/Native/KuGou.Net.Native：把 SDK 能力导出为 Native AOT 友好的 C ABI

KgTest 一个测试用的终端播放器，功能还算凑合，目前也把智能过渡功能加上了，想试试的可以克隆仓库运行。详细功能、快捷键和配置说明见 src/Apps/KgTest/README.md。

git clone https://github.com/Linsxyx/KugouMusic.NET.git
cd KugouMusic.NET

dotnet restore KugouMusic.NET.slnx
dotnet build KugouMusic.NET.slnx

dotnet run --project src/Apps/KugouAvaloniaPlayer/KugouAvaloniaPlayer.csproj

如需运行终端播放器：

dotnet run --project src/Apps/KgTest/KgTest.csproj

如需运行 Web API：

dotnet run --project src/Apps/KgWebApi.Net/KgWebApi.Net.csproj

Web API 文档（开发环境）：http://localhost:5058/scalar/v1

KugouMusic.NET
├─ src
│  ├─ Apps
│  │  ├─ KugouAvaloniaPlayer   # Avalonia 桌面客户端
│  │  ├─ KgTest                # 终端 TUI 播放器
│  │  └─ KgWebApi.Net          # ASP.NET Core Web API
│  ├─ Libraries
│  │  ├─ KuGou.Net             # 核心 SDK
│  │  ├─ SimpleAudio           # 音频播放与音效层
│  │  └─ AvaloniaLyrics        # Avalonia 歌词控件
│  └─ Native
│     └─ KuGou.Net.Native      # Native AOT 导出层
└─ docs/images           # README 截图资源

• QQ群：1081635731

• KuGouMusicApi

本项目是基于公开 API 接口开发的第三方音乐客户端，仅供个人学习和技术研究使用。

• 数据来源：所有音乐数据通过公开接口获取，本项目不存储、不传播任何音频文件
• 版权声明：音乐内容版权归原平台及版权方所有，请尊重知识产权，支持正版音乐
• 使用限制：禁止将本项目用于任何商业用途或违法行为
• 责任声明：因使用本项目产生的任何法律纠纷或损失，均由使用者自行承担
• 争议处理：如果官方音乐平台觉得本项目不妥，请通过 Issues 联系