Skip to content

Repository files navigation

YukiHub

YukiHub

官网

简体中文 | English

使用指南-web | 使用指南-md

Android GPL-3.0 Downloads 最新版本

YukiHub 是一款面向 Android 平台的Galgame/视觉小说管理与启动工具,适合用于管理本地游戏、安卓应用型,模拟器游戏入口、外部程序快捷方式以及游玩记录。

它的目标是把“游戏库管理、快捷启动、数据同步、资料查询”整合到一个统一的移动界面中。

同时欢迎各位开发者积极构建不同的分支版本,作为移动端的第一个gal前端,还有很多不足,一起加油喵(⌯ᵔᗜᵔ⌯)/

本项目采用 GPL-3.0 开源协议。


宣传海报(一眼看懂YukiHub)


特性

  • 多种导入方式:支持手动添加、批量导入文件夹以及从第三方平台迁移(如 PlaynitePotatoVNVniteLunaBox)。
  • 类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 和盖世的游戏并直启动

Bilibili Tutorial GitHub Download

  • 注:
    • 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 进行数据云同步的教程

WebDAV Tutorial


目前已知的问题

  • 1.目前用tf疑似不能直启动krkr的游戏(截止0.125+3版本,已修复,在运行sd卡游戏时,自动开启镜像目录运行游戏,存档和独立存档模式位置一致)

  • 2.华为等手机由于存储读写限制,不能正常游玩krkr,atermis等引擎的游戏。(现在做了外部私有存档选项,可以勾选试试,或许有用?还做了轻量级SAF🤔,就是不知道有没有用了,得看你们测试了)(功能入口如下图↓) ✓ (截止0.12.5+1版本,已修复,如仍有问题请反馈)

-以上,欢迎有能力的拉拉pr喵😽😽😽


交流群

QQ Group

QQ Channel

欢迎加入 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 协议的前提下使用本项目源码。


免责声明

本项目仅用于合法用途。

作者不对以下情况负责:

  • 用户自身操作失误
  • 第三方资源问题
  • 系统兼容性问题
  • 第三方服务不可用
  • 由用户使用本软件产生的任何违规行为

请确保你仅用于管理和启动你有权使用的软件、游戏或资源。


致谢

感谢参考和学习的项目:

也感谢所有参与测试、反馈和建议的用户。


❤️ Special Thanks

特别感谢所有 Contributors 对 YukiHub 的贡献 ❤️

开源伙伴 ❤️

  • Rinne Mobile - 雷圣出品,必属精品,大幅重构过的分支版本,对竖屏非常友好,ui也吊打YukiHub,qwq

相关项目 / 生态 (Related Projects)

  • Rinne Mobile:Rinne Mobile是本项目的一个分支,主攻移动端竖屏ui,同时,这是一个 YukiHub 重构 开发 的版本,使用更加现代化的技术栈与MVVM架构,目前正在三次重构向kotlin迁移。
  • KamiGAL:无意间发现的一个YukiHub分支,感觉很有意思,便收录进来,好像还打算做ios版本,不过好像已经停止更新。令人感叹。
  • KireiBox:KireiBox 是基于 YukiHub 的 RinneMobile 分支开发。并在ui设计上独具创新,颇有一番风味,个人感觉在横屏模式的ui下,非常好看,值得一用。

感谢以上所有项目的开发者,他们的工作为这个生态增添了更多可能性。同时也希望未来这个生态里能有更出色的项目,这里也会收录。


反馈与贡献

如果你在使用过程中遇到问题,欢迎提交 Issue 或 Pull Request。

你也可以在提交反馈时附上:

  • 设备型号
  • Android 版本
  • 问题截图
  • 复现步骤
  • 日志信息

这样更方便定位问题。


License

GPL-3.0

About

YukiHub is a Galgame management tool for Android that supports synchronization of local games, shortcuts, and play records. The project uses the GPL-3.0 open-source license.

Resources

Contributing

Stars

477 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages