OnionUI项目游戏封面图自动抓取指南

OnionUI项目游戏封面图自动抓取指南

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion

前言

在复古游戏掌机体验中，精美的游戏封面图能为游戏库增色不少。OnionUI项目内置了封面图抓取工具，但对于大型游戏库来说，使用PC端工具效率更高。本文将详细介绍如何在OnionUI系统中为游戏自动抓取和配置封面图。

封面图规范

文件格式与尺寸

• 格式要求：PNG格式
• 尺寸限制：最大360像素(宽)×250像素(高)
• 命名规则：与ROM文件同名（仅扩展名不同）

存放位置

封面图必须放置在对应游戏系统的Imgs文件夹中，注意以下几点：

1. 文件夹名称必须为Imgs（首字母大写）
2. 路径结构示例：
   • FC游戏：Roms/FC/Imgs
   • SFC游戏：Roms/SFC/Imgs
   • GB游戏：Roms/GB/Imgs

使用Skraper工具抓取封面

准备工作

1. 下载并安装Skraper工具
2. 登录Skraper账户

基础配置

1. 选择"Recalbox"作为前端系统
2. 勾选"Include non-Recalbox rom folders"选项
3. 对于非标准命名的游戏系统，需手动添加：
   • 点击左下角"+"按钮
   • 选择缺失的系统
   • 在左侧栏中选择添加的系统
   • 在"GAMES & FRONT END"标签页中修正ROM文件夹路径

封面模板选择

推荐方案：使用定制模板

1. 下载专为OnionOS优化的模板文件
2. 将ZIP文件解压到Skraper安装目录的Mixes子文件夹
3. 在"MEDIA"标签页中：
   • 清除"Fetched Media List"中除一项外的所有图片类型
   • 将"Media type"改为"USER PROVIDED MIX"
   • 选择解压后的模板文件
   • 禁用"Resize width to"、"Resize height to"和"Keep Image Ratio"选项

自定义方案

1. 在"MEDIA"标签页中：
   • 启用"Resize width to"并设置为250
   • 启用"Keep Image Ratio"
   • 移除不需要的图片类型
2. 可调整图片混合样式：
   • 推荐使用"Screenscraper's Recalbox Mix V2"
3. 对于竖版封面图：
   • 设置"Resize height to"为360
   • 禁用"Keep Image Ratio"

输出设置

1. 设置"Output folder"为%ROMROOTFOLDER%\Imgs
2. 在"Gamelist Link"中确保：
   • "Link from node ' '"已勾选
   • "Optimize media storage"已启用
3. 选择要抓取的系统或"all system"
4. 点击右下角播放按钮开始抓取

高级技巧

封面图优化建议

1. 对于不同游戏系统，可创建不同的模板
2. 建议定期清理重复或低质量的封面图
3. 可手动调整不满意的封面图后再放入Imgs文件夹

常见问题解决

1. 封面图不显示：
   • 检查文件名是否与ROM文件完全一致
   • 确认Imgs文件夹名称大小写正确
2. 封面图质量差：
   • 尝试更换数据源
   • 调整模板参数

视频教程参考

1. RetroBreeze的教程：展示了两种为Miyoo Mini添加精美封面图的方法
2. TechDweeb的教程：详细演示了在Onion OS上使用Skraper的完整流程

通过以上步骤，您可以为OnionUI系统的游戏库添加专业级的封面图展示，大幅提升游戏浏览体验。建议先对小批量游戏进行测试，确认效果满意后再进行大规模抓取。

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion