FLUTTER ECOSYSTEM

Empty-57/ZeroBit-Player

基於 flutter(dart) + rust + bass 開發的Material風格本地音樂播放器

在 GitHub 查看 ↗

Stars: 270
Forks: 20
最近推送（UTC）: 2026年9月15日
專案狀態: 未封存

GITHUB User

Empty ↗

Take me to a world where my soul can finally breathe in peace.

中国

語言DartRustC++CMakeShellRubyBatchfileCPowerShell

技術主題

# bass # dart # flutter # flutteranimation # rust # dio # flutter-rust-bridge # hive # libloading # lofty # smtc # ttf-parser # window-manager # getx

使用的依賴

依賴清單 36 項

flutter{"sdk":"flutter"}
signals^7.1.0
go_router^18.0.1
flutter_animate^4.5.2
window_manager^0.5.0
phosphoricons_flutter^1.0.0
transparent_image^2.0.1
file_picker^10.1.9
hive_ce^2.11.3
hive_ce_flutter^2.3.1
material_color_utilities^0.13.0
dio^5.8.0+1
convert^3.1.2
path_provider^2.1.5
flutter_colorpicker^1.1.0
flutter_single_instance^1.5.1
pinyin^3.3.0
path^1.9.1
fl_charset^1.0.2
scrollable_positioned_list^0.3.8
package_info_plus^9.0.0
flutter_markdown_plus^1.0.5
url_launcher^6.3.2
web_socket_channel^3.0.3
shared_preferences^2.5.3
hotkey_manager^0.2.3
crypto^3.0.7
mesh_gradient^1.3.8
leak_tracker^11.0.1
tray_manager{"git":{"url":"https://github.com/PythiaLaurus/tray_manager.git","ref":"main","path":"packages/tray_manager"}}
flutter_rust_bridge2.11.1
rust_lib_zerobit_player{"path":"rust_builder"}
signals_lint開發依賴^7.1.0
flutter_test開發依賴{"sdk":"flutter"}
flutter_lints開發依賴^5.0.0
integration_test開發依賴{"sdk":"flutter"}

所在榜單

Architecture#60

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

ZeroBit Player

logo

一款基于Flutter+Rust的Material风格本地音乐播放器

Ask DeepWiki Version Platform Flutter Rust Downloads License wakatime

Logo来源：阿里巴巴矢量图库

show

前往 官方文档 查看更多信息

安装/快速开始

安装

点击此处安装

快速开始

环境要求：

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编译后的内容复制到软件目录的 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 将会作为翻译数据（如果存在）若不存在，则会扫描内嵌歌词
若都不存在，则需要手动从网络选择歌词或者写入内嵌歌词
若开启了自动下载选择的歌词，则会在选择歌词后，自动在音频同目录下创建原文文件和翻译文件（如果有）

若选择了.lrc格式的歌词，有下面几种情况
若包含注音，会将相同时间戳的歌词行第一行作为注音，第二行作为原文，第三行作为翻译
例如：

[00:24.212]qi  yo to ma ga sa xi ta n da         这一行将会作为注音
[00:24.212]ちょっと魔がさしたんだ                  这一行将会作为原文
[00:24.212]我是有点鬼迷心窍了                      这一行将会作为翻译

若不包含注音，会将相同时间戳的歌词行第一行作为原文，第二行作为翻译
例如：

[00:24.212]ちょっと魔がさしたんだ                   这一行将会作为原文
[00:24.212]我是有点鬼迷心窍了                      这一行将会作为翻译

若只有一行，则会通过 / 分割歌词行，/前面的作为原文，/后面的作为翻译
例如：

[00:24.21]ちょっと魔がさしたんだ / 我是有点鬼迷心窍了     / 前面将会作为原文 / 后面将会作为翻译

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

使用LDDC来匹配本地歌词时，可以选择将歌词 保存到歌曲标签 ，也可以选择将歌词文件 保存到歌曲文件夹 ，歌词文件名请选择 与歌曲文件名相同

使用LDDC时，为了兼容罗马音，原文，翻译的渲染，请在LDDC的 设置 的 歌词设置 的 顺序 选项卡选择: 罗马音->原文->译文

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

手动写入内嵌歌词：

editLyrics

关于歌曲封面

可以选择本地图片作为封面,也可以点击 网络封面 来设置封面
若使用 网络封面 来设置封面，会以当前设置的API源来匹配封面，请尽量正确填写元数据（标题，艺术家，专辑）以提高匹配准确率
show

注意

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

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

感谢

项目在开发过程中参考/使用了以下优秀的项目:

coriander_player，Pure-music — 借鉴了UI设计
BASS — 播放器内核
Lofty — 读写音频元数据

贡献与赞助

如果你喜欢这个项目，觉得它对你有帮助，可以通过以下方式支持我，让我有动力继续维护和更新

贡献

创建一个 Issue

可以是bug反馈，新功能请求，若提交BUG，请尽可能说明复现步骤并提供截图和日志，日志文件位于软件根目录下的 logs 目录下。

创建一个 Pull Request

可以是bug修复，添加新功能，或者功能优化，若提交PR，请检查代码是否有潜在隐患并尽量做一些优化。