App Store (Recommended)

The easiest way to get Provenance on your iPhone, iPad, or Apple TV.


โœ… Installation Steps

1. Open the App Store

On your iOS device:

2. Download

  • Tap Get (it's free)

  • Authenticate with Face ID, Touch ID, or password

  • Wait for download to complete (~2.5 GB)

3. Launch

  • Tap Open from App Store, or find Provenance on your home screen

  • Grant any permissions requested (Files access, notifications)

  • You're ready to add games!


๐Ÿ“ฑ Supported Devices

Provenance works on:

  • โœ… iPhone (iOS 16.0+)

  • โœ… iPad (iPadOS 16.0+)

  • โœ… Apple TV (tvOS 16.0+)

  • โœ… Apple Vision Pro (visionOS 1.0+)

  • โœ… Mac (macOS 13.0+ with Apple Silicon)

Note: Some systems (like 3DS) require more powerful devices for good performance.


๐Ÿ†“ Free vs Provenance Plus

Free (App Store version):

  • All 38+ systems supported

  • Full emulation features

  • On-screen controls and controller support

  • Save states and battery saves

  • Local library management

Provenance Plus ($3.99/mo, $39.99/yr, or $99.99 lifetime):

  • โ˜๏ธ iCloud Sync - Library, saves, and settings across all devices

  • ๐Ÿงช Beta Access - Test new features early via TestFlight

  • ๐ŸŽฏ Priority Support - Get help faster

  • โค๏ธ Support Development - Keep Provenance improving

You decide: The free version is fully functional. Plus supports the project and adds convenience features.


โฌ†๏ธ Automatic Updates

App Store version updates automatically:

  • New features arrive seamlessly

  • Bug fixes applied without manual work

  • Just keep "Automatic Downloads" enabled in Settings โ†’ App Store

Manual update:

  1. Open App Store

  2. Tap your profile icon (top right)

  3. Scroll to Provenance

  4. Tap Update if available


โ“ Troubleshooting

"This app is not available in your region"

Provenance may not be available in all App Store regions due to Apple's policies. Alternatives:

  • Use a different Apple ID with a supported region

  • Sideload using AltStore (no region restrictions)

  • Build from source (developers)

"Cannot download - not enough storage"

Provenance is ~2.5 GB and needs additional space for games:

  • Free up space by deleting unused apps/files

  • Move photos/videos to iCloud or computer

  • Recommended: 10+ GB free for comfortable use

Installation stuck or won't complete

  1. Force-close App Store app

  2. Restart your device

  3. Try downloading again

  4. If still stuck, check Apple's System Statusarrow-up-right for App Store issues

App crashes on launch

  1. Ensure your device is on iOS 16.0+ (Settings โ†’ General โ†’ About)

  2. Restart your device

  3. Delete and reinstall Provenance


๐ŸŽฎ Next Steps

After installing:

  1. Import ROMs - Add games to your library

  2. BIOS Requirements - Some systems need BIOS files

  3. Controllers - Connect a gamepad for best experience

Optional:


๐Ÿ”„ Switching from Sideloaded Version

Already using a sideloaded version? You can switch:

  1. Backup your data (library, saves) - see BIOS Requirements

  2. Delete the sideloaded app

  3. Install from App Store

  4. Restore your data

Note: App Store and sideloaded versions use different data directories. Manual migration needed.


๐Ÿ†š App Store vs Sideloading Comparison

Feature
App Store
Sideloading

Installation

One-tap from App Store

Requires AltStore or computer

Updates

Automatic

Manual re-sideload

Revocation risk

None (official app)

Possible (7-day limit with free AltStore)

Provenance Plus

$3.99/mo or lifetime purchase

Not available (all features free)

iCloud Sync

Requires Plus subscription

Requires custom setup

Best for

Most users (easiest)

Power users, free alternative

Recommendation: Use App Store unless you specifically need free alternative or custom builds.


Last updated: February 2026 Provenance App Store version: Latest

Last updated