8000 GitHub - Dr-TSNG/fancyboot: Mountless Android boot animation module · GitHub
[go: up one dir, main page]

Skip to content
Dr-TSNGPublic

About

Mountless Android boot animation module

Resources

Stars

22 stars

Watchers

0 watching

Forks

Repository files navigation

fancyboot

让 Android 的开机画面显示实时日志,或播放自己的 bootanimation.zip。

屏幕上半部分显示内核日志,下半部分显示 Android 日志(logcat)。两路日志独立滚动,按级别着色,并自动换行。你可以在 WebUI 中调整显示效果,也可以直接在手机上预览,不必为了试一个字号反复重启。

fancyboot 通过 Zygisk Next 接管系统开机动画,不修改系统文件,也不需要挂载。

使用要求

  • Android 17、arm64 设备:目前安装器只支持这一组合。
  • 已获取 Root,并使用支持模块安装的管理器。
  • Zygisk Next 1.5.0 或更新版本,安装后保持启用。

目前已在 Xiaomi nezha(HyperOS 4 / Android 17)、KernelSU 和 Zygisk Next 1.5.0 上验证。其他 ROM、Magisk 和 APatch 尚未完成实机测试。

安装

  1. 安装并启用 Zygisk Next。
  2. 在 Root 管理器中安装 fancyboot-0.5.0-arm64.zip。
  3. 重启手机,让模块生效。
  4. 从管理器打开 fancyboot 的 WebUI,调整设置后保存。

安装或升级模块后需要重启一次;之后修改显示设置,只需保存并预览。

调整显示效果

WebUI 支持简体中文和 English,默认跟随系统语言,其他语言回退为英文。右上角可以手动切换,选择会自动记住;切换语言不会丢失未保存的表单或 TOML。

顶部选择实时日志或 ZIP 动画模式。WebUI 中的设置分为三页:

页面 可以调整的内容
实时日志 日志字号、边距、区域比例、刷新上限,以及内核与 logcat 开关、最低级别、历史容量和缓冲区
动画 导入、选择、删除动画包,查看尺寸、帧数和校验状态
TOML 直接编辑、校验和保存配置文本

日志使用 JetBrains Mono Regular 字体。字号可以在 8–48 px 之间逐像素调节,这里的 px 是手机屏幕的物理像素。默认字号为 20 px,刷新上限为 30 Hz。

保存设置后,在 实机预览 中选择时长并点击开始。手机会短暂显示选定的日志或动画,到时自动返回原来的界面;这个操作不会重启 Android。

启动日志画面目前仅支持 ASCII 字符,中文等未支持的字符会显示为 ?。关闭一路日志后,它的区域会保留并显示 Disabled;在日志模式下关闭两路,或关闭模块开关后,会使用系统原来的动画。

手动编辑配置

配置保存在:

/data/adb/fancyboot/config.toml

例如,把字号设为 15 px,并将 60% 的日志区域分给内核:

version = 1

[log.display]
font_size_px = 15
split_ratio = 0.6

version 是配置格式版本,当前为 1,与模块版本号无关。省略时按 1 读取;不支持的版本会报错,保存失败时保留原文件。

font_size_px 直接填写像素字号,未填写的字段使用默认值。修改已有文件时,调整对应的 [log.display] 段即可,不要重复添加同名段。

卸载会保留这个配置文件和自备的动画包。当前配置只接受新的结构,不提供迁移或旧字段别名。

使用 bootanimation.zip

在 WebUI 的 动画 页点击 从文件导入 ZIP,确认保存文件名后开始导入。导入完成后点击对应动画的 选择,再 保存配置,即可预览或在下次启动时播放。

大文件建议使用 从设备路径导入,例如 /sdcard/Download/bootanimation.zip。这会在设备上直接复制到动画库并校验一次,保留原文件。文件选择器则以 64 KiB 分块上传,显示进度并支持取消,不会将整个 ZIP 读入 JavaScript 内存。导入完成前保持 WebUI 打开。

所有动画必须直接存放在 /data/adb/fancyboot/animations/ 下,不能使用子目录、符号链接或硬链接。同名文件不会被覆盖;需要替换时先另存一个文件名。动画库可重新校验或删除文件,已保存选中的文件需要先切换选择并保存才能删除。手动放入目录或被外部修改过的 ZIP,必须点击 检查 后才能使用。

version = 1
enabled = true
mode = "animation"

[animation]
path = "/data/adb/fancyboot/animations/bootanimation.zip"

日志配置位于 [log.display]、[log.kernel] 和 [log.logcat],与 [animation] 同时保存;切换模式不会丢失另一种模式的设置。默认仍为 mode = "log"。

动画包遵循 Android bootanimation 格式:根目录含以换行结尾的 desc.txt,分段目录内的 PNG 帧使用 ZIP STORE(不压缩)。支持 p、c、f 分段和 $SYSTEM;音频、裁剪、循环、淡出和正常启动结束行为交给系统播放器处理。动画模式的限时预览会在到期后退出。

文件与解压后的总大小均不得超过 4 GiB。导入或手动检查时校验结构与帧的 ZIP CRC,将文件设为 root 所有、0400 权限和 u:object_r:system_file:s0 标签,并记录文件元数据。动画目录为 0700;不修改全局 SELinux 规则。

播放时只核对文件元数据,通过现有 ZN socket 的 SCM_RIGHTS 传递磁盘文件的只读 FD,系统播放器直接映射同一个 inode。启动时不会整包复制到内存或重复扫描全部帧;图像解码仍会消耗系统播放器所需的内存。删除操作只解除目录项,不截断已经打开的文件。读取失败、未校验或文件发生变化时保留系统动画。兼容性依赖 ROM 提供 ZipFileRO::open/openFd 和相应播放器入口。

su -c '/data/adb/modules/fancyboot/bin/fancybootctl check-animation'
su -c '/data/adb/modules/fancyboot/bin/fancybootctl animations list'
su -c '/data/adb/modules/fancyboot/bin/fancybootctl animations import /sdcard/Download/bootanimation.zip --name custom.zip'
su -c '/data/adb/modules/fancyboot/bin/fancybootctl animations check custom.zip'
su -c '/data/adb/modules/fancyboot/bin/fancybootctl animations remove custom.zip'

check-animation 检查已保存的路径,也可传入动画库内其他 ZIP 的完整路径。CLI 导入后仍需在 WebUI 选择并保存配置。

常见问题

仍然显示原来的开机动画?

先确认 Zygisk Next 和 fancyboot 都已启用,日志模式至少打开了一路日志;动画模式已设置有效的动画包,并且安装或升级后已经重启。如果问题仍在,可以在 WebUI 的“诊断”中运行自检,再查看模块日志:

su -c 'logcat -d -s fancyboot'

当前版本依赖 ROM 的开机动画实现,因此不保证所有 Android 17 设备都能使用。启动时先短暂显示原动画,再切换到日志,是正常现象。

想恢复系统动画?

在 WebUI 中关闭“启用 fancyboot”并保存即可。也可以在 Root 管理器中禁用或卸载模块,然后重启。

管理器里没有 WebUI 入口?

KernelSU 可以直接打开模块 WebUI。其他管理器需要支持兼容的 WebUI 接口;没æœ 5B1A ‰入口时,也可以手动编辑配置文件,并通过命令预览 8 秒:

su -c '/data/adb/modules/fancyboot/bin/fancybootctl preview 8'

从源码构建

需要 Python 3.11+、Rust 1.88+ 和包含 API 35 的 Android NDK(已验证 r29)。运行完整检查还需要 Node.js 18+;Windows 下的 shell 转义检查使用 Git Bash。无需安装 npm 依赖。

rustup target add aarch64-linux-android
python build.py check
python build.py zip

安装包输出到 dist/。目标架构与链接 API 位于 project-config.json。脚本默认选择 SDK 目录中满足要求的最新 NDK,无需配置固定版本;也支持 ANDROID_NDK_HOME / ANDROID_NDK_ROOT,或用 --ndk 指定路径或已安装的版本号:

python build.py --ndk /path/to/android-ndk-r29 zip

NDK 用来提供 Android 链接工具和系统库。当前代码使用 Rust std 并链接 EGL、GLES、log 与 libc,因此不能仅靠 rustup target add 完成构建。某些项目通过工具或 CI 自动准备 NDK,所以使用时看不到手动配置步骤。参见 Rust Android 目标说明和 Android NDK 构建指南。

已连接 ADB 的设备可以直接安装,或运行已安装模块的预览:

python build.py flash
python build.py preview --seconds 8

fancybootctl --help 可查看配置、预览与自检命令;preview --help 可查看预览参数。CLI 和 WebUI 不提供重启操作。

更多构建参数见 python build.py --help,实机测试范围和结果见验证记录。

About

Mountless Android boot animation module

Resources

Stars

22 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0