Back to Provenance

Provenance

README.md

3.3.127.2 KB
Original Source
<div align="center">

Provenance

The best free, open-source iOS game emulator for iPhone, iPad, and Apple TV.

Play retro games from 50+ classic consoles — no jailbreak required.

<a href="https://apps.apple.com/us/app/provenance-app/id1596862805"> </a> &nbsp; <a href="altstore://source?url=https://provenance-emu.com/apps.json"> </a> &nbsp; <a href="https://github.com/Provenance-Emu/Provenance/releases/latest"> </a>

</div>
<p align="center"> </p>

🆕 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 · → Changelog


✨ Features

<table> <tr> <td width="50%" valign="top">

🎮 50+ Classic Systems NES, SNES, N64, GameCube, Game Boy, GBA, DS, 3DS, PlayStation, PSP, Saturn, Dreamcast, Atari, Neo Geo, and many more

☁️ 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

🏆 RetroAchievements Earn achievements in hundreds of classic games via 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

</td> <td width="50%" valign="top">

🔒 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

📥 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

</td> </tr> </table>

💜 Provenance is and always will be free. If it's brought you joy, support development — Provenance Plus ($3.99/mo) adds iCloud sync across all devices, TestFlight beta access, and priority support. GitHub Sponsors · Patreon · Buy Me a Coffee


🎮 Systems Supported

<details> <summary><strong>Nintendo — 11 systems</strong></summary>
SystemCore(s)
NES / FamicomFCEUX · Nestopia · Mednafen
Famicom Disk SystemFCEUX
SNES / Super FamicomSNES9x · bsnes
Nintendo 64Mupen64Plus-NX · ParaLLEl
GameCube / WiiDolphin
Game Boy / Game Boy ColorGambatte · Mednafen
Game Boy AdvanceVBA-M · mGBA
Nintendo DSDeSmuME · melonDS
Nintendo 3DSemuThreeDS (Citra/Azahar)
Virtual BoyMednafen
Pokémon miniPokeMini
</details> <details> <summary><strong>Sega — 7 systems</strong></summary>
SystemCore(s)
SG-1000 / Master SystemGenesis Plus GX
Genesis / Mega DriveGenesis Plus GX · PicoDrive
Sega CD / Mega CDGenesis Plus GX
Sega 32XPicoDrive
Game GearGenesis Plus GX
SaturnMednafen
DreamcastFlycast
</details> <details> <summary><strong>Sony — 2 systems</strong></summary>
SystemCore(s)
PlayStation (PS1 / PSX)DuckStation · PCSX-ReARMed · Mednafen
PlayStation 2 ⚠️Play! (experimental — requires JIT)
PlayStation Portable (PSP)PPSSPP
</details> <details> <summary><strong>Atari — 6 systems</strong></summary>
SystemCore(s)
Atari 2600Stella
Atari 5200Atari800
Atari 7800ProSystem
Atari LynxMednafen
Atari JaguarVirtual Jaguar
Atari STHatari
</details> <details> <summary><strong>NEC · SNK · Bandai · and more — 17 systems</strong></summary>
SystemCore(s)
PC Engine / TurboGrafx-16Mednafen
TurboGrafx-CD / Super CD-ROM²Mednafen
PC Engine SuperGrafxMednafen
PC-FXMednafen
Neo Geo Pocket / ColorMednafen
WonderSwan / ColorMednafen
3DO Interactive MultiplayerOpera
ColecoVisionGearcoleco
VectrexVecX
IntellivisionFreeIntv
Magnavox Odyssey²O2EM
ZX SpectrumFuse
MSX / MSX2blueMSX · fMSX
Apple IIAtari800
IBM PC-DOSDOSBox
Watara SupervisionPotator
Mega DuckSameDuck
</details>

📖 BIOS requirements, ROM formats, and full compatibility notes: wiki.provenance-emu.com


🚀 Getting Started

1. Install

The easiest way is the App Store. For sideloading (AltStore / SideStore) or building from source, see the Installation Guide.

2. Add your games

See Importing ROMs — WebDAV, AirDrop, Files, or browser downloads all work.

3. (Optional) Add BIOS files

Some systems require BIOS files. See BIOS Requirements.

🆘 Stuck? Check the FAQ or ask on Discord.


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.

<sup>prov·e·nance  /ˈprävənəns/   n.   ¹ place of origin   ² the beginning of something's existence</sup>


⌨️ Keyboard Controls

<details> <summary>Show full keyboard mapping</summary>
KeyActionKeyAction
W A S DD-Pad / Left StickArrow KeysD-Pad / Right Stick
Space / ReturnA ButtonF / EscapeB Button
QX ButtonEY Button
Tab / Caps LockL1Left ShiftL2
RR1VR2
/SelectRight ShiftStart
~Menu1 / UOptions
XL3CR3
</details>

📊 Repository Activity


⭐ Star History

<a href="https://star-history.com/#Provenance-Emu/Provenance&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Provenance-Emu/Provenance&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Provenance-Emu/Provenance&type=Date" /> </picture> </a>

🤝 Contributing

We welcome bug fixes, features, documentation, and testing.

  1. Check open issues for something to work on
  2. Read Issues Usage before opening new ones
  3. Fork → branch → PR against develop

💬 For discussion and community help: Discord · @provenanceapp · 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.

<table> <tr> <td width="50%" valign="top">

📱 Provenance Plus — In-App

The best way to support us while unlocking premium features:

PlanPricePerks
Monthly$3.99 / moiCloud sync, priority support
Annual$39.99 / yrAll above + savings
Lifetime$99.99 one-timeAll above, forever
Apple TVFreeCloudKit sync always free on tvOS

Get Provenance Plus →

</td> <td width="50%" valign="top">

💸 One-Time & Recurring Donations

PlatformLinkNotes
⭐ GitHub Sponsorsgithub.com/sponsors/JoeMattListed in README
🎨 Patreonpatreon.com/provenanceTestFlight beta queue
☕ Buy Me a Coffeebuymeacoffee.com/joemattielloQuick one-time support
🤝 Open Collectiveopencollective.com/provenanceemuTransparent org funding
</td> </tr> </table>

🏆 GitHub Sponsors are automatically recognized in the 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!

<details> <summary>Show all cores & libraries</summary>
CoreSystem(s)Project
DuckStationPlayStationhttps://www.duckstation.org
PPSSPPPSPhttps://www.ppsspp.org
DolphinGameCube / Wiihttps://dolphin-emu.org
emuThreeDS (Citra/Azahar)3DShttps://github.com/emuPlace/emuThreeDS
FlycastDreamcasthttps://github.com/flyinghead/flycast
MednafenMulti-systemhttps://mednafen.github.io
Mupen64Plus-NXN64https://github.com/mupen64plus
GLideN64N64 (graphics)https://github.com/gonetz/GLideN64
Genesis Plus GXSega multihttps://github.com/ekeeke/Genesis-Plus-GX
SNES9xSNEShttps://www.snes9x.com
bsnesSNEShttps://github.com/bsnes-emu/bsnes
GambatteGB / GBChttps://github.com/sinamas/gambatte
VBA-M / mGBAGBAhttps://vba-m.com / https://mgba.io
melonDSDShttps://melonds.kuribo64.net
DeSmuMEDShttps://desmume.org
FCEUX / NestopiaNEShttps://fceux.com / https://nestopia.sourceforge.net
PicoDriveSega 32X / CDhttps://github.com/notaz/picodrive
PCSX-ReARMedPlayStationhttps://github.com/notaz/pcsx_rearmed
StellaAtari 2600https://stella-emu.github.io
HatariAtari SThttps://hatari.tuxfamily.org
Opera3DOhttps://github.com/libretro/opera-libretro
FreeIntvIntellivisionhttps://github.com/libretro/FreeIntv
GearcolecoColecoVisionhttps://github.com/drhelius/Gearcoleco
FuseZX Spectrumhttps://fuse-emulator.sourceforge.net
PokeMiniPokémon minihttps://sourceforge.net/projects/pokemini
PotatorSupervisionhttps://github.com/alekmaul/potator
VecXVectrexhttps://www.bannister.org/software/vecx.htm
libretro / RetroArchFrameworkhttps://www.libretro.com
OpenEmuFramework inspirationhttps://openemu.org
OpenVGDBROM databasehttps://github.com/OpenVGDB/OpenVGDB
RetroAchievementsAchievementshttps://retroachievements.org
</details>

Collaborators

<!-- readme: collaborators -start --> <table> <tr> <td align="center"> <a href="https://github.com/jasarien">
        <sub><b>James Addyman</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/JoeMatt">
        
        

        <sub><b>Joe Mattiello</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/sevdestruct">
        
        

        <sub><b>Sev</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/mrjschulte">
        
        

        <sub><b>MrJs</b></sub>
    </a>
</td></tr>
</table> <!-- readme: collaborators -end -->

Contributors

<!-- readme: JoeMatt/-,jasarien/-,sevdestruct/-,mrjschulte/-,contributors -start --> <table> <tr> <td align="center"> <a href="https://github.com/JoeMatt">
        <sub><b>Joe Mattiello</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/jasarien">
        
        

        <sub><b>James Addyman</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/sevdestruct">
        
        

        <sub><b>Sev</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/dnicolson">
        
        

        <sub><b>Dave Nicolson</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/mrjschulte">
        
        

        <sub><b>MrJs</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/cheif">
        
        

        <sub><b>Dan Berglund</b></sub>
    </a>
</td></tr>
<tr> <td align="center"> <a href="https://github.com/ToddLa">
        <sub><b>Todd Laney</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/braindx">
        
        

        <sub><b>Jay Mattis</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/marcelvoss">
        
        

        <sub><b>Marcel Voss</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/josejulio">
        
        

        <sub><b>Josejulio Martínez</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/ac90b671">
        
        

        <sub><b>Max Rahm</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/rafcabezas">
        
        

        <sub><b>Raf Cabezas</b></sub>
    </a>
</td></tr>
<tr> <td align="center"> <a href="https://github.com/leolobato">
        <sub><b>Leo Lobato</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/willco007">
        
        

        <sub><b>Will Cosgrove</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/apexad">
        
        

        <sub><b>Alex Martin</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/error404-na">
        
        

        <sub><b>Error404-na</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/zydeco">
        
        

        <sub><b>Jesús A. Álvarez</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/DanielFontes">
        
        

        <sub><b>Daniel Fontes</b></sub>
    </a>
</td></tr>
<tr> <td align="center"> <a href="https://github.com/stuartjmoore">
        <sub><b>Stuart Moore</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/yoshisuga">
        
        

        <sub><b>Yoshisuga</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/cplr">
        
        

        <sub><b>Cplr</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/SteveBarnegren">
        
        

        <sub><b>Steve Barnegren</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/jabwd">
        
        

        <sub><b>Antwan Van Houdt</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/james-richards-privitar">
        
        

        <sub><b>James Richards</b></sub>
    </a>
</td></tr>
<tr> <td align="center"> <a href="https://github.com/drakkhen">
        <sub><b>Drakkhen</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/nenge123">
        
        

        <sub><b>Nenge123</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/thales17">
        
        

        <sub><b>Adam Richardson</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/ianclawson">
        
        

        <sub><b>Ian Clawson</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/stefz">
        
        

        <sub><b>Stefano Zanetti</b></sub>
    </a>
</td>
<td align="center">
    <a href="https://github.com/thedrick">
        
        

        <sub><b>Tyler Hedrick</b></sub>
    </a>
</td></tr>
<tr><td align="center">
    <a href="https://github.com/rf2222222">
        
        

        <sub><b>Richard</b></sub>
    </a>
</td></tr>
</table> <!-- readme: JoeMatt/-,jasarien/-,sevdestruct/-,mrjschulte/-,contributors -end -->

Sponsors

<!-- readme: sponsors -start --> <table> </table> <!-- readme: sponsors -end -->

Bots

<!-- readme: bots -start --> <table> </table> <!-- readme: bots -end -->

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 (auto-generated from Core.plist files by Scripts/generate_licenses.py).

See LICENSE.md for Provenance's own license terms.


<sub>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 <a href="LICENSE.md">LICENSE.md</a> for the full terms.</sub>