retroarch 中文文档 下载 App

封面图与缩略图 三种类型、下载方法、路径规则

三种缩略图

RetroArch 支持三种游戏缩略图,根据你使用的菜单驱动和设置,可能显示其中一种或多种:

类型说明示例
Boxart游戏包装盒封面图一张游戏封面图,类似手机应用商店的图标
Title Screen游戏标题画面截图游戏启动时显示的标题画面
In-Game游戏内画面截图实际游玩时的画面

Ozone 默认优先显示 boxart,在列表条目下方可以看到 title 和 in-game 的小缩略图。RGUI 不支持缩略图,GLUI 支持 boxart。

批量下载缩略图

Online Updater → Update Playlist Thumbnails 是全量下载入口——会为所有扫描过的主机列表下载全套缩略图包(每个主机一个 zip 包,解压到 thumbnails 目录)。

Online Updater → Update Playlist Thumbnails Updater 更灵活——可以按列表单独下载,只挑你玩的那几个主机,省时间和空间。

下载过程可能很慢(特别是 PS1 这样大主机的缩略图包可能几百 MB),网络不好时耐心等。

缩略图路径规则

缩略图保存在 RetroArch 的 Thumbnails 目录下,按数据库名分子文件夹:

thumbnails/
  Nintendo - Game Boy Advance/
    Named_Boxarts/
      Pokémon Emerald (USA).png
    Named_Titles/
      Pokémon Emerald (USA).png
    Named_Snaps/
      Pokémon Emerald (USA).png
  Sony - PlayStation/
    Named_Boxarts/
      ...

每个子文件夹的命名规则是 游戏名.png——必须和播放列表里的游戏名精确匹配(包括空格、括号、标点),否则 RetroArch 对不上。这也是为什么严格扫描(No-Intro 数据库匹配)比手动扫描好——手动扫描生成的条目名可能和缩略图文件名差太远,对不上。

自己添加缩略图

如果官方缩略图包里没有某款游戏的图,或你想用自己截的图:

  1. 找到这款游戏对应的数据库名文件夹(在 thumbnails 目录下按主机名找)
  2. 找到或新建对应的缩略图子文件夹(Named_Boxarts / Named_Titles / Named_Snaps)
  3. 把图片重命名成和播放列表里的游戏名完全一致,扩展名 .png
  4. 重启 RetroArch(或刷新播放列表)

缩略图缺失怎么办

扫描后列表里游戏条目没有封面(显示灰格子)的原因:

原因解决
没下载缩略图包Online Updater 里下载
下载了但文件名对不上严格扫描重扫(让条目名变成 No-Intro 标准名),或手动改缩略图文件名
数据库里就没有这款游戏的图手动添加自己的截图

手动扫描列表的缩略图

手动扫描生成的列表条目名不一定符合 No-Intro 标准——这种情况下缩略图大概率对不上。解决方案: