패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소Empty-57/ZeroBit-Player

ZeroBit-Player

flutter(dart) + rust + bass를 기반으로 개발된 매터리얼 스타일 로컬 음악 플레이어

ZeroBit-Player 프로젝트 이미지
스타
270
포크
20
최근 푸시(UTC)
2026. 9. 15.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

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的 设置 的 歌词设置 的 顺序 选项卡选择: 罗马音->原文->译文

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

search

手动写入内嵌歌词:

editLyrics

关于歌曲封面

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

注意

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

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

感谢

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

贡献与赞助

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

贡献

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

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

赞助

桌面歌词展示

show show

软件展示

深色模式

show show show show show show

浅色模式

show show show show

Empty GitHub avatar
GitHub 작성자

Empty ↗

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

中国
언어DartRustC++CMakeShellRubyBatchfileCPowerShell

분류

사용 중인 의존성

의존성 목록 36 개

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗