# Obtainium Emulation Pack
An [Obtainium](https://github.com/ImranR98/Obtainium) import file that adds popular Android
emulation applications to Obtainium.
The maintainer of Obtainium also hosts a collection of Crowdsourced app configurations.
[apps.obtainium.imranr.dev](https://apps.obtainium.imranr.dev)
## Prerequisite
> [!TIP]
> Which APK you need to download will depend on your device.
> If you're unsure, you can download `app-release.apk`
Download and Install the [latest release of Obtainium](https://github.com/ImranR98/Obtainium/releases/latest)
## Setup
### Option 1. Import Method
> [!TIP]
> This is recommended installation method for beginners and/or new devices
1. On your android emulation device, navigate to the [latest release](https://github.com/RJNY/Obtainium-Emulation-Pack/releases/latest) of the Obtainium Emulation Pack.
1. Download the file titled `obtainium-emulation-pack-vX.X.X.json` to your device.
1. Open Obtainium.
1. Navigate to Import/Export.
1. Select `Obtainium Import` and open `obtainium-emulation-pack-vX.X.X.json`
1. You should see packages imported to your obtainium.
### Option 2. Click-to-Install Method
1. Visit this page on your android emulation device
1. Click the "Add to Obtainium!" links of the emulators you wish to track
## Applications
### Emulator
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| aPS3e | Add to Obtainium! | ✅ | ✅ |
| ARMSX2 | Add to Obtainium! | ✅ | ✅ |
| Azahar | Add to Obtainium! | ✅ | ✅ |
| Cemu | Add to Obtainium! | ✅ | ❌ |
| Cemu (Dual-Screen) | Add to Obtainium! | ❌ | ✅ |
| Citra MMJ | Add to Obtainium! | ✅ | ✅ |
| Dolphin Emulator | Add to Obtainium! | ✅ | ✅ |
| Dolphin Emulator (Dev build) | Add to Obtainium! | ❌ | ❌ |
| Dolphin-MMJR2-VBI | Add to Obtainium! | ❌ | ❌ |
| DuckStation | Add to Obtainium! | ✅ | ✅ |
| Eden | Add to Obtainium! | ✅ | ✅ |
| Eden Nightly | Add to Obtainium! | ❌ | ❌ |
| Flycast | Add to Obtainium! | ✅ | ✅ |
| Kenji-NX | Add to Obtainium! | ❌ | ❌ |
| MelonDS | Add to Obtainium! | ✅ | ❌ |
| MelonDS (Dual-Screen) | Add to Obtainium! | ❌ | ✅ |
| MelonDS Nightly | Add to Obtainium! | ❌ | ❌ |
| NetherSX2-Classic | Add to Obtainium! | ❌ | ❌ |
| NetherSX2-Patch | Add to Obtainium! | ✅ | ✅ |
| Pico8 Android | Add to Obtainium! | ✅ | ✅ |
| PPSSPP | Add to Obtainium! | ✅ | ✅ |
| RetroArch (AArch64) | Add to Obtainium! | ✅ | ✅ |
| RetroArch Nightly (AArch64) | Add to Obtainium! | ❌ | ❌ |
| RPCSX | Add to Obtainium! | ✅ | ✅ |
| ScummVM | Add to Obtainium! | ✅ | ✅ |
| Vita3K | Add to Obtainium! | ✅ | ✅ |
### Frontend
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| Argosy | Add to Obtainium! | ✅ | ✅ |
| Cocoon FE | Add to Obtainium! | ✅ | ✅ |
| Daijishō | Add to Obtainium! | ✅ | ✅ |
| iiSU | Add to Obtainium! | ✅ | ✅ |
| Pegasus | Add to Obtainium! | ✅ | ✅ |
| RetroHrai | Add to Obtainium! | ✅ | ✅ |
### PC Emulation
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| GameHub Lite | Add to Obtainium! | ✅ | ✅ |
| GameHub Lite (pre-release) | Add to Obtainium! | ❌ | ❌ |
| GameNative | Add to Obtainium! | ✅ | ✅ |
| Winlator | Add to Obtainium! | ✅ | ✅ |
| Winlator CMod | Add to Obtainium! | ✅ | ✅ |
| Winlator-Ludashi | Add to Obtainium! | ✅ | ✅ |
### Streaming
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| Artemis | Add to Obtainium! | ✅ | ✅ |
| Moonlight | Add to Obtainium! | ✅ | ✅ |
### Track Only
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| AdrenoToolsDrivers | Add to Obtainium! | ✅ | ✅ |
| Obtainium Emulation Pack | Add to Obtainium! | ✅ | ✅ |
### Utilities
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|------------------|------------------|---------------------------|----------------------|
| Bifrost | Add to Obtainium! | ✅ | ✅ |
| CHDroid | Add to Obtainium! | ✅ | ✅ |
| EmuReady Lite | Add to Obtainium! | ✅ | ✅ |
| ES-DE Android Apps | Add to Obtainium! | ✅ | ✅ |
| ES-DE Companion | Add to Obtainium! | ❌ | ✅ |
| Jarngreipr | Add to Obtainium! | ❌ | ✅ |
| Mjolnir | Add to Obtainium! | ❌ | ✅ |
| OdinTools | Add to Obtainium! | ✅ | ✅ |
| PixelGuide | Add to Obtainium! | ✅ | ✅ |
| Syncthing-Fork | Add to Obtainium! | ✅ | ✅ |
## FAQ
### A note about stable, beta, nightly and canary versions of the same app
You cannot install more than one version of the same app. For example: You must choose between RetroArch (stable) or RetroArch (nightly). You cannot have both.
To make things easier for beginners, I've omitted nightly, beta and canary versions where a stable
one exists.
You can manually add beta/nightly applications by using the links in the README
### How do I update Obtainium Emulation Pack?
Same as install method. It'll update existing resources.
It will not remove any other resources you've added.
### Why do some applications say TRACK ONLY?
As the name implies, these application versions are only tracked, not pulled.
This was done because we _can't_ pull these resources, but you may still care to know when these
resources have updates so you can pull them manually. For example: NetherSX2 can't provide an APK
for legal reasons, but you'll get update notifications so you don't have to manually check or be
stuck with outdated resources.
### How do I use TRACK ONLY resources?
When you get notified of an update to your track only resource:
- visit the link to your resource
- download it manually
- in obtainium > click resource > click "Mark Updated"
### Can this break?
Yes. Absolutely it can.
Any of the scrapers that use regex can break if the application maintainers break convention.
The applications pulling from GitHub are more stable and less likely to break.
## Contributing
Want to add an app or fix a config? See the [Contributing Guide](CONTRIBUTING.md) for setup instructions, how to add apps, and the pre-commit checklist.
Quick version:
```bash
git clone https://github.com/RJNY/Obtainium-Emulation-Pack.git
cd Obtainium-Emulation-Pack
# Add or edit apps in src/applications.json (or use make add-app)
make test # verify configs resolve to real APKs
make build # validate, regenerate README, and build release JSONs
```