Skip to content
znbsfPublic
forked from Predidit/Kazumi

About

A Kazumi-based anime browser and player for Android TV, optimized for remote controls, with danmaku and phone remote support.

Resources

Stars

45 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

2,161 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KazumiTV

为 Android TV 和遥控器设计的动画浏览与播放应用。 基于 Predidit/Kazumi:延续上游的 Flutter/Dart 业务、规则与 media-kit 播放能力,结合本仓库原生 TV 版本的布局和交互工作,形成当前 Flutter TV 融合版。本项目是独立衍生项目,不是上游官方 TV 版本。

下载 0.4.8 正式版 · 版本记录 · 构建说明

维护入口:当前项目状态 · 开发经验

可以做什么

0.4.8 已发布,修复缓存播放并完善失败恢复:

  • 修复完整 MP4 缓存续播、前后拖动及再次播放时可能黑屏的问题。缓存失败后可关闭缓存并保留进度重试;离线入口可关闭并返回,已有文件保留。
  • 弹幕超时与 429 分别提示,可关闭当前弹幕并保存默认关闭;之后播放不再自动请求,手动成功选取可恢复开启。
  • 弹幕服务数据独立缓存,默认开启、上限 256 MiB;弹幕、搜索和剧集列表 6 小时内复用,番剧 ID 匹配保留 7 天。相同请求合并,429 后暂停请求并按服务端要求等待,更新失败时可回退 30 天内的旧数据。
  • 在「设置 → 弹幕设置 → 弹幕缓存」或「存储与日志 → 弹幕缓存」查看用量、调整 64 MiB~1 GiB 容量或清除缓存。与视频缓存分开管理;隐身模式不读写此缓存。
  • 「近期视频缓存」仍为默认关闭的独立实验功能;完整视频可离线播放,手动下载保持原有入口。手机脱敏日志导出也已合入,使用方法见下方日志说明。

0.4.8 已于 2026-11-15 正式发布。缓存续播、拖动和故障关闭入口已有电视验收,ARMv7 正式包保留数据升级检查通过;三个架构 APK 及配套附件均已匿名下载并核对哈希。具体验证方式与边界见 0.4.8 发布说明及项目状态。手机日志复制/下载沿用 0.4.7 的用户实测结果。

  • 遥控器浏览:单排横向导航、五列海报卡片、向下持续加载;清晰的焦点高亮,返回时恢复浏览位置。
  • 找番与看资料:分类目录、搜索、排期、作品详情、角色和关联作品。
  • 管理播放来源:导入与管理规则,搜索可用来源,选择线路和剧集。
  • 接着看:收藏、历史记录和分集续播,保留日常追番入口。
  • 内置播放:暂停、进度调整、选集、倍速,以及音轨、字幕和弹幕设置;实际可用能力取决于媒体与来源。

电视界面展示

电视首页 · 手机入口、海报编号与缓存更新时间

0.4.4电视首页:手机遥控入口、编号海报和刷新状态

电视首页图来自已验收的r7测试包;截图版本与范围见截图说明。

0.4.3 正式版界面

以下截图来自 v0.4.3 正式包的 Android TV 实机验收(2026-10-16),不是个人电视/EPG 预览或兼容播放实验。节目资料、弹幕与可播放来源以在线服务的实际返回为准。

首页 · 最近观看、横向分类与五列海报

KazumiTV v0.4.3 首页:最近观看入口、横向分类导航与五列海报

播放器 · 真实视频画面、弹幕与遥控控制栏

KazumiTV v0.4.3 播放器:暂停的视频画面、弹幕、进度条与选集和 INFO 按钮

INFO · 当前作品、来源与下一集

KazumiTV v0.4.3 INFO 卡片:作品封面、当前集数、播放来源、下一集与返回播放按钮

截图保留实际界面,仅压缩图片体积;截图来源与说明。截图不代表所有来源、设备或长时间播放均已验证。

0.4.6 手机输入、下载与播放优化

0.4.6 已于 2026-10-30 正式发布,包含已验收的首页焦点优化。

  • 手机输入覆盖更多场景:来源检索、弹幕、剧集数字定位、验证码以及 Bangumi / WebDAV 凭据;先确认文字,再由电视执行搜索、发送或保存。
  • 下载恢复与进度刷新修复:改善中断续传和下载完整性检查,修复并行任务进度刷新,长剧集列表按需创建行。
  • 播放与界面减少重复刷新:合并连续快进退请求,缩小选集栏、缓冲状态、首页和历史的更新范围;控制栏隐藏后停止无效进度刷新,日志按需处理。
  • 首页遥控响应更快:焦点边框立即亮起,缩放和跨行滚动缩短;长按方向键直接定位,减少列表追赶焦点的感觉。
  • 来源与网络处理改善:规则更新失败后可保留、停用或移除;搜索与评论等公开接口支持有界备用切换,修复弹幕取消后的迟到结果和限流提示。
  • Android 9 更新兼容修复:改善下载 APK 的签名读取兼容性。

具体改动及验证范围见 0.4.6 发布说明。性能改动已验证减少重复工作,未量化所有设备的帧率或卡顿改善;备用接口仍可能受网络和服务状态影响。

历史问题:播放界面的“讨论”无法滚动查看(#51),已在 0.4.7 修复。

0.4.5 播放修复

  • 有界跟随后续播放页,并在失败时一次复用近期首帧确认的同集地址缓存。
  • 特定 HHJX 补救按实际故障条件判断,正常解析优先,不按 Android/WebView 版本号推测。
  • 换源提交和失败回滚保持原 UA/Referer;日志容忍非法百分号编码。
  • 发布说明与已测范围。QA/Gecko 实验与规则 overlay 未进入本版。

0.4.4 新功能

以下功能已随 0.4.4 发布。完整变化见 0.4.4 发布说明。

  • 手机就是遥控器:从首页打开配对入口,同一局域网扫码使用方向键、确认、返回、播放/暂停、快进退、上下集和选集,也可输入搜索文字。页面随电视应用使用浅色/深色风格,支持可关闭的按键震动。
  • 记住配对 7 天:电视重新打开应用后可从收藏的网址重连;电视显示在线遥控端数量,可暂停全部连接或取消配对。电视 IP 改变可能需要重新扫码;配对有效期不代表后台保活或待机唤醒。
  • 编号选番、直接续播:首页输入海报编号后稍候,已看番剧尝试续播,无记录则进入详情。主动按确认始终查看详情。播放器选集面板闲置3秒自动收起,操作时重新计时。
  • GitHub 应用更新:正式版自动读取本仓库 Release 和对应架构下载链接,下载后校验,并由系统提示确认安装。
  • 首页缓存与刷新:先显示缓存,冷启动后台刷新;也可手动刷新。失败时保留旧内容和更新时间。
  • 源健康探测(实验功能):可选择将成功来源用于其他番剧的首次选源;先搜索当前作品,未命中或失败返回普通选源,已有观看记录优先续播。
  • 故障更容易排查:解析超时、资源请求错误和播放器异常留下带会话标识的脱敏记录,重试后仍可回查;记录错误不代表自动修复所有来源。

手机遥控 · 浅色首页与深色播放控制

手机遥控浏览器场景预览:数字选番、方向与确认、播放控制、按键震动和7天配对提示

手机图是实际网页代码的浏览器场景预览;场景数据与范围见截图说明。

手机输入怎么用(0.4.6)

  1. 手机与电视连接同一局域网,在电视首页打开「手机遥控」,开启配对并扫码;输入弹窗内的「手机键盘」也可打开配对入口。
  2. 在电视选中要编辑的字段并按 OK,打开编辑框。手机网页会显示当前字段;只移动焦点到字段上不会开始编辑。
  3. 在手机输入文字,点击网页里的 「确认文本」。手机键盘的完成键不等同于网页确认;搜索、检索、发送、定位或保存仍需在电视点击对应按钮。
输入内容 电视上的入口
番剧名称 首页 → 搜索 → 搜索框 → OK
指定来源的检索词 番剧详情 → 重新选源 → 来源右侧「…」→ 修改此来源的检索词 → 输入框
弹幕检索或发送文字 播放控制栏 → 设置 → 弹幕来源/发送弹幕
剧集数字 选集栏顶部「#」→ 定位剧集;原生选集实验开启时,先通过旁边的切换按钮关闭
Bangumi Access Token 我的 → 同步备份 → 连接/管理追番同步 → Access Token
WebDAV 地址、用户名和密码 我的 → 同步备份 → 设置/管理 WebDAV → 连接你的云盘/同步服务器 → 对应字段
规则链接或 JSON 我的 → 规则设置 → 添加规则 → 从剪贴板导入 → 规则内容
来源验证码 检索时遇到需要验证码的来源自动出现,没有固定的手动打开入口

同一台电视、同一次有效配对共用一个手机网址,不同输入框无需分别扫码。选择保留配对后可收藏网址,在有效期内重连;取消配对、配对过期或电视 IP 改变后需重新扫码。配对网址可控制电视,请勿公开分享。

普通文本默认不回读,可在电视配对弹窗临时授权读取;密码和 Token 始终只接收新内容,即使电视切换为明文显示,也不会回传给手机。手机确认文本不会替你连接账号或保存服务器配置。

下载与安装

当前正式版:0.4.7。需要 Android 7.0/API 24 或更新版本,按系统 ABI 选择 APK。

0.4.7 更新电视右侧面板、选源选集及讨论阅读,新增独立弹幕缓存、可选近期视频缓存和手机日志导出。完整范围和验收边界见 0.4.7 发布说明。

安装包 适用系统
ARMv7 32 位 ARM Android
ARM64 64 位 ARM Android
x86_64 x86_64 Android / 模拟器
  1. 下载并侧载 APK,在启动器打开 KazumiTV。
  2. 首次启动按引导准备规则与播放来源,再从作品详情选择来源和剧集。
  3. 方向键移动、确认选择、返回关闭面板或回到上页;播放进度可用左右键调整。

包名为 com.znbsf.kazumi.fluttertv。从 0.4.0 起固定使用正式发布证书;已安装 0.4.0-preview.1 的用户需先卸载预览版再安装,预览版数据不会保留。后续正式版沿用同一证书。 它与原生版、Legacy 和实验版并存;不自动迁移这些旧应用的收藏或历史,详见数据说明。0.4.4 起支持应用内更新:从本仓库 GitHub 正式 Release 自动选择系统支持的 APK,校验哈希、包名、版本与签名后,由你确认系统安装。0.4.3 首次升级仍需从 Release 手动下载安装;QA/preview 不参与正式更新。

已知限制

  • 来源可能失效、超时或需要验证;目录有作品不保证存在可用播放线路。部分番剧元数据可能遇到连接超时。
  • 页面仍可能有长帧,不承诺所有设备60fps。音画确认仅覆盖实测小米电视及所测内容,未进行整集长播或全站点兼容验收。
  • 各版本的候选设备回归、正式签名与升级验收分别记录;ARM64/x86_64 不宣称实机通过,参见当前发布说明。

问题反馈与日志

请使用本仓库的 Bug 反馈表单。填写应用版本及安装包来源、电视/盒子型号、系统版本、复现步骤和预期结果。播放问题还请说明来源名称、线路、集数,以及失败发生在解析、等待首帧还是已经播放之后;无需提供完整播放链接。

从应用内获取

  1. 出错后先记下时间及所在时区、最后一次操作。先保留日志,再重试;获取前不要点击「清空日志」、清除应用数据或卸载。
  2. 打开 设置 → 存储与日志 → 错误日志,选择 复制日志。电视首页的「设置」会先进入「我的」页,再点右上角「设置」进入分类设置;「存储与日志」在左侧靠下的「其他」分组中。当前日志入口不在「关于」页。
  3. 在能够使用该设备剪贴板的编辑器或浏览器中粘贴,检查并脱敏后提交;较长内容可保存为 .txt 附件。电视剪贴板不会自动同步到手机或电脑;需要手机获取日志时,使用下方的手机导出。无法导出时,先附错误日志截图并说明情况,仍可提交 Issue。

0.4.7 起支持手机日志导出(验收范围见 项目状态):在电视错误日志页点 手机导出,按提示连接同一局域网的手机遥控页,展开 问题反馈与日志 → 获取电视日志。检查预览后可 复制日志 或 下载 .txt 文件,再打开页面中的 GitHub 反馈链接粘贴内容或添加附件。若浏览器不允许自动复制,可长按选中文本复制,或使用下载文件。导出快照 5 分钟有效;电视可点 停止导出 提前撤销,清空日志或关闭遥控会话也会撤销。已下载或复制到手机的内容需自行管理。

手机导出按需读取近期应用日志,遮盖常见凭据、完整 URL、账号、设备标识与私有路径,保留版本和时间信息;不会自动向 GitHub 上传。脱敏无法覆盖任意文字中的所有隐私,提交前仍需检查预览。

普通模式会保存警告、错误及主动持久化的播放诊断,不是全部运行日志。日志为空或缺少某段信息不表示故障没有发生;先提交现有证据,无需默认开启播放器调试模式。

日志文件位置

文件名为 kazumi_logs.log,程序使用的路径是 getApplicationSupportDirectory()/logs/kazumi_logs.log。

  • Android 正式包、默认用户的通常路径:/data/user/0/com.znbsf.kazumi.fluttertv/files/logs/kazumi_logs.log,部分系统也显示为 /data/data/com.znbsf.kazumi.fluttertv/files/logs/kazumi_logs.log。
  • QA、实验包或其他系统用户的包名/用户目录可能不同;桌面系统的应用支持目录也由平台决定。优先使用应用内入口,勿按某台开发电脑的绝对路径查找。

Android 上这是应用私有文件,普通文件管理器和 adb pull 通常无权读取,正式 Release 包也通常不支持 run-as。路径用于识别文件,不需要为反馈问题获取 root、卸载或改装调试包。

闪退、卡死或无法进入日志页时

如果已有获授权的 ADB 连接,可在故障后尽快从电脑保存系统日志。先用 adb devices 查看目标,将下面的 DEVICE_SERIAL 替换为对应设备标识;输出文件保存在电脑当前目录:

adb devices
adb -s DEVICE_SERIAL logcat -d -v threadtime > kazumitv-logcat.txt

这会导出设备当前保留的系统日志,不会清空缓冲,也不是复制 kazumi_logs.log。系统日志可能已被覆盖,并可能包含其他应用信息:本地保留原件,只提交与故障时间、KazumiTV 进程或系统崩溃相关的必要片段。没有 ADB 连接时,直接说明「无法获取系统日志」即可。

Issue 和附件公开可见。提交前删除 token、Cookie、账号信息、完整播放 URL(尤其签名参数)、设备标识及私有地址。播放器调试日志和系统日志不能假定已自动脱敏;无法安全处理时,仅提供现象、时间和截图。

来源与许可

感谢 Predidit/Kazumi 及其贡献者,以及 media-kit、Bangumi 和弹弹play 等项目与服务。 代码遵循 GPL-3.0,保留上游版权和许可;第三方依赖及资源按各自许可使用,详见 NOTICE。MiSans 字体版权归 Xiaomi Inc.,遵循其字体协议。节目海报、资料和媒体归各自权利人,本项目不托管影视资源。

原生 0.3.3、Flutter Legacy 与 0.4.0 预览版继续保留;原生完整源码及历史文档可独立查阅。

About

A Kazumi-based anime browser and player for Android TV, optimized for remote controls, with danmaku and phone remote support.

Resources

Stars

45 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages