部分系统需要额外准备 BIOS 文件才能运行;PS2 模拟需 JIT,App Store 版仅在越狱或旧系统可玩;Apple II 为实验性支持,仅侧载版本可见
Provenance
Provenance-Emu活跃维护iOS 和 tvOS 上的多平台游戏模拟器前端,把 Atari、任天堂、世嘉、索尼等历代主机的模拟核心整合到一个 App 里,省去装一堆模拟器的麻烦。
iOS & tvOS multi-emulator frontend, supporting various Atari, Bandai, NEC, Nintendo, Sega, SNK and Sony console systems… Get Started: https://wiki.provenance-emu.com |
从 App Store 安装:https://apps.apple.com/us/app/provenance-app/id1596862805;或从 GitHub Releases 下载 IPA 侧载运行 iOS 16+、tvOS 16+ 或 macOS 13+ 的 Apple 设备;README 未说明显存或 GPU 型号要求
iOS/tvOS 多平台复古游戏模拟器前端,免越狱在 iPhone、iPad、Apple TV 上玩 50+ 经典主机游戏
iOS 和 tvOS 上的多平台游戏模拟器前端,把 Atari、任天堂、世嘉、索尼等历代主机的模拟核心整合到一个 App 里,省去装一堆模拟器的麻烦。
核心能力
- 支持 50+ 主机系统,覆盖任天堂、世嘉、索尼、雅达利等
- 通过 CloudKit 同步 ROM、存档、BIOS 和封面图
- Metal 视频滤镜提供 CRT、LCD、VHS 等效果
- 支持 Game Genie、Action Replay、GameShark 金手指
- 自动抓取封面、简介和类型,构建游戏库
容易踩的坑
- alphaProvenance Alpha (f009aad)pre-release2026-11-09 · 2026-11-09 04:32 UTC
查看更新说明
Alpha Build
f009aadAutomated alpha build from
developbranchCommit f009aadBuilt 2026-11-09 04:31 UTC CI Run View build log Bundle ID com.provenance-emu.provenance.alphaNote: This alpha build uses a separate bundle ID so it can be installed alongside the stable release.
Commits since last alpha
f009aad13 fix: await Realm opening after content server import ee46c1a7e feat: add opt-in content server game browsing and playback 488c11089 fix(maint): commit unattended, without submodule pointers 362f838aa fix(skins): default to built-in controls and apply explicit resets 919074944 MetalAPIValidationSettings 1ce9e299b chore(ci): declare least-privilege workflow token permissions (#3806) e46e14dd7 Point the iCube submodule at develop 010603077 fix(ci): keep uploaded local dylibs instead of a cached copy f76d78911 fix(webserver): follow the ecosystem port map, report the bound port, recover from dead listeners (#3805) 9301e4f04 bump dolphinMerged PRs
- #3805: fix(webserver): follow the ecosystem port map, report the bound port, recover from dead listeners
- #3806: chore(ci): declare least-privilege workflow token permissions
These builds are unsigned and intended for sideloading via AltStore/SideStore. Install the Provenance Alpha app (separate from stable) by adding the sideload feed — or tap Add to AltStore / Add to SideStore on your device to add it directly.
Which iOS IPA?
File App IDs used Trade-off Provenance-iOS-NoExtensions.ipa1 No widgets, Spotlight, QuickLook, stickers, or Files.app ROM provider. Import ROMs via the built-in web server. Provenance-iOS.ipa~9 Everything included. A free Apple ID can register only 10 App IDs per 7 days, and every embedded extension consumes one — so the full build can use up almost your entire weekly quota in a single install. The sideload feed serves the NoExtensions build for that reason; grab the full IPA above if you have a paid developer account or want the extensions.
This release is automatically updated on every successful develop push.
Cores found inside each built IPA, with their installed size. A core that failed to build usually still ships a framework, so a size far below its siblings is the signal to look for.
Provenance-iOS-NoExtensions.ipa
App Provenance-iOS.appUncompressed size 1.8 GB Native cores 20 libretro cores 110 Support frameworks 61 (91.3 MB) Native cores
Core Size Systems Version Azahar 35.5 MB 3ds 2126.1.2+provenance 4DO/FreeDO 430.5 KB 3DO 0 Atari 800 577.6 KB 5200, atari8bit 7.2.1 Bliss 373.8 KB intellivision 2.1.2 Bliss 18.6 KB intellivision 2.1.2 CrabEMU 328.5 KB sms, sg1000, colecovision 0.2.0 Dolphin 854.5 KB gamecube, wii 14.3 FCEUX 1.2 MB nes, fds 2.7.0 Gambatte 1.7 KB gb, gbc 0.5.0 Genesis Plus GX 2.9 MB genesis, gamegear, mastersystem, sg1000, segacd v1.7.4 Mednafen 14.8 MB saturn, psx, lynx, ngp, ngpc, pce, pcecd, pcfx, sgfx, vb, ws, wsc, nes, fds, snes, gb, gbc, gba 1.32.1 PicoDrive 1.1 MB 32X 2.04 PPSSPP 19.4 MB psp v1.13.2-2467 ProSystem 245.2 KB 7800 1.3 Snes9x 1.8 MB snes 1.60 Stella 3.6 MB 2600 8.0_pre TGBDual 252.5 KB gb, gbc v0.8.3 VisualBoyAdvance 858.2 KB gba 2.2.3 EmuThreeds 26.8 MB 3ds 1.0.6 Mupen64Plus 2.3 MB n64 2 - 3.3.13.3.1 - Alphapre-release2026-03-30 · 2026-03-30 03:20 UTC
查看更新说明
Fixes some issues with 3.3.0 maybe,
I'm skipping this release officially in favor for 3.4.0
- 3.3.03.3.0 — iCloud Sync, New tvOS UI & Video Filters最新正式版2026-03-14 · 2026-03-14 02:17 UTC
What's New in 3.3.0
This is a big one. Four months of work since 3.2.1 covering iCloud sync, a completely revamped tvOS interface, video filters, and a ton of core and stability fixes.
☁️ iCloud / CloudKit Sync
- ROMs, save states, BIOS files, and artwork now sync across devices via iCloud
- Real-time download progress indicators when loading cloud save states
- Auto BIOS sync on game load when available in iCloud
- ROM metadata syncs alongside files
- Artwork syncs after library updates
- CloudKit records management tab in Settings
- iCloud upsell UI for new users with empty libraries
- Sync queue pauses during emulation and resumes after
📺 New tvOS UI (Default)
- Completely redesigned tvOS interface now enabled by default
- RetroWave-themed side menu with smooth animations
- Save states browser accessible from the main UI with artwork and core name
- "View All" saves section with per-system filtering
- TopShelf v2: recent games and save states with artwork and timestamps
- Cheats UI in the pause menu
- Game "More Info" panel
- Log viewer tab
- Import status view in side menu
- Search with persistent history
- Dozens of focus, navigation, and theming fixes throughout
🎨 Video Filters & Shaders
- Unified filter pipeline works across native and RetroArch cores
- GB and VHS filters improved
- Filters accessible from the pause menu
- RetroArch GLES 3D cores now supported (Vecx/GLiden, etc.)
- Dolphin shader/filter support
- PPSSPP filter support
🎮 Core & Controller Fixes
- RetroArch: Fixed player index mapping for MFi, PS4, and Xbox controllers; PS4 start/select fixed; 32x controls added; GameCube controller responder added
- Mupen64Plus: Fixed PS4 start button; fixed tvOS scaling and placement; better save error messages
- Dolphin: Fixed Vulkan landscape rendering
- GenPluGX: Added CHD support; added wide-screen GameGear core
- PicoDrive: Fixed crash on unload; fixed 32x controller mapping
- FCEUmm: Fixed start/select button mapping
- Mednafen: Fixed DualShock/DualSense pause/play button mapping
- GameBatte / TGDB Dual: Fixed PSX/Xbox pause/select button mapping
🐛 Bug Fixes & Stability
- Fixed multiple app hangs from main-thread Realm access (moved to background)
- Fixed crash in pause menu when closing core
- Fixed potential crash if audio ring buffer init fails
- Fixed crash in share/import extension
- Fixed aspect ratio issues in Stella and some other cores
- Fixed FPS label appearing in screenshots
- Fixed artwork not refreshing in game library after sync
- Fixed game importer re-queuing already-imported items
- Fixed Realm contentless core crash
- Fixed "Continue" carousel metadata mismatch
- Skin selector refreshes orientation previews on rotation change
- ManicSkin/DeltaSkin files can now be opened directly from Safari
- iPad import status modal clipped layout fixed
- DSP audio engine fixes
⚡ Performance
- Artwork loading significantly faster
- Game library UI rendering optimizations (removed unnecessary Observable wrappers)
- Async tab bar icon loading
- CloudKit sync deduplication and repeat-lookup fixes
- Game importer skips MD5 hashing for large non-BIOS files
Full Changelog: https://github.com/Provenance-Emu/Provenance/compare/3.2.1...3.3.0
- 3.2.13.2.1 - iPad skin bug fixes2025-11-23 · 2025-11-23 18:54 UTC
查看更新说明
Full Changelog: https://github.com/Provenance-Emu/Provenance/compare/3.2.0...3.2.1
Bug fixes:
- iPad skins fixed
- Joystick in default skin fixed in landscape
- Atari Lynx Retroach controls fixed
- RetroAchievements login fixed
- Skin selection and import UIs fixed
- Skin rotation issues fixed
- Skin previews fixed
- 3.2.03.2.0 - Skins, many bug fixes, speedups2025-11-20 · 2025-11-20 20:56 UTC
查看更新说明
Release 3.2.0
We're excited to announce Provenance 3.2.0, a major update focused on performance, skins, and quality of life improvements. This release brings highly requested features and fixes that make Provenance faster and more enjoyable than ever.
🎨 Skins: Now Free for Everyone!
The biggest news: Full skin support is now available to all users—no Provenance Plus required! We believe everyone should enjoy customizing their gaming experience. However, if you love what we're building, please consider supporting the project through Provenance Plus or Patreon.
What's New with Skins
- Full Manic and Delta Skin Support for all systems (except 3DS and DS—those are coming soon!)
- Dramatically Improved Performance: Faster rendering, loading, and smoother UI
- Fixed Rotation Issues: No more slow redraws when changing orientation
- Memory Optimizations: More efficient skin storage and rendering
- RetroArch Core Support: Skins now work across all emulator cores
- Enhanced Skin Browser: Faster, more responsive skin selection and preview
⚡ Performance Improvements
Library & UI
- Faster Main Library: Significantly improved scrolling and navigation performance
- Optimized Rendering Loop: Better frame pacing and smoother gameplay across all cores
Core Performance
- Dreamcast/Flycast Enhancements:
- Faster emulation speed
- Windows CE-based games now supported
- Full networking support enabled
- emuThreeDS (3DS Core): Performance bump and reduced graphic glitches
- PPSSPP: More options exposed, layout fixes, and full skin support
ROM Management
- Rewritten ROM Importer:
- Batch processing for multiple imports
- Significantly improved artwork matching—more comprehensive, faster, and more accurate
- Much faster and more reliable with fewer errors
- Fixed bug where existing ROMs were repeatedly re-imported
- Eliminated erroneous duplicate imports
- 7zip Archive Support: Fixed large 7zip archive handling
- MAME/CPS ZIP Support: Drop MAME/CPS1,2,3 ZIP files directly into imports or the MAME/CPS ROMs folder—they'll import and load correctly!
🐛 Major Bug Fixes
Core Stability
- GameCube/Wii (Dolphin) Improvements:
- Fixed flickering after pause/resume
- Fixed mis-mapped button inputs
- Corrected inverted settings
- Faster access to overclock/underclock settings
- Performance improvements matching dedicated emulator apps
- Atari ST: No longer crashes at boot
- Vectrex: Fixed core booting and blank video output
- Mednafen: Fixed static audio in CHD files with FLAC compression
- Odyssey2: Added numpad button support (can now select game number at boot)
- Atari 8-bit: Fixed and added proper controller support
- CPS1/2/3 (Capcom Arcade): Better compatibility and support
- RetroArch Core Crashes: Fixed many boot-up crashes
- RetroArch Pause Bug: Cores now properly pause when menu is opened, and menus are fully navigable
- VSync Output: Fixed video output issues when VSync was disabled
System Issues
- Siri Search Bug: Opening games from Siri search no longer causes games to reopen when closed
- Spotlight Database Corruption: Fixed critical bug that could corrupt the database during Spotlight searches, requiring slow re-imports
- ROM System Migration: Fixed bug where ROMs moved to different systems wouldn't actually move their files, causing incorrect re-imports
- Sideload Bundle ID: Sideloaded apps with changed bundle IDs no longer think they're App Store builds—all Provenance Plus features now work when sideloading or building with Xcode!
📊 Development Tools
FPS Indicator Improvements
- More Accurate Stats: Works with native Provenance cores (3D accelerated)
- *Additional Information
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
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.
🆕 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
🎮 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
🔒 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
💜 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
| 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 |
| 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 |
| 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 |
| 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 |
| 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
🚀 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.
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
| 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.
- Check open issues for something to work on
- Read Issues Usage before opening new ones
- 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.
📱 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 |
💸 One-Time & Recurring Donations
| Platform | Link | Notes |
|---|---|---|
| ⭐ GitHub Sponsors | github.com/sponsors/JoeMatt | Listed in README |
| 🎨 Patreon | patreon.com/provenance | TestFlight beta queue |
| ☕ Buy Me a Coffee | buymeacoffee.com/joemattiello | Quick one-time support |
| 🤝 Open Collective | opencollective.com/provenanceemu | Transparent org funding |
🏆 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!
Collaborators
Contributors
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 (auto-generated from Core.plist files by Scripts/generators/generate_licenses.py).
See 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.