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

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

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

前言

在复古游戏掌机体验中，精美的游戏封面图能大大提升视觉享受。OnionUI项目内置了封面图抓取工具，但对于大型游戏合集，使用PC端工具效率更高。本文将详细介绍如何为OnionUI项目配置专业的封面图抓取流程。

技术规范

文件格式要求

• 图片格式：PNG
• 最大尺寸：250px(高) × 360px(宽)
• 色彩模式：建议使用RGB模式

存储路径规范

封面图必须放置在特定目录结构中，路径区分大小写：

Roms/<游戏系统>/Imgs

示例路径：

• Roms/FC/Imgs (红白机游戏)
• Roms/SFC/Imgs (超级任天堂游戏)
• Roms/GB/Imgs (Game Boy游戏)

专业抓取工具配置

工具准备

推荐使用Skraper工具，这是一款专业的复古游戏元数据抓取软件，支持多种游戏平台和丰富的元数据源。

初始设置步骤

1. 选择"Recalbox"作为前端类型
2. 勾选"包含非Recalbox游戏文件夹"选项
3. 对于非标准系统名称，需手动添加系统并指定正确的ROM文件夹路径

封面图模板选择

推荐模板

OnionUI项目有专门优化的封面图模板，特点包括：

• 大尺寸缩略图设计
• 清晰的游戏标题显示
• 适配Miyoo Mini屏幕分辨率

模板安装方法：

1. 下载专用模板文件
2. 解压至Skraper安装目录的Mixes子文件夹
3. 在软件中选择"USER PROVIDED MIX"类型
4. 加载解压的模板文件

自定义设置

如需自定义封面样式：

1. 设置图片宽度为250像素
2. 保持图片比例
3. 选择单一图片类型(如仅使用封面图)
4. 对于竖版封面图，可设置高度为360像素

输出配置技巧

1. 输出路径设置为%ROMROOTFOLDER%\Imgs（注意大写I）
2. 勾选"从 节点链接"选项
3. 启用"优化媒体存储"功能
4. 这些设置对后续生成gamelist.xml文件至关重要

最佳实践建议

1. 批量处理：建议按游戏系统分批处理，避免一次性处理过多游戏
2. 命名规范：确保ROM文件名与封面图文件名一致
3. 质量检查：抓取完成后应抽样检查封面图质量
4. 备份策略：建议保留原始抓取数据备份

常见问题解决方案

1. 封面图不显示：检查路径大小写是否正确
2. 图片变形：确认是否保持了原始比例
3. 部分游戏缺失封面：可尝试手动补充或更换数据源
4. 性能优化：大型游戏库建议分多次处理

通过以上专业配置，您可以为OnionUI项目打造一套完美的游戏封面图库，极大提升游戏浏览体验。

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