hiby-modding/hiby-mods

# HiBy Mods 一系列针对 HiBy 数字音频播放器的自定义固件修改集合，以及为了 Mod 社区利益而记录的专有 OTA 固件格式文档。 本项目是 [hiby-modding](https://github.com/hiby-modding) 组织的一部分。另请参阅： - [hiby_os_crack](https://github.com/hiby-modding/hiby_os_crack)，作者 Tartarus6 —— 互补的固件修改项目，包含干净的解包/重打包脚本、QEMU 仿真设置、Windows 支持以及 SOC 硬件文档。 ## 本项目功能 为支持的设备上的 HiBy OS 提供自定义固件构建和修改工具。修改基于原厂固件构建，并以即刷即用的 `.upt` 文件形式分发。 **v1.1 版本当前的修改：** - 字母排序修复 —— 以 “The” 开头的 Albums（专辑）和 Artists（艺术家）现在按后面的单词排序，而不是排在 “T” 下 - 扩展 Unicode 字体支持 —— 增加了对原厂固件中未包含的脚本的渲染。此前不支持的脚本显示为带 X 的方框。 **已知限制：** - 添加的 Unicode 脚本从左到右显示，无论脚本的自然阅读方向如何 —— HiBy OS 文本渲染器不支持双向文本 - 字符以孤立形式出现，互不连接 —— OS 渲染器不支持上下文整形 ## 测试环境 - 设备：HiBy R3 Pro II (r3proii) - 固件版本：current_version=0（2026 年 1 月发布） - 用于构建的宿主操作系统：Ubuntu / Pop!_OS (Linux) ## 快速安装（预构建固件） 如果您只想刷入最新的修改而不想从源代码构建： 1. 从 [Releases](https://github.com/hiby-modding/hiby-mods/releases) 部分下载 `r3proii-v1.1.upt` 2. 验证校验和与发布说明中列出的是否一致 3. 将其复制到 SD 卡的根目录并重命名为 `r3proii.upt` 4. 将 SD 卡插入您的 HiBy R3 Pro II 5. 按住 **音量加** 并按下 **电源** 以进入更新程序 6. 让它刷写 —— 它会显示 “Upgrading...” 然后显示 “Succeeded” 7. 在设备重启前取出 SD 卡（如果可能） 8. 完成 ## 从源代码构建 ### 环境要求 ``` sudo apt install squashfs-tools xorriso fontforge python3-fontforge ``` ### 步骤 ``` # 1. Clone this repository git clone https://github.com/hiby-modding/hiby-mods cd hiby-mods # 2. Download the stock firmware from HiBy's website # Place it at: firmware/r3proii_stock.upt # 3. Run the build script ./tools/build_upt.sh firmware/r3proii_stock.upt firmware/r3proii-custom.upt # 4. Flash the output file as described in Quick Install above ``` ### 构建脚本功能 1. 挂载原厂 `.upt` ISO 并从增量块重组 rootfs 2. 解压 squashfs 文件系统 3. 应用字体修改以扩展 Unicode 脚本支持 4. 使用与原始参数相同的设置重新打包 squashfs 5. 将新的 rootfs 拆分为正确命名和哈希的块 6. 将所有内容打包成有效的 `.upt` ISO 文件 ## 仓库结构 ``` hiby-mods/ ├── README.md ├── docs/ │ └── FIRMWARE_FORMAT.md # Detailed OTA format documentation ├── tools/ │ ├── build_upt.sh # Complete build script │ └── merge_arabic_font.py # Font merging script └── firmware/ ├── r3proii-arabic.upt # v1.0 pre-built firmware └── r3proii-v1.1.upt # v1.1 pre-built firmware (latest) ``` ## 文档 请参阅 [docs/FIRMWARE_FORMAT.md](docs/FIRMWARE_FORMAT.md) 获取以下内容的完整文档： - OTA 更新文件格式 - 块命名和哈希链系统 - Squashfs 构建参数 - 分区布局 - 启动序列 - 字体系统 - 硬件详情 此文档完全通过逆向工程生成，对于任何想要构建进一步修改的人来说可能是有用的。 ## 更新日志 ### v1.1 - 针对原厂固件中未包含的脚本扩展了 Unicode 字体支持 - Albums 和 Artists 的字母排序修复 —— 以 “The” 开头的条目现在正确排序 ### v1.0 - 初始版本 - 记录了 OTA 固件格式 - 概念验证自定义固件构建 ## 免责声明 本固件按“原样”提供，不提供任何保证。刷写自定义固件存在导致设备暂时无法启动的微小风险。如果发生启动循环，您始终可以通过上述的音量加 + 电源方法，刷入 HiBy 网站上的原始原厂固件来进行恢复。 本项目未关联或受认可于 HiBy Music。 ## 贡献 欢迎贡献。以下领域将非常有价值： - 在共享相同固件格式的其他 HiBy 设备上进行测试 - 启用 ADB（守护进程存在但被禁用） - 调查内核源代码的可用性（查看 github.com/hiby-music） - 增加对额外 Unicode 脚本的支持 - GUI 和主题修改 - RockBox 蓝牙/WiFi 集成 - 改进构建流程 ## 致谢 - [@Jepl4r](https://github.com/Jepl4r) —— 字母排序修复 - [@Tartarus6](https://github.com/Tartarus6) —— hiby_os_crack 工具和协作 - Noto Naskh Arabic 字体，作者 Google（OFL 授权） - HiBy Music 制造了出色的设备 - [head-fi.org](https://head-fi.org) 社区 - Reddit [r/hiby](https://reddit.com/r/hiby) 社区

标签：Cutter, DAP, HiBy, HiBy OS, OTA升级, R3 Pro II, Unicode, 云资产清单, 固件修改, 字体支持, 定制固件, 嵌入式固件, 嵌入式开发, 开源硬件, 排序修复, 数字音频播放器, 本地化, 海贝, 逆向工具, 逆向工程, 音频发烧友, 音频设备