Provenance EMU
  • Welcome
  • Frequently Asked Questions
  • Installation & Usage
    • Installing Provenance
      • Sideloading
      • Building from Source
      • Updating
    • BIOS Requirements
    • ROMs
      • Importing ROMs
      • Formatting ROMs
      • Customizing ROMs
      • Modding ROMs
  • Info
    • Supported Systems
    • Controllers & Controls
      • Controllers
        • Controller Reviews
      • Controls
    • Game Saves
    • Miscellaneous
      • Restoring Files
      • Launch ROMs via URL
      • Virtualizing macOS
  • Help
    • Troubleshooting
    • Contributing
    • Discord
  • Development
    • GitHub
    • Release Roadmap
Powered by GitBook
On this page
  • Replacing Cover Art
  • Pasting
  • Uploading
  • Formatting
  • Renaming
  • Editing Game Info
  • ⚠️ Known Issues

Was this helpful?

  1. Installation & Usage
  2. ROMs

Customizing ROMs

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

PreviousFormatting ROMsNextModding ROMs

Last updated 2 years ago

Was this helpful?

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:

**** ****[**Renaming Games **](customizing-roms.md#renaming)****[**Editing Game Info**](customizing-roms.md#editing-game-info) · v1.5, iOS only

Please refer to the 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:

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

  • **** (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.

Requirements:

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

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

Pasting

  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.

Uploading

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

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 Bar → Go → Connect to Server...

  2. Enter http://[deviceip]:81 → Connect 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.

Mass-Replacing

  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.

Formatting

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

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

ROM(s):

[game].[romext]

Image(s):

Provenance v1.4, previous…

[game].[romext].[imgext]

Provenance v1.5+:

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

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

Renaming

  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

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

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

This is similar to .

Custom Cover Art 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.

Custom Game Names are when doing Refresh Library.

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

Importing ROMs
is not retained
not currently considered
help
Replacing Cover Art
Known Issues
Pasting
Uploading
Formatting