shubham-pathak1/orca
GitHub: shubham-pathak1/orca
Orca 是一款基于 Tauri 和 Svelte 构建的 Windows 本地音乐播放器，集音频播放、歌词同步、元数据编辑与播放列表管理于一体。
Stars: 22 | Forks: 1
# Orca
Orca 是一款适用于 Windows 的本地音乐播放器，使用 Svelte 5、Tauri 2 和 Rust 构建。
## 核心功能
- **快速扫描**：添加本地目录进行扫描，即时构建您的数据库。支持 `MP3`、`FLAC`、`M4A`、`WAV`、`OGG`、`OPUS` 和 `AIFF` / `AIF` 音频文件。
- **音频引擎**：由 `rodio` 驱动，支持淡入淡出。
- **波形进度条**：根据音轨的音频声道生成平滑的波形进度条。
- **LRC 歌词**：与 LRCLIB 同步获取歌词，支持点击歌词行进行跳转。
- **元数据编辑**：直接在应用中编辑标签（标题、艺术家、专辑、流派、封面图）。
- **播放列表**：创建和管理播放列表，包括自定义播放列表封面。
- **布局**：环境艺术色彩背景、侧边栏导航、队列管理以及可切换的布局模式。
## 截图
**音乐库**：
**专辑**：
**艺术家**：
**全屏播放器**：
**同步歌词**：
**元数据编辑器**：
## 技术栈
* **前端**：Svelte 5 (Vite)、TypeScript、Tailwind CSS、HTML5 Canvas
* **后端**：Rust、Tauri 2、SQLite (`rusqlite`)
* **音频引擎**：Rodio
* **标签库**：Lofty
## 仓库结构
```
src/ Svelte frontend codebase
src/lib/components/ UI components (Player, Waveform, Metadata, Queue)
src-tauri/ Tauri application backend and command handlers
crates/orca-core/ Core database structure, scanning engine, and audio thread logic
```
## 开始使用
### 前置条件
您需要在 Windows 计算机上安装以下工具：
1. [Rust](https://www.rust-lang.org/tools/install)
2. [Bun](https://bun.sh/)
3. [Tauri Windows 设置要求](https://v2.tauri.app/start/prerequisites/)
### 开发
克隆仓库并安装依赖：
```
bun install
```
启动带有实时重载的开发服务器：
```
bun run tauri:dev
```
要在运行开发服务器时启用 Rust 优化（发行级别的音频解码速度）：
```
bun run tauri dev --release
```
## 构建发行版
Orca 使用 **NSIS** 为 Windows 打包一个轻量级的可执行安装程序。构建 MSI 安装程序的功能已被禁用，以简化打包流程。
要构建 NSIS 安装程序：
```
bun run tauri:build
```
输出的 `.exe` 安装程序将位于 `src-tauri/target/release/bundle/nsis/`。
## 贡献与支持
感谢您关注 Orca！如果您想帮助改进这款播放器：
* 欢迎通过发起 GitHub Issue 来报告 Bug 或提出功能建议。
* 随时欢迎提交 Pull request！
## 许可证
MIT 许可证。有关更多详细信息，请参阅 [LICENSE](LICENSE)。
标签：Rust, SBOM分析, SQLite, Svelte, Tauri, 可视化界面, 本地音乐播放器, 桌面应用, 网络流量审计, 音频元数据编辑