Welcome
The premier multi-system emulator for iOS, tvOS, and visionOS.
Play games from 38+ classic systems with beautiful library management, native Apple TV support, and museum-quality presentation. Available now on the App Store.
🚀 New Here? Start Here
Get Provenance
Recommended: Download from the App Store (easiest, automatic updates)
Alternative methods: Sideloading or Building from source (advanced users)
First Time Setup
Install from App Store
Add games - See Importing ROMs
Start playing!
Need help? Check the FAQ or visit our Discord.
✨ What Makes Provenance Special
📺 Premier Apple TV Emulator
The only emulator built natively for tvOS. Play retro games on your big screen with proper controller support, TopShelf integration, and optimized performance.
🎨 Museum-Quality Library
Automatic artwork, manuals, and game information. Your collection looks beautiful.
🎮 38+ Systems Supported
From Atari 2600 to Nintendo 3DS, PlayStation to Sega Saturn. See all systems →
🔓 100% Open Source
Fully transparent, no tracking, community-driven. Free forever when sideloaded or built from source.
☁️ iCloud Sync
Seamlessly sync your library, saves, and settings across all your devices (Provenance Plus).
📖 Quick Navigation
Getting Started
Getting Started Guide - Install, import, and play in under 10 minutes
Installing Provenance - App Store, sideloading, building
BIOS Requirements - Required files for certain systems
Importing ROMs - Add games to your library
FAQ - Common questions answered
Using Provenance
Supported Systems - Full compatibility list
Controllers & Controls - Supported controllers and setup
Game Saves - Save states and battery saves
Customizing ROMs - Artwork, metadata, organization
Advanced
Building from Source - For developers
Contributing - Help improve Provenance
Troubleshooting - Fix common issues
🆕 What's New
Recent Features
🎨 Skins - Customize on-screen controls per system
⚡ Performance HUD - Real-time FPS monitoring
🎮 Enhanced Save States - Improved save state selection UI
🔧 Core Updates - Latest emulation cores with better accuracy
🎬 Shader Filters - Visual enhancements for RetroArch/PPSSPP/Dolphin cores
🌟 Provenance Plus
Optional Provenance Plus upgrade – $3.99/month, $39.99/year, or a $99.99 one-time lifetime purchase to support development and unlock premium features:
☁️ iCloud Sync - Seamless library and save sync across devices
🧪 Beta Access - Test new features early via TestFlight
🎯 Priority Support - Get help faster
❤️ Support Development - Keep Provenance improving
Note: Provenance is free forever when sideloaded or built from source. Plus features support ongoing development.
💬 Community
Discord: discord.gg/provenance
Issues: Report bugs
Reddit: r/Provenance
📚 Documentation Structure
This wiki is organized into sections:
Installation & Usage - Getting Provenance installed and adding games
Info - System compatibility, controllers, technical details
Help - FAQ, troubleshooting, contributing
Development - Building from source, contributing code
Use the sidebar navigation to explore, or search for specific topics.
Last updated: March 2026 Provenance version: Latest (App Store) Wiki maintained by: Provenance community
Last updated