# 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)
## How to install
### Option 1. Import Method
1. Download the latest obtainium-emulation-pack.json release json to your device
2. Open Obtainium on your device
3. Navigate to Import/Export
4. Select `Obtainium Import` and select the obtainium-emulation-pack.json
5. Profit. You should see packages added to your obtainium
### Option 2. Click to Install method
| Application | Category | Add to Obtainium | Additional Info |
|--------------------------------|------------|------------------|-----------------|
| Azahar | Emulator |
| Conflicts with Lime3DS|
| Cemu | Emulator |
|
| Dolphin (Development Versions) | Emulator |
|
| Duckstation (Beta) | Emulator |
|
| MelonDS (stable) | Emulator |
|
| MelonDS (nightly) | Emulator |
|
| Lime3DS | Emulator |
| Conflicts with Azahar|
| NetherSX2-Classic | Emulator |
|
| NetherSX2-Classic (Pre-Release) | Emulator |
|
| PPSSPP | Emulator |
|
| RetroArch (AArch64) (stable) | Emulator |
| Conflicts with RetroArch Nightly|
| RetroArch (AArch64) (nightly) | Emulator |
| Conflicts with RetroArch Stable|
| RPCSX | Emulator |
|
| ScummVM | Emulator |
|
| Winlator | Emulator |
|
| Vita3k | Emulator |
|
| Vita3k ZX | Emulator |
|
| Turnip Drivers | Track-Only |
|
| Obtainium Emulation Pack | Track-Only |
|
## FAQ
### 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"
### How do I updated Obtainium Emulation Pack?
Same as install method. It'll update existing resources.
It will not remove any other resources you've added.
### A new switch emulator has released! Can you add it?
No.
### 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.
### How does this work?
Obtainium allows you to filter for links on a page using regular expression (regex)
It also allows you to follow multiple links using regex.
see for a basic example of how this works.
### Can this break?
Yes. Absolutely it can.
Any of the scrapers that use regex can break if the maintainer changes their page.
The applications pulling from GitHub are more stable and less likely to break.