KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

ZeroBit-Player

★ 250 Open GitHub ↗

基于 flutter(dart) + rust + bass 开发的Material风格本地音乐播放器

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ZeroBit Player

<div align="center">
  <img src="assets/app_icon.ico" alt="logo" width=150 height=150>
<p align="center">
  一款基于Flutter+Rust的Material风格本地音乐播放器
</p>
</div>
<div align="center">
  <a href="https://deepwiki.com/Empty-57/ZeroBit-Player"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
<img src="https://img.shields.io/badge/Platform-Windows-blue" alt="Platform">
  <img src="https://img.shields.io/badge/Flutter-3.44+-0044aa" alt="Flutter">
  <img src="https://img.shields.io/badge/Rust-1.92+-black" alt="Rust">
  <img src="https://img.shields.io/badge/License-GPL--3.0-green" alt="License">
<a href="https://wakatime.com/badge/user/7dfa2142-9f15-461d-ba44-2a9e14966a3b/project/e540bf5c-e190-4823-b0bd-02e367cbfa2b"><img src="https://wakatime.com/badge/user/7dfa2142-9f15-461d-ba44-2a9e14966a3b/project/e540bf5c-e190-4823-b0bd-02e367cbfa2b.svg" alt="wakatime"></a>
</div>

<p align="center">Logo来源：阿里巴巴矢量图库</p>

---

![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/7.png)

## 安装/快速开始
### 安装
[点击此处安装](https://github.com/Empty-57/ZeroBit-Player/releases/latest)
### 快速开始
#### 环境要求：
- Windows 10/11
- Flutter 3.44+
- Rust 1.92+

### 开发
```
# 安装依赖
flutter pub get

# 运行开发模式
flutter run

# 构建 Release 版本
flutter build windows --release

# 构建 Debug 版本
flutter build windows --debug
```

### 生成FRB绑定
```
flutter_rust_bridge_codegen generate --watch
```

### 注意
编译后要把 BASS 库的 64 位的：
 - `bass.dll`
 - `bassalac.dll`
 - `bassape.dll`
 - `bassdsd.dll`
 - `bassflac.dll`
 - `bassmidi.dll`
 - `bassopus.dll`
 - `basswasapi.dll`
 - `basswebm.dll`
 - `basswv.dll`
 - `bass_fx.dll`

复制到软件目录的 `BASSDLL` 文件夹下

要把[`Zerobit Player Desktop Lyrics`](https://github.com/Empty-57/zerobit_player_desktop_lyrics)编译后的内容复制到软件目录的 `desktop_lyrics` 文件夹下以支持桌面歌词

## 特性
- 支持自定义歌单
- 支持读写（部分）元数据
- 支持读写（部分）内嵌歌词
- 支持读取本地歌词文件
- 支持多种音频格式
- 支持均衡器功能
- 支持从网络获取歌词数据以及专辑封面
- 支持根据艺术家，专辑，文件夹分类
- 使用 Material 3 风格
- 支持自定义主题色和自定义字体
- 支持动态主题色
- 支持SMTC
- 支持音频可视化
- 支持桌面歌词
- 支持WASAPI独占模式
- 支持音量平衡
- 支持自定义快捷键
- 支持后台播放

## 支持的音频格式
- aac
- ape
- aiff
- aif
- flac
- mp3
- mp4 m4a m4b m4p m4v
- mpc
- opus
- ogg
- oga
- spx
- wav
- wv
- dff
- dsf

## 支持的歌词格式
- qrc
- yrc
- krc
- 逐行lrc 
- 逐字Lrc
- 增强型Lrc

## 支持读写的元数据格式
| 音频格式       | 元数据格式                        |
|------------|------------------------------|
| AAC (ADTS) | `ID3v2`, `ID3v1`             |
| Ape        | `APE`, `ID3v2`\*, `ID3v1`    |
| AIFF       | `ID3v2`, `Text Chunks`       |
| FLAC       | `Vorbis Comments`, `ID3v2`\* |
| MP3        | `ID3v2`, `ID3v1`, `APE`      |
| MP4        | `iTunes-style ilst`          |
| MPC        | `APE`, `ID3v2`\*, `ID3v1`\*  |
| Opus       | `Vorbis Comments`            |
| Ogg Vorbis | `Vorbis Comments`            |
| Speex      | `Vorbis Comments`            |
| WAV        | `ID3v2`, `RIFF INFO`         |
| WavPack    | `APE`, `ID3v1`               |

\* 由于缺乏官方支持，该标签将是**只读**的

## 关于歌词
默认会优先从音频相同的目录寻找同名的歌词文件，然后寻找同名的`.lrc`文件作为翻译数据，会优先寻找逐字歌词格式，如音频 `a.flac` 会先寻找 `a.qrc` 作为歌词数据，`a.lrc` 将会作为翻译数据（如果存在）
若不存在，则会扫描内嵌歌词</br>
若都不存在，则需要手动从网络选择歌词或者写入内嵌歌词</br>
若开启了自动下载选择的歌词，则会在选择歌词后，自动在音频同目录下创建原文文件和翻译文件（如果有）</br>

若选择了`.lrc`格式的歌词，有下面几种情况</br>
若包含注音，会将相同时间戳的歌词行第一行作为注音，第二行作为原文，第三行作为翻译</br>
例如：</br>
```
[00:24.212]qi  yo to ma ga sa xi ta n da         这一行将会作为注音
[00:24.212]ちょっと魔がさしたんだ                  这一行将会作为原文
[00:24.212]我是有点鬼迷心窍了                      这一行将会作为翻译
```

若不包含注音，会将相同时间戳的歌词行第一行作为原文，第二行作为翻译</br>
例如：</br>
```
[00:24.212]ちょっと魔がさしたんだ                   这一行将会作为原文
[00:24.212]我是有点鬼迷心窍了                      这一行将会作为翻译
```

若只有一行，则会通过 ` / ` 分割歌词行，` / `前面的作为原文，` / `后面的作为翻译</br>
例如：</br>
```
[00:24.21]ちょっと魔がさしたんだ / 我是有点鬼迷心窍了     / 前面将会作为原文 / 后面将会作为翻译
```

若使用了[LDDC](https://github.com/chenmozhijin/LDDC)来匹配本地歌词并且将歌词文件保存到歌曲同目录时，仍然会优先使用 `.qrc` `.krc` `.yrc` 格式的歌词文件作为原文，请先删除上述两种格式的文件以使用[LDDC](https://github.com/chenmozhijin/LDDC)歌词

使用[LDDC](https://github.com/chenmozhijin/LDDC)来匹配本地歌词时，可以选择将歌词 `保存到歌曲标签` ，也可以选择将歌词文件 `保存到歌曲文件夹` ，歌词文件名请选择 `与歌曲文件名相同`

使用[LDDC](https://github.com/chenmozhijin/LDDC)时，为了兼容罗马音，原文，翻译的渲染，请在[LDDC](https://github.com/chenmozhijin/LDDC)的 `设置` 的 `歌词设置` 的 `顺序` 选项卡选择: 罗马音->原文->译文

若要搜索歌词，请通过输入歌曲信息，搜索更精确的歌词：</br>

![search](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/5.png)

手动写入内嵌歌词：</br>

![editLyrics](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/14.png)

## 关于歌曲封面
可以选择本地图片作为封面,也可以点击 `网络封面` 来设置封面</br>
若使用 `网络封面` 来设置封面，会以当前设置的API源来匹配封面，请尽量正确填写元数据（标题，艺术家，专辑）以提高匹配准确率</br>
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/10.png)

## 提交BUG或者PR
- 若提交BUG，请创建一个新的 issue，尽可能说明复现步骤并提供截图和日志，日志文件位于软件根目录下的 `logs` 目录下。
- 若提交PR，请检查代码是否有潜在隐患并尽量做一些优化。

## 注意
若软件发生了严重错误，可尝试到目录 `C:\Users\<用户名>\Documents\zerobit_config` 下删除所有 `.hive` 以及同名的 `.lock` 的后缀的配置文件

1.4.3以后的版本，配置文件的位置从 `C:\Users\<用户名>\Documents` 移动到 `C:\Users\<用户名>\Documents\zerobit_config`

## 感谢
项目在开发过程中参考/使用了以下优秀的项目:
- [coriander_player](https://github.com/Ferry-200/coriander_player) — 借鉴了UI设计
- [BASS](https://www.un4seen.com/) — 播放器内核
- [Lofty](https://crates.io/crates/lofty) — 读写音频元数据

## 桌面歌词展示
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/12.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/13.png)

## 软件展示
### 深色模式
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/1.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/2.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/3.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/4.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/5.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/6.png)
### 浅色模式
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/7.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/8.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/9.png)
![show](https://raw.githubusercontent.com/Empty-57/ZeroBit-Player/master/screenshot/10.png)

ZeroBit-Player

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README