> For the complete documentation index, see [llms.txt](https://wiki.provenance-emu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.provenance-emu.com/readme.md). # Welcome **The premier multi-system emulator for iOS, iPadOS, macOS, and tvOS.** Play games from 38+ classic systems with beautiful library management, native Apple TV support, and museum-quality presentation. Available now on the **App Store**. *** {% hint style="success" %} **New to emulation?** Not sure what any of this is? โ†’ [**What is an Emulator?**](/getting-started/what-is-an-emulator.md) โ€” a friendly explainer for everyone, including what you can play and why you'd want to. {% endhint %} ## ๐Ÿš€ New Here? Start Here ### Get Provenance **Recommended:** [Download from the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) (easiest, automatic updates) **Alternative methods:** [Sideloading](/getting-started/installing-provenance/advanced/sideloading.md) or [Building from source](/getting-started/installing-provenance/advanced/building-from-source.md) (advanced users) ### First Time Setup 1. **Install** from App Store 2. **Add games** - See [Importing ROMs](/using-provenance/importing-roms.md) 3. **Start playing!** Need help? Check the [FAQ](/faqs.md) or visit our [Discord](https://discord.gg/provenance). *** ## โœจ 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 โ†’](/platforms-and-performance/supported-systems.md) ### ๐Ÿ”“ 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](/getting-started/getting-started.md) - Install, import, and play in under 10 minutes * [Installing Provenance](/getting-started/installing-provenance.md) - App Store, sideloading, building * [BIOS Requirements](/getting-started/bios-requirements.md) - Required files for certain systems * [Importing ROMs](/using-provenance/importing-roms.md) - Add games to your library * [FAQ](/faqs.md) - Common questions answered ### Using Provenance * [Supported Systems](/platforms-and-performance/supported-systems.md) - Full compatibility list * [In-Game Menu](/using-provenance/in-game-menu.md) - Pause menu features and shortcuts * [Controllers & Controls](/using-provenance/controllers-and-controls.md) - Supported controllers and setup * [Skins Guide](/using-provenance/skins-guide.md) - Custom controller overlays * [Game Saves](/using-provenance/saves.md) - Save states and battery saves * [Quick Continue](/using-provenance/quick-continue.md) - Core picker and save previews * [Screen Filters & Shaders](/using-provenance/shaders-and-filters.md) - CRT, LCD, VHS effects * [Cheats](/using-provenance/cheats.md) - Game Genie, Action Replay, GameShark * [Fast Forward](/using-provenance/fast-forward.md) - Speed up gameplay * [Multiplayer](/using-provenance/multiplayer.md) - Local and online play * [RetroAchievements](/using-provenance/retroachievements.md) - Earn achievements in retro games ### Platforms * [Performance Optimization](/platforms-and-performance/performance-optimization.md) - Get the best experience * [Apple TV / tvOS Guide](/platforms-and-performance/tvos-guide.md) - Big-screen gaming * [iPad Features](/platforms-and-performance/ipad-features.md) - CRT bezel skins and keyboard support * [Provenance Plus](/platforms-and-performance/provenance-plus.md) - iCloud sync and premium features ### Advanced * [System-Specific Guides](/platforms-and-performance/system-guides.md) - N64, 3DS, GameCube/Wii deep dives * [Building from Source](/getting-started/installing-provenance/advanced/building-from-source.md) - For developers * [Contributing](/help-and-community/contribute.md) - Help improve Provenance * [Troubleshooting](/help-and-community/troubleshooting.md) - Fix common issues *** ## ๐Ÿ†• What's New ### Recent Features * ๐ŸŽจ **Skins** โ€” Custom controller overlays from DeltaStyles.com (free for all users) * ๐ŸŽฌ **Metal Shader Filters** โ€” 7 built-in filters: Simple CRT, Complex CRT, Mega Tron, ulTron, LCD, Game Boy, VHS * ๐Ÿ† **RetroAchievements** โ€” Earn achievements in retro games * โฉ **Fast Forward** โ€” Speed up gameplay with a pause menu toggle or controller shortcut * ๐ŸŽฎ **Multiplayer** โ€” Local multiplayer with up to 4 controllers * ๐Ÿงฉ **Cheats** โ€” Game Genie, GameShark, Action Replay across 12+ native cores * ๐Ÿ”„ **Quick Continue** โ€” Save state previews and core picker on game launch [See full changelog โ†’](https://github.com/Provenance-Emu/Provenance/releases) *** ## ๐ŸŒŸ 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](https://discord.gg/provenance) * **GitHub:** [github.com/Provenance-Emu/Provenance](https://github.com/Provenance-Emu/Provenance) * **Issues:** [Report bugs](https://github.com/Provenance-Emu/Provenance/issues) * **Reddit:** [r/Provenance](https://www.reddit.com/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 *** **๐ŸŒ Main website:** [provenance-emu.com](https://provenance-emu.com) โ€” Download the best free iOS game emulator for iPhone, iPad, and Apple TV.