How to Install Custom Controller Skins in Provenance

Step-by-step guide to browsing, downloading, and installing custom controller skins in Provenance — the free iOS and tvOS retro game emulator.

  • guide
  • how-to
  • skins

Provenance 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.

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. Provenance 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 →

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

  • The Provenance Discord#skins channel
  • DeltaStyles.com — Delta skins are fully compatible with Provenance
  • 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 in Safari.
  2. Tap any skin card, then tap ⬇ Download.
  3. iOS will ask which app to open the file with — choose Provenance.
  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 Provenance 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. Provenance 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 Provenance from the share sheet.
  3. Provenance 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.
  • Submit your skin to the community catalog at provenance-emu.com/skins/submit.html.

Download Provenance

Provenance is free on the App Store — no jailbreak required.

Get Provenance on the App Store · Provenance Plus

Ready to Relive the Classics?

Download Provenance from the App Store and start playing your favorite retro games on iPhone, iPad, and Apple TV today.

Get Provenance