Provenance # [Provenance](https://provenance-emu.com) **The best free, open-source iOS game emulator for iPhone, iPad, and Apple TV.**
Play retro games from 50+ classic consoles — no jailbreak required. Download on the App Store   Add to AltStore   Download IPA
[![Stars](https://img.shields.io/github/stars/provenance-emu/provenance?style=flat-square&logo=github&color=FA3399&label=Stars)](https://github.com/provenance-emu/Provenance/stargazers) [![Forks](https://img.shields.io/github/forks/provenance-emu/provenance?style=flat-square&logo=github&color=FA3399&label=Forks)](https://github.com/provenance-emu/Provenance/network) [![Contributors](https://img.shields.io/github/contributors/provenance-emu/provenance?style=flat-square&logo=github&color=FA3399&label=Contributors)](https://github.com/Provenance-Emu/Provenance/graphs/contributors) [![IPA Downloads](https://img.shields.io/github/downloads/provenance-emu/provenance/total?style=flat-square&logo=github&color=FA3399&label=IPA+Downloads)](https://github.com/Provenance-Emu/Provenance/releases) [![Discord](https://img.shields.io/discord/421819941835243520?style=flat-square&logo=discord&logoColor=white&color=5865F2&label=Discord)](https://discord.gg/4TK7PU5) [![Follow](https://img.shields.io/twitter/follow/provenanceapp?style=flat-square&logo=x&logoColor=white&color=000&label=Follow)](https://x.com/provenanceapp) [![Latest Release](https://img.shields.io/github/v/release/provenance-emu/provenance?style=flat-square&label=Latest&color=2ea44f)](https://github.com/Provenance-Emu/Provenance/releases/latest) [![Release Date](https://img.shields.io/github/release-date/provenance-emu/provenance?style=flat-square&color=2ea44f&label=Released)](https://github.com/Provenance-Emu/Provenance/releases/latest) [![Commits Since Release](https://img.shields.io/github/commits-since/provenance-emu/provenance/latest?style=flat-square&label=Commits+Since)](https://github.com/Provenance-Emu/Provenance/commits) [![Build](https://img.shields.io/github/actions/workflow/status/provenance-emu/provenance/build.yml?style=flat-square&logo=github-actions&logoColor=white&label=Build)](https://github.com/Provenance-Emu/Provenance/actions/workflows/build.yml) [![Last Commit](https://img.shields.io/github/last-commit/provenance-emu/provenance?style=flat-square&label=Last+Commit)](https://github.com/Provenance-Emu/Provenance/commits) [![Commit Activity](https://img.shields.io/github/commit-activity/m/provenance-emu/provenance?style=flat-square&label=Commits%2FMonth)](https://github.com/Provenance-Emu/Provenance/commits) [![iOS 16+](https://img.shields.io/badge/iOS-16%2B-007AFF?style=flat-square&logo=apple&logoColor=white)](https://developer.apple.com/ios/) [![tvOS 16+](https://img.shields.io/badge/tvOS-16%2B-000000?style=flat-square&logo=apple&logoColor=white)](https://developer.apple.com/tvos/) [![macOS 13+](https://img.shields.io/badge/macOS-13%2B-636366?style=flat-square&logo=apple&logoColor=white)](https://developer.apple.com/macos/) [![Swift 5.9](https://img.shields.io/badge/Swift-5.9-FA7343?style=flat-square&logo=swift&logoColor=white)](https://swift.org) [![Xcode 16.2](https://img.shields.io/badge/Xcode-16.2-147EFB?style=flat-square&logo=xcode&logoColor=white)](https://developer.apple.com/xcode/) [![Open Issues](https://img.shields.io/github/issues/provenance-emu/provenance?style=flat-square&label=Issues)](https://github.com/provenance-emu/Provenance/issues) [![Open PRs](https://img.shields.io/github/issues-pr-raw/provenance-emu/provenance?style=flat-square&label=PRs)](https://github.com/provenance-emu/Provenance/pulls) [![Roadmap](https://img.shields.io/badge/Roadmap-GitHub%20Projects-blue?style=flat-square&logo=github)](https://github.com/orgs/Provenance-Emu/projects/1)
---

SNES on iPhone N64 on iPhone PlayStation on iPhone NES CRT filter on iPhone PSP on iPhone

--- ## 🆕 What's New — v3.3.0 > **☁️ iCloud Sync** — ROMs, saves, BIOS, and artwork sync across all devices via CloudKit
> **📺 Redesigned tvOS UI** — RetroWave side menu, save state browser, cheats UI, TopShelf v2
> **🎬 Unified Video Filters** — Metal shaders across native and RetroArch cores
> **🎮 Core & Controller Fixes** — Mupen64Plus, Dolphin, DuckStation, PicoDrive, FCEUmm, Mednafen
> **🐛 Stability** — Fixed app hangs, crashes, artwork refresh, and game importer [→ Full release notes](https://github.com/Provenance-Emu/Provenance/releases/tag/3.3.0) · [→ Changelog](CHANGELOG.md) --- ## ✨ Features
**🎮 50+ Classic Systems** NES, SNES, N64, GameCube, Game Boy, GBA, DS, 3DS, PlayStation, PSP, Saturn, Dreamcast, Atari, Neo Geo, and [many more](#-systems-supported) **☁️ iCloud Sync** *(Provenance Plus)* Sync ROMs, save states, BIOS files, and artwork across iPhone, iPad, Mac, and Apple TV **🎨 Custom Controller Skins** Hundreds of free community skins — [provenance-emu.com/skins](https://provenance-emu.com/skins/) **🏆 RetroAchievements** Earn achievements in hundreds of classic games via [retroachievements.org](https://retroachievements.org) **📺 Native Apple TV App** Full tvOS UI with RetroWave side menu, TopShelf v2, save state browser — iCloud sync free on Apple TV **🎬 Metal Video Filters** Simple CRT · Complex CRT · Mega Tron · ulTron · LCD · Game Boy · VHS + RetroArch shader support **🔒 Cheat Codes** Game Genie, Action Replay, GameShark on 12+ native cores and all RetroArch cores **💾 Save States** Save and restore progress anywhere with visual thumbnail previews; screenshot browser in pause menu **⏩ Fast Forward** Speed through slow sections with a pause menu toggle or controller shortcut **🖼️ Museum-Quality Library** Automatic box art, descriptions, and genre data via [OpenVGDB](https://github.com/OpenVGDB/OpenVGDB) **📥 Flexible Importing** WebDAV, AirDrop, Files app, Safari downloads, and more **🔓 100% Free & Open Source** No ads, no tracking, no required account — free forever when sideloaded or built from source
--- > 💜 **Provenance is and always will be free.** If it's brought you joy, [support development](https://provenance-emu.com/plus/) — Provenance Plus ($3.99/mo) adds iCloud sync across all devices, TestFlight beta access, and priority support. [GitHub Sponsors](https://github.com/sponsors/JoeMatt) · [Patreon](https://patreon.com/provenance) · [Buy Me a Coffee](https://buymeacoffee.com/joemattiello) --- ## 🎮 Systems Supported
Nintendo — 11 systems
| System | Core(s) | |---|---| | NES / Famicom | FCEUX · Nestopia · Mednafen | | Famicom Disk System | FCEUX | | SNES / Super Famicom | SNES9x · bsnes | | Nintendo 64 | Mupen64Plus-NX · ParaLLEl | | GameCube / Wii | Dolphin | | Game Boy / Game Boy Color | Gambatte · Mednafen | | Game Boy Advance | VBA-M · mGBA | | Nintendo DS | DeSmuME · melonDS | | Nintendo 3DS | emuThreeDS (Citra/Azahar) | | Virtual Boy | Mednafen | | Pokémon mini | PokeMini |
Sega — 7 systems
| System | Core(s) | |---|---| | SG-1000 / Master System | Genesis Plus GX | | Genesis / Mega Drive | Genesis Plus GX · PicoDrive | | Sega CD / Mega CD | Genesis Plus GX | | Sega 32X | PicoDrive | | Game Gear | Genesis Plus GX | | Saturn | Mednafen | | Dreamcast | Flycast |
Sony — 2 systems
| System | Core(s) | |---|---| | PlayStation (PS1 / PSX) | DuckStation · PCSX-ReARMed · Mednafen | | PlayStation 2 ⚠️ | Play! *(experimental — requires JIT)* | | PlayStation Portable (PSP) | PPSSPP |
Atari — 6 systems
| System | Core(s) | |---|---| | Atari 2600 | Stella | | Atari 5200 | Atari800 | | Atari 7800 | ProSystem | | Atari Lynx | Mednafen | | Atari Jaguar | Virtual Jaguar | | Atari ST | Hatari |
NEC · SNK · Bandai · and more — 17 systems
| System | Core(s) | |---|---| | PC Engine / TurboGrafx-16 | Mednafen | | TurboGrafx-CD / Super CD-ROM² | Mednafen | | PC Engine SuperGrafx | Mednafen | | PC-FX | Mednafen | | Neo Geo Pocket / Color | Mednafen | | WonderSwan / Color | Mednafen | | 3DO Interactive Multiplayer | Opera | | ColecoVision | Gearcoleco | | Vectrex | VecX | | Intellivision | FreeIntv | | Magnavox Odyssey² | O2EM | | ZX Spectrum | Fuse | | MSX / MSX2 | blueMSX · fMSX | | Apple II | Atari800 | | IBM PC-DOS | DOSBox | | Watara Supervision | Potator | | Mega Duck | SameDuck |
> 📖 BIOS requirements, ROM formats, and full compatibility notes: [wiki.provenance-emu.com](https://wiki.provenance-emu.com) --- ## 🚀 Getting Started **1. Install** The easiest way is the **[App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)**. For sideloading (AltStore / SideStore) or building from source, see the [Installation Guide](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance). **2. Add your games** See [Importing ROMs](https://wiki.provenance-emu.com/installation-and-usage/roms/importing-roms) — WebDAV, AirDrop, Files, or browser downloads all work. **3. (Optional) Add BIOS files** Some systems require BIOS files. See [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements). > 🆘 Stuck? Check the [FAQ](https://wiki.provenance-emu.com/faqs) or ask on [Discord](https://discord.gg/4TK7PU5). --- ### Why "Provenance"? _Provenance_ is our origin story — the word shares its meaning with _Genesis_, where the project began: a Sega Genesis emulator on iOS in 2016. prov·e·nance  _/ˈprävənəns/_   n.   ¹ place of origin   ² the beginning of something's existence --- ## ⌨️ Keyboard Controls
Show full keyboard mapping
| Key | Action | Key | Action | |---|---|---|---| | `W A S D` | D-Pad / Left Stick | `Arrow Keys` | D-Pad / Right Stick | | `Space` / `Return` | A Button | `F` / `Escape` | B Button | | `Q` | X Button | `E` | Y Button | | `Tab` / `Caps Lock` | L1 | `Left Shift` | L2 | | `R` | R1 | `V` | R2 | | `/` | Select | `Right Shift` | Start | | `~` | Menu | `1` / `U` | Options | | `X` | L3 | `C` | R3 |
--- ## 📊 Repository Activity ![Repobeats](https://repobeats.axiom.co/api/embed/19c0dec78befc395b346c14006c62ff964912fa9.svg "Repobeats analytics image") --- ## ⭐ Star History Star History Chart --- ## 🤝 Contributing We welcome bug fixes, features, documentation, and testing. 1. Check [open issues](https://github.com/Provenance-Emu/Provenance/issues) for something to work on 2. Read [Issues Usage](https://github.com/Provenance-Emu/Provenance/wiki/Issues-Usage) before opening new ones 3. Fork → branch → PR against `develop` 💬 For discussion and community help: [Discord](https://discord.gg/4TK7PU5) · [@provenanceapp](https://x.com/provenanceapp) · [r/Provenance](https://www.reddit.com/r/Provenance/) --- ## ❤️ Support Provenance Provenance has been **free and open-source since 2016**. If it's brought you joy, please consider supporting ongoing development — every contribution keeps the project alive and improving.
### 📱 Provenance Plus — In-App The best way to support us while unlocking premium features: | Plan | Price | Perks | |------|-------|-------| | Monthly | $3.99 / mo | iCloud sync, priority support | | Annual | $39.99 / yr | All above + savings | | Lifetime | $99.99 one-time | All above, forever | | Apple TV | **Free** | CloudKit sync always free on tvOS | **[Get Provenance Plus →](https://provenance-emu.com/plus/)** ### 💸 One-Time & Recurring Donations | Platform | Link | Notes | |----------|------|-------| | ⭐ GitHub Sponsors | [github.com/sponsors/JoeMatt](https://github.com/sponsors/JoeMatt) | Listed in README | | 🎨 Patreon | [patreon.com/provenance](https://www.patreon.com/provenance) | TestFlight beta queue | | ☕ Buy Me a Coffee | [buymeacoffee.com/joemattiello](https://buymeacoffee.com/joemattiello) | Quick one-time support | | 🤝 Open Collective | [opencollective.com/provenanceemu](https://opencollective.com/provenanceemu) | Transparent org funding |
> 🏆 **GitHub Sponsors** are automatically recognized in the [Sponsors](#sponsors) section of this README.
> 🎮 **Patreon supporters** get a dedicated TestFlight invitation queue — more slots, earlier access.
> 💜 Every dollar goes directly toward development, infrastructure, and keeping Provenance free. --- ## 🙏 Upstream Projects Provenance wouldn't exist without these incredible open-source projects. Please consider supporting them!
Show all cores & libraries
| Core | System(s) | Project | |---|---|---| | DuckStation | PlayStation | https://www.duckstation.org | | PPSSPP | PSP | https://www.ppsspp.org | | Dolphin | GameCube / Wii | https://dolphin-emu.org | | emuThreeDS (Citra/Azahar) | 3DS | https://github.com/emuPlace/emuThreeDS | | Flycast | Dreamcast | https://github.com/flyinghead/flycast | | Mednafen | Multi-system | https://mednafen.github.io | | Mupen64Plus-NX | N64 | https://github.com/mupen64plus | | GLideN64 | N64 (graphics) | https://github.com/gonetz/GLideN64 | | Genesis Plus GX | Sega multi | https://github.com/ekeeke/Genesis-Plus-GX | | SNES9x | SNES | https://www.snes9x.com | | bsnes | SNES | https://github.com/bsnes-emu/bsnes | | Gambatte | GB / GBC | https://github.com/sinamas/gambatte | | VBA-M / mGBA | GBA | https://vba-m.com / https://mgba.io | | melonDS | DS | https://melonds.kuribo64.net | | DeSmuME | DS | https://desmume.org | | FCEUX / Nestopia | NES | https://fceux.com / https://nestopia.sourceforge.net | | PicoDrive | Sega 32X / CD | https://github.com/notaz/picodrive | | PCSX-ReARMed | PlayStation | https://github.com/notaz/pcsx_rearmed | | Stella | Atari 2600 | https://stella-emu.github.io | | Hatari | Atari ST | https://hatari.tuxfamily.org | | Opera | 3DO | https://github.com/libretro/opera-libretro | | FreeIntv | Intellivision | https://github.com/libretro/FreeIntv | | Gearcoleco | ColecoVision | https://github.com/drhelius/Gearcoleco | | Fuse | ZX Spectrum | https://fuse-emulator.sourceforge.net | | PokeMini | Pokémon mini | https://sourceforge.net/projects/pokemini | | Potator | Supervision | https://github.com/alekmaul/potator | | VecX | Vectrex | https://www.bannister.org/software/vecx.htm | | libretro / RetroArch | Framework | https://www.libretro.com | | OpenEmu | Framework inspiration | https://openemu.org | | OpenVGDB | ROM database | https://github.com/OpenVGDB/OpenVGDB | | RetroAchievements | Achievements | https://retroachievements.org |
--- ### Collaborators
jasarien
James Addyman 		JoeMatt
Joe Mattiello 		sevdestruct
Sev 		mrjschulte
MrJs
### Contributors
JoeMatt
Joe Mattiello 		jasarien
James Addyman 		sevdestruct
Sev 		dnicolson
Dave Nicolson 		mrjschulte
MrJs 		cheif
Dan Berglund
ToddLa
Todd Laney 		braindx
Jay Mattis 		marcelvoss
Marcel Voss 		josejulio
Josejulio Martínez 		ac90b671
Max Rahm 		rafcabezas
Raf Cabezas
leolobato
Leo Lobato 		willco007
Will Cosgrove 		apexad
Alex Martin 		error404-na
Error404-na 		zydeco
Jesús A. Álvarez 		DanielFontes
Daniel Fontes
stuartjmoore
Stuart Moore 		yoshisuga
Yoshisuga 		cplr
Cplr 		SteveBarnegren
Steve Barnegren 		jabwd
Antwan Van Houdt 		james-richards-privitar
James Richards
drakkhen
Drakkhen 		nenge123
Nenge123 		thales17
Adam Richardson 		ianclawson
Ian Clawson 		stefz
Stefano Zanetti 		thedrick
Tyler Hedrick
rf2222222
Richard
### Sponsors
### Bots
--- ## License Attribution Provenance bundles 60+ open-source emulator cores and libraries under a variety of licenses (GPL, LGPL, MIT/Expat, BSD, and others). Each core's license and copyright holder are recorded in its `Core.plist` and displayed in the app's **About > Licenses** screen. For the full machine-readable table of all bundled projects and their licenses, see **[LICENSES.md](LICENSES.md)** (auto-generated from `Core.plist` files by `Scripts/generate_licenses.py`). See [LICENSE.md](LICENSE.md) for Provenance's own license terms. --- Copyright © 2016–2026 Joseph Mattiello and the Provenance contributors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: (1) Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. (2) Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in documentation and/or other materials provided with the distribution. (3) Neither the name Provenance nor the names of its contributors may be used to endorse products derived from this software without prior written permission. (4) The Provenance name, logo, and associated trademarks may NOT be used in any commercial redistribution. See LICENSE.md for the full terms.