YukiHub
YukiHub 是一款面向 Android 平台的 Galgame/视觉小说管理与启动工具，适合用于管理本地游戏、安卓应用型，模拟器游戏入口、外部程序快捷方式以及游玩记录。
它的目标是把“游戏库管理、快捷启动、数据同步、资料查询”整合到一个统一的移动界面中。
同时欢迎各位开发者积极构建不同的分支版本，作为移动端的第一个 gal 前端，还有很多不足，一起加油喵(⌯ᵔᗜᵔ⌯)/
本项目采用 GPL-3.0 开源协议。
宣传海报(一眼看懂 YukiHub)
特性
- 多种导入方式：支持手动添加、批量导入文件夹以及从第三方平台迁移（如 Playnite、PotatoVN、Vnite、LunaBox）。
- 类 steam 的社交在线服务，在这里，你可以与好友尽情享受 Gal 的快乐，并且可以像 steam 一样记录时长，并且查看好友的游玩动态，以及正在游玩的游戏
- 支持鲲 Galgame、Hikarinagi 第三方账号快捷登录与绑定
- 支持好友聊天、游玩动态、在线状态等社交功能
- 集合了 VNDB、Bangumi、月幕 Gal、Hikarinagi 的游戏资料刮削源
- 拥有一个相对来说比较完整的 ocr 翻译功能，可以让你在游玩 gal 的途中，减少硬啃生肉游戏的烦恼，可以自选多种翻译 api，并且支持高自由度的 api 自定义设置(原项目来自MoeTranslate(萌译))
- 支持添加、编辑、删除游戏条目，并且支持多选和一键清空
- 支持目录为空的游戏条目
- 适用于安卓应用型游戏、外部程序、自定义启动项
- 支持 GameHub 快捷方式导入
- 快捷方式列表支持图标显示
- 支持搜索筛选
- 支持多种启动方式
- 支持本地游戏、安卓应用型条目和外部启动入口
- 支持游戏同步与导入导出
- 支持游戏条目同步
- 支持游玩记录同步
- 支持空目录条目的匹配与恢复
- 支持设置内查看完整免责声明
- 支持游戏库快速 / 兼容双扫描模式（设置内可选）
- 支持应用图标切换（设置内可选，默认新图标）
- 支持内置 Web 社区（动态发布、评论、游戏评价、关注与收藏）
- 深色风格界面，适合横屏使用
项目定位
YukiHub 更偏向于一个 本地游戏管理中心，而不是单纯的游戏启动器。
它适合以下场景：
- 管理本地安装的游戏
- 管理安卓应用型游戏条目
- 管理外部启动入口
- 统一整理快捷方式
- 记录和同步游玩记录
- 在多设备之间迁移游戏数据
核心功能
1. 游戏管理
支持添加、编辑、删除游戏条目，并对不同类型的启动项进行统一管理。
2. 空目录条目支持
对于不需要本地目录的游戏或应用入口，可以不强制填写目录。
这对于以下场景尤其有用：
- 直接启动安卓应用
- 使用包名启动的条目
- 外部程序入口
- 自定义快捷启动项
3. GameHub 快捷方式导入
支持从 GameHub 中导入快捷方式，并提供：
- 图标显示
- 搜索筛选
- 更清晰的列表选择体验
4. 同步功能
支持游戏数据与游玩记录的同步导入导出，适合本地备份或多设备迁移。并且支持☁️WebDAV 云同步功能。
同步时会尽量根据以下信息进行匹配：
- root 路径
- 本地 ID
- 游戏标题
对于空目录条目，会优先按标题进行匹配。
5. 游戏时长记录
- 当前的游戏时长记录模式为，从软件点击启动对应游戏后，开始计时，直到你回到软件前台，计时结束，中途后台掉了也没关系，重进软件也能记上。(但是，别因为好奇玩一半又回到前台然后直接回游戏，这样你后半段时间就不算了，你得重新在软件里进游戏才行)
6. 游戏资料刮削
- 支持从 VNDB、Bangumi、月幕 Gal、Hikarinagi 等源获取封面、简介、标签与角色信息， 可在设置中选择资料源与显示优先级，刮削结果可本地缓存，供离线查看。
7. 应用图标切换
- 可在首页设置的「应用图标」中切换桌面图标（新图标 / 经典图标）， 切换后桌面图标可能需要稍后刷新，属于本机个性化设置，不参与云同步。
截图
主界面
同步页面
游戏详情页
教程区
导入 Winlator 和盖世的游戏并直启动
- 注:
- winlator 模拟器改包是在 hostei2 大佬的改版的基础上将 XServerDisplayActivity exported=false 改为 android:exported="true"，对外公开活动进行的直启。
- 盖世游戏是在原版 5.3.5 的基础上进行了 mt 文件提取器注入以及活动公开的操作，就是将 AndroidManifest 的 android:name="com.xj.landscape.launcher.ui.gamedetail.GameDetailActivity" 加上或者改成 android:exported="true" 。
使用 WebDAV 进行数据云同步的教程
目前已知的问题
1.目前用 tf 疑似不能直启动 krkr 的游戏(截止 0.125+3 版本，已修复，在运行 sd 卡游戏时，自动开启镜像目录运行游戏，存档和独立存档模式位置一致)
2.华为等手机由于存储读写限制，不能正常游玩 krkr，atermis 等引擎的游戏。(现在做了外部私有存档选项，可以勾选试试，或许有用?还做了轻量级 SAF🤔，就是不知道有没有用了，得看你们测试了)(功能入口如下图↓) ✓ (截止 0.12.5+1 版本，已修复，如仍有问题请反馈)
-以上，欢迎有能力的拉拉 pr 喵😽😽😽
交流群
欢迎加入 QQ 交流群和 QQ 频道，反馈问题、提建议或一起讨论功能。
使用前说明
本项目内置免责声明机制，首次启动时需要勾选同意后才能继续使用。
请确保你仅用于管理和启动你有权使用的游戏、应用或资源。
本项目不提供：
- 游戏本体
- 破解资源
- 绕过授权的能力
- 任何违规用途的支持
系统要求
- Android 8.0 及以上
- 横屏体验更佳
- 需要部分文件访问权限
- 部分功能可能依赖系统兼容性或第三方组件支持
- 部分功能（第三方登录、社区、刮削）需要网络环境
- 游戏启动依赖第三方引擎与系统兼容性
权限说明
本应用可能会请求以下权限：
- 文件读写权限
- 全盘文件访问权限
- 网络权限
用途说明：
- 文件权限：用于读取和管理游戏文件、目录与配置
- 网络权限：用于同步、联网资源或相关功能
- 全盘访问：用于某些目录型游戏管理场景
请仅在你明确理解并接受用途时授予权限。
安装方式
方法 1：直接安装 APK
从 Releases 页面下载 APK 并安装。
方法 2：自行编译
如果你想自己编译项目，请确保你已安装：
- Android Studio
- Android SDK
- Gradle 环境
然后打开项目并执行构建。
构建信息
- Application ID:
com.yuki.yukihub - Min SDK:
26 - Target SDK:
33 - Compile SDK:
33 - 当前版本：
0.1
已知说明
- 项目当前处于开源发布前后的持续打磨阶段
- 部分同步或云功能依赖外部服务可用性
- 某些兼容入口依赖设备环境与第三方应用支持
开源协议
本项目采用 GNU General Public License v3.0 (GPL-3.0) 开源。
你可以：
- 自由使用
- 自由修改
- 自由分发
- 在 GPL-3.0 约束下进行二次开发
请在遵守 GPL-3.0 协议的前提下使用本项目源码。
免责声明
本项目仅用于合法用途。
作者不对以下情况负责：
- 用户自身操作失误
- 第三方资源问题
- 系统兼容性问题
- 第三方服务不可用
- 由用户使用本软件产生的任何违规行为
请确保你仅用于管理和启动你有权使用的软件、游戏或资源。
致谢
感谢参考和学习的项目：
- krkr2
- Tyranor
- Beacon
- LunaBox
- Playnite
- OnscripterYuri
- ppsspp
- MoeTranslate(萌译)
也感谢所有参与测试、反馈和建议的用户。
❤️ Special Thanks
特别感谢所有 Contributors 对 YukiHub 的贡献 ❤️
相关项目 / 生态 (Related Projects)
- Rinne Mobile：Rinne Mobile 是本项目的一个分支，主攻移动端竖屏 ui，同时，这是一个 YukiHub 重构 开发 的版本，使用更加现代化的技术栈与 MVVM 架构，目前正在三次重构向 kotlin 迁移。
- KamiGAL：无意间发现的一个 YukiHub 分支，感觉很有意思，便收录进来，好像还打算做 ios 版本，不过好像已经停止更新。令人感叹。
- KireiBox：KireiBox 是基于 YukiHub 的 RinneMobile 分支开发。并在 ui 设计上独具创新，颇有一番风味，个人感觉在横屏模式的 ui 下，非常好看，值得一用。
感谢以上所有项目的开发者，他们的工作为这个生态增添了更多可能性。同时也希望未来这个生态里能有更出色的项目，这里也会收录。
反馈与贡献
如果你在使用过程中遇到问题，欢迎提交 Issue 或 Pull Request。
你也可以在提交反馈时附上：
- 设备型号
- Android 版本
- 问题截图
- 复现步骤
- 日志信息
这样更方便定位问题。
