Aura Music Desktop

Aura Music Desktop 是基于 Aura Music 构建的 Windows 桌面发行版。项目使用 Tauri 2 封装完整播放器，并提供透明、置顶、可缩放的桌面歌词窗口。

当前桌面端版本：1.9.4。

功能

• 完整的 Aura Music 播放、搜索、本地导入、播放队列和歌词功能
• 与应用融为一体的自绘顶部栏，以及自适应紧凑窗口布局
• Windows 系统托盘、关闭后驻留和快捷恢复
• 透明桌面歌词、逐词进度、翻译/音译和主题色同步
• 桌面歌词拖动、八方向缩放、滚轮调字号和播放控制
• 鼠标穿透模式；可通过托盘菜单或 Ctrl + Alt + L 解除
• 高分辨率应用、任务栏、托盘、安装程序和快捷方式图标
• 窗口位置和尺寸记忆，同时避免恢复 Windows 原生标题栏

环境要求

• Windows 10/11 x64
• Node.js 18 或更高版本
• Rust stable（MSVC 工具链）
• Microsoft Edge WebView2 Runtime

本地开发

安装依赖：

npm install

启动桌面应用：

npm run desktop:dev

仅启动浏览器版本：

npm run dev

构建

npm run desktop:build

安装包生成在：

desktop-lyrics/src-tauri/target/release/bundle/

Tauri 应用版本在 desktop-lyrics/package.json、desktop-lyrics/src-tauri/Cargo.toml 和 desktop-lyrics/src-tauri/tauri.conf.json 中保持同步。

检查

npx tsc --noEmit
node --check public/lyrics.js
npx --yes bun test tests
cargo fmt --manifest-path desktop-lyrics/src-tauri/Cargo.toml --check
cargo check --manifest-path desktop-lyrics/src-tauri/Cargo.toml
npm run build -- --base ./

项目结构

desktop-lyrics/       Tauri 2 桌面壳、托盘、窗口和打包配置
public/lyrics.*       正式桌面歌词页面、样式和交互逻辑
hooks/useLyricOverlay.ts
                      播放器与桌面歌词之间的状态同步
lyric-overlay-server/ 浏览器开发模式的兼容 WebSocket 服务
components/           Aura Music React 界面组件
services/             媒体、歌词、缓存和播放状态服务
tests/                Bun 自动化测试

许可证与上游

本仓库保留上游 Aura Music 的许可证与版权声明。桌面端封装、Windows 集成和透明桌面歌词实现作为本 fork 的扩展维护。