38 KiB
Obtainium Emulation Pack
An 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
How to install
Option 1. Import Method
Tip
This is recommended installation method for beginners and/or new devices
- On your android emulation device, navigate to the latest release of the Obainium Emulation Pack.
- Download the file titled
obtainium-emulation-pack-vX.X.X.jsonto your device. - Open Obtainium.
- Navigate to Import/Export.
- Select
Obtainium Importand openobtainium-emulation-pack-vX.X.X.json - You should see packages imported to your obtainium.
Option 2. Click-to-Install Method
- Visit this page on your android emulation device
- Click the "Add to Obtainium!" links of the emulators you wish to track
| Application Name | Category | Add to Obtainium |
|---|---|---|
| Artemis | Streaming | Add to Obtainium! |
| Azahar | Emulator | Add to Obtainium! |
| Cemu | Emulator | Add to Obtainium! |
| Dolphin Emulator (Dev build) | Emulator | Add to Obtainium! |
| Dolphin Emulator | Emulator | Add to Obtainium! |
| DuckStation (Beta) | Emulator | Add to Obtainium! |
| melonDS | Emulator | Add to Obtainium! |
| melonDS Nightly | Emulator | Add to Obtainium! |
| PPSSPP | Emulator | Add to Obtainium! |
| RetroArch AArch64 (Stable) | Emulator | Add to Obtainium! |
| RetroArch AArch64 (Nightly) | Emulator | Add to Obtainium! |
| RPCSX | Emulator | Add to Obtainium! |
| ScummVM | Emulator | Add to Obtainium! |
| Winlator | Emulator | Add to Obtainium! |
| Vita3K | Emulator | Add to Obtainium! |
| Vita3K ZX | Emulator | Add to Obtainium! |
| NetherSX2 Classic | Emulator | Add to Obtainium! |
| Syncthing-Fork | Utilities | Add to Obtainium! |
| AdrenoToolsDrivers | Track Only | Add to Obtainium! |
| Obtainium Emulation Pack | Track Only | Add to Obtainium! |
Development & Contribution
Contributing
You are welcome to make a PR with a contribution.
1. Making changes to the pack
You'll want to directly edit only things in either ./pages/ or ./src/. Everything else should be designed to update
through scripts. Including the README!
...why template out the README? Because that table is very cumbersome to update on every change.
2. Pre-Commit
Before you commit, make sure to run make release.
This will:
- template the README
- update the minified json release file
Development Tips
Meta field options
My scripts will do specific actions if a meta field is present
| key | type | default | description |
|---|---|---|---|
| exludeFromExport | bool | false | Excludes the app from the release export json. |
| exludeFromTable | bool | false | Excludes the app from the README table. |
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 https://regexr.com/7rmf7 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.