BiliPai README

The project's README from github.com/jay3-yy/BiliPai. As one markdown file: README.md.

BiliPai

BiliPai

原生、纯净、可扩展的第三方 Bilibili Android 客户端

面向日常使用的现代 Android 客户端:视频、番剧、直播、动态、下载、插件与大屏体验。

简体中文 · English

Release 0.2.3-beta.27 Android 8.0+ Kotlin Non-Commercial License Stars

Telegram channel Telegram group X account

README 更新:2026-09-01 · 当前构建版本以 app/build.gradle.kts 为准 · 已发布版本以 CHANGELOG.md 为准


仓库导航

我想要…… 快速入口
下载与体验 下载说明 · 版本变更 · Telegram 频道 · 常见问题
了解项目 真机预览 · 核心能力 · 功能矩阵 · 路线图
阅读文档 Wiki 首页 · 架构说明 · QA 手册
开发与构建 构建说明 · 代码结构规范 · 版本规范 · 发布流程
开发插件 JSON 插件 · 原生插件 · Plugin SDK · 示例
参与项目 贡献说明 · 提交 Issue · Pull Requests · AI / LLM 入口

项目定位

BiliPai 是一个基于 Kotlin 与 Jetpack Compose 的第三方 Bilibili Android 客户端,覆盖视频、番剧、直播、动态、消息、离线缓存等日常使用流程,并支持插件扩展与平板/折叠屏等大屏形态。

[!IMPORTANT] 应用默认设置面向通用场景。安装后建议进入 设置 调整外观、动画、播放、弹幕、后台播放和插件选项。

真机预览

以下图片来自当前真机截图目录,后续 README 改版也会继续沿用这组资产。

BiliPai screenshot 1 BiliPai screenshot 2 BiliPai screenshot 3 BiliPai screenshot 4 BiliPai screenshot 5 BiliPai screenshot 6 BiliPai screenshot 7 BiliPai screenshot 8 BiliPai screenshot 9

下载与安装

项目 说明
源码 GitHub
公告 / 发布 Telegram 频道 @bilipai666
交流 Telegram 群组 @bilipai888
系统要求 Android 8.0+ / API 26+
推荐系统 Android 12+,可获得更完整的 Material You 与动态取色体验
CPU 架构 以 Release 实际产物为准,优先面向 64 位设备
登录方式 TV 扫码、手机号密码、短信验证码、Cookie 导入

安装 APK 时可能需要允许“安装未知来源应用”。请从官方频道或群组获取安装包,并核对发布说明中的版本与校验信息。

核心能力

模块 能力
视频播放 DASH 自适应码率、4K / 1080P60 / HDR、弹幕、手势、倍速、后台播放、画中画、播放记忆
视频笔记 私有笔记、新建/编辑/删除、AI 总结生成草稿、富文本编辑、时间点、Markdown 中间格式、系统分享
听视频 沉浸式 / 黑胶唱片模式、歌词、播放列表、定时关闭、系统媒体中心联动
番剧影视 选集面板、季度/版本切换、横屏顶部操作、追番与播放进度
直播 分区浏览、HLS 播放、实时弹幕、动态卡片跳转直播间
动态消息 关注流、GIF、图片预览/保存、消息分类、富文本链接跳转
搜索空间 视频 / UP 主 / 番剧检索,UP 空间搜索,历史记录与实时建议
离线缓存 清晰度选择、断点续传、本地播放管理、音视频合并
插件系统 内置插件、JSON 规则插件、源码级原生插件、外部包格式预览
投屏与备份 DLNA、Google Cast、WebDAV 设置备份与恢复
大屏适配 平板/折叠屏侧边栏、影院布局、横竖屏方向策略

体验设计

BiliPai 的界面围绕“内容优先、控制轻量、动效克制”调整。

插件生态

形态 当前状态 文档
内置插件 随主应用分发,当前注册空降助手、去广告、Anime4K、弹幕增强、夜间护眼、今日推荐单、CDN 属地优选、初见推荐、DLNA 与 Google Cast 共 10 个插件 应用内插件中心
JSON / .bp 规则插件 支持 URL 导入,适合推荐流过滤、弹幕过滤与高亮 JSON 插件开发
外部 .bpplugin 包 SDK、包格式、manifest、签名校验已就绪;外部 Dex 执行仍处于预览阶段 Plugin SDK
源码级原生插件 适合复杂播放器、推荐、弹幕能力,需要重新编译 APK 原生插件开发

[!CAUTION] 导入第三方插件前请审阅规则和能力声明,尤其是 NETWORK、LOCAL_HISTORY_READ、LOCAL_FEEDBACK_READ、PLAYER_CONTROL 等敏感能力。

初见推荐致谢原作者 wangdaodao 的 TabulaBili 与 tjsky 的 TabulaBili-Plus,BiliPai 仅实现 Android 端内置插件形态。

技术栈

类别 选型
语言 Kotlin
构建基线 AGP 9.3.1、Gradle 9.5、Kotlin 2.4、JDK 21、compileSdk 37
UI Jetpack Compose、Material 3、Miuix、Compose Cupertino、MVVM
导航 Navigation3 runtime/UI 1.2.0-alpha07、NavigationEvent 1.2.0-alpha03
网络 Retrofit、OkHttp、Kotlinx Serialization
存储 Room、DataStore
媒体 AndroidX Media3 / ExoPlayer、MediaCodec
弹幕 DanmakuRenderEngine、自研弹幕策略与覆盖层
视觉 Haze 2、Miuix Backdrop / Liquid Glass
动画 Compose Animation / SharedTransition、Lottie、自研 shimmer 与粒子效果
图片 Coil Compose
后台任务 WorkManager

项目结构

BiliPai/
├── app/                         # Android 应用壳、业务功能与绝大多数运行时代码
│   └── src/main/java/com/android/purebilibili/
│       ├── app/                 # Application、启动初始化与顶层装配
│       ├── core/                # 网络、存储、播放器、插件、主题和 UI 公共能力
│       ├── data/                # API/数据库模型与 Repository
│       ├── domain/              # 可复用 UseCase 与纯业务规则
│       ├── feature/             # 视频、首页、动态、直播、设置等业务场景
│       ├── navigation/          # 路由兼容、入口策略与顶层导航装配
│       └── navigation3/         # NavKey、返回栈、Entry/Scene 与预测返回
├── design-system/               # 三套风格共享的主题、组件、动效、模糊与适配策略
├── settings-core/               # 可复用设置策略
├── network-core/                # 可复用网络回退与推荐策略
├── plugin-sdk/                  # 推荐、播放器、弹幕插件接口与能力声明
├── baselineprofile/             # 启动、首页、设置和视频详情性能基准
├── docs/                        # Wiki、插件开发文档与截图资源
├── plugins/                     # SDK 文档、JSON/源码示例、皮肤示例与社区索引
└── scripts/                     # CI、发布、性能采集与 Baseline Profile 工具

构建

git clone https://github.com/jay3-yy/BiliPai.git
cd BiliPai
./gradlew :app:compileDebugKotlin

本地开发使用 JDK 21;Android Studio、Android SDK 与 Gradle 环境需兼容 AGP 9.3.1 和 compileSdk 37。如需生成可安装的本地测试 APK,可运行:

./gradlew :app:assembleDev

完成后可安装交付包位于 app/build/outputs/bilipai/dev/BiliPai-0.2.3-beta.27-dev.apk。正式发布构建对应输出 app/build/outputs/bilipai/release/BiliPai-0.2.3-beta.27.apk;AGP 内部的 app-*.apk 不作为交付文件。

google-services.json 是可选项:放入 app/ 后启用 Firebase Crashlytics / Analytics;缺失时构建脚本会跳过相关能力。

文档入口

内容 链接
Wiki 首页 docs/wiki/README.md
当前路线图 docs/wiki/ROADMAP.md
AI / LLM 入口 llms.txt · docs/wiki/AI.md
功能矩阵 docs/wiki/FEATURE_MATRIX.md
架构说明 docs/wiki/ARCHITECTURE.md
QA 手册 docs/wiki/QA.md
用户问答 docs/wiki/FAQ.md
发布流程 docs/wiki/RELEASE_WORKFLOW.md
版本规范 docs/wiki/VERSIONING.md
变更日志 CHANGELOG.md

最近更新

当前构建为 0.2.3-beta.27 / versionCode 344;最新完整发布记录为 v0.2.3-beta.27。源码与变更以 GitHub 和 CHANGELOG.md 为准;安装包与公告见 Telegram 频道 / 交流群:

路线图

状态 方向
已完成基线 首页、播放、番剧、直播、动态、消息、离线、听视频、视频笔记、投屏、WebDAV、多账号会话、插件、大屏与三套视觉风格
当前 P0 视频整卡/预测返回全入口验收、转场稳态性能、Navigation3 1.2 真机回归、AGP 9 单元测试链路恢复
后续 外部插件可控执行、多账户数据隔离、收藏夹管理、完整本地化与历史云同步评估

完整优先级、完成条件与非目标见 路线图。

参与贡献

欢迎提交 Issue 和 Pull Request。

  1. Fork 本仓库。
  2. 从主分支创建 feature/xxx 或 fix/xxx 分支。
  3. 保持改动聚焦,补充必要测试或说明。
  4. 提交 PR,并描述改动目的、影响范围和验证结果。

维护者会优先处理可复现的问题、清晰的功能补全、真实设备反馈和带有验证记录的修复。

致谢

BiliPai 依赖并参考了多个优秀开源项目:

项目 用途
Jetpack Compose 声明式 UI 框架
AndroidX Media Media3 / ExoPlayer 播放引擎
DanmakuRenderEngine 高性能弹幕渲染参考
bilibili-API-collect B 站 API 文档
PiliPlus 播放链路与移动端体验参考
Bili Pilot 签名 CDN 候选、分片级选线与预缓存设计参考;BiliPai 为独立 Kotlin 实现,未复制其 JavaScript 代码
BilibiliSponsorBlock 空降助手数据与 API
Haze 毛玻璃效果
Compose Cupertino iOS 风格组件
Miuix Miuix 风格组件
BiliPai-miuix UI 组件 facade / design-system 重构贡献(@piracola)
Lottie 矢量动画
Coil 图片加载
Retrofit / OkHttp 网络请求
Room / DataStore 本地数据与偏好存储

如有遗漏,欢迎通过 Issue 或 PR 补充。

免责声明

[!CAUTION]

  1. 本项目按 GPLv3 开源;使用、修改与分发时请遵守许可证及相关法律法规。
  2. 数据来源于 Bilibili 官方公开接口或用户登录后的正常访问能力,版权归对应权利方所有。
  3. 登录信息仅保存在本地,不会主动上传隐私数据。
  4. 使用本应用观看、下载或分享内容时,请遵守相关法律法规与平台规则。
  5. 如涉及版权或权益问题,请联系维护者处理。

许可证

GNU General Public License v3.0

你可以依照 GPLv3 使用、研究、修改与分发本项目。分发修改版本或二进制作品时,须按 GPLv3 提供对应源代码并保留许可证与版权声明。

Made by YangY

( ゜- ゜)つロ 干杯~

BiliPai (jay3-yy/BiliPai)

Searching Database…

4.9K ·GitHub
What is this?BiliPai is a third-party, native Android client for Bilibili that covers video playback, anime (bangumi), live streaming, moments, messages, offline downloads, and a plugin system, built with Kotlin and Jetpack Compose.
Is this the official Bilibili app, or some modified repackage of it?Neither — it's an independent native app written from scratch in Kotlin that talks to Bilibili's public API, not a cracked or repackaged official APK.
How do I get it installed on my phone?Download the release APK from the official Telegram channel (@bilipai666) and allow 'install from unknown sources' to sideload it, or build it yourself with JDK 21 and Android Studio using AGP 9.3.1 and compileSdk 37.
What Android version and login method do I need?It requires Android 8.0 (API 26) or higher, with Android 12+ recommended for full Material You support; you can log in via TV QR scan, phone number and password, SMS code, or cookie import.
Can I load third-party plugin packages right now?Built-in and JSON/.bp rule plugins already work, but running external .bpplugin packages with their own native code (external Dex execution) is still in a preview stage.
Can I watch videos without an internet connection?Yes, BiliPai has an offline-cache module that lets you pick a quality, resume broken downloads, and merge audio/video for local playback.
What plugins are included out of the box?Ten built-in plugins ship by default, including an ad-blocker, Anime4K upscaling, danmaku enhancement, a night-eye-care mode, a first-look recommendation list, CDN region optimization, and DLNA/Google Cast support.
Why build another Bilibili client instead of using the official app?BiliPai focuses on a native, clean and extensible experience — Material You/Miuix theming, liquid-glass visuals, tablet/foldable layouts, and a plugin system — that the official app doesn't offer.
Can I cast playback to a TV or back up my settings?Yes, it supports screen casting via DLNA and Google Cast, and you can back up or restore your app settings through WebDAV.
Does it handle big-screen devices like tablets or foldables?Yes, it has dedicated sidebar and theater-mode layouts plus orientation strategies tailored for tablets and foldable phones.
Creator
jay3-yy
Size
468.3 MB
Stars
4.9K
Age
10mo
Commits · 90 Days