把卡带和光盘，重新摆回架子上。

复古猫是一款本地优先的 Android 复古游戏前端。选一个 ROM 目录就能开始，用手柄浏览每台游戏机原本的包装和介质，再用插件、主题和平台包扩展成你想要的样子。

下载复古猫阅读 Wiki

Android 8.0 及以上 · 3DS 存档同步程序另行提供

网页重现的 App 界面，不是实机截图。包装盒是 App 的同款模型，可以拖动查看。这里的游戏都是虚构的演示内容，封面由 AI 绘制。

35个机种的包装与介质模型

4种内置语言，可自动匹配

3种界面风格，主题可扩展

0个账号，不配置网盘也能用

每台机器，都有它自己的盒子

纸盒、塑料盒、珠宝盒、卡带和光盘分别建模，默认采用日版造型。内置 35 个机种，封面会贴到实物比例的 3D 模型上。

任天堂: Famicom · Famicom Disk System · Super Famicom · Game Boy · Game Boy Color · Game Boy Advance · Nintendo 64 · GameCube · Wii · Wii U · Nintendo DS · Nintendo 3DS · Nintendo Switch
世嘉: Master System · Mega Drive · Mega CD · SEGA 32X · Game Gear · SEGA Saturn · Dreamcast
索尼: PlayStation · PlayStation 2 · PlayStation 3 · PSP · PS Vita
SNK: NEO GEO · NEO GEO CD · NEO GEO Pocket · NEO GEO Pocket Color
NEC: PC Engine · PC Engine CD
万代: WonderSwan · WonderSwan Color
微软: Xbox · Xbox 360

选一次目录，剩下的交给它

选择 ROM 总目录
按目录名、索引和明确的扩展名发现机种，无法判断的目录才询问你。
自动匹配媒体
同名图片和视频自动归位，也可以读取 ES-DE、Pegasus、LaunchBox 的已有索引。
按下 A 开始游戏
通过模拟器的公开入口启动：RetroArch、PPSSPP、Dolphin、DuckStation、Azahar 等。

存档跟着你走，版本由你做主

通过 WebDAV 或百度网盘同步 ROM、媒体和存档。存档由你主动同步，出现分叉时由你选择；每个版本都保存在你自己的网盘里，可以随时恢复。

局域网一键配置，新设备不用重新填写账号。

了解存档同步

手柄优先，也适配各种屏幕

方向键只在封面间移动，肩键切机种，扳机键切页面，按键可以重新映射，A/B 确认方向也能互换。界面以 16:9 设计，同时适配 4:3、1:1 和双屏掌机。

插件系统

不只是前端，也是一个平台

插件是真正能运行的程序：一段后台脚本加几个网页，通过公开的 SDK 调用复古猫的能力。不用改主程序，也不用重新打包 APK。

能做真正的功能
读写游戏资料、收藏和最近记录，管理媒体关联，把字段随索引同步，调用网络，读写网盘里的 JSON，为 ROM 同步增加资源，自定义启动入口。
有自己的界面
用 HTML、CSS 和 JavaScript 写页面，框架随你选。页面在复古猫的导航里打开，配色跟随主题，手柄方向键可以移动焦点。
权限由玩家决定
插件要先声明能力，玩家同意后才能启用。更新时新增能力，插件会保持停用，直到玩家再次同意。联网必须声明主机。
不拖慢游戏
启动游戏不等待插件。后台脚本在隔离的引擎中按需运行，任务结束后释放，关闭页面也不会中断任务。
发布不用等我
每个人都能用自己的 GitHub 仓库发布。玩家添加仓库地址后，就能在商店看到更新、版本和作者。

plugin.json

{
  "id": "example.hello",
  "version": "1.0.0",
  "entryPoint": "main.js",
  "capabilities": ["LIBRARY_READ"],
  "pages": [{ "id": "main", "path": "index.html" }],
  "actions": [{ "id": "count" }]
}

main.js

retromao.define({ actions: {
  async count() {
    const page = await retromao.library.records({ limit: 200 });
    await retromao.tasks.progress(page.games.length);
    return { total: page.games.length };
  }
} });

安装“收藏同步”？这个插件需要以下能力：

读取和修改游戏库
使用你允许的网盘连接

同意并启用

插件系统开发插件 RetroMao-Community

现在就能在商店安装

这些插件都用同一套公开 SDK 开发，也是可参考的示例。

收藏同步通过已配置的网盘同步收藏，不传输 ROM、媒体或存档。
最近游戏记录同步同步最近游玩时间、次数和时长。
拼音首字母搜索用拼音首字母搜索游戏和应用，例如 jsq 搜索计算器。
Vita3K ROM 同步同步 Vita3K 的游戏本体、补丁、DLC 和许可。
自定义启动入口选择平台并自定义模拟器启动参数。

四种扩展方式

扩展都放在公开的 GitHub 仓库里，开发时不需要主程序源码。

准备好把游戏摆上架了吗？

下载复古猫

复古猫不附带任何游戏 ROM、BIOS 或模拟器。

把卡带和光盘，重新摆回架子上。

每台机器，都有它自己的盒子

选一次目录，剩下的交给它

选择 ROM 总目录

自动匹配媒体

按下 A 开始游戏

存档跟着你走，版本由你做主

手柄优先，也适配各种屏幕

不只是前端，也是一个平台

能做真正的功能

有自己的界面

权限由玩家决定

不拖慢游戏

发布不用等我

现在就能在商店安装

四种扩展方式

准备好把游戏摆上架了吗？