基于 C++/Qt/QML 构建的强大高性能跨平台音乐播放器
可能是桌面跨平台上UI最美丽丝滑，性能最强的开源音乐播放器？ 基于 Qt 6.10 / QML 与 GPU 加速 RHI 渲染的开源跨平台音乐播放器，支持接入网易云、酷狗等平台的公开音乐服务接口。 动效美丽，性能出众，开发者坚持 永久免费 & 开源。
🚧 项目正处于 开发/预览阶段，部分功能尚未完善, 仍存在部分问题，有一些功能无法使用，会持续更新，欢迎 Star & Fork 一起参与！
国内快速下载本应用及历史版本：
永久下载链接：下载 提取码：iqda
加入QQ群获取最新消息：1105114511
Warning
1.本项目仅供用户学习与研究使用，禁止将本项目用于任何非法用途。
2.本项目开发者不接受任何形式的赞助，打赏，捐赠行为，禁止任何用户向本开发者赞助，打赏，捐赠。
3.本项目的使用者出现的任何侵权、盗用、版权问题等违规情况，与本项目无关。
4.本项目并不提供公共云端曲库与媒体分发服务，在线音频获取的能力均使用第三方平台个人账号授权获取，付费内容，会员内容，受限制的内容请遵循第三方平台版权。
5.如果音乐平台发现本项目包含侵权或有问题的行为，可联系开发者进行更改或移除。
6.本项目使用了一些第三方模块，如果你认为本项目违反了部分协议，可联系开发者进行更改或移除。
特性 • 技术栈 • 安装 • 截图 • 结构 • 计划 • 贡献 • 许可证 • 免责声明
| 维度 | 亮点 |
|---|---|
| 🎶 多平台音乐 | 支持网易云、酷狗等平台公开接口接入（仅访问公开内容，详见免责声明） |
| ⚡ 性能出众 | C++ 核心模块 + QML RHI 场景渲染，内存占用低，核显 / 老旧 CPU 依然流畅 |
| 🎨 精美 UI | 高级毛玻璃圆角卡片、可自定义主题色 & 界面样式，自研 Theme / 配色系统 |
| 🔄 流畅动画 | 自定义贝塞尔曲线动画，歌词界面丝滑，QML Animation 全局稳定 60fps |
| 📦 功能丰富 | 歌词滚动 / 桌面歌词、10 段均衡器、歌单管理、搜索推荐、收藏同步 |
| 🛡️ 可靠性高 | 自制 JS API 管理层，统一错误处理，速度快且持续优化 |
| 💻 跨平台 | 全面支持 Windows / macOS / Linux 三大桌面端 |
本地歌曲按以下顺序读取歌词：同目录同名 .lrc → 音频内嵌歌词 → 在线匹配 → “纯音乐，请欣赏”占位。
内嵌歌词支持 ID3v2 的同步歌词（SYLT）与非同步歌词（USLT），以及 TagLib 能识别的
LYRICS 文本元数据（常见于 FLAC、Ogg/Opus、MP4/M4A 等格式）。
项目正处于 开发/预览阶段，下面直接放效果（演示的歌曲仅供参考）
 🏠 主界面 |
 🎤 歌词页 · 沉浸式 |
 🎶 歌词页 · 常规 |
 ⚙️ 设置页 |
| 类别 | 技术 |
|---|---|
| 框架 | Qt 6.10.3 Community |
| 构建 | CMake ≥ 3.24 / Ninja |
| 语言 | C++17 / JavaScript / QML |
| 音频 | Qt Multimedia (FFmpeg7.1.1 后端) |
| 渲染 | QtRHI — 基于平台原生GPU渲染器 |
| 数据库 | Qt SQL / SQLite |
| 工具链 | MSVC 2022 / GCC 13+ / MinGW 13+ / LLVM-MinGW 17+ |
- Qt 6.10+（含 Qt Multimedia, Qt SQL, Qt ShaderTools等基础Qt库）
- CMake ≥ 3.24
- 编译器：GCC 13+ / MinGW 13+ / LLVM-MinGW 17+ / Clang
- （可选）Ninja 构建系统（推荐，已内置在预设中）
git clone --recurse-submodules https://github.com/BroNekoX/QueMusic.git
cd QueMusic
⚠️ 重要：本项目使用 QWindowKit、TagLib 作为 git 子模块，务必加上--recurse-submodules。 如果已经 clone 但忘记拉子模块，运行：git submodule update --init --recursive
本项目内置CmakePresets.json,支持快速构建：
! 该操作需提前安装just ! 然后执行：
just b #构建
just r #运行# 配置（自动选择预设）
cmake --preset <preset-name>
# 编译
cmake --build build/<preset-name> -j 8
# 运行
./build/<preset-name>/bin/QueMusic # Linux/macOS
./build/<preset-name>/bin/QueMusic.exe # Windows预设如下：
| 平台 | 预设名 | 编译器 |
|---|---|---|
| Windows | win-llvm-mingw-release | LLVM-MinGW（Qt 6.10 的 llvm-mingw_64 套件） |
| Windows | win-mingw-release | MinGW（Qt 的 mingw_64 套件） |
| Linux | linux-gcc-release | GCC |
| MacOS | mac-clang-release | Clang |
💡 如果 CMake 找不到 Qt，请先设置环境变量
CMAKE_PREFIX_PATH指向你的 Qt 安装目录（例如~/Qt/6.10.3/llvm-mingw_64或~/Qt/6.10.3/gcc_64）。
# LLVM-MinGW（Qt 6.10 推荐）
cmake -B build -G Ninja \
-DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ \
-DCMAKE_PREFIX_PATH=/path/to/Qt/6.10.3/llvm-mingw_64
cmake --build build --parallel
./build/bin/QueMusic
# MinGW
cmake -B build -G Ninja \
-DCMAKE_PREFIX_PATH=/path/to/Qt/6.10.3/mingw_64cmake -B build -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH=~/Qt/6.10.3/gcc_64
cmake --build build -j"$(nproc)"
./build/bin/QueMusiccmake -B build -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH=~/Qt/6.10.3/clang_64 \
-DCMAKE_OSX_DEPLOYMENT_TARGET=11.0
cmake --build build -j 8
./build/bin/QueMusic.app/Contents/MacOS/QueMusic📦 三种平台的可执行安装包都会随 Release 发布。
- Windows：使用Windeployqt + Inno Setup(可选)进行分步打包。
- Linux：运行
bash packaging/build-linux.sh生成 AppImage。 - MacOS：运行
just mac-bundle生成.dmg（需安装macdeployqt）。
QueMusic/
├── CMakeLists.txt # 顶层构建配置
├── cmake/ # CMake 模块
│ ├── external/qwindowkit.cmake # QWindowKit 子模块集成
│ └── qtruntime.cmake
├── main.cpp # C++ 程序入口
├── main.qml # QML 主入口
├── cpp/ # C++ 后端模块
│ ├── CoverHelper.cpp/h # 封面图片处理
│ ├── ColorExtractor.cpp/h # 颜色提取（自适应主题色）
│ ├── GetWave.cpp/h # 音频波形数据
│ ├── FolderModel.cpp/h # 本地文件夹模型
│ ├── DownloadManager.cpp/h # 下载管理器
│ ├── LocalLyricsReader.cpp/h # .lrc 与音频内嵌歌词读取
│ └── Favorites.cpp/h # 收藏管理
├── meshgradient/ # 🧩 独立 Mesh Gradient 背景组件（AGPL-3.0）
│ ├── CMakeLists.txt # 独立库 target：quemusic_meshgradient
│ ├── LICENSE # GNU AGPL v3.0 全文
│ ├── README.md # 组件说明 / 来源 / 修改记录
│ ├── MeshGradientItem.cpp/h # 网格渐变渲染（衍生自 AMLL）
│ └── shaders/ # meshgradient.vert/.frag（衍生自 AMLL）
├── api/ # JavaScript API 层
│ ├── QCloudMusicApi/ # 存放QCloudMusicApi第三方项目
│ ├── MusicApiService.cpp/h # 在线音乐 API总部
│ ├── KugouApi.cpp/h # 酷狗音乐 API
│ ├── NeteaseApi.cpp/h # 网易云音乐 API
│ └── OnlinelistModel.cpp/h # 在线api的列表模型自定义组件
├── components/ # QML 组件库（自研 UI 库）
│ ├── Q***.qml # 各自控件，QueMusic由它们组成
│ ├── MusicApi.qml # 在线音乐整合单例
│ ├── Style.qml # 全局单例样式
│ ├── Options.qml # 设置文件
│ └── ...
├── layout/ # 页面布局
│ ├── LeftSideBar.qml # 左侧导航栏
│ ├── MainContent.qml # 主内容区
│ ├── PlayerControl.qml # 播放控制栏
│ └── PlayerMaxCenter.qml # 全屏 / 最大化歌词中心
├── pages/ # 页面
│ ├── HomePage.qml # 首页 / 推荐
│ ├── SearchPage.qml # 搜索
│ ├── PlaylistPage.qml # 歌单详情
│ ├── FavouritePage.qml # 收藏
│ ├── FilePage.qml # 本地文件
│ └── DownloadPage.qml # 下载管理
├── resources/ # 资源文件
│ ├── app/ # 应用图标、图片
│ ├── fonts/ # 字体（Poppins, Feather Icons）
│ ├── window-bar/ # 窗口按钮图标
│ ├── pic/ # 背景图片
│ └── app/shaders/ # GLSL 着色器
├── ThirdParty/
│ └── qwindowkit/ # Git Submodule — 无边框窗口框架
├── .gitignore
├── .gitattributes
├── .gitmodules
├── LICENSE # Apache License 2.0
└── README.md
- 首要-功能完善：补全设置、编辑、歌单管理等功能，增强稳定性
- 品牌统一性: 在名称以及宣传上计划使用一个新的名称或定义，统一形象
- 推动发展: 后面计划推出QueMusic网站，建立QQ群，与社区共建生态
- 优化性能：持续优化内存 & GPU 占用，解决性能瓶颈
- 加入沉浸播放：参考 Folia / MineRadio 概念，引入 3D 可视化与高度自定义歌词
- UI 强化：继续打磨自研 QML 组件库，统一设计语言
- 国际化：可选计划，由于使用国内音乐平台，不一定更新
- 更多：自定义插件系统,自定义主题UI插件系统
即使不断更新，QueMusic开发者始终保持开源，免费，没有付费内容，保持完全的免费，但是对于歌曲版权方面，请自费购买平台VIP或付费歌曲，登录平台账号进行收听（即将更新）。
欢迎任何形式的贡献！
| 方式 | 说明 |
|---|---|
| 🐛 报告 Bug | 提交 Issue，附上复现步骤和环境 |
| 💡 提出新功能 | 在 Discussion 中发起讨论 |
| ⭐ Star | 点亮 GitHub Star，支持持续开发 |
| 🧪 测试 | 构建并试用，反馈兼容性问题 |
| 🔧 Pull Request | 修复 Bug、优化代码、完善功能 —— 欢迎任何人 |
| 📖 利用 | 基于Apache-2.0 协议，开发者欢迎任何项目使用本项目的代码 |
- Fork 本仓库
- 创建功能分支：
git checkout -b feat/your-feature - 提交修改：
git commit -m "feat: add xxx" - 推送：
git push origin feat/your-feature - 发起 Pull Request
代码风格请参考现有文件，遵循 C++17 / Qt6 / QML best practices。
本项目主体遵循 Apache License 2.0 —— 欢迎自由使用、修改、分发，甚至商用（需保留版权声明与许可证副本）。
Apache License
Version 2.0, January 2004
Copyright (c) 2025-2026 QueMusic Contributors
💡 Apache-2.0 要点：允许商用、修改、分发；需在衍生作品中保留原始版权声明与 NOTICE；对专利授权有明确条款，为用户提供额外保护。
本项目中的 meshgradient/ 独立组件（动态流体渐变背景）衍生自
AMLL Core(Apple Music Like Lyrics)，
以 GNU Affero General Public License v3.0 单独授权：
- 该组件作为独立库（
quemusic_meshgradient）编译，与主体保持"聚合"关系； - 组件许可证不影响 QueMusic 其余 Apache-2.0 代码；
- 来源文件、修改内容详见
meshgradient/README.md； - 全部第三方组件声明见
THIRD_PARTY_NOTICES.md。
本项目中的所有音乐内容（歌曲、歌词、封面等）版权均归其原始权利人所有。本项目不提供、不存储、不缓存任何音乐文件，所有播放内容均来自用户自行选择的第三方公开网络服务。
- 本项目仅调用各音乐平台对外公开的接口，不包含任何破解、绕过付费、解锁 VIP、盗取音源等行为；
- 不提供任何付费内容的非法获取途径，也无法播放需要单独授权的加密内容；
- 各平台接口可能随时调整或失效，本项目不对接口的可用性与稳定性作任何保证。
本项目中出现的所有商标、产品名称、服务名称均为其各自所有者的财产，仅用于描述兼容性，不代表任何官方授权、认可或关联。
使用者应遵守所在地法律法规以及各第三方平台的服务条款。因使用本项目而产生的任何直接或间接后果，由使用者自行承担，项目开发者不承担任何责任。
本项目按 "现状"（AS-IS） 提供，不附带任何明示或暗示的担保。详细免责条款请参阅 LICENSE 文件。
- Qt Project — 提供强大的跨平台框架
- QWindowKit — 无边框窗口解决方案
- AMLL Core(Apple Music Like Lyrics) — 背景着色器的算法（AGPL-3.0，见
meshgradient/组件） - qiuliw/Qt6_QWindowKit_QML_demo — 项目框架参考
- QCloudMusicApi — 使用了本项目api服务，以实现在线音乐网易云音乐平台部分
- Cryptopp — 用于QCloudMusicApi解析
- libqrencode — 用于QCloudMusicApi
- Taglib — 用于解析本地音乐部分数据
- SMTC-Bridge-Cpp — Windows 系统媒体控件(SMTC)桥接参考实现(C++)
- smtc_bridge_rust — Windows 系统媒体控件(SMTC)桥接参考实现(Rust)
- 以下参考了他们的部分代码实现，特此致谢。
- EvolveUI — 部分组件设计参考
- ShaderToy — 着色器灵感来源
- 所有贡献者与测试者
QueMusic 官方版本始终保持开源与永久免费，没有任何Pro、Ultra、高级版、捐献版等版本，QueMusic也没有任何付费、会员、捐献、充值、赞助内容，如果你发现你的QueMusic需要钱或者QueMusic内存在付费项目，请立即向开发者告知。
- QQ：241422517
- 邮箱：uihugd@outlook.com
- Bilibili: 695207057
Written by QueMusic Project
最后更新：2026-8-28