usfjrain/RaineyWrapper

选用指南

AI 根据 README 整理 · 2026/11/4 20:27:16

适用场景

适用于将合法获得的游戏备份或自制软件转换为独立Android应用，在掌机上直接游玩，支持多种游戏系统。

查看 README 依据

<p align="center"><img src="App image.png" width="180" alt="RaineyWrapper icon"></p> # RaineyWrapper Turn your game backups into standalone Android apps. Each game gets its own icon on your home screen and boots straight into the game: no frontend, no menus. Made for Android gaming handhelds (Retroid, AYN Odin, Anbernic and similar), and works on any 64-bit Android 8.0+ device. Games are converted **on the device itself** with the RaineyWrapper app, or on a computer with the command-line builder. > No games, BIOS files or other copyrighted content are included. Use your own legally

> obtained game backups or homebrew. ## Supported systems | System | Emulator inside each game app | Files | |---|---|---| | Game Boy Advance / Game Boy / Game Boy Color | mGBA | `.gba .gb .gbc` | | Super Nintendo | bsnes | `.sfc .smc` | | Genesis / Mega Drive | ClownMDEmu | `.md .gen .bin` | | Master System / Game Gear | SMS Plus GX | `.sms .gg` | | PlayStation | PCSX ReARMed | `.cue .chd .pbp` | | Nintendo 64 | Mupen64Plus-Next | `.z64 .n64 .v64` | | PSP | PPSSPP | `.iso .cso` | | Dreamcast | Flycast | `.chd .cdi .gdi` | | GameCube | Dolphin | `.iso .rvz .gcm` |

使用方式

通过Android应用或命令行工具在设备上或电脑上转换游戏，转换后安装为独立应用。

查看 README 依据

<p align="center"><img src="App image.png" width="180" alt="RaineyWrapper icon"></p> # RaineyWrapper Turn your game backups into standalone Android apps. Each game gets its own icon on your home screen and boots straight into the game: no frontend, no menus. Made for Android gaming handhelds (Retroid, AYN Odin, Anbernic and similar), and works on any 64-bit Android 8.0+ device. Games are converted **on the device itself** with the RaineyWrapper app, or on a computer with the command-line builder. > No games, BIOS files or other copyrighted content are included. Use your own legally

1. Browse to a game (d-pad + A, or touch). 2. Check the title and icon. A cover image with the same name as the game, next to it or in an `images`, `covers` or `boxart` folder, is used automatically. 3. Choose **Put the game inside the app** (works on its own) or **Play from where the file is now** (small app; keep the file in place). Disc-based systems default to the second. 4. Tap **Convert and install**. If Google Play Protect says "App scan recommended", tap **More details → Install without scanning**. ("Scan app" uploads the whole game file to Google.) ### In-game menu

Requirements: macOS or Linux, JDK 17, Android SDK (platform 37, build-tools 37), NDK 29.0.14206865, CMake 3.22.1, Python 3. ```sh cores/fetch_cores.sh mgba pcsx_rearmed snes9x genesis_plus_gx mupen64plus_next_gles3 ppsspp dolphin flycast pcsx2 ./raineywrapper doctor # checks the toolchain and says what's missing ./raineywrapper converter --public # build the RaineyWrapper app (distributable cores) ./raineywrapper package # release folder + zip on the Desktop ./raineywrapper build game.gba --install # convert one game on the computer ```

部署要求

需要64位Android 8.0+设备；PS2需要用户自备BIOS；从源码构建需要macOS或Linux、JDK 17、Android SDK、NDK等。

查看 README 依据

<p align="center"><img src="App image.png" width="180" alt="RaineyWrapper icon"></p> # RaineyWrapper Turn your game backups into standalone Android apps. Each game gets its own icon on your home screen and boots straight into the game: no frontend, no menus. Made for Android gaming handhelds (Retroid, AYN Odin, Anbernic and similar), and works on any 64-bit Android 8.0+ device. Games are converted **on the device itself** with the RaineyWrapper app, or on a computer with the command-line builder. > No games, BIOS files or other copyrighted content are included. Use your own legally

and 120 Hz. ### Tips - Put games in folders named after their system (`psx`, `ps2`, `dreamcast`, `gamecube`, …) so shared formats like `.chd` and `.iso` are detected correctly. (GameCube and Wii discs are told apart automatically.) You can also pick the system by hand. - PS2 needs a BIOS dumped from your own console: put the 4 MB `.bin` in a `bios` folder (for example `ps2/bios`) and RaineyWrapper bundles the one matching the game's region. - A Dreamcast BIOS in `bios/dc/` is used automatically when present (optional). ## Building from source

Requirements: macOS or Linux, JDK 17, Android SDK (platform 37, build-tools 37), NDK 29.0.14206865, CMake 3.22.1, Python 3. ```sh cores/fetch_cores.sh mgba pcsx_rearmed snes9x genesis_plus_gx mupen64plus_next_gles3 ppsspp dolphin flycast pcsx2 ./raineywrapper doctor # checks the toolchain and says what's missing ./raineywrapper converter --public # build the RaineyWrapper app (distributable cores) ./raineywrapper package # release folder + zip on the Desktop ./raineywrapper build game.gba --install # convert one game on the computer ```

已知限制

PS2需要用户自备BIOS；实验性macOS目标不支持PS2在Intel Mac上运行；分享由商业游戏制作的应用等同于分享游戏副本。

查看 README 依据

and 120 Hz. ### Tips - Put games in folders named after their system (`psx`, `ps2`, `dreamcast`, `gamecube`, …) so shared formats like `.chd` and `.iso` are detected correctly. (GameCube and Wii discs are told apart automatically.) You can also pick the system by hand. - PS2 needs a BIOS dumped from your own console: put the 4 MB `.bin` in a `bios` folder (for example `ps2/bios`) and RaineyWrapper bundles the one matching the game's region. - A Dreamcast BIOS in `bios/dc/` is used automatically when present (optional). ## Building from source

Experimental: `./raineywrapper build game.gba --target mac --install` makes a standalone macOS app (RetroArch inside, one game per app). 2D systems work; PS2 doesn't run on Intel Macs yet. The first build creates a signing key in `~/.raineywrapper/`. Keep it: updates only install over apps signed with the same key. ### Project layout | Folder | What it is | |---|---| | `player-template/` | The game app (Kotlin): loads one game, menu, touch controls, saves |

(GPL-3.0) and the emulator cores listed in [LICENSES-public.md](LICENSES-public.md), each under its own license. Game apps you create contain the game you converted. Sharing an app made from a commercial game is sharing a copy of that game, so only share apps made from homebrew whose license allows it.