## 1. Project Overview & Quickstart (Provenance-Emu/CHANGELOG)

# CHANGELOG

Open-source repository Provenance-Emu/CHANGELOG

### Repository Details
- **Repository:** [Provenance-Emu/CHANGELOG](https://github.com/Provenance-Emu/CHANGELOG)
- **Primary Language:** Code

*Note: High-volume repository documentation is actively indexed and synchronized by YakaAI.*

## 2. Official Technical Reference & Guides (Provenance-Emu/Provenance-Emu.github.io)

## File: README.md

# Provenance Site

This repository serves the source code for https://provenane-emu.com which uses [Hugo](https://gohugo.io/).

This repo is setup to automatically build and deploy to GitHug pages on the branch `gh-pages`

## Building locally / developing

1. [Install Hugo](https://gohugo.io/installation/)
2. Clone this repository

```bash
git clone https://github.com/Provenance-Emu/provenance-emu.github.io
cd provenance-emu.github.io
```

3. Edit any files you want to change.

4. Run Hugo and select the theme of your choosing

```bash
hugo server
```

5. View and test the page locally at http://localhost:1313/

6. Open a Pull-Request here.

---

## File: CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Part of `personal-os`

This repo is a satellite of [`personal-os`](file:///Users/jmattiello/Workspace/personal-os) at `~/Workspace/personal-os`. A fresh agent session here should read `personal-os/AGENTS.md` first for shared conventions:

- **`VOICE.md`** — voice rules for any public-facing prose (marketing copy on this site falls under it).
- **`decisions/`** — cross-repo MADR-numbered ADRs.
- **`journal/`** — daily orchestration log; touch entries when shipping work in this repo.
- **`INBOX.md`** — things-to-act-on across all projects.
- **`wiki/projects-index.md`** — registry of every active repo and how it relates to this one.

Don't edit `personal-os/raw/` from a satellite — that's the central drop-zone, one-way.

## Project Overview

Official website for the Provenance iOS/tvOS multi-emulator app, built with Hugo static site generator. Hosted at https://provenance-emu.com via GitHub Pages.

## Build & Development Commands

```bash
# Local development server (requires Hugo installed)
hugo server

# Local dev server with drafts
hugo server --buildDrafts

# Production build (what CI runs)
hugo --minify

# Docker-based development (uses version from .env)
docker-compose up

# Full production-like build
hugo --gc --minify
```

Local dev server runs at http://localhost:1313/

## Deployment

Automated via GitHub Actions (`.github/workflows/gh-pages.yml`). Pushing to `main` triggers a build with Hugo extended (latest) and deploys to the `gh-pages` branch with CNAME `provenance-emu.com`. Pull requests get a build check but no deployment.

## Architecture

### Theme System

The site uses a **multi-theme chain** defined in `config.toml`:
```
theme = ["hugo-social-metadata", "hugo-redirect", "hugo-cloak-email", "small-apps-prov"]
```

- **`small-apps-prov`** — The primary custom theme (in `themes/small-apps-prov/`). All site layouts, partials, and SCSS live here.
- The other three themes are git submodules providing social metadata, URL redirects, and email obfuscation.
- `hugo-universal-theme` is also a submodule but is not in the active theme chain; it serves as a reference/base.

### Content is Data-Driven

The homepage and most static pages are **not built from Markdown content** — they are driven by YAML data files in `data/`:

- `data/homepage.yml` — Main homepage content (hero, features, systems list, download section, social proof, comparison table, carousel)
- `data/faq.yml`, `data/about.yml`, `data/contact.yml`, `data/privacy.yml`, `data/team.yml` — Page-specific data
- `data/plus.yml`, `data/press.yml` — Plus and Press page data
- `data/carousel/`, `data/features/`, `data/releases/` — Structured data for homepage sections

The homepage template that consumes this data is `themes/small-apps-prov/layouts/index.html` (~410 lines).

### Markdown Content Sections

Several sections use traditional Markdown with front matter:

- `content/blog/` — Blog posts (title, date, tags, author, image)
- `content/guides/` — How-to guide pages with `single.html` layout
- `content/compare/` — "Provenance vs" comparison pages with `single.html` layout
- `content/systems/` — System-specific landing pages (NES, SNES, GBA, PSX, etc.) with `single.html` layout

### Custom Styling

- `static/css/provenance-custom.css` — Site-wide custom CSS overrides (~510 lines), loaded as a plugin via `config.toml`
- Theme SCSS files in `themes/small-apps-prov/assets/scss/` — Core theme styles compiled by Hugo Pipes

### Key Layouts

All in `themes/small-apps-prov/layouts/`:
- `index.html` — Homepage (complex, data-driven, most editing happens here)
- `_default/baseof.html` — Base template wrapper
- `partials/head.html`, `header.html`, `footer.html` — Shared page structure
- `partials/jsonld.html` — JSON-LD structured data partial
- Page-specific layouts: `about/`, `product/`, `faq/`, `privacy/`, `contact/`, `team/`
- `plus/list.html`, `press/list.html` — Plus and Press pages (data-driven)
- `guides/list.html`, `guides/single.html` — How-to guide index and individual pages
- `compare/list.html`, `compare/single.html` — Comparison page index and individual pages
- `systems/list.html`, `systems/single.html` — System-specific landing page index and individual pages
- `layouts/donate/list.html` — Custom donate page (in root layouts dir, overrides theme)

### Configuration

`config.toml` controls: menus, social links, plugins (Bootstrap, jQuery, Owl Carousel, Fancybox, AOS animations), Disqus comments, Google Analytics, CTA section, and widget toggles. Many homepage sections (carousel, features, testimonials, clients, recent_posts) have enable/disable flags.

### Submodules

Clone with `--recursive` or run `git submodule update --init --recursive` after cloning. Required for themes to resolve.

### `_site/` Directory

`_site/` is a separate git worktree or checkout of another branch (not the main source). Do not edit files there — changes will not affect the main site build. The actual source files are at the repo root.

### `static/apps.json`

Auto-updated weekly by `.github/workflows/update-altstore-source.yml`, which pulls from GitHub Releases. Do not manually edit this file; it will be overwritten.

## ⚠️ Hard Rules — Do Not Change Without Understanding Why

### AOS CSS must be loaded synchronously
`themes/small-apps-prov/layouts/partials/head.html` loads `plugins/aos/aos.css` with a plain `<link rel="stylesheet">` — **never change this to async/preload**.

Why: AOS sets `opacity:0` on `[data-aos]` elements via CSS. If the CSS loads after `AOS.init()` runs (which happens when CSS is async), the opacity is never reset to 1 — elements become permanently invisible. This broke the status page and homepage multiple times. The Lighthouse performance gain from async-loading this one small CSS file (~3KB) is negligible.

### All `<script>` tags must have `data-cfasync="false"`
Every `<script>` in `footer.html` has `data-cfasync="false"`. This bypasses Cloudflare Rocket Loader, which rewrites script tags and breaks our deferred execution order. Do not remove these attributes.

### Do not add `data-aos` to functional/dashboard pages
The `/status/` page layout (`themes/small-apps-prov/layouts/status/list.html`) intentionally has no `data-aos` attributes. AOS animations are for marketing pages only — adding them to functional dashboards causes invisible content if timing is off.

## GitHub Issues & PR Conventions

### Epic Issues
Issues labeled `epic` are parent tracking issues that group multiple related PRs. They must **never** be auto-closed by a PR merge.

- **NEVER** use `Closes #N`, `Fixes #N`, or `Resolves #N` when referencing an epic issue in a PR description.
- **ALWAYS** use `Part of #N` or `Related to #N` when a PR addresses work from an epic.
- Child/sub-issues (individual tasks) CAN be closed by PRs using `Closes #N`.
- If you create a PR that fully completes all tasks in an epic, manually close the epic after human review — do not rely on keyword auto-close.

### PR Description Template
```
## Summary
- Brief bullets of what changed

## Part of
- Part of #N (epic title)

## Test plan
- [ ] Hugo builds without errors
- [ ] Page renders correctly at localhost:1313
```

---

## File: docker-compose.yml

version: '3'

services:
  hugo:
    container_name: provenance_hugo
    image: "peaceiris/hugo:v${HUGO_VERSION}"
    # image: peaceiris/hugo:v${HUGO_VERSION}-mod   # Hugo Modules
    # image: peaceiris/hugo:v${HUGO_VERSION}-full  # Hugo Modules and Node.js
    ports:
      - 1313:1313
    volumes:
      - ${PWD}:/src
    command:
      - server
      - --bind=0.0.0.0
      - --buildDrafts

---

## File: frontmatter.json

{
  "$schema": "https://frontmatter.codes/frontmatter.schema.json",
  "frontMatter.content.pageFolders": [
    {
      "title": "static",
      "path": "[[workspace]]/static"
    },
    {
      "path": "[[workspace]]/content/blog/release-2.1.0/images"
    }
  ],
  "frontMatter.content.publicFolder": "static",
  "frontMatter.framework.id": "hugo"
}

---

## File: .lighthouserc.yml

ci:
  collect:
    # 3 runs + median aggregation smooths out the CPU/network variance that's
    # common on shared GitHub Actions runners — a single run can easily swing
    # 15-20 performance points from noise alone, causing false-positive
    # regression issues to be opened against an unchanged site.
    numberOfRuns: 3
    settings:
      chromeFlags: '--no-sandbox --disable-dev-shm-usage'
  assert:
    preset: lighthouse:no-pwa
    assertions:
      # Minimum thresholds — issues will be created below these
      categories:performance:
        minScore: 0.70
        aggregationMethod: median
      categories:accessibility:
        minScore: 0.80
        aggregationMethod: optimistic
      categories:best-practices:
        minScore: 0.80
        aggregationMethod: optimistic
      categories:seo:
        minScore: 0.90
        aggregationMethod: optimistic

---

## File: archetypes/default.md

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

---

## File: content/about/_index.md

---
title: "About Provenance"
date: 2021-07-19T23:37:17-05:00
pageDescription: "The story behind Provenance, the community-driven open-source emulator for iPhone, iPad, and Apple TV."
---

---

## File: content/apps/_index.md

---
title: "Provenance apps and sideload sources"
date: 2026-09-07T00:00:00-05:00
---

---

## File: content/beta/_index.md

---
title: "Beta Access — Provenance"
date: 2026-03-27T00:00:00-05:00
---

---

## File: content/blog/_index.md

---
title: Blog
date: '2021-07-20T06:38:19.051Z'
pageDescription: Keep up to date with Provenance EMU news.
---

---

## File: content/blog/development-preview-next.md

---
title: "Development Preview: Cheats, Controllers & Netplay"
date: 2026-03-06T00:00:00-05:00
draft: false
tags: ["development", "preview", "cheats", "netplay"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["development"]
image: "images/banners/banner-1.jpg"
---

# Development Preview: What's Coming Next

A lot has been happening in the `develop` branch lately. None of this is in the App Store yet — these features are still being polished — but we wanted to share what's in the pipeline so you know where the project is heading. No release date promises here, just an honest look at the work in progress.

If you want early access to these features, [Patreon supporters](https://www.patreon.com/provenance) get beta builds as they become available.

---

## 🎮 Cheat Code System

This is the biggest new feature in active development, and it's shaping up to be something genuinely useful rather than just a checkbox.

At the core is a **bundled 67MB libretro cheat database** shipped directly with the app — no internet required. Tap the search icon on any game and {{< brand >}}Provenance{{< /brand >}} looks up cheats via **MD5 hash matching** for exact ROM identification, or falls back to a fuzzy title match. You get the right cheats for your exact ROM version, completely offline.

For users who want the absolute latest codes, there's also **optional online lookup** from the libretro GitHub-hosted cheat database, with 24-hour disk caching and a globe icon to indicate when results are coming from the network vs. local storage. The online path is opt-in; the offline database works without any network access at all.

The cheat editor itself has been rebuilt in SwiftUI with **real-time format validation** — the input field goes green or red as you type, auto-formats your code to the expected layout, and shows format-specific hints. No more guessing whether your code is entered correctly.

Cheat support is landing across **11+ emulator cores**:

- Game Boy / GBC (Gambatte)
- Game Boy Advance (mGBA)
- Nintendo DS (melonDS)
- Nintendo 64 (Mupen64Plus)
- PlayStation (BeetlePSX, DuckStation)
- Genesis (Genesis Plus GX)
- 32X (PicoDrive)
- All RetroArch cores via a libretro cheat API bridge

Supported formats include Game Genie, Game Shark, Pro Action Replay, Code Breaker, Gecko, and Action Replay.

---

## 📺 Configurable CRT Shader Parameters

CRT shaders have been in {{< brand >}}Provenance{{< /brand >}} for a while, but until now the settings were mostly fixed. A new settings UI with **sliders and toggles** lets you tune the visual effect in real time — adjustments feed directly into the Metal shaders as you move them, so you can dial things in visually instead of guessing.

**Simple CRT controls**: curvature, light boost, vignette, zoom, and brightness.

**Complex CRT controls**: bloom, scanlines, shadow mask, warp, and gamma — each individually toggleable and adjustable. Each section also has a reset-to-defaults button if you go too far.

---

## 🕹️ Custom Controller Button Remapping

Full button remapping is coming with proper profile support. You create **named controller profiles** with any button layout you want, then scope them to a specific controller vendor (DualSense, Xbox, MFi, Switch Pro), a specific system, or even a single game.

Priority works the way you'd expect: game-specific profiles override system-specific ones, which override the global default. Profiles apply automatically at game launch — no menu diving required every time you pick up a different controller.

---

## ⌨️ DOSBox: Keyboard and Mouse Support

Physical Bluetooth and USB keyboards now work in DOSBox games. Mouse movement tracking and left/right button support have been added as well.

This sounds small but it makes a real difference. Classic DOS games like Doom and Wing Commander are genuinely playable on iOS and tvOS now rather than being awkward workarounds. If you've got a Bluetooth keyboard handy, DOSBox games are finally worth loading up.

---

## 📖 In-App Controller Setup Guide

A new Controller Guide lives in Settings and also appears on the empty library screen. It walks through numbered pairing steps for DualSense, DualShock 4, Xbox, MFi, and iCade controllers, so new users have a clear path to getting a controller connected without hunting through documentation.

On tvOS the guide uses focusable controller cards, and it includes a note for Siri Remote users encouraging them to pair a proper game controller before diving into anything that needs analog input.

---

## 🌐 Netplay (Groundwork Laid)

To be clear: **netplay is not ready, and we're not announcing a timeline**. But the work has begun.

The architecture has been designed and documented. We've audited 60+ RetroArch cores for netplay compatibility. The planned rollout is phased: first enable the `HAVE_NETPLAY` build flag across all RetroArch cores, then build out the lobby UI, then integrate native iOS networking.

The reason to mention it now is to be transparent about where we're heading. The groundwork is done. When it's ready, it'll be ready — and it's being built to be stable rather than rushed.

---

## 💿 CHD Support (A Quiet Differentiator)

This one already exists in {{< brand >}}Provenance{{< /brand >}} but deserves more attention than it gets.

CHD (Compressed Hunks of Data) is MAME's disc image format — it compresses multi-track disc images for PS1, Saturn, PC-Engine CD, and other disc-based systems dramatically compared to raw BIN/CUE or ISO. Nearly all CD-based cores in {{< brand >}}Provenance{{< /brand >}} support CHD, so this isn't unusual across the board.

What is unusual: **{{< brand >}}Provenance{{< /brand >}}'s native Mednafen core supports CHD via a custom implementation that doesn't exist in other standalone Mednafen forks**. Standard upstream Mednafen has no CHD support at all. Beetle (RetroArch's Mednafen-derived core) does — and {{< brand >}}Provenance{{< /brand >}} includes Beetle too — but if you're running the native Mednafen core for PS1, Saturn, or PC-Engine CD, CHD just works here in a way it won't in other standalone Mednafen ports.

The practical impact: your disc-based game library takes significantly less storage while preserving disc accuracy. If you're sitting on a pile of BIN/CUE rips, CHD is worth converting to.

---

## 💖 Support the Project

All of this work is happening because of community support. Development takes real time, and the features above represent hundreds of hours of work that hasn't shipped yet.

If you want to help keep things moving:

- **[Patreon](https://www.patreon.com/provenance)** — Monthly support with early access to beta builds
- **[Provenance Plus](https://apps.apple.com/us/app/provenance-app/id1596862805)** — Optional in-app purchase on App Store builds
- **[Buy Me a Coffee](https://buymeacoffee.com/joemattiello)** — One-time contributions
- **[Open Collective](https://opencollective.com/provenanceemu)** — Transparent community funding

Thank you for following along and for your patience while these features get finished properly.

---

## File: content/blog/new-site.md

---
title: "Welcome to the new Provenance homepage."
date: "2021-07-20T03:44:53.356Z"
tags: ["theme"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["starting"]
image: "images/banners/banner-1.jpg"
---

## Welcome

Welcome to the new site. This is under construction.

## Alt-Store

New Alt-Store source at [https://provenance-emu.com/apps.json](https://provenance-emu.com/apps.json)

---

## File: content/blog/release2.0.2.md

---
title: "Release 2.0.2"
date: 2021-09-14T19:05:12-04:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 2.0.2

## Links

- 📲 [iOS IPA](/apps/2.0.2/Provenance-iOS.ipa)
- 📺 [tvOS IPA](/apps/2.0.2/Provenance-tvOS.ipa)
- 📝 [GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.0.2)
- 🏪 [AltStore](/altstore/)



## Install Instructions

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## Changes

*More Bug fixes mostly.*

### Added

- XCode will detect missing git submodules and auto-clone recursive before building the rest of the project

### Fixed

- [#1586](https://github.com/Provenance-Emu/Provenance/issues/1586) Running same core twice in a row would crash
- [#1593](https://github.com/Provenance-Emu/Provenance/issues/1593) Cheat codes menu crash fixes and other cheat code quality improvements

### Updated

- [#1564](https://github.com/Provenance-Emu/Provenance/issues/1564) SteamController native SPM package port
- Jaguar core updated with libretro upstream + my performance hacks. PR made https://github.com/libretro/virtualjaguar-libretro/pull/53#issuecomment-919242560
- Fix many static analyzer warnings about possible nil pointer/un-malloc'd memory usage, now we check and log nils or early exit where applicable
- SQLite.swift updated
- RxRealm updated from 5.0.2 to 5.0.3
- realm-cocoa updated from 10.14.0 to 10.15.0

---

## File: content/blog/release2.0.3.md

---
title: "Release 2.0.3"
date: 2021-12-21T00:00:12-04:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/banners/203banner.jpg"
---

# Release 2.0.3

## Links

- 📲 [iOS IPA](/apps/2.0.3/Provenance-iOS.ipa)
- 📺 [tvOS IPA](/apps/2.0.3/Provenance-tvOS.ipa)
- 📝 [GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.0.3)
- 🏪 [AltStore](/altstore/)



## Install Instructions

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## Changes

*More Bug fixes, some core updates.*

## [2.0.3] - 2021-12-16

### Added

- Odyssey2 core
- Mac Catalyst early support (M1 and Intel) (not for public use yet)
- SNES FAST and PCE FAST core options for Mednafen
- watch os demo target
- Odyssey add and use od2 extension
- Add odyssey to build
- Tentative support for VecX and CrabEMU
- macOS testing catalyst
- Add nitotv methods for tvOS
- Override openURL for tvOS
- Add Patron link to readme
- Add Desmume2015 core
- DuckStation initial commit
- Cores add plist feature to ignore
- Add PPSSPP Source
- Play! PS2 initial commit
- Add Dolphin project
- Add GameCube support classes and metadata (WIP)
- Add flycast core (WIP)
- Add a Chinese loading example
- Add localized strings file and example

### Fixed

- #1621 GBC palette options crashed gambatte
- #1414 smarter expecptions in PVSystem
- #1645 PCE Audio setting tweaks to match real hardware
- #1637 Cheats label name cut off fixed
- #1649 two PCE module audio related setting tweaks that enable {{< brand >}}Provenance{{< /brand >}}'s PCE Audio output to match much closer to the measured MDFourier output of a real system, as tested with @artemio from the MDFourier project.
- Fixed rare crash in OERingBuffer
- Cores that don't support saves no loner display save actions in menu
- OpenVGDB Update (fixes artwork and metadata not loading)
- Fixed strong self refs in some classes, closures
- Fixed MD5 mismatch log message
- Add back a crash logger #1605 add crash logger and fix minor build settings
- switch jaguar to upstream branch
- core option as bool for objc
- RxDataSources switch to SPM package
- Fix some implicit self block refs
- closes Conflicts not reported #1601 conflicts reporting correctly
- fixes Gambatte core immediately crashes #1621 GBC palette options crashed gambatte
- refs After Resolving an "Import Conflict", subsequent imports no longer work #1414 smarter expecptions in PVSystem
- refs WebDav Server Always-On broken #822 add small main queue delay 4webdav start
- tvOS add multi micro gamepad to infoplist
- tvOS fix target order setting error
- Fix minor iCloud warning
- Fix random warnings
- Fix force unwraps in appdeleagte
- Fix finicky tvOS schemes
- Fix whole/single compilation for rel/arch targets
- Mednafen, proper ELOG in swift
- Mednafen remove dead file ref
- RxSwift fix some threading issues
- Fix GL_SILENCE_DEPRECATION=1
- Fix PS2 stealing PS1 bios
- Fix gamecub stealing n64 roms
- add nintendo DS enums
- Replace QuickTableViewController SPM with source
- PicoDrive fix naming
- altkit not in catalyst
- Remove reicast from build
- Fix catalyst and other build tweaks

### Updated

- Jaguar core upstream & custom performance hacks
- Mupen/GlideN64/Rice... updated to latest upstream
- All SPM packages to upstream

### Removed

- Delete Romefile
- dolphini remove used parent project

---

## File: content/blog/release2.0.4.md

---
title: "Release 2.0.4"
date: 2021-12-24T00:00:12-04:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 2.0.4

## Links

- 📲 [iOS IPA](/apps/2.0.4/Provenance-iOS.ipa)
- 📺 [tvOS IPA](/apps/2.0.4/Provenance-tvOS.ipa)
- 📝 [GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.0.4)
- 🏪 [AltStore](/altstore/)



## Install Instructions

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## Changes

*More Bug fixes, some core updates.*

## [2.0.4] - 2021-12-16

### Fixed

- (Possible) Mupen N64 Core fix for tvOS/iOS by @mrjschulte in https://github.com/Provenance-Emu/Provenance/pull/1651
- Update TVL in crt_fragment.glsl to reduce moirée effects at UHD by @mrjschulte in https://github.com/Provenance-Emu/Provenance/pull/1652
- Remove absolute path to file from .xcodeproj by @davidmuzi in https://github.com/Provenance-Emu/Provenance/pull/1654
- Release/2.0.4 by @JoeMatt in https://github.com/Provenance-Emu/Provenance/pull/1668

---

## File: content/blog/release3.0.4.md

---
title: "Release 3.0.4"
date: 2025-02-08T18:13:48-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 3.0.4

## Links

- 📲 [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)
- 📝 [GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/3.0.4)
- 🏪 [AltStore](/altstore/)



## Install Instructions

Download from the AppStore for iOS or macOS Catalyst!

📲 [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

### Side Load

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## Changes

*UI improvements, core updates, and preliminary work on new features*

## [3.0.4] - 2025-02-08

### App Store Version Changes

#### UI Enhancements
- Improved game cell styling with smoother scrolling
- New marquee text effect for game titles
- Updated settings icon for a fresher look
- Fixed media cache to prevent artwork clipping

#### Core Updates
- Added NooDS core for improved DS emulation
- Updated RetroArch assets for better visual consistency

#### System Improvements
- Enhanced core filtering for better performance
- Improved handling of supported cores

#### Other
- Various bug fixes and performance improvements
- Updated in-app documentation and What's New section

### Non-App Store Version Additional Changes

#### Preliminary Dreamcast Support (WIP)
- Added multiple test cores for Flycast
- Note: This feature is still in development and not fully functional

#### Preliminary CD-i Support (WIP)
- Initial groundwork laid for Philips CD-i emulation
- Note: This feature is in early stages and not yet playable

#### DeltaSkins System (WIP)
- Initial integration of the DeltaSkins framework
- Early testing of skin preview and management functionality
- Note: This feature is for internal testing only and not user-ready

#### Additional Core Updates
- Improved Dolphin core Vulkan loading
- Updated MAME plugins

#### Build Improvements
- Fixed several tvOS build issues
- Updated CI/CD pipelines for more efficient builds

### Full Changelog

For a complete list of changes, please visit our [GitHub release page](https://github.com/Provenance-Emu/Provenance/releases/tag/3.0.4).

We're continuously working to improve {{< brand >}}Provenance{{< /brand >}} and bring you the best retro gaming experience possible. The WIP features in the non-App Store version represent our ongoing efforts to expand our emulation capabilities.

As always, we appreciate your support and feedback. Happy gaming!

---

## File: content/blog/release3.1.0.md

---
title: "Release 3.1.0"
date: 2025-08-18T17:07:19-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 3.1.0 - Flycast, Dolphin, RetroAchievements

We're excited to announce {{< brand >}}Provenance{{< /brand >}} 3.1.0, a major feature release bringing Flycast (Dreamcast), Dolphin (GameCube/Wii), RetroAchievements support, and iCloud Sync to {{< brand >}}Provenance{{< /brand >}}.

## Links

- [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)
- [GitHub Release](https://github.com/Provenance-Emu/Provenance/releases/tag/3.1.0)
- [AltStore](/altstore/)

## Install Instructions

Download from the App Store for iOS or macOS Catalyst!

[App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

### Side Load

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## What's New

### Flycast (Dreamcast) Support

Flycast core integration brings Sega Dreamcast emulation to {{< brand >}}Provenance{{< /brand >}}. Play your favorite Dreamcast titles on the go!

### Dolphin (GameCube/Wii) Support

GameCube and Wii emulation via the Dolphin core, enabling an even wider library of classic games.

### RetroAchievements Integration

Earn achievements while playing your favorite retro games! RetroAchievements support lets you track your progress and compete with friends.

### iCloud Sync

Sync your game saves and data across all your devices with iCloud Sync v1. Start a game on your iPhone and pick up right where you left off on your iPad or Mac.

## What's Changed

* Fixed iOS 16 MD5 hash failing; fixed BIOS watcher crashing by @pabloarista in https://github.com/Provenance-Emu/Provenance/pull/2409
* Release/3.0.6a by @JoeMatt in https://github.com/Provenance-Emu/Provenance/pull/2410
* iCloud Sync v1 by @pabloarista in https://github.com/Provenance-Emu/Provenance/pull/2414
* Feature/emulation scene by @JoeMatt in https://github.com/Provenance-Emu/Provenance/pull/2411

### Full Changelog

For a complete list of changes, please visit our [GitHub release page](https://github.com/Provenance-Emu/Provenance/releases/tag/3.1.0).

**Full Changelog**: https://github.com/Provenance-Emu/Provenance/compare/3.0.6...3.1.0

---

## Provenance Plus

The new iCloud Sync feature in 3.1.0 is just the beginning. **[Provenance Plus](/plus/)** takes it further with full cross-device iCloud sync, TestFlight beta access so you get new features first, and priority support — all while directly funding the continued development of {{< brand >}}Provenance{{< /brand >}}. Subscribe from within the app: *Settings > {{< brand >}}Provenance{{< /brand >}} Plus*.

---

Thank you for being part of the {{< brand >}}Provenance{{< /brand >}} community. Happy gaming!

---

## File: content/blog/release3.1.1.md

---
title: "Release 3.1.1"
date: 2025-11-08T20:03:01-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 3.1.1 - Bug Fixes

{{< brand >}}Provenance{{< /brand >}} 3.1.1 is a bug fix release focused on UI and settings improvements, fixing issues reported by the community after the 3.1.0 release.

## Links

- [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)
- [GitHub Release](https://github.com/Provenance-Emu/Provenance/releases/tag/3.1.1)
- [AltStore](/altstore/)

## Install Instructions

Download from the App Store for iOS or macOS Catalyst!

[App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

### Side Load

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## What's Changed

### Settings Fixes
- Fixed settings titles display
- Fixed settings labels on small devices
- Replaced "Wifi" with "Wi-Fi" for correct terminology

### UI Improvements
- Fixed side menu icon alignment
- Fixed search bar position

### System Improvements
- Added check if app group container is readable for better stability

## Contributors

* @dnicolson - Settings and UI fixes
  * Fix settings titles in https://github.com/Provenance-Emu/Provenance/pull/2419
  * Check if app group container is readable in https://github.com/Provenance-Emu/Provenance/pull/2420
  * Fix settings labels on small devices in https://github.com/Provenance-Emu/Provenance/pull/2421
  * Replace "Wifi" with "Wi-Fi" in https://github.com/Provenance-Emu/Provenance/pull/2427
  * Fix side menu icon alignment in https://github.com/Provenance-Emu/Provenance/pull/2429
  * Fix search bar position in https://github.com/Provenance-Emu/Provenance/pull/2430

### Full Changelog

For a complete list of changes, please visit our [GitHub release page](https://github.com/Provenance-Emu/Provenance/releases/tag/3.1.1).

**Full Changelog**: https://github.com/Provenance-Emu/Provenance/compare/3.1.0...3.1.1

---

## Provenance Plus

Enjoying {{< brand >}}Provenance{{< /brand >}}? **[Provenance Plus](/plus/)** adds iCloud sync across all your Apple devices, TestFlight beta access, and priority support — while directly funding ongoing development. Your subscription helps keep the fixes and improvements coming. Subscribe from within the app: *Settings > {{< brand >}}Provenance{{< /brand >}} Plus*.

---

Thank you for being part of the {{< brand >}}Provenance{{< /brand >}} community. Happy gaming!

---

## File: content/blog/release3.2.0.md

---
title: "Release 3.2.0"
date: 2025-11-21T00:00:00-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["release"]
image: "images/banners/banner-1.jpg"
lightgallery: true
fontawesome: true
linkToMarkdown: true
rssFullText: false
layout: photography
---

# Release 3.2.0

We're excited to announce {{< brand >}}Provenance{{< /brand >}} 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 {{< brand >}}Provenance{{< /brand >}} faster and more enjoyable than ever.

## 🎨 Skins: Now Free for Everyone!

The biggest news: **Full skin support is now available to all users—no {{< brand >}}Provenance{{< /brand >}} 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](https://apps.apple.com/us/app/provenance-app/id1596862805) or [Patreon](https://www.patreon.com/provenance).

### 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
- **GameBoy Color Skins on GameBoy**: Use your favorite GBC skins on original GameBoy games
- **Enhanced Skin Browser**: Faster, more responsive skin selection and preview


	
		
			
				<h2 class="font-weight-bold mb-3">See the New Skins in Action</h2>
				Beautiful system-specific skins bring your favorite retro games to life
			
		
		
			
				
					
						
						<h5 class="mt-3">Sega Saturn</h5>
					
          
						
						<h5 class="mt-3">Sega Dreamcast</h5>
					
					
						
						<h5 class="mt-3">PlayStation Portable</h5>
					
					
						
						<h5 class="mt-3">Nintendo Game Boy</h5>
					
					
						
						<h5 class="mt-3">Nintendo Game Boy Color</h5>
					
					
						
						<h5 class="mt-3">Nintendo Game Boy Advance</h5>
					
					
						
						<h5 class="mt-3">Nintendo Entertainment System</h5>
					
					
						
						<h5 class="mt-3">Super Nintendo Entertainment System</h5>
					
					
						
						<h5 class="mt-3">Nintendo 64</h5>
					
					
						
						<h5 class="mt-3">Sony PlayStation</h5>
					
					
						
						<h5 class="mt-3">Sega 32X</h5>
					
				
			
		
	


## ⚡ 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 {{< brand >}}Provenance{{< /brand >}} Plus features now work when sideloading or building with Xcode!

## 📊 Development Tools

### FPS Indicator Improvements
- **More Accurate Stats**: Works with native {{< brand >}}Provenance{{< /brand >}} cores (3D accelerated)
- **Additional Information**: More detailed performance metrics
- Note: Currently limited to native cores; RetroArch-based cores coming later

## ☁️ iCloud Sync Enhancements

- **CloudKit Improvements**: More reliable sync with better error detection
- **Better Error Messaging**: Clear, actionable error messages throughout the app
- **Faster Sync**: Optimized sync speeds for game saves and ROMs

## 🎮 Quality of Life

### PPSSPP Updates
- More emulation options exposed in settings
- Fixed options not saving correctly
- UI layout improvements
- Full skin support

### emuThreeDS (3DS) Updates
- Settings fixes
- Graphic glitch improvements
- Slight performance increase

### General UI
- **Improved Pause Menu**: Cleaner, more intuitive interface
- **Better Messaging**: Enhanced error messages and notifications throughout the app

## 🌐 Website Update

We've completely refreshed [provenance-emu.com](https://provenance-emu.com) with:
- Updated information and screenshots
- Modern styling and improved navigation
- New [donation page](/donate/) with multiple support options

## 🚀 Coming Soon

We're hard at work on exciting features for future releases:
- **tvOS App Store Release**: Official App Store distribution for Apple TV
- **3DS & DS Skin Support**: Complete the skin coverage
- **More Cores**: Additional system support
- **Enhanced Stability**: Continued refinement and optimization
- **Seamless Cloud Storage**: On-demand downloading for iCloud ROMs

## 💖 Support the Project

{{< brand >}}Provenance{{< /brand >}} is a labor of love, built by the community for the community. If you'd like to support continued development:

- **[Provenance Plus](https://apps.apple.com/us/app/provenance-app/id1596862805)**: Optional in-app purchase (App Store builds only)
- **[Patreon](https://www.patreon.com/provenance)**: Monthly support with exclusive perks
- **[Buy Me a Coffee](https://buymeacoffee.com/joemattiello)**: One-time contributions
- **[Open Collective](https://opencollective.com/provenanceemu)**: Transparent funding

Every contribution helps keep this project alive and thriving. Thank you!

## Installation

Get {{< brand >}}Provenance{{< /brand >}} 3.2.0:
- **App Store**: [Download from the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)
- **IPA Download**: [GitHub Releases](https://github.com/Provenance-Emu/Provenance/releases)
- **Sideload**: [Installation Instructions](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading)

---

Thank you for being part of the {{< brand >}}Provenance{{< /brand >}} community. Happy gaming! 🎮

---

## File: content/blog/release3.2.1.md

---
title: "Release 3.2.1"
date: 2025-11-23T18:54:37-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["release"]
image: "images/icons/icon.512x512.png"
---

# Release 3.2.1 - iPad Skin Bug Fixes

{{< brand >}}Provenance{{< /brand >}} 3.2.1 is a quick follow-up to the 3.2.0 release, addressing several skin-related bugs on iPad, joystick issues, and other fixes reported by the community.

## Links

- [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)
- [GitHub Release](https://github.com/Provenance-Emu/Provenance/releases/tag/3.2.1)
- [AltStore](/altstore/)

## Install Instructions

Download from the App Store for iOS or macOS Catalyst!

[App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

### Side Load

https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading

## Bug Fixes

- **iPad skins fixed** - Skins now display and function correctly on iPad
- **Joystick in default skin fixed in landscape** - Landscape mode joystick input corrected for the default skin
- **Atari Lynx RetroArch controls fixed** - Controller mapping corrected for Atari Lynx emulation
- **RetroAchievements login fixed** - Login flow for RetroAchievements is now working properly
- **Skin selection and import UIs fixed** - Resolved issues with the skin browser and import interfaces
- **Skin rotation issues fixed** - Skins now handle device rotation smoothly
- **Skin previews fixed** - Preview images in the skin browser now load correctly

### Full Changelog

For a complete list of changes, please visit our [GitHub release page](https://github.com/Provenance-Emu/Provenance/releases/tag/3.2.1).

**Full Changelog**: https://github.com/Provenance-Emu/Provenance/compare/3.2.0...3.2.1

---

## Provenance Plus

Love what the team is building? **[Provenance Plus](/plus/)** gives you iCloud save sync across all your Apple devices, early access via TestFlight, and priority support — and every subscription goes directly toward sustaining {{< brand >}}Provenance{{< /brand >}}'s development. Subscribe from within the app: *Settings > {{< brand >}}Provenance{{< /brand >}} Plus*.

---

Thank you for being part of the {{< brand >}}Provenance{{< /brand >}} community. Happy gaming!

---

## File: content/blog/skin-catalog-launch.md

---
title: "Introducing the Provenance Skin Catalog"
date: 2026-03-13T00:00:00-05:00
draft: false
tags: ["skins", "community", "feature"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
authorDescription: "Joe Mattiello is the lead developer of Provenance, an open-source multi-system emulator for iOS and tvOS with 10+ years of active development."
categories: ["feature", "community"]
image: "images/blog/skin-catalog-launch.webp"
---

# The Provenance Skin Catalog Is Live

We've launched a new community skin catalog at **[provenance-emu.com/skins/](https://provenance-emu.com/skins/)** — a searchable, browsable directory of controller skins for {{< brand >}}Provenance{{< /brand >}}, updated automatically from community GitHub repos.

## What It Is

The [Skin Catalog](https://provenance-emu.com/skins/) is an open-source directory of `.deltaskin` and `.manicskin` files compatible with {{< brand >}}Provenance{{< /brand >}}. Skins are indexed from the community automatically, with thumbnail previews extracted directly from the skin files themselves.

- **Browse** skins by system — GBA, SNES, PSX, N64, and more
- **Search** by name or author
- **Submit** your own skin in under a minute

The catalog powers the in-app skin browser (Settings → Skins → Browse Catalog), so anything you submit shows up right inside {{< brand >}}Provenance{{< /brand >}}.

## How to Submit a Skin

There are four ways to get your skin in the catalog:

1. **Drop a URL** — Go to [provenance-emu.com/skins/submit](https://provenance-emu.com/skins/submit) and paste any direct link to your `.deltaskin` or `.manicskin` file. The site parses the file in your browser and creates a GitHub issue pre-filled with your skin's metadata.

2. **Open a GitHub issue** — Visit [github.com/Provenance-Emu/skins/issues/new](https://github.com/Provenance-Emu/skins/issues/new/choose) and use the "Submit a Skin" template. Paste your download URL and it's automatically processed into the catalog.

3. **Pull request** — Fork [Provenance-Emu/skins](https://github.com/Provenance-Emu/skins), add a JSON file to the `skins/` directory, and open a PR. Automated validation runs on every PR.

4. **Register your repo** — If you maintain a GitHub repo full of skins, open a "Register Source" issue to have it crawled weekly. Your skins will be indexed automatically going forward.

## For Skin Creators

If you've been hosting skins on DeltaStyles, a personal GitHub repo, or anywhere else — you can bring them into the {{< brand >}}Provenance{{< /brand >}} catalog without moving any files. The catalog just links to your existing download URL.

Want your whole repo crawled automatically? [Register it as a source](https://github.com/Provenance-Emu/skins/issues/new/choose).

## Under the Hood

The catalog is fully open source at [github.com/Provenance-Emu/skins](https://github.com/Provenance-Emu/skins). It:

- Crawls community repos weekly for new skins
- Extracts thumbnail images from inside skin ZIP files (PNG preferred, PDF converted to PNG via poppler)
- Stores thumbnails on GitHub Releases as a CDN, with repo fallback
- Rebuilds the catalog JSON on every change and deploys to GitHub Pages
- Validates all submissions via CI before they go live

The JSON catalog at `catalog.json` follows an open schema — if you want to build your own browser or integrate it into another app, go for it.

---

**[Browse the Skin Catalog →](https://provenance-emu.com/skins/)**

---

## File: content/blog/release-2.1.0/index.en.md

---
title: "Release 2.1.0"
date: 2022-02-15T00:00:12-04:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/banners/210banner.jpg"
lightgallery: true
fontawesome: true
linkToMarkdown: true
rssFullText: false
layout: photography
---

# Release 2.1.0

## Links

- 📲 __[iOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/Provenance%202022-02-15%2023-07-51/Provenance.ipa)__
- 📺 __[tvOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/ProvenanceTV-Release%202022-02-15%2023-19-32/Provenance.ipa)__
- 📝 __[GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.1.0)__
- 🏪 __[AltStore](/altstore/)__

- ___[Installation Instructions](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading)___

## Changes

### Site

- IPAs now hosted in Amazon S3 for faster downloads/installs.

### Core options

- Added support for more styles of Core Options (multiple select options, enumerations, Int and Float ranges)
- New Options exposed for
  - Mupen (N64)
  - Mednafen

{{< figure src="images/options-mednafen-ios.jpg" title="Mednafen new options menu items" width="360">}}
{{< figure src="images/ios-coreoptions-mednafen.jpg" title="Mednafen new options menu items" width="360">}}
{{< figure src="images/ios-coreoptions-genesis.jpg" title="Mednafen new options menu items" width="360">}}
{{< figure src="images/ios-coreoptions-mupen.jpg" title="Mednafen new options menu items" width="360">}}

### Controllers

{{< figure src="images/n64-onscreen-joystick-HD 1080p.mov" title="N64 and PSX new on-screen joystick" width="480px">}}
{{< figure src="images/n64-ios-newlayout.jpg" title="Updated N64 on screen controls" width="360">}}
{{< figure src="images/ipad-keyboard-controller.jpeg" title="iPad SmartKeyboard as a gamepad" width="360">}}

### GamePad menu Navigation

Fully navigate the iOS/iPad OS UI with any compatible GamePad (MFi, DualShock, Steam, iCade etc)
Completely wireless play, no need to be within touching distance of your mobile devices!

{{< figure src="images/gamepad-navigation-HD 1080p.mov" title="Full interface navigation with GamePad" width="480px">}}

### Update UI components for iOS and tvOS

{{< figure src="images/browser-ipad.jpg" title="iPad Browser UI" width="360">}}
{{< figure src="images/gameboy-ios-palettes-menu.jpg" title="GameBoy Color Select Menu" width="360">}}
{{< figure src="images/ios-menu-icons.jpg" title="iOS Menu Icons" width="360">}}
{{< figure src="images/tvos-browser-options.jpg" title="Apple TV new options styling" width="360">}}
{{< figure src="images/tvos-settings.jpg" title="tvOS Settings new Styling" width="360">}}

### Render Engine

{{< figure src="images/crt-closeup.jpg" title="CRT Filter improvements"width="360" >}}

#### Experimental Metal backend

All new CRT and more shaders native in Metal.

#### Google Cardboard / Split View 3D for VirtualBoy

Added a new option to enable Mednafen's VirtualBoy core to render 3D in left/right split view, with optional middle gap.
This is early support for using stereoscopic 3D screens such as 3D TV's with "Side by Side" mode, or Google Cardboard or similar headset with a mounted iPhone.

### Spotlight

{{< figure src="images/ios-spotlight-mk.jpg" title="Fixed iOS Spotlight Results" width="360">}}

### Log viewer

{{< figure src="images/ios-logview2.jpg" title="Fixed iOS Spotlight Results" width="360">}}

---

## File: content/blog/release-2.1.1/index.en.md

---
title: "Release 2.1.1"
date: 2022-06-15T00:00:12-04:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/banners/210banner.jpg"
lightgallery: true
fontawesome: true
linkToMarkdown: true
rssFullText: false
layout: photography
---

# Release 2.1.1

## Links

- 📲 __[iOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/apps/2.1.1/Provenance-iOS.ipa)__
- 📺 __[tvOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/apps/2.1.1/Provenance-tvOS.ipa)__
- 📝 __[GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.1.1)__
- 🏪 __[AltStore](/altstore/)__

- ___[Installation Instructions](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading)___

## [2.1.1] - 2022-06-15

### Added

- Controls: PSX on-screen joystick can be disabled in settings. No longer shows when controller is connected
- Swift UI beta for tvOS
- tvOS theme support
- Metal shader 200% speedup 👉 @mrjschulte
- early dosbox testing code (no running yet)

### Fixed

- tgbdual crash on ios fixed

### Updated

- fceux update core to 2.6.2

---

## File: content/blog/release-2.2.0/index.en.md

---
title: "Release 2.2.0"
date: 2022-12-09T00:00:12-05:00
draft: false
tags: ["release"]
type: "post"
author: "Joe Mattiello"
authorImage: "images/team/joe.jpg"
authorSocial:
  - icon : "tf-ion-social-github"
    URL : "https://github.com/JoeMatt"
  - icon : "tf-ion-social-twitter"
    URL : "https://twitter.com/joemattiello"
categories: ["release"]
image: "images/banners/220banner.jpg"
lightgallery: true
fontawesome: true
linkToMarkdown: true
rssFullText: false
layout: photography
---

## Links

- 📲 __[iOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/apps/2.2.0/Provenance.ipa)__
- 📺 __[tvOS IPA](https://provenance-builds.s3-us-east-2.amazonaws.com/apps/tvOS/2.2.0/Provenance-tvOS.ipa)__
- 📺 __[macOS APP](https://provenance-builds.s3-us-east-2.amazonaws.com/apps/macOS/2.2.0/Provenance.pkg)__
- 📝 __[GitHub](https://github.com/Provenance-Emu/Provenance/releases/tag/2.2.0)__
- 🏪 __[AltStore/SideStore](/altstore/)__

- ___[Installation Instructions](https://wiki.provenance-emu.com/installation-and-usage/installing-provenance/sideloading)___

## Screenshots

{{< image src="images/IMG_2306.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2307.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2308.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2309.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2310.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2311.jpg" caption="." height="400" >}}
{{< image src="images/IMG_2312.jpg" caption="." height="400" >}}

## [2.2.0] - 2022-12-09

Super special thanks to @Carter1190 @dnicolson @ianclawson @mrjschulte @stuartcarnie for providing pull requests.
Special thanks for all the Patreon and Discord members that provided testing feedback and support.

### Added

- Light/Dark theme
- tvOS artwork options
- Saturn Core options
- Movable buttons (beta)
- Option for onscreen joystick with keyboard on/off, or never.
- add build.yml for github actions
- stella: joystick deadzone

### Fixed

- tvOS various layout, styling improvements
- fixes #1915 joystick layout busted
- BoxArt fix nil crash
- add sfc extension
- Catalyst, fix crash on game load
- catalyst: remove broken bliss
- fixes #1973 incorrect paths in xcworkspace
- fixes #1991 Fixes mupen plugin paths
- fixes #1997 update ios launch storyboard
- fixes #2010 remove unused codesign settings
- disable broken contributors.yml
- fix various tvos targets with wrong target platfrm
- fixes #1814 Use documents for image cache
- Fixes #1814, lib deletion and icloud fixes
- fixes #1986 adds ways to press start in SS
- fixes #1986 Saturn start MFi, I think.
- fixes #2019 Mednafen SNES A/B swap
- fixes #2026 joyPad move works, clear BG
- fixes #2027 importer double run and deleting
- fix archive step
- fix artwork download
- stella: don’t crash on 2nd load
- stella: updated and cheats,save support
- closes #1765 map dualsense home to pause on saturn
- closes #1765 map dualsense home to pause on saturn
- closes #1888 fix n64 scaling
- closes #1903 tvos build broken
- conflicts manager add delete option
### Updated

- Min target iOS 13 all around
- More localised strings and xib's
- SwiftUI additions and fixes
### PRs

- Merge branch 'feature/dos-box' into develop
- Merge branch 'remove-unneeded-styling' into develop
- Merge branch 'remove-unneeded-table-generics' into develop
- Merge pull request #1919 from Provenance-Emu/feature/dos-box
- Merge pull request #1995 from dnicolson/style-fixes
- Merge pull request #2006 from Provenance-Emu/pullrequests/dnicolson/general-cleanup
- Merge pull request #2015 from dnicolson/fix-constraint-warnings
- Merge pull request #2016 from dnicolson/use-tvalertcontroller
- Merge pull request #2017 from dnicolson/remove-unneeded-styling
- Merge pull request #2018 from dnicolson/use-system-background-for-settings
- Merge pull request #2025 from Provenance-Emu/largeGameArt-Support
- Merge pull request #2028 from dnicolson/add-light-theme
- Merge pull request #2029 from Provenance-Emu/tvOS-GameInfo-Tweaks
- Merge pull request #2030 from Provenance-Emu/feature/JoystickFixes
- Merge pull request #2033 from dnicolson/fix-library-bottom-separators
- Merge pull request #2036 from Provenance-Emu/feature/gh_build_action
- Merge pull request #2038 from Provenance-Emu/mrjschulte_section_header_fix_tvOS

### GitLog

- Add theme switcher
- Add ThemeOptions enum
- Adjust cell height as needed
- AppDelegate refactor code, improve URL open
- AppDelegate start of save open
- azure 14.1
- azure pipeline macos-12
- azure turn off xcode pretty
- azure update to newer xcode/macos
- cdx4 fix submodule
- cicd remove UIBrackgroundModes processing
- citra: combine platforms
- core 4do updates to fix tvos
- cores framework don’t embed
- cores table view, hide unsupported cores unless on
- Cores, add .core.name to ones that didn’t
- cxd4 fix submodule bs
- delete dup schemes, new shaders, blissemu framewk
- delete old tvos schemes and rename others
- desmume2015 readd and fix debug
- duckstation: fix some build stuff
- entitlements remove ones that break xc cloud
- Extend navigation bar
- Extensions placeholders for new ones
- fastlane update
- Fix 4do build and almost works, bad gfx freedo
- Fix and update Marketing Version 2.1.2
- Fix button height constraint warning
- fix catalyst builds
- Fix cell background color
- Fix cell font sizes
- Fix controller selection table cell focus
- Fix entitlement paths for 2 extions
- Fix extensions in build
- Fix iCade controller cell background
- Fix iCloud, Spotlight entitlement, re-import path
- fix ios/tvos build
- Fix library options cell background color
- Fix logs crash
- fix macos/catalyst build and export
- Fix navigation bar tint color
- Fix PVFile iCloud paths incorrect
- Fix slider cell text alignment
- fix some warnings and self capture
- Fix stack spacing constraint warning
- fix submodules
- Fix SwiftUI crash on iOS 16
- fix tvos availability
- Fix tvOS build
- flycast builds
- flycast, fbneo, dolphin fix some build stuff
- Frameworks combined into single multi-platform!
- fuse fix some build stuff
- game view cell, hide delete text on start
- GameLibVC fix potential crash
- gba remove driverkit
- gcdweb fix QOS
- genesis: reflector2static libs, submodule 4 upstrm
- gh action fix xcodebuild command
- gh action macos-12
- git insists on touching these submodules
- github action build test
- GitHub actions disable broken ones
- gitignore .xcarchive
- Hide unsupported cores from conflicts unless on
- iCloud containers fix thread issue/warning
- icloud sync catch exception
- Improve how theme is set
- Info.plist add ITSAppUsesNonExemptEncryption
- Info.plist fix xcode cloud issues
- Install the CodeSee workflow. Learn more at https://docs.codesee.io
- intellivision respond protocol fixes
- ios fix gliden compile
- iOS settings menu replace (i) with >
- jaguar: core update video fixes
- Launch screen add brazil locale
- libretro build flags update
- Make web server alerts consistent
- mednafen fix targeted device families
- mednafen refactor controls to catagory
- mednafen: refactor compiler flags to xcconfig
- mednafen: remove broken options,controller reorder
- melon DLOG for nslog
- melonds build flags update
- MetalVC minor catalyst chagnes
- mu fixed embedded framework
- mupen audio on/off callbacks
- mupen speed option
- mupen: fix crash on load
- mupen: hi res off by default, fix catalyst
- n64 controller fix warning
- obscure cores various build fixes
- On screen controller adjustments
- option lcd filter
- Patreon features
- pcsx reamred builds
- pcsx submodule
- pcsx, fix submodule again
- PCSXRearmed added to build
- play: builds with gfx and audio callbacks
- play: fix build
- play: fix release build
- Prevent bottom separators from disappearing
- project remove nil file
- ps2: add bios info
- PVGenesis -Os
- PVLIBRARY fix copy/embed
- PVLogVC fix tvOS color error
- Reduce width of log buttons
- Remove Bliss, its breaking CI
- remove broken cores from build
- Remove cancel action from alert
- Remove cell background color
- remove duckstation from build
- Remove forced dark interface style
- Remove iOS 11 conditional
- Remove iOS 13 conditionals
- remove old vibrate for xccloud
- Remove PVRadioOptionRow and PVRadioOptionCell
- Remove red cell background
- Remove redundant style
- Remove SettingsTableView class
- Remove styles in favor of defaults
- Remove SystemSettingsCell
- Remove SystemSettingsHeaderCell
- Remove unimplimented extensions from app target
- Remove unneeded code
- Remove unneeded guard clause
- Remove unneeded ifdef
- Remove unneeded QuickTableView generics (#2031)
- Remove unneeded section header styles
- Remove unneeded styling
- Remove unused code
- Remove unused file
- remove unused macos xib
- Remove unused styling
- Remove unused variable
- Remove VecXGL submodule
- rename o2em and jaguar cores to PV..
- Replace remaining com.provenance-emu with org
- Replace sync network with async for artwork
- Replace UIWebView with WKWebView
- retro: add bliss, 4do, some organization
- retro: add game music and vicx
- retro: all the cores
- retro: fix build missing #endif
- retro: fix framework dyload
- retro: fix tvos bitcode
- retro: gme builds and links
- retro: gme fix tvos build
- retro: gme loads
- retro: gme plays
- retro: ios biulds
- retro: metal video doesn’t crash but still odd
- retro: potator loads, fix static rom buffer copy
- retro: remove VecXGL for libretro version
- retro: software fb callback and pixl fmt fixes
- retro: split core into categories, add cores
- retro: the final cores! for now
- retro: tvOS builds
- retro: update core submodules
- retro: video callback pitchshift work
- rice: use newer branch, fixes catalyst
- Set library header background
- Set navigation bar style only for game library
- Set overrideUserInterfaceStyle
- Set settings button font only on tvOS
- Settings webDav always tvOS and sim
- Settings, disable swiftUI in iOS 13
- shaders add support for lcd/crt screen option
- Simplify code
- Single frameworks, catalyst, macos
- snes n64 fix a/b and deadzone
- snesticle builds
- snesticle: remove from app, needs work
- snesticle: tvos, add to ios build
- spotlight scheme update depends
- stella module fix
- stella snapshot
- stella xcconfig
- stella: delete duplicate files
- stella: use a submodule and static libs
- submodules: Single framework, macos
- swap experimentalCores option with unsupported
- swiftpm updates
- swiftpm update depends
- SwiftUI flow — make landing screen the console carousel if any consoles available, reduce side menu open width
- systems.plist update ext and bios for new cores
- tic80 add submodule
- tic80 submodule
- tvos add missing enums
- tvOS don’t copy glsl to docs
- tvOS fix duplicate symbols in mupen/gliden
- tvOS Fix jaguar compile
- tvOS fix missing target warnings, introspect err
- tvOS hide metadata edit behind #if TVOS_HAS_EDIT
- tweak previous commit
- update bliss
- Update bliss submodule, 2 targets
- Update deployment targets
- Update MednafenGameCore.mm
- Update PVGameLibrarySectionHeaderView.swift
- Update PVGameLibraryViewController.swift
- Update PVGameLibraryViewController.swift
- Update PVGameLibraryViewController.swift
- Update PVGameLibraryViewController+CollectionView.swift
- Update PVGameLibraryViewController+CollectionView.swift
- Update PVGameMoreInfoViewController.swift
- Update PVMetalViewController.m
- Update PVSettingsModel.swift
- Update PVSettingsModel.swift
- Update realm schema version
- Update rebase.yml
- Update save game alert
- update some core repos
- Update stella to upstream
- Update styles on theme change
- Update various cores and ios target includes
- Use different yellow that works with both themes
- Use ellipsis
- Use system alert system background color
- Use system background color for game library
- Use system background for game info
- Use system background for settings
- Use system color for “Game library empty”
- Use system colors for file logs
- Use system colors for live log
- Use system colors for save states
- Use system gear image
- Use system sort libray options background colors
- Use theme for section header style
- Use TVAlertController everywhere
- uupdate cores ios version and target platforms
- WebServer fix hardcoded 8080
- webserver fix queue QOS warning
- webserver nslog to logger
- whitespace
- xcodebuild action remove cache clear
- yabause: update c flags
- Add .all-contributorsrc config file
- add a working project for dosbox
- Add dosbox-pure
- Add fceux netplay server
- add framework targets for cores and expermnt cores
- add libretro framework
- add libretro target to framework
- beetle: it runs but no video
- bridging-header remove superfulous import availaiblity
- bump version to 2.1.1
- Cancel as localized string
- clean up window rootViewController assignment for SwiftUI path
- desmume use prov upstream
- desume builds with libretro
- dosbox add libretro library
- dosbox builds
- dosbox technically it builds
- dosbox: av tweaks
- dosbox: link correclty
- dosbox: some overwrides
- ds: add controls callbacks
- ds: melon and extensions tweaks
- duckstation: rebase
- Emu VC defer gesture .bottom to b,l,r
- Enable MTL fast math support
- ep128: fix c++ issue
- fbneo minor shit
- fceux add upstream submodule
- fceux update core to 2.6.2
- filters: add simple crt demo
- filters: metal filter menu
- First version of movable buttons
- Fix broken wiki link, minor UX improvements
- fix build
- fix compile
- fix gles shaders and add other framework core targetrs
- fix some tvos build issues
- fixes #1849 tgbdual crash on ios fixed
- fuck git sometimes
- fucking around with app clips and associated domai
- fxeux swift to 2.2.3
- gameimporter hacky override 4 updated gamefaq url
- gameimporter throw less by pre-checking
- gitignore dsstore
- gitignore newrelic file
- glescore: did i loop wrong?
- hacks: placeholder 4 volumebutton and carplay hax
- include assets
- iOS 13 target in xcconfig
- jag: add CD library support and loading
- jaguar: update core for memory fix
- libretro refactor and add files
- make a libretro and it builds
- mednafen: fix a build issue with switch statement
- Merge branch 'feature/dos-box' into develop
- Merge branch 'release/2.1.0' into develop
- Merge pull request #1761 from ianclawson/ian/swiftui-menu-path
- Merge pull request #1764 from Provenance-Emu/feature/MoveableButtons
- Merge pull request #1810 from Provenance-Emu/feature/fceuxUpdate
- Merge pull request #1900 from Provenance-Emu/feature/1888_N64_19x9
- Merge pull request #1901 from Provenance-Emu/feature/snes9xControllerFix
- Merge pull request #1909 from rrroyal/develop
- Merge pull request #1926 from Provenance-Emu/feature/JoystickLayoutFix
- Merge pull request #1933 from Provenance-Emu/feature/filtermanager
- movebuttons: fix some buttons from resetting
- mupen add more core options
- mupen fix type-o in option
- mupenx: core compile updates
- NOTICKET core options enum default fixed
- NOTICKET Options tableview popover rect fixed
- options onscreen joypad as beta setting
- package resolve update
- pblibretro base code
- prov: yabause hacks
- pvdosbox use retro core as base
- pvgenesis m68kcpu.c compiler flags
- pvretrocore start point
- refs #1765 fix non-dualshock start in  Saturn
- refs #1797 refactor fceux into static libs
- refs #1915 fixes psx start button layout
- remove appclip from build
- reto: video init code
- retro add more files
- retro:  start to add mupenNX
- retro: a bunch of fixes, build flag updates, controllers, gles core
- retro: add a beetle core cause y not
- retro: add hatari build
- retro: Add melonDS start of core
- retro: add minivmac core
- retro: add Mupen64Plus-NX
- retro: add potator cause y not
- retro: add potator core
- retro: add proper projects for test forks
- retro: add submodules and blank projects for more
- retro: add vmac and fix other stuff
- retro: add Yabause core
- retro: beetle builds?!
- retro: beetlepsx builds
- retro: better code to find cores
- retro: better wrapper
- retro: callbacks set
- retro: CORES OPEN MSX!
- retro: desmeme2015 prov patches
- retro: desmume, dosbox, neo, msx, genesis udates
- retro: double buffer and real screen dimensions
- retro: fbneo builds
- retro: fbneo builds shockingly
- retro: fix embedding framework
- retro: fix loading gles cores
- retro: fix paths, desumeme runs now
- retro: fix release builds
- retro: fix tvos build with melon,msx
- retro: i more linking stuff, fbneo start
- retro: kind of loads
- retro: more cores
- retro: more fb neo
- retro: more linking, libretro.h into build
- retro: mupen-nx has proper build, though errors
- retro: pbbeetle additions
- retro: pcsx rearmed some progress
- retro: remove broken beetle from build
- retro: reset targets, builds but empty
- retro: schemes for ep128, msx
- retro: stuff almost runs
- retro: submodules update
- retro: supervision works with new callbacks
- retro: tvos builds, refactor cores into frameworks
- retro: various fixes, tvos builds
- retro: vecrex
- retro: video work
- retro: yabause update
- shader manager
- shaders metal are wrong
- swiftlint corrections
- SwiftUI menu design revamp - bulk add all changes from fubar'ed branch
- systems.plist add DOS
- systems.plist fill in all openvgdb system ids
- systems.plist psx add compresed formats
- test adding dos to build
- Themes.swift cleanup some re-used code
- tvOS add debug setting to use themes
- tvOS fix swift ui build
- Update Atari8bit bios sizes
- Update blit_ps.metal
- Update PVSearchViewController.swift
- Update PVSNESEmulatorCore.mm
- xcconfig: GLES_SILENCE_DEPRECATION=1
- yabause: fix release build

---

## File: content/compare/_index.md

---
title: "iOS Emulator Comparisons"
date: 2026-03-05T00:00:00-05:00
pageDescription: "Objective comparisons between Provenance and other iOS emulators. Find the right retro game emulator for your iPhone, iPad, or Apple TV."
---

## More comparisons from the Provenance family

- [iCube vs Provenance](https://icube-emu.com/compare/icube-vs-provenance/) — iCube's standalone GameCube/Wii app compared to Provenance's GameCube core.
- [iCube vs Dolphin](https://icube-emu.com/compare/icube-vs-dolphin/) — iCube compared to running the Dolphin core directly.
- [iFly vs Provenance](https://ifly-emu.com/compare/ifly-vs-provenance/) — iFly's standalone Dreamcast app compared to Provenance's Dreamcast core.
- [iFly vs Flycast in RetroArch](https://ifly-emu.com/compare/ifly-vs-flycast/) — iFly compared to running the Flycast core in RetroArch.

---

## File: content/compare/provenance-vs-delta.md

---
title: "Provenance vs Delta: Which iOS Emulator Is Right for You?"
date: 2026-03-05T00:00:00-05:00
---

Both {{< brand >}}Provenance{{< /brand >}} and Delta are free options for playing retro games on iPhone. They serve different audiences, and the right choice depends on what systems you want to play and what devices you own. This page lays out the facts so you can decide for yourself.

## Feature Comparison

| Feature | {{< brand >}}Provenance{{< /brand >}} | Delta |
|---|---|---|
| **Price** | Free (sideload or App Store); Plus is optional | Free (App Store or sideload via AltStore) |
| **Beta / early features** | Public releases | Early access via Patreon or AltStore+ subscription |
| **Platforms** | iOS, iPadOS, tvOS (Apple TV) | iOS, iPadOS |
| **Apple TV support** | Yes — native tvOS app with full native UI | No |
| **Systems supported** | 38+ (NES, SNES, N64, GBA, GBC, GB, DS, PS1, Saturn, Genesis, and many more) | 7 (NES, SNES, N64, GBA, GBC, GB, DS) |
| **PlayStation 1** | Yes | No |
| **Sega Genesis/Mega Drive** | Yes | No |
| **Atari systems** | Yes | No |
| **Open source** | Yes (MIT License) | No |
| **Controller support** | MFi, Xbox, PlayStation, Bluetooth | MFi, Xbox, PlayStation, Bluetooth |
| **Custom skins** | Yes | Yes |
| **Cheats** | Yes | Yes |
| **Save states** | Yes | Yes |
| **RetroAchievements** | Yes | Yes |
| **Core updates** | Frequent — tracks libretro upstream | Infrequent — bundled cores |
| **Per-core config options** | Extensive | Limited |
| **Multiplayer (local)** | Yes | Yes |
| **Active development** | Yes | Yes |

## Where Delta Stands Out

Delta is focused exclusively on Nintendo systems and launched on the App Store in 2024. Its developer also created AltStore, so Delta integrates well with that sideloading ecosystem. For users who only need those seven Nintendo platforms, Delta provides a straightforward setup experience.

## Where Provenance Stands Out

{{< brand >}}Provenance{{< /brand >}} supports 38+ systems, covering platforms Delta does not: PlayStation 1, Sega Genesis, Saturn, Atari, and many more. If you want to play beyond Nintendo's library, {{< brand >}}Provenance{{< /brand >}} is the only option of the two.

{{< brand >}}Provenance{{< /brand >}} uses libretro cores that are actively maintained and updated from upstream, meaning you get newer emulation accuracy, broader compatibility, and more per-core configuration options. This translates to better game compatibility and more fine-grained control over emulation behavior versus bundled, less frequently updated cores.

{{< brand >}}Provenance{{< /brand >}} is one of the very few emulators with a native tvOS app. RetroArch also supports tvOS, but uses a cross-platform non-native UI shared with desktop platforms — requiring manual menu navigation and file management for setup. {{< brand >}}Provenance{{< /brand >}} provides a native Apple TV experience with Top Shelf extension, proper controller navigation, and no manual file wrangling. Being open source under the MIT license means the community can contribute, audit the code, and build on it.

## Summary

If you only need Delta's seven Nintendo systems, Delta is a functional free choice — though note that beta features and early builds require a Patreon or AltStore+ subscription. If you want broader system support — PlayStation, Sega, Atari, and 30+ more — a true native Apple TV experience, frequently updated libretro cores with more configuration options, or open source code, {{< brand >}}Provenance{{< /brand >}} is the stronger fit.

There is no technical reason you cannot use both apps simultaneously.

## Try Provenance

{{< brand >}}Provenance{{< /brand >}} is free to download from the App Store, with no subscription required for core features.

[Download Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

---

## File: content/compare/provenance-vs-manicemu.md

---
title: "Provenance vs ManicEmu: Which iOS Emulator Is Right for You?"
date: 2026-03-05T00:00:00-05:00
---

ManicEmu is a newer iOS emulator that appeared on the App Store in 2024 alongside several other options following Apple's policy changes. {{< brand >}}Provenance{{< /brand >}} has been around much longer and takes a different approach in terms of scope, pricing, and platform support. Here is a factual look at how they compare.

## Feature Comparison

| Feature | {{< brand >}}Provenance{{< /brand >}} | ManicEmu |
|---|---|---|
| **Price** | Free (sideload or App Store); Plus is optional | Free on App Store (premium features included); free to sideload |
| **Platforms** | iOS, iPadOS, tvOS (Apple TV) | iOS, iPadOS |
| **Apple TV support** | Yes — native tvOS app | No |
| **Systems supported** | 38+ systems | Multiple systems (Nintendo, SEGA, PlayStation) |
| **PlayStation 1** | Yes | Yes |
| **Sega Genesis/Mega Drive** | Yes | Yes |
| **Atari systems** | Yes | No |
| **Open source** | Yes (MIT License) | No (closed source) |
| **Controller support** | MFi, Xbox, PlayStation, Bluetooth | MFi, Xbox, PlayStation, Bluetooth |
| **Custom skins** | Yes | Yes |
| **Cheats** | Yes | Yes |
| **Save states** | Yes | Yes |
| **RetroAchievements** | Yes | Yes |
| **Core updates** | Frequent — tracks libretro upstream | Unknown (closed source) |
| **Per-core config options** | Extensive | Unknown (closed source) |
| **Active development** | Yes | Yes |

## Where ManicEmu Stands Out

ManicEmu is available directly on the App Store for free and can also be sideloaded at no cost. It supports a range of Nintendo and SEGA platforms and includes premium features without a paywall.

## Where Provenance Stands Out

{{< brand >}}Provenance{{< /brand >}} supports 38+ systems including Atari platforms and several others that ManicEmu does not cover. {{< brand >}}Provenance{{< /brand >}} is free when sideloaded, and the App Store version has no mandatory subscription — {{< brand >}}Provenance{{< /brand >}} Plus is an optional add-on for extra features, not a paywall for basic emulation.

{{< brand >}}Provenance{{< /brand >}} uses libretro cores that are actively maintained and updated from upstream, giving you newer emulation accuracy, broader game compatibility, and extensive per-core configuration options. ManicEmu is closed source, so its core quality, update cadence, and compatibility coverage are not independently verifiable.

{{< brand >}}Provenance{{< /brand >}} is open source under the MIT license — the code is publicly auditable and community-contributed. {{< brand >}}Provenance{{< /brand >}} is one of the few emulators with a native tvOS app. RetroArch also supports tvOS but uses a cross-platform non-native UI requiring manual menu diving and file management. {{< brand >}}Provenance{{< /brand >}} provides a proper native Apple TV experience with Top Shelf extension and full controller navigation out of the box.

## Pricing Summary

- {{< brand >}}Provenance{{< /brand >}}: Free via sideloading (AltStore, Sideloadly, etc.); also available on the App Store for free with {{< brand >}}Provenance{{< /brand >}} Plus as an optional in-app purchase
- **ManicEmu**: Free on the App Store with premium features included; also free to sideload

## Summary

If you want the broadest system support, a native Apple TV experience, open source code, and actively maintained libretro cores, {{< brand >}}Provenance{{< /brand >}} is the more capable choice. ManicEmu is a free alternative for users who need a narrower set of systems and don't need Apple TV.

## Try Provenance

{{< brand >}}Provenance{{< /brand >}} is free to download from the App Store, with no subscription required for core features.

[Download Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805)

---

## File: content/contact/_index.md

---
title: About Provenance
date: '2021-07-20T03:46:31.626Z'
pageDescription:
---

---

## File: content/donate/_index.md

---
title: "Support Development"
date: 2026-03-15T00:00:00-05:00
---

---

## File: content/faq/_index.md

---
title: "Frequently Asked Questions"
date: 2019-02-28T12:35:54+06:00
pageDescription: "Common questions about installing Provenance, supported consoles, controllers, and Provenance Plus."
---

---

## File: content/guides/_index.md

---
title: "How-To Guides"
date: 2026-03-05T00:00:00-05:00
pageDescription: "Step-by-step guides for getting the most out of Provenance, the free iOS and tvOS retro game emulator."
---

---

## File: content/guides/adding-games.md

---
title: "How to Add Games to Provenance"
date: 2026-03-05T00:00:00-05:00
tags: ["guide", "how-to"]
---

{{< brand >}}Provenance{{< /brand >}} supports games from 38+ retro systems, but you need to provide your own ROM files. This guide explains several methods for getting games into {{< brand >}}Provenance{{< /brand >}} on iPhone, iPad, or Apple TV.

## What You Need

You will need ROM files for the games you want to play. You are responsible for ensuring you have the legal right to use any ROM files. A common legal approach is to dump ROMs from physical cartridges you own.

## Method 1: Import from the Files App (Easiest)

This is the most straightforward method on iOS 17+.

1. **Transfer your ROM files to your iPhone or iPad.** You can do this via AirDrop, iCloud Drive, a USB cable and the Files app on Mac, or any cloud storage app like Google Drive or Dropbox.

2. **Open the Files app** and locate your ROM file.

3. **Long-press the ROM file** and tap **Share**.

4. **Select {{< brand >}}Provenance{{< /brand >}}** from the share sheet. {{< brand >}}Provenance{{< /brand >}} will open and automatically import the game into your library.

5. **Wait for the import to complete.** {{< brand >}}Provenance{{< /brand >}} will scan the file, identify the system, and add the game to your library with artwork if available.

## Method 2: WebDAV (Recommended for Bulk Transfers)

{{< brand >}}Provenance{{< /brand >}} includes a built-in WebDAV server that lets you transfer multiple ROMs at once from a computer on the same network.

1. **Open {{< brand >}}Provenance{{< /brand >}} on your iPhone or iPad.**

2. **Go to Settings > Import/Export > WebDAV Server** and tap **Start WebDAV Server**. {{< brand >}}Provenance{{< /brand >}} will show you an IP address and port number.

3. **On your Mac or PC**, open Finder (Mac) or Windows Explorer (Windows). On Mac, press `Cmd+K` in Finder and enter `http://[IP address shown in Provenance]:[port shown in Provenance]/`. On Windows, map a network drive to the same address, including the port.

4. **Copy your ROM files** into the appropriate system folder in the WebDAV share.

5. **Stop the WebDAV server** in {{< brand >}}Provenance{{< /brand >}} and return to the library. {{< brand >}}Provenance{{< /brand >}} will scan and import the new files.

## Method 3: iTunes File Sharing

If you prefer a wired connection to a Mac or PC:

1. **Connect your iPhone or iPad to your computer** with a USB cable.

2. **Open Finder on Mac** (or iTunes on Windows) and select your device.

3. **Go to the Files tab** and find {{< brand >}}Provenance{{< /brand >}} in the app list.

4. **Drag your ROM files** into the {{< brand >}}Provenance{{< /brand >}} documents folder.

5. **Disconnect and open {{< brand >}}Provenance{{< /brand >}}.** The app will detect and import the new files.

## Method 4: Adding Games to Apple TV

Apple TV has a more restricted filesystem, so game management works differently.

1. **Add games using one of the methods above on your iPhone or iPad first.**

2. **Use the {{< brand >}}Provenance{{< /brand >}} WebDAV server on iPhone/iPad** and access it from Apple TV via the {{< brand >}}Provenance{{< /brand >}} tvOS app, if you have a shared library configured.

3. Alternatively, check the {{< brand >}}Provenance{{< /brand >}} wiki for the latest recommended approach for Apple TV, as options may expand with new app versions.

## Tips

- {{< brand >}}Provenance{{< /brand >}} automatically identifies most ROMs and downloads artwork from an online database. If a game is not recognized, try renaming the file to match the official game title.
- BIOS files for certain systems (PlayStation, Sega Saturn, etc.) must be added separately. See the {{< brand >}}Provenance{{< /brand >}} wiki for the full list of required BIOS files and where to place them.
- If a game does not appear after import, check that the file extension matches the expected format for that system.

## Download Provenance

{{< brand >}}Provenance{{< /brand >}} is free on the App Store and supports 38+ retro systems out of the box. [Get Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805). For advanced features, explore [Provenance Plus](/plus/).

---

## File: content/guides/apple-tv-airplay.md

---
title: "How to Play on Apple TV with Provenance"
date: 2026-03-05T00:00:00-05:00
tags: ["guide", "how-to"]
---

{{< brand >}}Provenance{{< /brand >}} is one of the only iOS emulators with native Apple TV support, letting you play 38+ retro game systems on your television. This guide covers both the native tvOS app and using AirPlay to mirror from your iPhone or iPad.

## Option 1: Native tvOS App

The {{< brand >}}Provenance{{< /brand >}} tvOS app runs directly on Apple TV, giving you the best performance and lowest latency. This is the recommended approach for regular gaming sessions.

### Steps

1. **Install {{< brand >}}Provenance{{< /brand >}} on your Apple TV.** Open the App Store on your Apple TV, search for "{{< brand >}}Provenance{{< /brand >}}," and download it.

2. **Add games to {{< brand >}}Provenance{{< /brand >}}.** The easiest way is to use the {{< brand >}}Provenance{{< /brand >}} app on your iPhone or iPad to add games, then use a shared library or WebDAV to sync them. You can also add ROMs via iTunes File Sharing from a Mac or PC.

3. **Pair a controller.** The Apple TV Siri Remote provides basic input but is not ideal for gaming. Pair a Bluetooth controller via **Apple TV Settings > Remotes and Devices > Bluetooth**. See our [controller setup guide](/guides/controller-setup/) for details.

4. **Launch {{< brand >}}Provenance{{< /brand >}} on Apple TV.** Open the app, navigate to your game library, and select a game to play.

5. **Adjust display settings if needed.** If the screen does not fill your TV, check your Apple TV display settings under **Settings > Video and Audio** and ensure the resolution matches your TV.

## Option 2: AirPlay from iPhone or iPad

If you prefer to run the game on your iPhone or iPad and stream the display to your TV, you can use AirPlay.

### Steps

1. **Connect your Apple TV and iPhone/iPad to the same Wi-Fi network.**

2. **Open Control Center on your iPhone or iPad.** Swipe down from the top-right corner (on Face ID devices) or up from the bottom (on older devices).

3. **Tap Screen Mirroring** and select your Apple TV from the list.

4. **Open {{< brand >}}Provenance{{< /brand >}} on your iPhone or iPad and launch a game.** The display will mirror to your TV in real time.

5. **Pair a controller to your iPhone or iPad** for a better gaming experience. See our [controller setup guide](/guides/controller-setup/).

## Tips

- For the best gaming experience on Apple TV, use the native tvOS app rather than AirPlay, which can introduce input lag over Wi-Fi.
- A wired Ethernet connection for your Apple TV will reduce any network-related issues.
- The SteelSeries Nimbus+ and Xbox Series X/S controllers are well-tested with the {{< brand >}}Provenance{{< /brand >}} tvOS app.
- Volume can be adjusted using the Apple TV remote even while a game is running.

## Download Provenance

{{< brand >}}Provenance{{< /brand >}} is available for free on the App Store for both iOS and tvOS. [Get Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805). For extra features, visit [Provenance Plus](/plus/).

---

## File: content/guides/controller-setup.md

---
title: "How to Use a Controller with Provenance"
date: 2026-03-05T00:00:00-05:00
tags: ["guide", "how-to"]
---

{{< brand >}}Provenance{{< /brand >}} supports a wide range of physical game controllers on both iOS and tvOS, giving you a much more authentic retro gaming experience. This guide walks you through connecting a controller and getting it working in {{< brand >}}Provenance{{< /brand >}}.

## Supported Controllers

{{< brand >}}Provenance{{< /brand >}} works with any MFi (Made for iPhone) certified controller and most Bluetooth controllers, including:

- **PlayStation DualSense and DualShock 4** — pair via Bluetooth
- **Xbox Series X|S and Bluetooth-capable Xbox One controllers (e.g., Xbox One S)** — pair via Bluetooth
- **8BitDo controllers** — pair via Bluetooth (use MFi mode)
- **SteelSeries Nimbus+** and other MFi controllers
- **Apple TV Siri Remote** — limited input, works for basic navigation

## Steps

1. **Put your controller in pairing mode.** For PlayStation and Xbox controllers, hold the pairing button until the light flashes. For 8BitDo controllers, hold the pairing button and switch to MFi/iOS mode as described in the controller's manual.

2. **Open Settings on your iPhone, iPad, or Apple TV.** Go to **Settings > Bluetooth** and ensure Bluetooth is turned on.

3. **Select your controller from the device list.** It should appear under "Other Devices." Tap it to pair. Once connected, it will move to the "My Devices" section.

4. **Open {{< brand >}}Provenance{{< /brand >}} and launch a game.** Your controller should be detected automatically. You do not need to configure anything inside {{< brand >}}Provenance{{< /brand >}} for standard button layouts.

5. **Access in-game settings if needed.** While a game is running, swipe down from the top of the screen (or press the Menu button on your controller) to access the {{< brand >}}Provenance{{< /brand >}} overlay. From there you can adjust controller mappings under **Settings > Controllers**.

6. **Customize button mappings (optional).** In the {{< brand >}}Provenance{{< /brand >}} settings, navigate to **Controllers** to remap buttons for individual systems or globally.

## Tips

- If your controller is not detected, try toggling Bluetooth off and on, then re-pairing.
- On Apple TV, the Siri Remote serves as a secondary controller for Player 2 in some games.
- For the most reliable experience on Apple TV, use a controller with a strong MFi certification such as the SteelSeries Nimbus+.
- 8BitDo controllers must be in the correct pairing mode for iOS. Refer to your controller's manual for the exact button combination.

## Download Provenance

{{< brand >}}Provenance{{< /brand >}} is free to download from the App Store. [Get Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805). For additional features, check out [Provenance Plus](/plus/).

---

## File: content/guides/custom-skins.md

---
title: "How to Install Custom Controller Skins in Provenance"
date: 2026-03-13T00:00:00-05:00
tags: ["guide", "how-to", "skins"]
---

{{< brand >}}Provenance{{< /brand >}} supports custom controller skins, letting you replace the default on-screen controls with community-created artwork that matches the original hardware. Hundreds of skins are available for free at the [Provenance Skin Catalog](https://provenance-emu.com/skins/).

## What Are Controller Skins?

Controller skins are themed overlays for the on-screen button layout that appears when playing without a physical controller. A skin defines the layout, button positions, and artwork for a specific system. {{< brand >}}Provenance{{< /brand >}} uses the open `.deltaskin` and `.manicskin` file formats — the same formats used by Delta and Manic, so a large back-catalog of skins works out of the box.

## Find a Skin

**[Browse the Provenance Skin Catalog →](https://provenance-emu.com/skins/)**

The catalog is searchable by system (GBA, SNES, PlayStation, etc.) with thumbnail previews. You can also find skins on:

- The [Provenance Discord](https://discord.gg/4TK7PU5) — `#skins` channel
- [DeltaStyles.com](https://deltastyles.com) — Delta skins are fully compatible with {{< brand >}}Provenance{{< /brand >}}
- GitHub repositories — search for `.deltaskin` or `.manicskin` files

## Install a Skin

### Option 1 — Download directly on iPhone/iPad (easiest)

1. On your iPhone or iPad, open the [Skin Catalog](https://provenance-emu.com/skins/) in Safari.
2. Tap any skin card, then tap **⬇ Download**.
3. iOS will ask which app to open the file with — choose {{< brand >}}Provenance{{< /brand >}}.
4. The skin is imported automatically and ready to use.

### Option 2 — Import via the Files app

1. Download the `.deltaskin` or `.manicskin` file to your Files app (Downloads folder).
2. Open {{< brand >}}Provenance{{< /brand >}} and go to **Settings → Skins**.
3. Tap **Import Skin** (the `+` or import button) to open the Files picker.
4. Navigate to your downloaded file and select it.
5. {{< brand >}}Provenance{{< /brand >}} imports and validates the skin.

### Option 3 — Share from another app

If a skin was sent to you via Discord, Messages, or another app:

1. Tap and hold the file, then tap **Share**.
2. Select {{< brand >}}Provenance{{< /brand >}} from the share sheet.
3. {{< brand >}}Provenance{{< /brand >}} opens and imports the skin immediately.

## Activate a Skin

After importing, activate the skin for a system:

1. Go to **Settings → Skins**.
2. Select the system you want to customize (e.g. Game Boy Advance).
3. Tap the skin you imported and tap **Use This Skin**.
4. Launch any game for that system — the skin will be active.

## Tips

- Skins are **system-specific** — a GBA skin won't work for SNES. Check the system tag before downloading.
- **iPad skins** often have landscape-optimized layouts. Look for skins tagged `ipad` or `landscape`.
- The **Skin Catalog** automatically extracts thumbnails from skin files, so what you see in the preview is what you get.
- Want to **make your own skin**? The format is documented at [wiki.provenance-emu.com](https://wiki.provenance-emu.com/info/skins-guide).
- **Submit your skin** to the community catalog at [provenance-emu.com/skins/submit.html](https://provenance-emu.com/skins/submit.html).

## Download Provenance

{{< brand >}}Provenance{{< /brand >}} is free on the App Store — no jailbreak required.

[Get Provenance on the App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) · [Provenance Plus](/plus/)

---

## File: content/install/_index.md

---
title: "Install Provenance"
date: 2026-03-15T00:00:00-05:00
---

---

## File: content/licenses/_index.md

---
title: "Open Source Licenses"
type: "licenses"
---

---

## File: content/plus/_index.md

---
title: "Provenance Plus"
date: 2026-03-05T00:00:00-05:00
pageDescription: "Support development and unlock cloud sync, beta access, and priority support."
---

---

## File: content/press/_index.md

---
title: "Press Kit"
date: 2026-03-05T00:00:00-05:00
pageDescription: "Everything journalists, bloggers, and content creators need to cover Provenance."
---

---

## File: content/privacy/_index.md

---
title: Privacy Policy
date: '2021-07-20T03:47:35.309Z'
pageDescription: ''
---

---

## File: content/product/_index.md

---
title: "About Provenance"
date: 2019-02-28T12:35:54+06:00
pageDescription : ""
---

---

## File: content/redirect/altstore.md

+++
# For example, to Redirect from /old_blog to /blog, set 
# url to "/old_blog" and redirect_to to "/blog" below
type = "redirect"
url = "/altstore"
redirect_to = "altstore://source?url=https://provenance-emu.com/apps.json"
redirect_enabled = true
private = false
+++

---

## File: content/redirect/ipa.md

+++
# For example, to Redirect from /old_blog to /blog, set 
# url to "/old_blog" and redirect_to to "/blog" below
type = "redirect"
url = "/ipa"
redirect_to = "https://github.com/Provenance-Emu/Provenance/releases/latest"
redirect_enabled = true
private = false
+++

---

## File: content/redirect/patreon.md

+++
# For example, to Redirect from /old_blog to /blog, set 
# url to "/old_blog" and redirect_to to "/blog" below
type = "redirect"
url = "patreon"
redirect_to = "https://www.patreon.com/provenance"
redirect_enabled = true
private = true
+++

---

## File: content/redirect/patreon_redirect.md

+++
# For example, to Redirect from /old_blog to /blog, set 
# url to "/old_blog" and redirect_to to "/blog" below
type = "redirect"
url = "patreon_redirect"
redirect_to = "https://www.patreon.com/provenance"
redirect_enabled = true
private = false
+++

---

## File: content/redirect/pr.md

+++
# For example, to Redirect from /old_blog to /blog, set 
# url to "/old_blog" and redirect_to to "/blog" below
type = "redirect"
url = "/pr"
redirect_to = "itms-services://?action=download-manifest&url=https://provenance-builds.s3-us-east-2.amazonaws.com/prs/1810/Provenance%202022-02-19%2014-24-44/manifest.plist"
redirect_enabled = true
private = false
+++

---

## File: content/redirect/sidestore.md

+++
type = "redirect"
url = "/sidestore"
redirect_to = "sidestore://source?url=https://provenance-emu.com/apps.json"
redirect_enabled = true
private = false
+++

---

## File: content/status/_index.md

---
title: "Site Status"
type: "status"
draft: false
---

---

## File: content/systems/3ds.md

---
title: "Play Nintendo 3DS Games on iPhone & iPad | Provenance"
date: 2026-03-13
system: "Nintendo 3DS"
shortName: "3DS"
supportedFormats: ".3ds, .cia, .cxi, .app, .ncsd, .ncch"
---

{{< brand >}}Provenance{{< /brand >}} brings the Nintendo 3DS to iPhone and iPad through the Azahar (formerly Citra) emulation core. The 3DS library spans nearly a decade of outstanding handheld gaming — Pokémon X/Y/Sun/Moon, The Legend of Zelda: A Link Between Worlds, Fire Emblem Fates, Monster Hunter 4 Ultimate, and hundreds more.

## Supported File Formats

- `.3ds` — Standard 3DS ROM format (most common)
- `.cia` — CTR Importable Archive (installed game format)
- `.cxi` / `.app` — 3DS executable formats
- `.ncsd` / `.ncch` — Raw NAND/card image formats

## Encryption Note

Many 3DS ROMs are encrypted. {{< brand >}}Provenance{{< /brand >}} requires decrypted ROMs or proper AES keys to run encrypted titles. See the [wiki](https://wiki.provenance-emu.com/info/system-guides/3ds) for setup details.

## Features

- **Azahar Core** — Derived from Citra, offering broad 3DS game compatibility
- **Save States** — Snapshot support independent of in-game saves
- **Controller Support** — Full analog stick and button support via MFi, Xbox, and PlayStation controllers
- **Circle Pad Support** — Full analog input mapping including the Circle Pad Pro buttons
- **Touchscreen** — Bottom-screen touch input mapped to on-screen overlay

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your 3DS save states and game library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your decrypted 3DS ROM files** via the Files app or Wi-Fi import.
3. **Start playing** — your 3DS games appear in your library automatically.

For detailed setup instructions and encryption key guidance, visit the [Provenance wiki](https://wiki.provenance-emu.com/info/system-guides/3ds).

---

## File: content/systems/_index.md

---
title: "Retro Console Emulator for iOS & iPhone | Provenance"
---

{{< brand >}}Provenance{{< /brand >}} is a free, open-source emulator for iPhone, iPad, and Apple TV that supports more than 38 classic gaming systems. Whether you want to play Super Nintendo games, revisit PlayStation classics, or dive into your Game Boy Advance library, {{< brand >}}Provenance{{< /brand >}} has you covered — no jailbreak required.

Browse the consoles below to learn about ROM format support, features, and how to get started.

---

## File: content/systems/atari2600.md

---
title: "Play Atari 2600 Games on iPhone | Provenance"
date: 2024-03-05
system: "Atari 2600"
shortName: "Atari 2600 / VCS"
supportedFormats: ".a26, .bin, .rom"
---

The Atari 2600 — originally sold as the Video Computer System — launched in 1977 and brought arcade gaming into living rooms for the first time. Its library of Pitfall!, Space Invaders, Pac-Man, Asteroids, and Combat defined early home gaming. With {{< brand >}}Provenance{{< /brand >}}, you can play the entire 2600 catalog on your iPhone, iPad, or Apple TV.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. No jailbreak required.

## Supported File Formats

Atari 2600 ROM files are small by modern standards. {{< brand >}}Provenance{{< /brand >}} supports all common formats:

- `.a26` — The dedicated Atari 2600 ROM extension
- `.bin` — Generic binary format; the most common format for 2600 dumps
- `.rom` — Alternate ROM extension used by some archiving tools

Because Atari 2600 cartridges were so small — most are under 32KB — entire libraries take up a fraction of modern storage.

## Features

Playing Atari 2600 games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save at any point; most 2600 games had no native save functionality, making this essential for longer sessions
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; the simple 2600 joystick maps naturally to a single analog stick and button
- **Shader Support** — CRT scanline and phosphor filters to recreate the warm, blurry look of playing on a 1970s television
- **Cheat Codes** — Code support for supported titles
- **Fast Forward** — Accelerate through slower sections
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Atari 2600 save states and game library. Your progress and high scores stay consistent whether you're playing on your iPhone or Apple TV.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Atari 2600 ROM files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — your game library appears automatically once files are imported.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/dreamcast.md

---
title: "Play Sega Dreamcast Games on iPhone | Provenance"
date: 2024-03-05
system: "Sega Dreamcast"
shortName: "Dreamcast / DC"
supportedFormats: ".cdi, .gdi, .chd, .iso"
---

Sega's Dreamcast was ahead of its time — online multiplayer, VMU memory cards, and an exceptional software library that included Shenmue, Sonic Adventure, Jet Set Radio, Marvel vs. Capcom 2, and Soul Calibur. Though the hardware was discontinued in 2001, the games hold up remarkably well. {{< brand >}}Provenance{{< /brand >}} brings the Dreamcast to your iPhone, iPad, and Apple TV.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. No jailbreak required.

{{< family-app app="ifly" text="Want a dedicated Dreamcast app? iFly is our standalone Flycast-based emulator." compare="https://ifly-emu.com/compare/ifly-vs-provenance/" >}}

## Supported File Formats

Dreamcast games were GD-ROM disc-based. {{< brand >}}Provenance{{< /brand >}} supports the standard Dreamcast disc image formats:

- `.gdi` — GD-ROM Disc Image format; the most accurate representation of Dreamcast discs, typically paired with `.bin` track files in the same directory
- `.cdi` — DiscJuggler image format; widely used for Dreamcast backups
- `.chd` — Compressed Hunks of Data format; significantly reduces file sizes while maintaining full compatibility
- `.iso` — Standard disc image format for compatible releases

CHD is the recommended format for a Dreamcast library — Dreamcast games are large, and CHD compression makes them much more practical to store on a mobile device.

## Features

Playing Dreamcast games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save anywhere, supplementing the Dreamcast's own VMU save system
- **VMU Emulation** — Virtual Memory Unit support for games that use the Dreamcast's built-in save functionality
- **Controller Support** — Full analog stick and trigger support via MFi, Xbox, and PlayStation controllers, closely matching the Dreamcast controller layout; on-screen touch controls also available
- **Shader Support** — CRT filters and upscaling options that make Dreamcast's distinctive art style shine on Retina displays
- **Cheat Codes** — Code support for Dreamcast titles
- **Fast Forward** — Skip loading screens or speed through slower sections

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Dreamcast save states, so your Shenmue chapter progress and Marvel vs. Capcom 2 unlocks are automatically backed up and available across all your devices.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Dreamcast disc image files** via iTunes File Sharing, the Files app, or web import. For GDI images, keep all associated track files in the same folder.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} will detect your Dreamcast titles automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/gamecube.md

---
title: "Play GameCube Games on iPhone & iPad | Provenance"
date: 2026-03-13
system: "Nintendo GameCube"
shortName: "GameCube"
supportedFormats: ".iso, .gcm, .gcz, .rvz, .wbfs, .ciso"
---

{{< brand >}}Provenance{{< /brand >}} brings the Nintendo GameCube to iPhone, iPad, and Apple TV through the Dolphin emulation core — the same battle-tested engine used on desktop platforms. The GameCube library is home to some of the greatest games ever made: The Legend of Zelda: The Wind Waker, Super Mario Sunshine, Metroid Prime, Resident Evil 4, and F-Zero GX.

{{< family-app app="icube" text="Want a dedicated GameCube and Wii app? iCube is our standalone Dolphin-based emulator with the same team behind it." compare="https://icube-emu.com/compare/icube-vs-provenance/" >}}

## Supported File Formats

- `.iso` — Standard GameCube disc image
- `.gcm` — GameCube Master disc image (same format, different extension)
- `.gcz` — Dolphin-compressed GameCube image
- `.rvz` — Modern Dolphin compressed format (recommended — best compression)
- `.wbfs` — Wii Backup File System image (also accepted)
- `.ciso` — Compact ISO format

## Features

- **Dolphin Core** — Industry-standard GameCube/Wii emulation with broad game compatibility
- **Save States** — Snapshot and restore at any point, independent of memory card saves
- **Memory Card Emulation** — Virtual memory cards for in-game saves, no physical hardware needed
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support; analog sticks fully supported
- **Widescreen Support** — Many GameCube games support 16:9 widescreen mode
- **Folder Structure** — Organize your library using Dolphin's standard folder conventions

## Getting GameCube ROMs

GameCube games are large (typically 1–1.5 GB per disc). RVZ format offers the best compression while maintaining full compatibility. Use Dolphin on your Mac to rip your own GameCube discs.

See the [wiki guide on formatting ROMs](https://wiki.provenance-emu.com/installation-and-usage/roms/formatting-roms) for details on GameCube file organization.

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your GameCube save states and game library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your GameCube ROM files** via the Files app, Wi-Fi import, or iTunes File Sharing.
3. **Start playing** — GameCube games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/gb.md

---
title: "Play Game Boy Games on iPhone | Provenance"
date: 2024-03-05
system: "Game Boy"
shortName: "GB / DMG"
supportedFormats: ".gb, .gbc"
---

Nintendo's original Game Boy launched in 1989 and went on to become one of the best-selling consoles of all time. With {{< brand >}}Provenance{{< /brand >}}, you can play the full Game Boy library — including Game Boy Color titles — on your iPhone, iPad, or Apple TV. Tetris, Pokémon Red and Blue, The Legend of Zelda: Link's Awakening, Kirby's Dream Land: all of it, in your pocket again.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store with no jailbreak needed.

## Supported File Formats

{{< brand >}}Provenance{{< /brand >}} supports both original Game Boy and Game Boy Color ROM formats:

- `.gb` — Standard Game Boy ROM format, covering the original gray-cartridge library
- `.gbc` — Game Boy Color ROMs, including titles that require the GBC and those with enhanced color support on GBC hardware

The same emulator handles both formats seamlessly. If a game has GBC enhancements, {{< brand >}}Provenance{{< /brand >}} will render them correctly.

## Features

Playing Game Boy and Game Boy Color games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save at any point, not just at in-game save prompts; essential for the original Game Boy's battery-save limitations
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; on-screen touch controls also available
- **Shader Support** — Apply a classic green-tinted DMG palette filter or CRT-style effects to nail the original handheld aesthetic
- **Cheat Codes** — Game Genie and GameShark code support for Game Boy titles
- **Fast Forward** — Speed through slow text sequences or random encounters
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Game Boy save states and game library. Your Pokémon save files and Link's Awakening progress stay backed up and available across all your devices automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Game Boy ROM files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} detects your Game Boy and GBC titles automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/gba.md

---
title: "Play Game Boy Advance Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "Game Boy Advance"
shortName: "GBA"
supportedFormats: ".gba"
---

{{< brand >}}Provenance{{< /brand >}} includes a full Game Boy Advance emulator for iPhone, iPad, and Apple TV. The GBA had an outstanding lineup of games — Pokemon FireRed and LeafGreen, The Legend of Zelda: The Minish Cap, Metroid Fusion, Castlevania: Aria of Sorrow — and {{< brand >}}Provenance{{< /brand >}} lets you play the entire library on your Apple device.

Available free on the App Store with no jailbreak required, {{< brand >}}Provenance{{< /brand >}} is one of the most capable GBA emulators available for iOS.

## Supported File Formats

- `.gba` — Standard Game Boy Advance ROM format

## Features

- **Save States** — Save and restore your progress at any point, independent of in-game saves
- **Battery Save Emulation** — Full support for GBA game save files, so in-game saves work exactly as expected
- **Controller Support** — Works with MFi, Xbox, and PlayStation wireless controllers; on-screen touch overlay available for handheld play
- **Shader Support** — Pixel-accurate rendering with optional CRT and LCD-style visual filters
- **Cheat Codes** — GameShark and Action Replay code support
- **Fast Forward** — Speed through slow sections or skip repetitive encounters

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) brings iCloud sync to your GBA save states and library. Start a Pokemon run on your iPhone and pick up exactly where you left off on your iPad or Apple TV — automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your GBA ROM files** using iTunes File Sharing, the Files app, or {{< brand >}}Provenance{{< /brand >}}'s web import.
3. **Start playing** — your Game Boy Advance games appear in your library immediately.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/gbc.md

---
title: "Play Game Boy & Game Boy Color Games on iPhone | Provenance"
date: 2024-03-05
system: "Game Boy Color / Game Boy"
shortName: "GBC / GB"
supportedFormats: ".gbc, .gb"
---

{{< brand >}}Provenance{{< /brand >}} supports both the original Game Boy and the Game Boy Color on iPhone, iPad, and Apple TV. With hundreds of classic titles spanning two generations — Pokemon Red and Blue, The Legend of Zelda: Link's Awakening, Tetris, Pokemon Gold and Silver, Kirby's Dream Land, and countless others — the Game Boy library is one of the most beloved in gaming history.

{{< brand >}}Provenance{{< /brand >}} is free on the App Store, open-source, and requires no jailbreak.

## Supported File Formats

- `.gb` — Original Game Boy ROM format
- `.gbc` — Game Boy Color ROM format

Game Boy Color is backward-compatible with original Game Boy cartridges, and {{< brand >}}Provenance{{< /brand >}} handles both seamlessly. GBC-enhanced games that were playable on the original GB work correctly in {{< brand >}}Provenance{{< /brand >}} as well.

## Features

- **Save States** — Save your progress at any moment, completely separate from in-game saves
- **Battery Save Emulation** — In-game save systems (like those in Pokemon) are fully emulated
- **Color Palettes** — For original Game Boy games, {{< brand >}}Provenance{{< /brand >}} can apply color palettes similar to those used by the real Game Boy Color hardware
- **Controller Support** — Works with MFi, Xbox, and PlayStation controllers; on-screen touch controls available for handheld use
- **Fast Forward** — Speed through slower sections or dialogue
- **Cheat Codes** — Game Genie and GameShark code support

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Game Boy and Game Boy Color save states. Whether you're playing Pokemon on your iPhone or your iPad, your save data follows you automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Game Boy ROM files** (`.gb` for original, `.gbc` for Color) via iTunes File Sharing, the Files app, or web import.
3. **Start playing** — your Game Boy and Game Boy Color games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/genesis.md

---
title: "Play Sega Genesis Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "Sega Genesis / Mega Drive"
shortName: "Genesis / Mega Drive"
supportedFormats: ".md, .bin, .gen, .smd"
---

{{< brand >}}Provenance{{< /brand >}} includes a Sega Genesis emulator for iPhone, iPad, and Apple TV, covering both the North American Genesis and the international Mega Drive. Sonic the Hedgehog, Streets of Rage, Mortal Kombat, Phantasy Star IV — the Genesis library is enormous and {{< brand >}}Provenance{{< /brand >}} gives you access to all of it on your Apple device.

Available free on the App Store, {{< brand >}}Provenance{{< /brand >}} requires no jailbreak and is fully open-source.

## Supported File Formats

- `.md` — Standard Mega Drive / Genesis ROM format
- `.bin` — Binary ROM dump, common for Genesis cartridge dumps
- `.gen` — Alternate Genesis ROM extension
- `.smd` — Super Magic Drive interleaved format

## Features

- **Save States** — Save and resume anywhere in a game, separate from in-game saves
- **Controller Support** — MFi, Xbox, and PlayStation wireless controllers work great; the 6-button Genesis layout is fully mapped; on-screen controls available for touch play
- **Shader Support** — CRT scanline effects and other filters for an authentic or enhanced presentation
- **Cheat Codes** — Game Genie and Action Replay code support for Genesis titles
- **Fast Forward** — Speed up slow sections or bypass repetitive content

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Genesis save states, keeping your progress backed up and available across all your Apple devices automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Genesis / Mega Drive ROM files** via iTunes File Sharing, the Files app, or web import.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} detects your Sega Genesis games and adds them to your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/jaguar.md

---
title: "Play Atari Jaguar Games on iPhone | Provenance"
date: 2026-09-07
system: "Atari Jaguar"
shortName: "Jaguar"
supportedFormats: ".j64, .jag, .rom, .abs, .cof, .bin, .prg, .cdi, .cue"
---

Atari's Jaguar was the company's last home console, launched in 1993 and marketed as the first "64-bit" system. Its library is small but has a devoted following, with standout titles like Tempest 2000, Alien vs Predator, and Iron Soldier. {{< brand >}}Provenance{{< /brand >}} emulates the Jaguar, including Jaguar CD titles, through the Virtual Jaguar core.

{{< family-app app="jaguar" text="Virtual Jaguar libretro is the core that powers this emulation, and it has its own site with detailed compatibility and performance data." >}}

## Supported File Formats

- `.j64` — Standard Jaguar cartridge ROM format
- `.jag` — Alternative Jaguar cartridge ROM extension
- `.rom` — Generic ROM extension used by some Jaguar dumps
- `.abs` — Jaguar executable/homebrew format
- `.cof` — Jaguar COFF executable format
- `.bin` — Raw binary cartridge dump
- `.prg` — Jaguar program/homebrew format
- `.cdi` / `.cue` — Jaguar CD disc images, supported where the underlying core provides Jaguar CD emulation

## BIOS

Jaguar CD titles may require BIOS files for full compatibility. See [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements) for details.

## Features

- **Virtual Jaguar Core** — Cartridge and Jaguar CD emulation
- **Save States** — Snapshot and restore progress at any point
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your Jaguar save states and library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Jaguar ROM files** via the Files app or Wi-Fi import.
3. **Start playing** — your Atari Jaguar games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/lynx.md

---
title: "Play Atari Lynx Games on iPhone | Provenance"
date: 2026-03-13
system: "Atari Lynx"
shortName: "Lynx"
supportedFormats: ".lnx, .lyx"
---

The Atari Lynx was the world's first color handheld gaming console, released in 1989 — beating the Game Boy Color to market by almost a decade. Its hardware was technically impressive for its time, featuring hardware-accelerated sprites and scaling. Standout titles include California Games, Chip's Challenge, Rygar, and Blue Lightning.

{{< brand >}}Provenance{{< /brand >}} emulates the Atari Lynx through the Mednafen core.

## Supported File Formats

- `.lnx` — Standard Atari Lynx ROM format
- `.lyx` — Alternative Lynx ROM extension (headerless format)

## BIOS

The Atari Lynx requires a BIOS file for full compatibility. See [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements) for details.

## Features

- **Mednafen Core** — Accurate Lynx emulation
- **Save States** — Snapshot and restore progress at any point
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support
- **Orientation Support** — Some Lynx games were designed to be rotated 90° — {{< brand >}}Provenance{{< /brand >}} handles both orientations

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your Lynx save states and library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Lynx ROM files** and BIOS via the Files app or Wi-Fi import.
3. **Start playing** — your Atari Lynx games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/mastersystem.md

---
title: "Play Sega Master System Games on iPhone | Provenance"
date: 2024-03-05
system: "Sega Master System"
shortName: "Master System / Mark III"
supportedFormats: ".sms, .bin, .rom"
---

The Sega Master System — released in Japan as the Mark III — was Sega's answer to the NES, featuring sharper graphics and a library that included Alex Kidd in Miracle World, Sonic the Hedgehog, Phantasy Star, and Golden Axe Warrior. While the NES dominated North America, the Master System found a devoted audience in Europe and Brazil. {{< brand >}}Provenance{{< /brand >}} brings the full Master System and Mark III library to your iPhone, iPad, and Apple TV.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. No jailbreak required.

## Supported File Formats

Master System cartridges used straightforward ROM formats. {{< brand >}}Provenance{{< /brand >}} supports all common options:

- `.sms` — The standard Sega Master System ROM extension
- `.bin` — Generic binary format; many Master System and Mark III dumps use this extension
- `.rom` — Alternate ROM extension used by some archiving tools

Master System ROM files are small — typically under 512KB — making entire libraries easy to manage on a mobile device.

## Features

Playing Master System games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save and resume anywhere; most Master System games used passwords rather than battery saves, making save states a major quality-of-life improvement
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; the Master System's simple two-button layout maps cleanly to any modern controller
- **Shader Support** — CRT scanline and phosphor filters to recreate the look of the original hardware on a period-correct television
- **Cheat Codes** — Code support for supported titles
- **Fast Forward** — Speed through slower segments or repetitive sequences
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Master System save states and game library, keeping your Phantasy Star progress and Sonic high scores consistent across your iPhone, iPad, and Apple TV.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Master System ROM files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — your game library appears automatically once files are imported.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/n64.md

[Binary file]

---

## File: content/systems/nds.md

---
title: "Play Nintendo DS Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "Nintendo DS"
shortName: "NDS"
supportedFormats: ".nds"
---

{{< brand >}}Provenance{{< /brand >}} includes Nintendo DS emulation for iPhone, iPad, and Apple TV. The DS had a remarkable dual-screen library — Pokemon Diamond and Pearl, Mario Kart DS, The Legend of Zelda: Phantom Hourglass, Chrono Trigger DS, Professor Layton, and hundreds more — and {{< brand >}}Provenance{{< /brand >}} brings that library to your Apple device.

Available free on the App Store, no jailbreak required. {{< brand >}}Provenance{{< /brand >}} is fully open-source and community-developed.

## Supported File Formats

- `.nds` — Standard Nintendo DS ROM format

## Features

- **Dual-Screen Display** — {{< brand >}}Provenance{{< /brand >}} renders both DS screens, with layout options to fit your device's screen
- **Save States** — Save and resume anywhere, independent of the DS's own save system
- **Battery Save Emulation** — In-game saves work as expected, preserving your in-game progress
- **Controller Support** — MFi, Xbox, and PlayStation controllers are supported; touchscreen input handles DS touch-screen interactions
- **Fast Forward** — Speed through cutscenes and dialogue-heavy sections

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Nintendo DS save states, keeping your game progress backed up and synchronized across your iPhone, iPad, and Apple TV.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your NDS ROM files** via iTunes File Sharing, the Files app, or {{< brand >}}Provenance{{< /brand >}}'s web import feature.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} detects and displays your Nintendo DS games in your library.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/neogeo.md

---
title: "Play Neo Geo Games on iPhone | Provenance"
date: 2026-03-13
system: "SNK Neo Geo"
shortName: "Neo Geo"
supportedFormats: ".zip, .7z (MAME ROM sets)"
---

The SNK Neo Geo was legendary for bringing true arcade hardware home in 1990. Its MVS (arcade) and AES (home) versions ran identical game ROMs, making it the gold standard for fighting games and run-and-guns. The library is dominated by SNK classics: Metal Slug 1–3, King of Fighters '98, Samurai Shodown II, and The Last Blade 2 — games that hold up beautifully decades later.

{{< brand >}}Provenance{{< /brand >}} runs Neo Geo games through the MAME core with excellent game compatibility.

## Supported File Formats

Neo Geo games use MAME-style ROM sets — each game is a ZIP archive containing multiple ROM files. The ZIP filename must match the MAME ROM name exactly (e.g., `mslug.zip` for Metal Slug).

- `.zip` — MAME ROM set (standard)
- `.7z` — Compressed MAME ROM set

## BIOS Requirements

Neo Geo requires the Neo Geo BIOS (`neogeo.zip`) placed in the same folder as your game ROMs. See [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements) for details.

## Features

- **MAME Core** — Broad Neo Geo game compatibility with accurate hardware emulation
- **Save States** — Snapshot and restore at any point
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support
- **4-Button Layout** — Full support for Neo Geo's A/B/C/D button layout on modern controllers
- **Memory Card Emulation** — Virtual Neo Geo memory card for in-game saves

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your Neo Geo save states and library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Neo Geo ROM sets** and `neogeo.zip` BIOS via the Files app or Wi-Fi import.
3. **Start playing** — your Neo Geo games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/nes.md

---
title: "Play NES Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "Nintendo Entertainment System"
shortName: "NES / Famicom"
supportedFormats: ".nes, .fds, .unf, .unif"
---

{{< brand >}}Provenance{{< /brand >}} brings the Nintendo Entertainment System — and its Japanese counterpart, the Famicom — to your iPhone, iPad, and Apple TV. The NES defined an entire generation of gaming, giving us Super Mario Bros., The Legend of Zelda, Metroid, Mega Man, Castlevania, Contra, and countless other classics. Now you can carry that legacy in your pocket, no jailbreak required.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. Just add your own ROM files and your NES library is ready to play.

## Supported File Formats

{{< brand >}}Provenance{{< /brand >}} supports all major NES and Famicom ROM formats:

- `.nes` — The standard iNES format, used by the vast majority of NES dumps
- `.fds` — Famicom Disk System images; the FDS was a Japan-only disk peripheral that hosted dozens of exclusive titles
- `.unf` / `.unif` — Universal NES Image Format, used for some unlicensed and homebrew titles

Famicom Disk System support means you can play FDS-exclusive games that never made it to cartridge in the West, including the original disk version of The Legend of Zelda and Metroid.

## Features

Playing NES games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save and resume at any point, bypassing the NES era's notoriously limited (or nonexistent) save systems
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; on-screen touch controls also available
- **Shader Support** — CRT scanline and other visual filters to recreate the look of playing on a real CRT television
- **Cheat Codes** — Game Genie code support for NES titles
- **Fast Forward** — Speed through repetitive sections or grind-heavy sequences
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your NES save states and game library, keeping your progress consistent across every device you own. Start a playthrough of Mega Man 2 on your iPhone and pick it up on Apple TV without missing a beat.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your NES ROM files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — your game library appears automatically once files are imported.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/pce.md

---
title: "Play PC Engine / TurboGrafx-16 Games on iPhone | Provenance"
date: 2026-03-13
system: "PC Engine / TurboGrafx-16"
shortName: "PCE / TG-16"
supportedFormats: ".pce, .ccd, .cue, .chd, .iso, .img"
---

{{< brand >}}Provenance{{< /brand >}} emulates the NEC PC Engine (sold as TurboGrafx-16 in North America) and its CD-ROM² add-on through the Mednafen core. Released in 1987 in Japan, the PC Engine punched well above its weight class with arcade-perfect ports and its revolutionary CD-ROM format. Highlights include Bonk's Adventure, Castlevania: Rondo of Blood, Ys Book I & II, and Street Fighter II'.

## Supported Systems

- **PC Engine / TurboGrafx-16** — HuCard cartridge games (`.pce`)
- **PC Engine CD-ROM² / TurboGrafx-CD** — CD-based games (`.ccd`, `.cue`, `.chd`)
- **SuperGrafx** — Enhanced PCE hardware (`.pce`, select titles)

## Supported File Formats

- `.pce` — PC Engine HuCard ROM
- `.cue` / `.ccd` / `.img` — CD image formats (use with CD-ROM games)
- `.chd` — Compressed Hunks of Data (recommended for CD images — smaller, faster)
- `.iso` — Raw ISO image (paired with audio tracks)

## BIOS Requirements

PC Engine CD-ROM² games require a BIOS file. See [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements) for the exact filename and placement instructions.

## Features

- **Mednafen Core** — Cycle-accurate PCE/PCE-CD emulation with excellent game compatibility
- **CHD Support** — Native CHD disc image support for CD-ROM games
- **Save States** — Full save state support
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support
- **6-Button Pad Support** — Extended controller mapping for Street Fighter II and other 6-button titles

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your PC Engine save states and game library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your PC Engine ROM files** via the Files app or Wi-Fi import.
3. **For CD games**, add your BIOS file first — see [BIOS Requirements](https://wiki.provenance-emu.com/installation-and-usage/bios-requirements).
4. **Start playing** — your PC Engine games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/ps2.md

---
title: "Play PlayStation 2 Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "PlayStation 2"
shortName: "PS2"
supportedFormats: ".iso, .bin/.cue, .chd"
---

The PlayStation 2 is the best-selling video game console ever made, and its library holds some of the greatest games ever created. {{< brand >}}Provenance{{< /brand >}} brings PS2 emulation to iPhone, iPad, and Apple TV — letting you play Grand Theft Auto: San Andreas, Shadow of the Colossus, God of War, Kingdom Hearts, Final Fantasy X, and hundreds of other titles on your Apple device.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. No jailbreak required.

## Supported File Formats

PlayStation 2 games were disc-based. {{< brand >}}Provenance{{< /brand >}} supports the most common PS2 disc image formats:

- `.iso` — Standard disc image format, the most widely used format for PS2 backups
- `.bin` / `.cue` — Common disc dump format; keep both files in the same directory
- `.chd` — Compressed Hunks of Data format; significantly reduces file sizes without sacrificing compatibility

CHD is recommended for large PS2 libraries — PS2 games can be several gigabytes each, and CHD compression makes storage much more manageable on a mobile device.

## Features

- **Save States** — Save anywhere, at any point in a game, not just at in-game memory card screens
- **Memory Card Emulation** — Virtual memory card support for games that use the PS2's standard save system
- **Controller Support** — Full analog stick and trigger support via MFi, Xbox, and PlayStation controllers; on-screen controls for touchscreen play
- **Shader Support** — Visual filters including upscaling options that make PS2-era graphics look sharper on modern Retina displays
- **Cheat Codes** — Code support for PS2 titles
- **Fast Forward** — Skip loading sequences or accelerate through slower sections

## Performance Note

PS2 emulation is computationally demanding. For the best experience, an iPhone 12 or newer (or equivalent iPad) is recommended. Older devices may experience reduced performance on graphically intensive titles.

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your PS2 save states, ensuring your progress on a lengthy RPG like Final Fantasy X or a massive open-world game like San Andreas is automatically backed up and available across all your devices.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your PS2 disc image files** via iTunes File Sharing, the Files app, or web import.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} will detect your PlayStation 2 titles automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/psp.md

---
title: "Play PSP Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "PlayStation Portable"
shortName: "PSP"
supportedFormats: ".iso, .cso, .pbp"
---

Sony's PlayStation Portable was a technical marvel when it launched in 2005, bringing near-PlayStation 2-quality gaming to a handheld. With {{< brand >}}Provenance{{< /brand >}}, you can bring that library to your iPhone, iPad, or Apple TV — playing God of War: Chains of Olympus, Crisis Core: Final Fantasy VII, Monster Hunter Freedom Unite, Persona 3 Portable, and dozens of other standout PSP titles.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store with no jailbreak required.

## Supported File Formats

PSP games are distributed as disc images or compressed archives. {{< brand >}}Provenance{{< /brand >}} supports the primary PSP formats:

- `.iso` — Standard UMD disc image, the most common format for PSP backups
- `.cso` — Compressed ISO format; reduces file sizes significantly while remaining broadly compatible
- `.pbp` — PlayStation Portable executable package format, used for digital and download releases

CSO compression is a practical choice for PSP games, which tend to be large and benefit from the space savings on mobile storage.

## Features

Playing PSP games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save at any moment, supplementing the PSP's own save system for extra flexibility
- **Controller Support** — Full analog stick support via MFi, Xbox, and PlayStation controllers, closely matching the PSP's original control layout; on-screen touch controls also available
- **Shader Support** — Visual filters and upscaling options to enhance PSP graphics on modern high-resolution displays
- **Cheat Codes** — Cheat code support for PSP titles
- **Fast Forward** — Speed through cutscenes or slower segments
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your PSP save states and game library. Whether you're deep into a Monster Hunter campaign or midway through a Crisis Core playthrough, Plus keeps your progress synced across every device automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your PSP game files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — your PSP library appears automatically once files are imported.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/psx.md

---
title: "Play PlayStation 1 Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "PlayStation"
shortName: "PS1 / PSX"
supportedFormats: ".bin/.cue, .iso, .img, .pbp, .chd"
---

{{< brand >}}Provenance{{< /brand >}} brings Sony's original PlayStation to iPhone, iPad, and Apple TV. The PS1 era produced some of the most iconic games in history — Final Fantasy VII, Metal Gear Solid, Castlevania: Symphony of the Night, and hundreds more — and {{< brand >}}Provenance{{< /brand >}} lets you play them all on your Apple device for free.

Available directly from the App Store, {{< brand >}}Provenance{{< /brand >}} is open-source and requires no jailbreak. Just add your own PlayStation disc images and start playing.

## Supported File Formats

PlayStation games were disc-based, so {{< brand >}}Provenance{{< /brand >}} supports several disc image formats:

- `.bin` / `.cue` — The most common PS1 dump format; keep both files together
- `.iso` — Standard disc image format
- `.img` — Alternate disc image format
- `.pbp` — PSP-style compressed PlayStation archives
- `.chd` — Compressed Hunks of Data format, greatly reduces file size while preserving disc accuracy

For multi-disc games, {{< brand >}}Provenance{{< /brand >}} handles disc switching so you can continue your save across discs.

## Features

- **Save States** — Save anywhere, not just at in-game memory card screens
- **Memory Card Emulation** — Virtual memory card support for games that use the PS1's built-in save system
- **Controller Support** — Full DualShock-style analog support via MFi, Xbox, and PlayStation controllers; on-screen controls for touchscreen play
- **Shader Support** — Apply CRT filters to replicate the visual style of original PlayStation hardware
- **Cheat Codes** — GameShark code support for PS1 titles
- **Fast Forward** — Skip cutscenes or accelerate through slower sections

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your PlayStation save states, so your progress on a long RPG is automatically backed up and available across all your devices.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your PS1 disc image files** via iTunes File Sharing, the Files app, or web import. If using `.bin`/`.cue`, import both files.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} will detect your PlayStation titles automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/saturn.md

---
title: "Play Sega Saturn Games on iPhone | Provenance"
date: 2024-03-05
system: "Sega Saturn"
shortName: "Saturn"
supportedFormats: ".bin/.cue, .iso, .chd"
---

The Sega Saturn was a cult classic — complex hardware that most developers struggled with, but that gave rise to some genuinely extraordinary games. Nights into Dreams, Virtua Fighter 2, Panzer Dragoon Saga, and the Japan-only port of Castlevania: Symphony of the Night all found their home on Saturn. {{< brand >}}Provenance{{< /brand >}} brings this rare library to your iPhone, iPad, and Apple TV.

{{< brand >}}Provenance{{< /brand >}} is free, open-source, and available directly from the App Store. No jailbreak required.

## Supported File Formats

Saturn games were CD-ROM based. {{< brand >}}Provenance{{< /brand >}} supports the standard Saturn disc image formats:

- `.bin` / `.cue` — The most common Saturn dump format; keep both files in the same directory when importing
- `.iso` — Standard disc image format compatible with many Saturn releases
- `.chd` — Compressed Hunks of Data format; highly recommended for Saturn libraries due to the space savings on large disc collections

Multi-disc Saturn games are supported, with disc-switching handled within the emulator.

## Features

Playing Sega Saturn games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save at any point; especially valuable for the Saturn's longer RPGs and adventure games
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; the Saturn's 6-button layout maps well to modern controllers for fighting games like Virtua Fighter
- **Shader Support** — CRT scanline and visual filters to replicate the look of Saturn games on period-accurate hardware
- **Cheat Codes** — Code support for Saturn titles
- **Fast Forward** — Speed through loading sequences, which were notoriously slow on Saturn hardware
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your Saturn save states, keeping your Panzer Dragoon Saga progress and Virtua Fighter records backed up and accessible across all your Apple devices automatically.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Saturn disc image files** via iTunes File Sharing, the Files app, or web import. For `.bin`/`.cue` files, import both together.
3. **Start playing** — {{< brand >}}Provenance{{< /brand >}} will detect your Sega Saturn titles automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/snes.md

---
title: "Play Super Nintendo Games on iPhone & iPad | Provenance"
date: 2024-03-05
system: "Super Nintendo Entertainment System"
shortName: "SNES / Super Famicom"
supportedFormats: ".smc, .sfc, .fig, .swc"
---

{{< brand >}}Provenance{{< /brand >}} brings the Super Nintendo Entertainment System to your iPhone, iPad, and Apple TV. With a library spanning RPGs, platformers, fighting games, and more, the SNES remains one of the most beloved consoles ever made — and now you can experience it all on your Apple device without a jailbreak.

As a free, open-source app available directly from the App Store, {{< brand >}}Provenance{{< /brand >}} makes it simple to load your own SNES ROM files and start playing within minutes.

## Supported File Formats

{{< brand >}}Provenance{{< /brand >}} supports the most common SNES ROM formats:

- `.smc` — The most widely used Super Nintendo ROM format
- `.sfc` — Super Famicom ROM files (Japanese releases)
- `.fig` — Early dump format, still widely compatible
- `.swc` — Super Wild Card format

## Features

Playing SNES games in {{< brand >}}Provenance{{< /brand >}} gives you access to the full suite of emulator features:

- **Save States** — Save and resume at any point, not just official in-game saves
- **Controller Support** — Full MFi, Xbox, and PlayStation controller compatibility; on-screen touch controls also available
- **Shader Support** — CRT scanline and other visual filters to recreate the look of playing on a real TV
- **Cheat Codes** — Game Genie and Pro Action Replay code support
- **Fast Forward** — Speed through slow sections or grinding sequences
- **On-Screen Controls** — Customizable touch overlay for playing without a physical controller

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) adds iCloud sync for your SNES save states and game library, so your progress carries across all your devices automatically. If you play on your iPhone during a commute and pick up an Apple TV controller at home, Plus keeps everything in sync.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your SNES ROM files** to {{< brand >}}Provenance{{< /brand >}} using iTunes File Sharing, the Files app, or a web server import.
3. **Start playing** — your game library appears automatically once files are imported.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/systems/virtualboy.md

---
title: "Play Virtual Boy Games on iPhone | Provenance"
date: 2026-03-13
system: "Nintendo Virtual Boy"
shortName: "Virtual Boy"
supportedFormats: ".vb, .vboy"
---

The Nintendo Virtual Boy was Nintendo's bold and ill-fated 1995 experiment with stereoscopic 3D — a table-top headset that displayed red monochrome graphics in two viewports to create depth. It sold poorly and was discontinued within a year, producing only 22 commercial games. That rarity makes the library a fascinating collector's target, and titles like Wario Land and Galactic Pinball hold up as genuinely good games.

{{< brand >}}Provenance{{< /brand >}} emulates the Virtual Boy through the Mednafen core, displaying the iconic red-on-black graphics on your iPhone screen.

## Supported File Formats

- `.vb` — Standard Virtual Boy ROM format
- `.vboy` — Alternative Virtual Boy ROM extension

## Features

- **Mednafen Core** — Accurate Virtual Boy emulation covering the full commercial library
- **Display Modes** — Red/black classic display or colorized modes for easier viewing
- **Save States** — Snapshot and restore at any point
- **Controller Support** — Full MFi, Xbox, and PlayStation wireless controller support with proper D-Pad support for the Virtual Boy's dual D-pad layout

## iCloud Sync with Provenance Plus

[Provenance Plus](/plus/) syncs your Virtual Boy save states and library across all your Apple devices via iCloud.

## How to Get Started

1. **Download {{< brand >}}Provenance{{< /brand >}}** from the [App Store](https://apps.apple.com/us/app/provenance-app/id1596862805) — it's free.
2. **Add your Virtual Boy ROM files** via the Files app or Wi-Fi import.
3. **Start playing** — your Virtual Boy games appear in your library automatically.

For detailed setup instructions, visit the [Provenance wiki](https://wiki.provenance-emu.com/).

---

## File: content/team/_index.md

---
title: Our Team
date: '2021-07-20T03:48:54.536Z'
pageDescription: We have a global team with people who have experience in building emulators
---

---

## File: data/about.yml

about:
  enable: true
  title : "This is our story."
  content : "Replay the past in the present."
  imageSlider:
    - image : "images/about/story-slider-01.webp"
      imageAlt : "images/about/story-slider-01.jpg"

    - image : "images/about/story-slider-01.webp"
      imageAlt : "images/about/story-slider-01.jpg"

    - image : "images/about/story-slider-01.webp"
      imageAlt : "images/about/story-slider-01.jpg"

# behind story
behindStory:
  enable : true
  title : "Why we created Small Apps"
  content : "Nulla quis lorem ut libero malesuada feugiat. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla quis lorem ut libero malesuada feugiat. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Proin eget tortor risus. Proin eget tortor risus. Proin eget tortor risus. Nulla quis lorem ut libero malesuada feugiat. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui. Vivamus suscipit tortor eget felis porttitor volutpat."

# create story
createStory:
  - image : "images/blog/post-01.webp"
    imageAlt : "images/blog/post-01.jpg"
    title : "Our Story"
    content : "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nulla consequat massa.Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu."
    
  - image : "images/blog/post-03.webp"
    imageAlt : "images/blog/post-03.jpg"
    title : "What we do"
    content : "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nulla consequat massa.Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu."

# quote slider
quoteSlider:
  enable : true
  sliderItem : 
    - quote : "Behind every great product, there is a great mind."
      quoteBy : "-TechCrunch"
      
    - quote : "Behind every great product, there is a great mind."
      quoteBy : "-TechCrunch"

# clients slider
clients: 
  enable : true
  title : "Featured In"
  clientSlider :
   - clientsLogo : "images/clients/business-finder.png"
   - clientsLogo : "images/clients/forbes.png"
   - clientsLogo : "images/clients/venture-beat.png"
   - clientsLogo : "images/clients/tech-crunch-new.png"

# investors
investors :
  enable : true
  title : "Our Angel Investors"
  description : "Nulla quis lorem ut libero malesuada feugiat. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla quis lorem ut libero malesuada feugiat."
  investor :
    - image : "images/team/marketing-team-01.webp"
      imageAlt : "images/team/marketing-team-01.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-02.webp"
      imageAlt : "images/team/marketing-team-02.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-03.webp"
      imageAlt : "images/team/marketing-team-03.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-01.webp"
      imageAlt : "images/team/marketing-team-01.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-02.webp"
      imageAlt : "images/team/marketing-team-02.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-03.webp"
      imageAlt : "images/team/marketing-team-03.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-01.webp"
      imageAlt : "images/team/marketing-team-01.jpg"
      name : "Spider Web"
      designation : "Investor"
      
    - image : "images/team/marketing-team-02.webp"
      imageAlt : "images/team/marketing-team-02.jpg"
      name : "Spider Web"
      designation : "Investor"

# call to action
cta :
  enable : true

---

## File: data/career.yml

# promo video
promo:
  enable : true
  title : "Who we're looking for"
  content : "Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. eget tortor risus. Vivamus magna justo, lacinia eget consectetur sed,convallis at tellus. Vivamus suscipit tortor eget felis porttitor volutpat.Curabitur arcu erat, accumsan id imperdiet et, porttitor at sem. Praesent sapien massa, convallis"
  videoThumb : "images/thumbs/promo-video-thumbnail.webp"
  videoThumbAlt : "images/thumbs/promo-video-thumbnail.jpg"
  videoURL : "https://www.youtube.com/embed/g3-VxLQO7do?autoplay=1"

# gallary
gallary:
  enable : true
  gallaryItem:
    - image : "images/gallery/gallery-01.webp"
      imageAlt : "images/gallery/gallery-01.jpg"

    - image : "images/gallery/gallery-02.webp"
      imageAlt : "images/gallery/gallery-02.jpg"
      
    - image : "images/gallery/gallery-03.webp"
      imageAlt : "images/gallery/gallery-03.jpg"

# funfacts
funfacts:
  enable : true
  title : "Some amenities for you to enjoy"
  funfactItem:
    - icon : "tf-ion-ios-stopwatch-outline"
      title : "Flexible hours"
      content : "Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Donec rutrum congue leo eget malesuada."
      
    - icon : "tf-ion-ios-wineglass"
      title : "Free Snacks & Drinks"
      content : "Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Donec rutrum congue leo eget malesuada."
      
    - icon : "tf-ion-ios-game-controller-b-outline"
      title : "Gaming"
      content : "Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Donec rutrum congue leo eget malesuada."
      
    - icon : "tf-ion-ios-flask-outline"
      title : "4 Working Days"
      content : "Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Donec rutrum congue leo eget malesuada."

# job list
job:
  enable : true
  title : "Job Opening"
  jobList:
    # job item
    - title : "Andriod Developer"
      location : "Hamburg, Germany"
      details : "With experience in creating visual directions for tech products, you are able to set the standard and lead designers along the way. You are not only able to execute beautiful user experiences yourself but communicate those concepts to the team and clients."
      experienceList:
        - experience : "3+ years Development experience in a startup environment"
        - experience : "Strong knowledge of iOS, Android & Web Platforms"
        - experience : "Dynamic presentation and communication skills"
        - experience : "Self-motivation: You manage your own milestones, deadlines, and priorities"
      formAction : "#"
      
    # job item
    - title : "DevOps Engineer"
      location : "London, United Kingdom"
      details : "With experience in creating visual directions for tech products, you are able to set the standard and lead designers along the way. You are not only able to execute beautiful user experiences yourself but communicate those concepts to the team and clients."
      experienceList:
        - experience : "3+ years Development experience in a startup environment"
        - experience : "Strong knowledge of iOS, Android & Web Platforms"
        - experience : "Dynamic presentation and communication skills"
        - experience : "Self-motivation: You manage your own milestones, deadlines, and priorities"
      formAction : "#"
      
    # job item
    - title : "Operations Associate / Manager"
      location : "New Jersey , USA"
      details : "With experience in creating visual directions for tech products, you are able to set the standard and lead designers along the way. You are not only able to execute beautiful user experiences yourself but communicate those concepts to the team and clients."
      experienceList:
        - experience : "3+ years Development experience in a startup environment"
        - experience : "Strong knowledge of iOS, Android & Web Platforms"
        - experience : "Dynamic presentation and communication skills"
        - experience : "Self-motivation: You manage your own milestones, deadlines, and priorities"
      formAction : "#"
      
    # job item
    - title : "International Compliance Officer"
      location : "Hamburg, Germany"
      details : "With experience in creating visual directions for tech products, you are able to set the standard and lead designers along the way. You are not only able to execute beautiful user experiences yourself but communicate those concepts to the team and clients."
      experienceList:
        - experience : "3+ years Development experience in a startup environment"
        - experience : "Strong knowledge of iOS, Android & Web Platforms"
        - experience : "Dynamic presentation and communication skills"
        - experience : "Self-motivation: You manage your own milestones, deadlines, and priorities"
      formAction : "#"

---

## File: data/contact.yml

address:
  - icon : "tf-phone2"
    addressList:
      - listItem : "(00) 789 456 7890 (USA)"
      - listItem : "(88) 016 725 0455 (UK)"
      
  - icon : "tf-map2"
    addressList:
      - listItem : "36. St Michael’s St, Oxford OX1, UK"
      - listItem : "123, Pennsylvania, USA"

form:
  formAction : "#"

---

## File: data/family.yml

# Canonical Provenance family list — this is the SOURCE OF TRUTH.
# Other repos (icube-emu.github.io, ifly-emu.github.io, etc.) keep a hand-synced
# copy of this file with a header comment pointing back here. If you edit this
# list, update those copies too.
#
# Order is fixed — do not reorder without updating the sibling copies.
family:
  - key: provenance
    name: "Provenance"
    url: "https://provenance-emu.com/"
    tagline: "Multi-system retro emulator for iOS, tvOS and macOS"
  - key: icube
    name: "iCube"
    url: "https://icube-emu.com/"
    tagline: "GameCube & Wii emulator for iOS and tvOS"
  - key: ifly
    name: "iFly"
    url: "https://ifly-emu.com/"
    tagline: "Dreamcast emulator for iOS and tvOS"
  - key: jaguar
    name: "Virtual Jaguar libretro"
    url: "https://jaguar.provenance-emu.com/"
    tagline: "Atari Jaguar core for RetroArch and Provenance"
  - key: wiki
    name: "Provenance Wiki"
    url: "https://wiki.provenance-emu.com/"
    tagline: "Guides, ROM ripping, BIOS help"
  - key: github
    name: "GitHub"
    url: "https://github.com/Provenance-Emu"
    tagline: "Source code for every app"
  - key: discord
    name: "Discord"
    url: "https://discord.gg/4TK7PU5"
    tagline: "Community chat"

---

## File: data/faq.yml

faq:
  - title: "Getting Started"
    faqList:
      - question: "What is Provenance?"
        answer: "Provenance is a free, open-source multi-system emulator for iPhone, iPad, and Apple TV. It supports 38+ classic gaming consoles including SNES, PlayStation, Nintendo 64, Game Boy Advance, Sega Genesis, and many more. No jailbreak is required."

      - question: "How do I install Provenance?"
        answer: "Provenance is available on the App Store — search for 'Provenance Emulator'. You can also sideload it for free using tools like AltStore or Sideloadly. No jailbreak is required for either method."

      - question: "Is Provenance free?"
        answer: "Yes. Provenance is free to download from the App Store and free to sideload. Provenance Plus is an optional in-app purchase that unlocks extra features, but the core emulation experience has no paywall or mandatory subscription."

      - question: "What devices does Provenance support?"
        answer: "Provenance runs on iPhone, iPad, and Apple TV (tvOS). It provides a native tvOS experience with Top Shelf extension and full controller navigation — one of the very few emulators to offer this."

      - question: "Do I need to jailbreak my device?"
        answer: "No. Provenance works on standard, non-jailbroken devices. You can download it from the App Store or sideload it using AltStore or Sideloadly without any jailbreak."

  - title: "Supported Systems"
    faqList:
      - question: "What consoles does Provenance support?"
        answer: "Provenance supports 38+ systems including NES, SNES, Nintendo 64, Game Boy, Game Boy Color, Game Boy Advance, Nintendo DS, PlayStation 1, Sega Genesis / Mega Drive, Sega Saturn, Sega Master System, Sega Game Gear, Atari 2600, Atari 5200, Atari 7800, Atari Jaguar, TurboGrafx-16, and more."

      - question: "Does Provenance support PlayStation games?"
        answer: "Yes. Provenance supports PlayStation 1 (PS1/PSX) games. You will need your own legally obtained ROM or disc image files to play."

      - question: "Does Provenance support Nintendo DS?"
        answer: "Yes. Provenance supports Nintendo DS (NDS) emulation on iPhone, iPad, and Apple TV."

      - question: "Does Provenance support Sega Genesis?"
        answer: "Yes. Provenance supports Sega Genesis and Mega Drive games, as well as Sega Master System and Sega Game Gear."

      - question: "Will more systems be added in the future?"
        answer: "Provenance is actively developed and new system support is added over time. Follow the project on GitHub and join the Discord community to stay up to date on new releases."

  - title: "ROMs & Game Files"
    faqList:
      - question: "Where do I get ROMs?"
        answer: "You must supply your own ROM files obtained from cartridges or discs you legally own. Provenance does not distribute or host ROM files."

      - question: "What file formats does Provenance support?"
        answer: "Provenance supports standard ROM formats for each system — for example, .smc and .sfc for SNES, .z64 for N64, .gba for Game Boy Advance, .bin/.cue or .iso for PlayStation, and .md/.gen for Sega Genesis. Compressed .zip files are also supported for most systems."

      - question: "How do I add games to Provenance?"
        answer: "You can import games via iTunes File Sharing, the Files app, a local Wi-Fi web server built into Provenance, or cloud storage services. On Apple TV, use the companion iOS app to transfer files."

  - title: "Controllers & Input"
    faqList:
      - question: "What controllers work with Provenance?"
        answer: "Provenance supports MFi (Made for iPhone) controllers, Xbox controllers, PlayStation (DualShock/DualSense) controllers, and other Bluetooth gamepads. On-screen controls are also available."

      - question: "Can I use a keyboard or mouse?"
        answer: "Keyboard input is supported on devices running iPadOS. Mouse and trackpad input support depends on the emulated system."

      - question: "Does Provenance support multiplayer?"
        answer: "Yes. Local multiplayer is supported for systems that offered it. Connect multiple controllers to play with friends."

  - title: "Provenance Plus"
    faqList:
      - question: "What is Provenance Plus?"
        answer: "Provenance Plus is an optional in-app purchase that unlocks additional features such as enhanced themes, advanced settings, and extra customization options. The core emulation experience is fully free without it."

      - question: "Is Provenance Plus a subscription?"
        answer: "No. Provenance Plus is a one-time purchase, not a recurring subscription. You pay once and keep access to the Plus features."

      - question: "Do I need Provenance Plus to play games?"
        answer: "No. All core emulation features — playing games, save states, controller support, all supported systems — are available for free. Provenance Plus is optional and adds extra features on top."

---

## File: data/homepage.yml

# social proof
socialProof:
  enable: true
  items:
    # NOTE: Update the 'number' value below annually to reflect years since 2016.
    - number: "10+"
      text: "Years Strong"
    # NOTE: GitHub Stars count is fetched live at build time via the GitHub API (resources.GetRemote).
    # The 'number' value below is used as a fallback if the API call fails (e.g. rate limiting).
    # The 'id' field provides a stable key for this item; the template primarily uses 'id' but still includes a text-based fallback (e.g., matching "GitHub Stars").
    - id: "github_stars"
      number: "6.2K+"
      text: "GitHub Stars"
    - number: "38+"
      text: "Systems Supported"
    - number: "100%"
      text: "Free & Open"
# banner
banner:
  title : "Your Classic Games.\nReimagined for iOS & tvOS."
  description : "The best free, open-source iOS game emulator. Play retro games from 38+ consoles — SNES, N64, PlayStation, GBA, Dreamcast, and more — with native iOS features, beautiful metadata, and iCloud sync."
  bgImage : "images/home-banner.webp"
  bgImageAlt : "images/home-banner.jpg"
  image : "images/mobile.webp"
  imageAlt : "images/mobile.png"
  button:
    btnText : "Get on App Store"
    URL : "https://apps.apple.com/us/app/provenance-app/id1596862805"
    badge: "images/badges/app-store-badge.svg"
    btnText2: 'Get on AltStore'
    URL2: "altstore"
    badge2: "images/badges/altstore-badge.svg"
    btnText3: 'Download IPA'
    URL3: 'https://github.com/Provenance-Emu/Provenance/releases'
    badge3: "images/badges/github-badge.svg"
    btnText4: 'Get on SideStore'
    URL4: 'sidestore'
    badge4: "images/badges/sidestore-badge.svg"


# banner-feature
bannerFeature:
  - icon: "tf-ion-social-apple"
    title: "Feels Like Home on iOS"
  - icon: "tf-ion-image"
    title: "Beautiful Game Library"
  - icon: "tf-ion-monitor"
    title: "iPhone to Big Screen"
# why provenance
whyProvenance:
  enable: true
  title: "Why Choose Provenance?"
  items:
    - icon: "tf-ion-code"
      title: "100% Open Source"
      content: "Fully transparent code on GitHub. No hidden tracking, no data collection, no mystery code. Contribute, audit, or fork - it's your freedom."
    - icon: "tf-ion-social-apple-outline"
      title: "Premier Emulator on Apple TV"
      content: "Experience retro gaming on the big screen. Native tvOS support with TopShelf integration brings your games to the living room like no other app can."
    - icon: "tf-ion-android-apps"
      title: "38+ Systems in One App"
      content: "From Atari 2600 to PlayStation 2, including rare systems like PC-FX and Virtual Boy. Nearly all CD-based cores support CHD disc images, including a custom CHD implementation in our native Mednafen core not found in other standalone Mednafen forks."
    - icon: "tf-ion-locked"
      title: "Free Forever (Sideloaded)"
      content: "When you sideload or build from source, everything is free. No subscriptions, no paywalls, no tiers. App Store builds include optional Provenance Plus features, but all core functionality remains free."
    - icon: "tf-ion-ios-people"
      title: "Actively Developed"
      content: "10+ years of active development with new features shipping regularly. Recent additions include online cheat code lookup from the libretro database, an in-app controller guide, expanded cheat support across 10+ cores, and configurable CRT shaders."
    - icon: "tf-ion-ios-book"
      title: "Museum-Quality Library"
      content: "Not just a game list - a digital collection. Automatic artwork, manuals, release info. Your ROMs deserve better presentation."

# feature one
featureOne:
  enable : true
  image : "images/feature/feature-rom-metadata.webp"
  imageAlt : "images/feature/feature-rom-metadata.png"
  title : "Your Games, Beautifully Presented"
  content : "Every game gets the treatment it deserves. Automatic artwork downloads, release information, ratings, and even scanned manuals. Edit any detail to make your library truly yours."
  comment : ""
  clientName : "Built for collectors and players alike"


# feature two
featureTwo:
  enable : true
  image : "images/feature/n64-core-options.webp"
  imageAlt : "images/feature/n64-core-options.png"
  title : "Fine-Tune Your Experience"
  content : "Customize emulation settings in real-time. Dial in configurable CRT scanline and phosphor shaders, adjust audio, tweak per-core options, and look up cheat codes directly from the libretro database — all without leaving your game."
  comment : ""
  clientImage : ""
  clientName : "Power users and casual gamers covered"

# feature three — skin catalog CTA
featureThree:
  enable : true
  image : "images/mockups/iphone-snes-mk3.webp"
  imageAlt : "images/mockups/iphone-snes-mk3.png"
  title : "Personalize With Community Skins"
  content : "Browse hundreds of community-made controller skins in the <a href=\"https://provenance-emu.com/skins/\">Skin Catalog</a> — searchable by system with live previews. Skin creators can submit directly via GitHub or a simple URL drop. Browse, install, or contribute your own designs."
  button:
    enable: true
    btnText: "Browse Skin Catalog"
    URL: "https://provenance-emu.com/skins/"
  comment : ""
  clientImage : ""
  clientName : "Community-made skins for every system"

# mockup carousel
mockupCarousel:
  enable: true
  title: "See It In Action"
  subtitle: "Beautiful gameplay across multiple systems"
  items:
    - image: "images/mockups/iphone-saturn.webp"
      imageAlt: "images/mockups/iphone-saturn.png"
      title: "Sega Saturn"
    - image: "images/mockups/iphone-dreamcast.webp"
      imageAlt: "images/mockups/iphone-dreamcast.png"
      title: "Sega Dreamcast"
    - image: "images/mockups/iphone-psp.webp"
      imageAlt: "images/mockups/iphone-psp.png"
      title: "PlayStation Portable"
    - image: "images/mockups/iphone-gb.webp"
      imageAlt: "images/mockups/iphone-gb.png"
      title: "Nintendo Game Boy"
    - image: "images/mockups/iphone-gbc.webp"
      imageAlt: "images/mockups/iphone-gbc.png"
      title: "Nintendo Game Boy Color"
    - image: "images/mockups/iphone-gba.webp"
      imageAlt: "images/mockups/iphone-gba.png"
      title: "Nintendo Game Boy Advance"
    - image: "images/mockups/iphone-nes-crt.webp"
      imageAlt: "images/mockups/iphone-nes-crt.png"
      title: "Nintendo Entertainment System"
    - image: "images/mockups/iphone-snes.webp"
      imageAlt: "images/mockups/iphone-snes.png"
      title: "Super Nintendo Entertainment System"
    - image: "images/mockups/iphone-n64.webp"
      imageAlt: "images/mockups/iphone-n64.png"
      title: "Nintendo 64"
    - image: "images/mockups/iphone-psx.webp"
      imageAlt: "images/mockups/iphone-psx.png"
      title: "Sony PlayStation"
    - image: "images/mockups/iphone-32x-doom.webp"
      imageAlt: "images/mockups/iphone-32x-doom.png"
      title: "Sega 32X"
# tvOS showcase
tvosShowcase:
  enable: true
  title: "Your Living Room. Your Arcade."
  subtitle: "The Premier Full-Featured Emulator for Apple TV"
  image: "images/console_logos.webp"
  imageAlt: "images/console_logos.jpg"
  features:
    - title: "TopShelf Integration"
    - title: "Siri Remote Optimized"
    - title: "iCloud Game Sync"
    - title: "4K Ready"
# service
service:
  enable : true
  title : "38+ Game Systems. One App."
  description : "From Atari to PlayStation, we've got you covered. The most comprehensive console support of any iOS emulator."
  image : "images/console_logos.webp"
  imageAlt : "images/console_logos.jpg"
  serviceItem :
    - icon : "tf-ribbon"
      title : "Atari"
      content : "2600, 5200, 7800, 8-bit Computer, Jaguar, Lynx"

    - icon : "tf-puzzle"
      title : "Bandai"
      content : "WonderSwan, WonderSwan Color"

    - icon : "tf-bargraph"
      title : "NEC"
      content : "PC Engine/TurboGrafx-16, PC Engine Super CD-ROM² System / TurboGrafx-CD, PC Engine SuperGrafx, PC-FX"

    - icon : "tf-adjustments"
      title : "Nintendo"
      content : "3DS, DS, DSi, GameCube, Wii, Famicom / NES, Famicom Disk System, Game Boy, Super Famicom / SNES, Game Boy Color, Virtual Boy, Nintendo 64, Game Boy Advance, Pokemon mini"

    - icon: 'tf-puzzle'
      title: 'Sega'
      content: 'Dreamcast, SG-1000, Master System, Mega Drive / Genesis, Game Gear, Mega-CD / CD, 32X, Saturn'

    - icon: 'tf-puzzle'
      title: 'SNK'
      content: 'Neo Geo Pocket, Neo Geo Pocket Color'

    - icon: 'tf-puzzle'
      title: 'Sony'
      content: 'PlayStation, PlayStation 2, PSP'

    - icon: 'tf-puzzle'
      title: 'Coleco'
      content: 'ColecoVision'

    - icon: 'tf-puzzle'
      title: 'Philips'
      content: 'CD-i'

    - icon: 'tf-puzzle'
      title: 'Panasonic'
      content: '3DO'

    - icon: 'tf-puzzle'
      title: 'Commodore'
      content: '64, 128'

    - icon: 'tf-puzzle'
      title: 'Palm'
      content: 'PalmOS'

    - icon: 'tf-puzzle'
      title: 'Smith Engineering'
      content: 'Vectrex'

    - icon: 'tf-puzzle'
      title: 'id Software'
      content: 'Wolfenstein 3D, Doom, Doom 2'

    - icon: 'tf-puzzle'
      title: 'Sinclair'
      content: 'ZX Spectrum'

    - icon: 'tf-puzzle'
      title: 'Mattel'
      content: 'Intellivision'

    - icon: 'tf-puzzle'
      title: 'Microsoft'
      content: 'MSX, MSX2'

    - icon: 'tf-puzzle'
      title: 'PC'
      content: 'DOS'

# promo video
promoVideo:
  enable : false
  bgImage : "images/background/promo-video-back.webp"
  bgImageAlt : "images/background/promo-video-back.jpg"
  title : "Watch Our Promo Video"
  content : "Vivamus suscipit tortor eget felis porttitor volutpat. Curabitur arcu erat, accumsan id imperdiet et, porttitor at sem. Vivamus"
  videoURL : "http://www.youtube.com/watch?v=opj24KnzrWo"

# testimonial
testimonial:
  enable : true
  testimonialSlider:
    - name: "JanBob654 — App Store Review"
      image: "images/icons/icon.512x512.png"
      content : "I used Provenance for years and it was the best emulator of all. Its ease importing games, setting up controllers, and the fact it covered all the emulators I wanted made it a hands down winner. And when I saw I was able to play Colecovision I almost cried."

    - name: "Drivers455 — App Store Review"
      image: "images/icons/icon.512x512.png"
      content : "Been using this app for various systems from the Atari consoles to the Game Boy series, and so far the games have performed very well. The UI is also very easy to use and cool looking."

    - name: "Dmytro Pankratov — hutko.dev"
      image: "images/icons/icon.512x512.png"
      content : "Provenance is a top pick for users who care about accuracy and retro authenticity. It supports dozens of older systems — from Sega Genesis to Atari — and lets you tweak visuals using filters and custom scaling options."

    - name: "emulatorios.com"
      image: "images/icons/icon.512x512.png"
      content : "Provenance still feels premium. The interface is beautiful, box art is auto-fetched, and your game library looks organized instead of messy. Provenance is a joy to use."

# comparison highlights
comparisonHighlights:
  enable: true
  title: "What Makes Us Different"
  items:
    - feature: "Apple TV Support"
      provenance: true
      others: false
    - feature: "Open Source Code"
      provenance: true
      others: false
    - feature: "Number of Systems"
      provenance: "38+"
      others: "6-15"
    - feature: "Subscription Required"
      provenance: false
      others: true
    - feature: "Game Artwork & Manuals"
      provenance: true
      others: "Limited"
    - feature: "Multi-disc CD Support"
      provenance: true
      others: "Varies"
# press quotes
pressQuotes:
  enable: true
  title: "As Seen In"
  subtitle: "Coverage from the gaming and tech press"
  items:
    - quote: "Great news for game emulation fans who will for the first time have the opportunity to run PlayStation games on iOS without relying on sideloading."
      source: "9to5Mac"
      url: "https://9to5mac.com/2024/04/19/provenance-playstation-emulator-app-store/"
    - quote: "An iOS and tvOS multi-emulator frontend to help you play your childhood faves from times long past — supporting Sega, Sony, Atari, Nintendo systems and more."
      source: "Pocket Gamer"
      url: "https://www.pocketgamer.com/provenance/launch/"
    - quote: "The Provenance PlayStation, Nintendo, and Atari game emulator is now available for beta download on iPhone and iPad — and an Apple TV version is next."
      source: "iMore"
      url: "https://www.imore.com/gaming/the-provenance-playstation-nintendo-and-atari-game-emulator-is-now-available-for-beta-download-on-iphone-and-ipad-and-an-apple-tv-version-is-next"

# download
download:
  enable : true
  title : "Ready to Play?"
  description : "Get it on the App Store for the easiest install, or choose from alternative installation methods."
  downloadButton :
    - btnText : "App Store"
      icon : "tf-ion-social-apple"
      URL : "https://apps.apple.com/us/app/provenance-app/id1596862805"
      badge : "images/badges/app-store-badge.svg"
    - btnText : "AltStore"
      icon : "tf-ion-ios-cloud-download"
      URL : "altstore"
      badge : "images/badges/altstore-badge.svg"
    - btnText : "Download IPA"
      icon : "tf-ion-android-download"
      URL : "https://github.com/Provenance-Emu/Provenance/releases"
      badge : "images/badges/github-badge.svg"