Skip to content

wood3n/biu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Biu 音乐播放器

Biu logo

基于哔哩哔哩(B 站)公开接口的跨平台桌面音乐播放器 🎧🎶

非官方项目,与哔哩哔哩无任何官方关联或背书

Latest Version License

home main
download settings
playlist

mini 播放器

mini

✨ 特色功能

  • 🎼 支持登录 Bilibili 并获取收藏夹、稍后再看、历史记录等信息
  • 🎧 高品质音频播放,优先拉取更高码率音频流(如无损 Flac,192K/Hi-Res)
  • 🔥 支持视频文件以及提取视频中的音频下载;支持收藏夹视频批量下载
  • 🧩 轻量界面,内置深色主题,同时可自定义部分主题样式,细腻的滚动与动效体验
  • 💿 系统托盘与最小化隐藏(Windows),便捷控制播放
  • 🍃 支持 mini 播放器模式,占用系统资源少,同时保留主窗口功能
  • ♻️ 安装包支持自动检测更新,始终保持最新体验

下载和使用

  • 下载页面:GitHub Releases
  • 快速选择:
    • Windows 优先选安装包 win-setup;需要免安装/无管理员权限选 win-portable
    • macOS 优先选 dmg;需要脚本/自动化分发可选 zip
    • Linux 优先选 AppImage;偏好包管理器可选 deb/rpm;Arch Linux 用户可选 AUR
  • 常见产物对比如下(<version> 为版本号,<arch> 常见为 x64/arm64):
系统 推荐下载 优点 限制 文件名示例
Windows
x64/arm64
安装包(NSIS)
win-setup
一键安装/卸载、开始菜单/桌面快捷方式
通常兼容性最好、适合长期使用
自动更新支持更完整
需要安装到磁盘(非免安装)
可能触发系统权限/安全提示
Biu-<version>-win-setup-x64.exe
Biu-<version>-win-setup-arm64.exe
Windows
x64/arm64
免安装版(Portable)
win-portable
解压/下载即用,不改系统配置
适合U盘/临时环境/无管理员权限
应用内自动更新受限,通常需要手动下载替换 Biu-<version>-win-portable-x64.exe
Biu-<version>-win-portable-arm64.exe
macOS
x64/arm64
DMG(推荐)
.dmg
拖拽安装体验好、适合大多数用户
分发与回收方便
首次打开可能需要在系统设置中允许来源
不同系统安全策略提示不同
Biu-<version>-mac-x64.dmg
Biu-<version>-mac-arm64.dmg
macOS
x64/arm64
ZIP
.zip
体积通常更小、适合脚本/CI 分发
解压即用
安装体验不如 DMG 直观(需要手动放入应用目录) Biu-<version>-mac-x64.zip
Biu-<version>-mac-arm64.zip
Linux AppImage(最通用)
.AppImage
发行版通用、下载即运行
不依赖包管理器,适合多发行版
需手动赋予可执行权限(例如 chmod +x
桌面集成需要额外操作
Biu-<version>-linux-x64.AppImage
Biu-<version>-linux-arm64.AppImage
Linux DEB / RPM
.deb / .rpm
更符合系统习惯,桌面/菜单集成更好
方便用系统包管理器安装/卸载
与发行版/依赖关系更强(Debian/Ubuntu 用 .deb,Fedora/RHEL 用 .rpm Biu-<version>-linux-x64.deb / .rpm
Biu-<version>-linux-arm64.deb / .rpm
Arch Linux AUR (由@cjlworld提供)
biu-bin
通过 AUR 助手安装更新方便
符合 Arch 用户习惯
依赖社区更新 paru -S biu-bin
  • 系统要求(建议)
    • Windows Windows 10 / 11(x64 / arm64
    • macOS macOS 12+(x64 / arm64
    • Linux 主流 Linux 发行版(x64 / arm64
  • 架构怎么选
    • Windows:设置 → 系统 → 关于 → “系统类型”(ARM 设备选 arm64,其余多为 x64
    • macOS:Apple 芯片选 arm64,Intel 芯片选 x64
    • Linux:执行 uname -m,常见 x86_64 对应 x64aarch64 对应 arm64
  • 自动更新说明
    • 应用会定期检查 GitHub Releases,下载安装更新(多数安装方式均支持)。
    • Windows 免安装版(portable)在应用内下载更新受限,建议前往 Releases 手动下载替换。
  • *.yml*.blockmap 为自动更新辅助文件,手动下载时无需关注。
  • 使用注意
    • 部分音频清晰度与解析可能需要登录或大会员权限。
    • 请遵循 Bilibili 使用条款,合理合规使用。

📄 许可证

本项目以 PolyForm Noncommercial License 1.0.0(非商业许可)发布,禁止任何商业用途。详情参见 LICENSE(SPDX:PolyForm-Noncommercial-1.0.0)。


如果你喜欢这个项目,欢迎 ⭐️ Star 支持!也欢迎提出 Issue 交流与反馈 🙌

🙏 鸣谢

  • 特别感谢 SocialSisterYi/bilibili-API-collect 对哔哩哔哩 API 的长期收集与整理,为本项目相关接口的使用提供了重要参考。
  • 感谢 @cjlworld 为 Arch Linux 用户创建并维护了 AUR 软件包,方便 Arch 用户通过 paru -S biu-bin 命令安装与更新。
  • 在引用与使用相关资料时,我们遵循其许可条款(CC-BY-NC 4.0),仅用于学习与研究,不涉及任何商业用途。

⚖️ 法律声明与使用限制

  • 本项目仅供学习与研究使用,禁止任何形式的商业用途(包括但不限于销售、收费服务、广告变现、商业集成等)。
  • 本项目与 Bilibili 无任何官方关联或背书,不使用其商标与标识;涉及的名称与商标归其权利人所有。
  • 数据来源于用户调用的公开接口与个人账户授权;使用时需遵守 Bilibili 的《用户协议》《社区规则》及相关法律法规。
  • 禁止绕过登录/会员权限、DRM/加密措施,或进行批量爬取、恶意抓取等违反平台规则的行为。
  • 如需商业授权或调整许可,请联系作者;如涉及权利或合规问题,请通过 Issues 反馈以便及时处理。

🤝 贡献指南

非常欢迎社区贡献!你可以按以下流程参与:

  1. Fork 本仓库并创建分支:feature/your-feature / fix/your-fix
  2. 开发并通过本地构建与基本自测(如:pnpm devpnpm build
  3. 提交 PR,详述改动点与影响范围
  4. 通过 CI 的构建与审查后合入主分支

建议:

  • 使用 ESLint/Prettier 保持代码风格一致(ESLint/Prettier 已配置)
  • 提交信息简洁规范(推荐使用 feat: ...fix: ... 等约定式格式)
  • PR 中附上必要的截图或说明

♥️ Contributors

🌟 Star History

Star History Chart