选择版本
找到你的系统，下载对应的版本。
♪快速开始开始使用
开始使用
KA Music。
先下载并安装 KA Music，再选择你想听的音乐。可以登录酷狗账号听在线歌曲，也可以直接导入电脑里存好的歌。
完成安装
打开安装包，或解压便携版后运行。
♪添加音乐
登录酷狗账号、导入本地歌曲，或连接 Jellyfin。
♪01
下载与安装先选对下载版本
大多数 Intel 或 AMD 电脑选择 x64，采用 ARM 芯片的设备选择 ARM64。不确定时，可先在系统信息中查看“系统类型”或“芯片”。
Windows
推荐使用 .exe 安装版。也可以选择便携 .zip，解压后直接运行。
Linux
下载 .AppImage，赋予执行权限后即可启动。首次运行可选择集成到应用菜单。
chmod +x KugouAvaloniaPlayer-*.AppImagemacOS
优先使用 .pkg，也可下载 .app.zip。当前安装包未签名，系统拦截时请参考下载页说明。
02
首次启动打开后，先选想听的音乐
使用在线曲库
听在线歌曲需要先登录酷狗账号。使用手机号验证码或扫码登录后，就能查看自己的歌单和账号信息。付费歌曲仍需账号拥有相应权限。
只听本地音乐
本地歌曲不用登录就能听。进入“本地音乐库”，导入存放歌曲的文件夹，等歌曲出现在列表里就可以播放。
03
添加音乐把收藏的音乐加进来
自己的 Jellyfin 音乐库可以连接到 KA Music，播放时需要保持服务器可访问。网易云音乐和 QQ 音乐的歌单也能导入，能否找到对应歌曲取决于曲库中的匹配结果。
- 本地音频：MP3、FLAC、WAV、OGG、M4A、AAC、WEBM、DSF、DFF
- 本地歌词：KRC、LRC、VTT、QRC
- 本地歌曲支持封面、歌词与歌手匹配
- 文件夹里新增歌曲后，可以刷新已导入的文件夹
04
播放与桌面设置按你的习惯设置播放器
系统托盘桌面歌词全局快捷键播放队列10 段均衡器切换音质智能过渡关闭行为设置
想让关窗后继续播放，就在设置中选择“最小化到托盘”；想直接结束播放，则选择“退出程序”。桌面歌词可以置顶显示，也支持透明和鼠标穿透。部分 Linux 桌面环境存在限制，详见常见问题。
05
更新版本在应用里检查更新
使用正式安装包安装后，可以在应用内检查更新。便携版和 ZIP 需要手动更新：到 GitHub 版本发布页下载新版，再替换旧版程序。