mirror of
https://github.com/lqtmcstudio/QZMusic_PC.git
synced 2026-08-18 13:20:47 +08:00
85 lines
2.9 KiB
Markdown
85 lines
2.9 KiB
Markdown
# QZ Music for Windows
|
||
|
||
一款简洁美观的跨平台音乐播放器，提供优雅的桌面音乐体验
|
||
安卓版本请访问：[官方网站](https://music.qz.shiqianjiang.cn)
|
||
|
||
## 🛠 技术架构
|
||
|
||
| 技术 | 说明 |
|
||
|----------------|---------------|
|
||
| **Electron** | 跨平台桌面应用框架 |
|
||
| **Vue 3** | 响应式前端框架 |
|
||
| **TypeScript** | 类型安全的开发体验 |
|
||
| **Pinia** | 轻量级状态管理 |
|
||
| **Vite** | 现代化的前端构建工具 |
|
||
| **QZ Plugins** | 高拓展性的插件运行环境 |
|
||
| **AMLL** | 背景渲染 |
|
||
| **QZPlayer** | 基于WASAPI和FFmpeg的轻量级模块化音频播放器,使用C编写,IPC与主程序通信 |
|
||
|
||
## 🐧 Linux (amd64) 支持
|
||
|
||
```bash
|
||
# 安装 TagLib 开发库 (用于编译本地音乐标签扫描器)
|
||
# Debian / Ubuntu
|
||
sudo apt install -y libtag1-dev
|
||
# Fedora
|
||
sudo dnf install -y taglib-devel
|
||
# Arch Linux
|
||
sudo pacman -S --needed taglib
|
||
|
||
# 编译本地音乐标签扫描器
|
||
bash native/taglib_reader/build.sh
|
||
|
||
# 确保播放核心二进制有可执行位 (Windows 下提交的二进制会丢失该位)
|
||
chmod +x core/qzplayer native/taglib_reader/build/taglib_reader_cli
|
||
|
||
# 安装依赖并打包
|
||
bun install
|
||
bun run electron:build:linux
|
||
# 产物: release/*.AppImage 与 release/*.deb
|
||
```
|
||
|
||
### 运行时依赖
|
||
|
||
安装/运行 Linux 版时需要以下系统库（`libfftw3f.so.3` 已随安装包内置，无需手动安装）：
|
||
|
||
| 依赖 | Debian / Ubuntu | 说明 |
|
||
|------|----------------|------|
|
||
| ALSA | `libasound2` | 音频输出（必需） |
|
||
| TagLib | `libtag1` | 本地音乐标签扫描（不使用本地音乐可不装） |
|
||
| zlib | `zlib1g` | 通常已预装 |
|
||
| FFTW（单精度） | `libfftw3-3` | 已内置，无需安装 |
|
||
|
||
```bash
|
||
# Debian / Ubuntu
|
||
sudo apt install -y libasound2 libtag1
|
||
|
||
# Fedora
|
||
sudo dnf install -y alsa-lib taglib
|
||
|
||
# Arch Linux
|
||
sudo pacman -S --needed alsa-lib taglib
|
||
```
|
||
|
||
## 📖 项目说明
|
||
|
||
本项目为 **Vue + Electron** 的学习实践作品，旨在完善QZ Music的多平台生态。
|
||
|
||
> ⚠️ 注意：
|
||
> - QZPlugin 仅提供插件运行框架，不包含任何默认音乐插件
|
||
> - AMLL 提供功能接口，不关联具体音乐数据源
|
||
|
||
## 🛠 开发者(排名不分先后)
|
||
- (以下内容实时更新,更新日期:2026.1.21)
|
||
- -蜻蜓T-T ([B站](https://space.bilibili.com/3546554124209112) [Github](https://github.com/lqtmcstudio)) | 插件系统 音频系统 UI设计/开发 后端
|
||
- 时迁酱 ([个人主页](https://shiqianjiang.cn)) 登录/鉴权系统
|
||
|
||
## 📄 开源协议
|
||
|
||
本项目采用 [**AGPL v3**](https://github.com/lqtmcstudio/QZMusic_PC/blob/master/LICENSE) 开源协议。
|
||
|
||
## 使用工具
|
||
|
||
[**WebStorm**](https://www.jetbrains.com/webstorm/): Make development more productive and enjoyable.
|
||
[**Antigravity**](https://antigravity.google/): Experience liftoff with the next-generation IDE
|