provenance

# Provenance **Provenance** is a free, open-source multi-system game emulator designed for Apple platforms, including iPhone, iPad, Apple TV, and Mac. It allows users to play retro games from over 50 classic consoles without requiring a jailbreak. The project has been active since 2016 and is continuously developed by a community of contributors. ## Key Features - **Broad System Support**: Emulates a wide range of systems, including Nintendo (NES, SNES, N64, GameCube, Game Boy, GBA, DS, 3DS), Sega (Genesis, Saturn, Dreamcast, Game Gear), Sony (PlayStation, PSP), Atari (2600, 5200, 7800, 8-bit), NEC (TurboGrafx-16, PC Engine), SNK (Neo Geo), and more. A full list is available in the README. - **Native Apple TV App**: Offers a dedicated tvOS interface with a RetroWave side menu, TopShelf v2, and a save state browser. iCloud sync is free on Apple TV. - **Metal Video Filters**: Includes unified video filters (e.g., CRT, LCD, Game Boy, VHS) using Metal shaders, with support for RetroArch shaders. - **Cheats and Achievements**: Supports Game Genie, Action Replay, and GameShark codes on many cores, plus achievements via RetroAchievements.org. - **iCloud Sync**: Sync ROMs, save states, BIOS files, and artwork across iPhone, iPad, Mac, and Apple TV (with a paid subscription for non-Apple TV devices). - **Customization**: Hundreds of free community skins available, plus automatic box art and metadata via OpenVGDB. - **No Ads or Tracking**: The app is free and open-source, with no required account. Optional support via Provenance Plus ($3.99/month) adds iCloud sync and TestFlight beta access. ## Installation Provenance is available on the App Store, or can be sideloaded via AltStore/SideStore or built from source. Detailed instructions are provided in the [Installation Guide](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance). ## Usage - **Importing ROMs**: Games can be added via WebDAV, AirDrop, Files, or browser downloads. Some systems require BIOS files; see the [wiki](https://wiki.provenance-emu.com) for details. - **Controls**: Supports on-screen touch controls, physical game controllers, and keyboard mappings (e.g., Space/Return for A, F/Escape for B). ## Community and Support - **Discord**: [Join the community](https://discord.gg/4TK7PU5) - **Reddit**: [r/Provenance](https://www.reddit.com/r/Provenance/) - **Twitter/X**: [@provenanceapp](https://x.com/provenanceapp) - **Wiki**: [wiki.provenance-emu.com](https://wiki.provenance-emu.com) ## Contributing Contributions are welcome, including bug fixes, features, documentation, and testing. Check [open issues](https://github.com/Provenance-Emu/Provenance/issues) to get started. ## Sponsorship and Donations Provenance is free and open-source. Support development via GitHub Sponsors, Buy Me a Coffee, or Open Collective. Sponsors are recognized in the README. ## Upstream Projects Provenance relies on many open-source emulator cores and libraries, including Gambatte, mGBA, Genesis Plus GX, Mednafen, PicoDrive, and more. A full list is available in the README. ## License Provenance is released under an open-source license (see the repository for details). It is free forever when sideloaded or built from source.