#rom #mame #roms

bin+lib roms-curator

管理 ROM 集合的辅助工具。目前仅适用于 MAME ROM。

3 个版本

0.1.5 2023 年 8 月 3 日
0.1.2 2023 年 2 月 13 日
0.1.1 2023 年 2 月 8 日

#1739 in 命令行工具

自定义许可

66KB
1.5K SLoC

roms-curator

License: MIT CI crates.io


管理 ROM 集合的辅助工具。目前仅适用于 MAME ROM,例如创建仅包含可工作的 ROM 集合。

可能的用途可能包括

  1. 作为创建新的 ROM 集合的应用程序,分离可工作和不可工作的 ROM(包括 CHD)

  2. 如果您想对整个收藏品进行分类并对其进行处理,则作为库使用。

索引

需求/依赖

此程序有 2 个外部依赖项,但未包含在此处,但很容易获得

  • MAME ROM 数据库(xml 文件)
    • 这里 下载 MAME。请记住,您需要与您的 ROM 集合版本对应的版本。
    • 然后提取数据库
      mame.exe -listxml > mame-roms.xml
      
  • ROM 类别文件
    • MAME 不对 ROM 进行分类(有些例外),为了分类 ROM,我们需要一个 MAME 支持文件 文件,可以从 这里 下载。
    • 下载适合您的 ROM 集合版本的包并提取 catver.ini 文件。

这是如何工作的

roms-curator 将使用 mame.xmlcatver.ini 和一些自定义逻辑(来自试错)来遍历您的 ROM 收藏,并对所有具有 workingnot-working 状态以及特定子类别(如 ROM/游戏的类型(bios、系统、机械等))的 ROM 进行分类。从这里,它将您的 ROM 复制到指定 destination_dir 中的子目录。

它还可以生成一个包含所有已复制文件和/或遇到的错误的报告。

子目录包括

  • working:所有处于可工作/可玩状态的 ROM 文件(不包括具有 CHD 依赖关系的 ROM)。
  • other:所有不在可工作/可玩状态的 ROM 文件(不包括具有 CHD 依赖关系的 ROM)。这也包括 bios、系统、赌场、机械以及其他不可玩的 ROM。
  • chd_working:所有 CHD 和依赖 CHD 文件的 ROM 在可工作/可玩状态。
  • chd_other:所有 CHD 和依赖 CHD 文件不在可工作/可玩状态的 ROM。

将这些ROM分类到这些子文件夹中,将允许您仅将可工作的ROM(工作文件夹)导入到您的mame前端,同时通过将所有目录添加为ROM目录,仍然允许MAME可执行文件访问所有ROM(这是由于ROM依赖性,例如,一个可工作的ROM需要BIOS ROM或CHD ROM才能正常工作)。

您还可能想要减小您的收藏集大小,而不会破坏任何内容的一种方法就是删除不可工作的CHD目录。完整的CHD文件集可达到500+ GB

应用程序运行说明

请参阅这里

构建说明

请参阅这里

库使用说明

请参阅这里

常见问题解答

请参阅这里

帮助

如果您遇到任何问题,请随时打开一个问题

  • 您遇到任何问题;
  • 文档材料中缺少某些内容或难以理解;
  • 有任何改进建议或功能请求。

计划在未来(也许)进行

  • 添加自动下载依赖项(mame xml和catver.ini)的选项。
  • 验证ROM集完整性。

依赖项

~11–20MB
~264K SLoC