Customizing ROMs

How to rename, replace covert art and change other game info…

ROMs in Provenance can be modified with the following customizations: Cover Art, Title, Descriptions, Genre, Publisher, Release Date, Region, Play History — all fully editable from the Game Info View (v1.5) or with the following methods:

****Replacing Cover Art ****[**Renaming Games **](****[**Editing Game Info**]( · v1.5, iOS only

Please refer to the Known Issues regarding Customizing ROMs before posting a new one.

Replacing Cover Art

There are a couple methods of getting custom or replacement artwork into the app for iOS, and one for tvOS users, with a couple options, including single-drop mass-replacement:

  • ****Pasting (from Mobile Browsers) · for iOS only

  • ****Uploading (via built-in Web Server)° · for iOS & tvOS

    • Web Server UI

    • WebDav Clients

° Mass-Replacing to restore Custom Art libraries or update multiple ROMs simultaneously is supported via Uploading only.


  • When uploading, all of your image filenames must match° your ROM filenames. (Formatting)

  • All image uploads must be either .png or .jpg formats

° Images without a matching ROM will stay in the directory until matched or deleted manually.


  1. In iOS, locate an image

    • Mobile Browser, Apple Photos, Files (iCloud Drive, Other Clouds, Remote Files apps, etc…

    • Tap and hold or use whatever button gets you to… Copy to Clipboard

  2. In Provenance (iOS only), lightly tap and hold for long press on the ROM you want to apply the replacement.

  3. Select Paste Custom Artwork. Done.


  1. Make sure your device's WiFi is turned on and connected to the same network as your computer.

  2. In Provenance: Turn on the Web Server:

    • Select the + button in the Game Library, or…

    • In Settings, select the Import/Export option.¹

    This is similar to Importing ROMs.

Web Server UI

  1. On computer, go to the URL http://[deviceip] in the pop-up dialog.

  2. Open the directory corresponding to your build…

    • Cover Art (v1.4, previous)

    • Imports (v1.5+)

  3. Upload your images…

    • Upload Files… button allows multiple file selections.

    • Drag & Drop is also supported.

WebDav Clients

  1. On computer, open a WebDav Client…

    • macOS Finder: Menu BarGoConnect to Server...

  2. Enter http://[deviceip]:81Connect as Guest → Provenance mounts as a new drive.

  3. Drag & Drop or Copy/Paste your images into:

    • Cover Art (v1.4, previous)

    • Imports (v1.5+)

  4. (Optional) tvOS: Enable Background Web Server option in Settings, if preferred.

¹ Exporting files (ROMs, BIOS, Saves, Cover Art) is also supported in both of the above methods.


  1. On Computer, store all your Custom Art files in _one folder._²

  2. Update all ROMs with Custom Art all in one single drop into…

    • Cover Art (v1.4, previous)

    • Imports (v1.5+)

² Requires all the correct formatting requirements be met before uploading.


  • When uploading, all of your image filenames must match° your ROM filenames.

  • All image uploads must be either .png or .jpg formats




Provenance v1.4, previous…


Provenance v1.5+:

[game].[romext].[imgext] (Legacy format broken in beta. Do not use!)

If images do not have a matching ROM they will stay in the directory until it has a match or deleted manually.


  1. In Provenance…

    • iOS: Tap & Hold for Long Press on the ROM you want to apply rename…

    • tvOS: Select ROM and Click/Press & Hold Remote or Controller Action Button…

  2. Select Rename

  3. Type new name. Done

…or alternatively you can edit the game title the Game Info View (iOS only)

Editing Game Info

  1. In Provenance… on the ROM you wish to edit:

    • Tap & Hold (Long Press), or…

    • 3D Touch and Swipe Up to bring up Game Info¹

  2. Tap & Hold (Long Press) on a field.

  3. Type, Paste, or Reset.² Done

¹ Game Info requires v1.5+, Editing is supported in iOS only ² Play History (Play Count, Time Spent Playing) can be reset, but not edited.

⚠️ Known Issues

  • Custom Cover Art is not retained on Refresh Library option in Settings, use at own risk. (you can always Mass Upload all of your custom artwork in one drop if you are using the Upload method (instead of Pasting), which is recommended, especially for large Custom Art libraries.

  • Uploading ROMs + Custom Cover Art in one archive may not yield a replacement until next Provenance quit/launch is cycled.

  • Uploading Cover Art before ROMs may not yield a replacement until next Provenance quit/launch is cycled.

  • Custom Game Names are not currently considered when doing Refresh Library.

  • Exhaustive meta data web-scraping fallbacks to additional sources are not currently implemented.

  • Option to match ROMs manually or Search for Covers from within app is not currently supported.

  • Files with extra . in filename will cause a crash.

🗯 If you are still stuck ask for help on our Discord.

Last updated