jay3-yy / BiliPai

# BiliPai
**原生、纯净、可扩展的第三方 BiliBili Android 客户端**
简体中文 · English
Telegram 频道 · Telegram 交流群 · X
 源码版本 0.5.4（502） · 更新于 2026-10-22 
BiliPai 基于 Kotlin 与 Jetpack Compose，支持视频、番剧、直播、动态、消息和离线缓存，适配手机、平板与折叠屏，后续会提供独立电视端。
下载 · 功能 · 预览 · 构建 · 更新日志
## 主要功能
| 功能 | 说明 |
| --- | --- |
| 视频播放 | DASH、高清画质、弹幕、手势、倍速、播放记忆、后台播放与画中画 |
| 听视频 | 沉浸式与黑胶模式、歌词、队列、定时关闭、系统媒体控制 |
| 字幕与笔记 | 本地字幕导入导出、样式与时间调整；私有笔记、时间点与 AI 总结草稿 |
| 番剧与直播 | 追番、选集、进度预览、直播分区与实时弹幕 |
| 动态与消息 | 关注动态、评论回复、图片预览与私信 |
| 搜索与缓存 | 视频、UP 主与番剧搜索；离线下载、断点续传与本地播放 |
| 外观与布局 | Material 3、Miuix、可选液态玻璃、动态取色与大屏布局 |
| 扩展能力 | 插件、DLNA / Google Cast 投屏、WebDAV 设置备份 |
部分画质需要登录或相应账号权限。外观、播放、弹幕与后台行为可在设置中调整。
## 界面预览
界面随版本、主题和设备尺寸有所不同。
## 下载与安装
从 Telegram 频道 获取安装包与发布说明，交流反馈可加入 Telegram 群组。
- 系统要求：Android 8.0+，架构以安装包为准。
- 登录方式：TV 扫码、密码、短信验证码或 Cookie 导入。
- 安装 APK 时需允许对应来源安装应用。
## 插件
内置空降助手、去广告、Anime4K、弹幕增强、夜间护眼、推荐与投屏等插件。JSON / `.bp` 规则支持 URL 导入；源码插件通过编译集成，外部 `.bpplugin` 执行仍处于预览阶段。
导入第三方插件前，请检查来源与权限声明。
## 最近更新
- 新增英文支持、本地字幕导入导出与样式调整。
- 完善播放器菜单、番剧进度预览和合集付费标识。
- 修复收藏夹多选，统一资料与侧栏图标，补充启动和交互性能基线。
完整记录见 CHANGELOG.md，源码版本以 `app/build.gradle.kts` 为准。
## 项目结构
 [code] 
## 构建
环境：JDK 21、Android SDK 37；Gradle Wrapper 与依赖版本由仓库管理。
Miuix 依赖从 GitHub Packages 获取，需在本机 `~/.gradle/gradle.properties` 配置 `gpr.user`、`gpr.key`，或设置 `GITHUB_ACTOR`、`GITHUB_TOKEN` 环境变量。凭据需有对应包的读取权限。
 [code] 
APK 输出至 `app/build/outputs/bilipai/dev/`；正式版输出至 `app/build/outputs/bilipai/release/`。
`app/google-services.json` 为可选配置，缺失时跳过 Firebase。主要技术栈为 Compose、Media3、Room、DataStore、Retrofit、OkHttp 与 Coil。
## 参与贡献
欢迎通过 Issue 反馈问题、提出建议，也欢迎提交 Pull Request，一起完善功能和翻译。
## 致谢
| 项目 | 用途 |
| --- | --- |
| Jetpack Compose | 声明式 UI 框架 |
| AndroidX Media | Media3 / ExoPlayer 播放引擎 |
| DanmakuRenderEngine | 高性能弹幕渲染参考 |
| BiliBili-API-collect | B 站 API 文档 |
| PiliPlus | 播放链路与移动端体验参考 |
| Bili Pilot | CDN 选线与预缓存设计参考 |
| BiliBiliSponsorBlock | 空降助手数据与 API |
| Haze | 毛玻璃效果 |
| Compose Cupertino | iOS 风格组件 |
| Miuix | 界面组件与液态玻璃动效参考 |
| BiliPai-miuix | UI 组件与设计系统贡献（@piracola） |
| Lottie | 矢量动画 |
| Coil | 图片加载 |
| Retrofit / OkHttp | 网络请求 |
| Room / DataStore | 本地数据与偏好存储 |
| TabulaBili / TabulaBili-Plus | 初见推荐参考 |
| biliSendCommAntifraud | 评论反诈检测参考 |
| Kotlin | 开发语言 |
| Kotlinx Coroutines | 协程与异步任务 |
| Kotlinx Serialization | 数据序列化 |
| MaterialKolor | 动态主题配色 |
| Compose Rich Editor | 富文本编辑 |
| ZXing | 二维码处理 |
| CameraX | 扫码相机 |
| WorkManager | 后台任务调度 |
| FFmpeg | 音频解码 |
| Readability4J | 文章正文提取 |
| jsoup | HTML 解析 |
| Telegram | 粒子动效与资料页交互参考 |
更多来源与许可证见 第三方声明。
## 许可证与声明
本项目采用 GPLv3。分发时请遵守许可证，提供对应源代码并保留版权声明。
本项目为非官方客户端，与 BiliBili 无隶属关系。内容版权归对应权利方所有，使用时请遵守相关法律法规与平台规则。登录信息保存在本地；使用统计可在设置中管理。
Made by YangY