性能强大
在QML框架方面尽可能做到简洁,前端渲染性能快;后端基于C++引擎,效率超高
QueMusic 是一款用 C++20 + Qt 6 + QML 从零写起的跨平台桌面音乐播放器。 它没有走「Electron / Web 内核套壳」的常见路线,而是把音频、渲染、界面三条链路都做成了原生实现。
QueMusic 从第一行代码到现在,已经走了 10 个月。没有现成的轮子可以直接套, 绝大多数代码都是一个人手写出来的 —— 音频链路、GPU 着色器、插件运行时, 一行一行刻出来,再一遍一遍打磨。
QueMusic 的定位很明确:一个愿意长期做下去的桌面音乐播放器。 本地曲库、WebDAV、多平台在线音乐、逐字歌词与桌面歌词、均衡器与音效、歌单收藏与下载管理, 这些「播放器该有的东西」都是内置实现的,而不是靠插件东拼西凑。
架构上分三层:C++ 核心负责解码、DSP、标签解析、目录扫描与网络; QML 界面只负责呈现与交互;Qt RHI 把绘制直接交给平台 GPU 后端。 三条链路各自独立,界面再忙也不会拖累声音。
| 项目 | 内容 |
|---|---|
| 框架 | Qt 6.10 · Qt Quick · Qt RHI |
| 语言 | C++20 / QML / JavaScript |
| 渲染 | D3D11 / Metal / Vulkan / OpenGL(由 RHI 自动选择) |
| 音频 | FFmpeg 解码 + 自研 DSP 全链路 |
| 平台 | Windows 10+ · macOS 11+ · 主流 Linux 发行版 |
| 许可 | Apache-2.0,永久免费开源,无任何付费内容 |
| 版本 | v0.7.1-Beta(Beta 阶段,功能持续补齐) |
网易云(QCloudMusicApi)、酷狗、哔哩哔哩统一接入:搜索、私人漫游、分类歌单、排行榜、歌手页、音质选择,操作方式完全一致。
本地文件夹多选扫描、排序、加入播放列表;WebDAV 服务器带鉴权直连播放,听过的曲目自动缓存,离线也能播。
逐字卡拉 OK、对唱歌词、桌面歌词、四套歌词主题(默认 / 极简 / 自由 / 3D),歌词界面还能整体换成插件。
10 段参数均衡器、0.25×–4× 变速保持音调、±12 半音移调、声道处理、ReplayGain 响度归一与限幅。
| 维度 | QueMusic | Web 内核套壳 |
|---|---|---|
| 运行时 | C++ 原生进程,无浏览器内核 | 内嵌 Chromium,常驻数百 MB |
| 音频链路 | 自研引擎,音频线程内逐样本处理 | 受限于 <audio> 与 JS 调度 |
| 渲染 | Scene Graph 批处理 + GPU 着色器 | DOM + CSS 合成,层数多 |
| 低配表现 | 核显 1080P 稳定 60 FPS | 滚动、切页易掉帧 |
| 包体 | 100-200MB左右 | 300MB+或依赖系统WebView |
四个理由,说白了就是「能长期用、敢放心用」。每一条都可以自己去验证。
在QML框架方面尽可能做到简洁,前端渲染性能快;后端基于C++引擎,效率超高
QueMusic Project是长线项目,将会持续更新,持续完善,持续进行维护,更新可靠。
QueMusic是永久开源免费的软件,其代码均可到GitHub或Gitee查看,代码基于QtQuick框架稳定开发,保障可靠安全性,并且没有任何病毒、后门与隐私查看器,值得可靠
BroNekoX拥有多年编程经验,对QtWidgets、QtQuick等框架基本熟练掌握,技术值得信赖,用技术一点点刻出更完美的QueMusic软件
| 承诺 | 做法 |
|---|---|
| 版本可追溯 | 每次发布都写 CHANGELOG,分类记录新增 / 重构 / 优化 / 修复 |
| 方向可预期 | 功能优先级公开讨论,插件体系承接长尾需求,避免主程序膨胀 |
| 不锁死平台 | Windows / macOS / Linux 同步发布,Linux 适配 Wayland 与中文输入法 |
| 不做「最终版」 | Beta 阶段持续修复已知问题,不靠换皮发新版本 |
代码、提交记录、更新日志、第三方许可证声明全部公开。你可以直接翻到任意一次修复, 看它究竟改在哪一行 —— 这比任何「我很靠谱」的说辞都更有说服力。
QueMusic基于QtQuick框架打造,在具有顶级性能的QtRHI渲染下具有非常高的UI渲染性能,后端更是使用顶级性能的C++,经过多线程极致优化,性能几乎遥遥领先。
界面线程只做两件事:处理输入、提交绘制。所有耗时操作都在 C++ 工作线程里完成。
qmlcachegen 编译,减少运行时解析| 场景 | CPU | GPU | 帧率 |
|---|---|---|---|
| 1080P 沉浸歌词界面 | ≈4% | ≈15% | 60 FPS |
| 常规列表浏览 | ≈2% | ≈8% | 60 FPS |
| 后台播放(窗口隐藏) | <1% | ≈0% | — |
测试环境:i5-12400 + UHD 730 核显,Windows 11,缓冲区 40 ms。
音频引擎自己握着整条链路,不依赖系统播放器:解码线程 → 无锁环形缓冲 → 音频回调线程, DSP 全在音频线程内逐样本完成喵。
文件 / 网络流 ↓ FFmpeg(libavformat / libavcodec) 解码线程 → 重采样到设备格式 ↓ 无锁环形缓冲(SPSC) 音频回调线程(QAudioSink 拉模式 + 自定义 QIODevice) ↓ DSP 链:声道 → EQ → 变速/变调 → 响度 → 限幅 → 淡变 ↓ 声卡输出 ↘ 频谱采样 → 界面可视化
QAudioSink 拉模式,自定义 QIODevice 从环形缓冲取数据| 模块 | 能力 | 参数范围 |
|---|---|---|
| 均衡器 | 10 段参数 EQ,10 组预设,前置增益与自动余量 | ±24 dB,Q 可调 |
| 变速 | 保持音调的时间伸缩 | 0.25× – 4× |
| 变调 | 独立半音移调,可与变速叠加 | ±12 半音 |
| 声道 | 平衡、单声道折叠、立体声宽度、声道互换、左右独立增益 | 0 – 200% |
| 响度 | ReplayGain 归一 + 峰值限幅,防削波 | 自动 |
| 淡变 | 切歌 / 暂停淡入淡出,逐样本计算 | 0 – 1 s |
SqueUI Next是新一代QtQuick组件库,具有美丽丝滑的效果,其渲染性能非常好, QueMusic基于SqueUI深度优化,渲染性能高效。 注意:SqueUI是QueMusic主要开发者开发,目前还处于预览阶段(github.com/bronekox/squeui)
Style 单例集中管理颜色、圆角、间距、字号,界面里没有硬编码色值| 效果 | 实现方式 |
|---|---|
| 毛玻璃卡片 | 单 pass:取样 → 模糊 → 提饱和 → 圆角裁剪 |
| 歌词渐进模糊 | 按距中心距离调整模糊强度,随滚动实时更新 |
| 流体背景 | GPU 噪声 + 封面取色,替代旧版着色器实现 |
| 3D 点云舞台 | 点云几何 + 真透视歌词平面,相机由鼠标驱动 |
x/y → anchors → Row/Column → Layouts界面里能换的、能加的,都是插件。一个文件夹就是一个插件,放进插件目录即被扫描到, 不用编译、不用改主程序喵。
换掉沉浸播放页的整套歌词界面。宿主注入播放进度、歌词数据与配色,插件只负责呈现;同时只用一个,播放页随时切换。
往界面里加东西:标题栏、底栏、侧栏、整窗覆盖层都是开放扩展点;插件用 api.mount() 挂按钮、api.loader() 挂面板。
lyrics/example/ 歌词界面插件 info.json 插件信息(必要) example.qml 入口 QML(必要,文件名在 info.json 指定) info.png 预览图(建议) shaders/wave.frag.qsb 自定义着色器(可选,需预编译) Tools/example/ 功能插件(约定相同)
{
"apiVersion": 1,
"name": "波浪示例",
"author": "QueMusic",
"version": "1.0.0",
"description": "着色器波浪背景 + 逐字高亮 + 双语翻译",
"entry": "example.qml",
"preview": "info.png"
}
入口根类型为 Item,声明同名属性即由宿主自动绑定;没写的会被跳过。
| 属性 | 含义 |
|---|---|
position | 当前播放位置(毫秒) |
playing / mediaActive | 是否正在播放 / 是否有媒体 |
lyricsModel | 歌词行列表(time / text / info / isOther) |
translateModel | 翻译行列表,与歌词行同下标对应 |
currentIndex | 当前行下标 |
title / artist / coverUrl | 歌曲信息 |
mainColor 等 | 封面取色得到的主色 / 次色 / 第三色 |
timerFunction() | 可选,宿主约每 320 ms 调用一次 |
styleOptions | 可选,在「播放器样式」弹窗中追加自定义项 |
import QtQuick
import QueMusic 1.0
QtObject {
property QtObject api // 宿主注入
function activate() {
api.mount("player.right", btnComp) // 挂按钮
api.loader(api.pluginUrl + "panel.qml", { width: 240 }) // 挂面板
api.toast("插件已就绪") // 提示
}
property Component btnComp: Component { }
}
| 扩展点 | 位置 |
|---|---|
titlebar.left / titlebar.right | 标题栏左右 |
player.left / player.right | 播放控制栏左右 |
sidebar.bottom | 左侧导航栏底部 |
window.overlay | 整窗覆盖层 |
.qsb,否则效果会静默失效QueMusic Project 作为长线开源项目,未来会持续迭代与开发,并做出更多的成就
高性能 QtQuick 组件库,把 QueMusic 里打磨出来的组件沉淀下来,拥有高度的自定义功能和流畅的性能
面向全球发布的 QueMusic,让更多地区和语言的用户也能用上它,使用全球的音乐平台API
基于 Qt 框架开发、用来代替 QML 的新式 GPU 渲染框架。