Provenance

---

--- ## 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 — 3 systems
| System | Core(s) | |---|---| | PlayStation (PS1 / PSX) | DuckStation · PCSX-ReARMed · Mednafen | | PlayStation 2 ⚠️ | Play! *(ships in the App Store build, but only playable with JIT — jailbroken devices or older OS versions that allow JIT for App Store installs; sideloaded/AltStore builds get JIT another way)* | | PlayStation Portable (PSP) | PPSSPP | Atari — 7 systems
| System | Core(s) | |---|---| | Atari 2600 | Stella | | Atari 5200 | Atari800 | | Atari 7800 | ProSystem | | Atari 8-bit (400 / 800 / XL / XE) | Atari800 | | 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 ⚠️ | MAME *(experimental — hidden from the App Store build; available via sideloading/AltStore only)* | | 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 --- ## ⭐ Star History --- ## 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

James Addyman

Joe Mattiello