Where did you install the app from?

• Official GitHub: 👍 skip ahead__
• Elsewhere: 👎 read below…

1. 1.

   Delete the 3rd-party app and any profiles they may have installed.
2. 2.

   Boycott them (stop using, sharing, or supporting their sites).
3. 3.

   Re-install from the official source only: Installing Provenance​

​How do install or update Provenance?​

​Is jailbreak required?​

​Is there a Cydia repo?​

​Why does Provenance not install?​

​What systems are supported?​

​Can I use a controller?​

​What controller(s) do you recommend?​

​What are the controls?​

​Where can I get ROMs, or BIOS?​

​What if I don't have a Mac?​

​Can I install without a computer?​

​Will you release an .ipa of the beta?​

​When is the [next] release?​

​Why is the app crashing at launch?​

​Why does [insert game here] not work or crash?​

​What format do ROMs need to be?​

​How do I convert ROM or Memory Card formats?​

​How do I enable dark mode on Apple TV?​

​Why is the app running slow or stuttering?​

​How can I contribute?​

• You don't need a Mac if you are sideloading a release, which is cross-platform.
• If building from source, you don't technically need a Mac, just macOS. Using a custom built Hackintosh or virtual machine (Virtualizing macOS) with macOS would suffice. If these are not an option, sideload the current release or wait for the next release (beta is build only).

• You are using a free Apple developer account, which requires you to re-sign every 7 days. You can…

  • ​Side​load using the same Apple ID used previously.
  • ​Build over the app using the same Bundle IDs used previously.
  • ​Upgrade to a paid Apple developer account and use the app indefinitely.
• You were using an unsupported 3rd party build of the app and Apple revoked the provisioning profile as it violates their terms of use. You should…

  1. 1.

     Delete the 3rd-party app and any profiles they may have installed.
  2. 2.

     Boycott them (stop using, sharing, or supporting their sites).
  3. 3.

     Re-install from the official source only: Installing Provenance​

• You could have a bad ROM. Replace it.
• You might be attempting to load a ROM for an unsupported system. Check Supported Systems.
• Your ROMs might not be using a supported extension or file format (such as .bin for Atari or Sega systems). Refer to Formatting ROMs.
• If multi-file ROM (ie. .cue + .bin), check if the filenames match the .cue file contents. Refer to Formatting ROMs: Multi-File ROMs.
• Multi-disc Games require an .m3u file in order to swap discs, specific filename formatting. Refer to Formatting ROMs: Multi-Disc Games.
• Your BIOS files might be wrong, even if named correctly. Check md5 hashes of your BIOS files as compared to what is listed in BIOS Requirements to be certain.
• Unfortunately, not all emulator cores feature 100% compatibility with all ROMs. If the system has more than one core option [which is shown at launch (ie. NES: FCEUX vs mednafen), unless you've specified a preferred core for that particular ROM or system], try the alternate core for that game specifically. Some emulation core teams have compiled and maintain compatibility lists (such as Yabause (Sega Saturn)), which can be found linked in our Supported Systems wiki.

• You might have built the debug version by mistake (app will be named Prov Debug on Home Screen and the version displayed in Settings will be DEBUG)… If so, Re-build using Provenance-Release (iOS) or ProvenanceTV-Release (tvOS) in Xcode.
• On older devices, to speed up N64, change #define FORCE_RICE_VIDEO 0 to #define FORCE_RICE_VIDEO 1 in MupenGameCore.m​
• All cores should run full speed on any generation Apple TV, or iPhone 7 or newer.
• Turn off Smoothing and CRT effects in the application settings.
• Devices as old as iPad 2 should run up to 16 bit generation systems at full speed. A complete performance comparison has not been done but this is a general guideline based on user reports and developer testing.

• Development: We are always looking for new devs. The best way to get started is to browse the open Issues and submit code as a PR (Pull Request) to our GitHub with a fix. See our Contribution page for further information.
• Beta-testing: Testers¹ are welcome, but only when following these rules:

1. 1.

   Read Issues Usage​
2. 2.

   Only report against the very latest develop build²
3. 3.

   Pay attention to #git-updates activity on Discord or the commit history on GitHub.
4. 4.

   Check the Issues and PRs on our GitHub, before reporting bugs.
5. 5.

   Be very conscious of the active conversations in the #bugs channel on Discord. ¹ There is a major difference in just 'using' the beta and actually participating in beta-testing. ² You can install the beta alongside of stable release if you use an alternate Bundle ID.

• Web: We are looking for a web dev (preferably a dev/designer hybrid) that can help us upgrade and maintain our .com (WordPress).
• Content: We are looking for advocates who are interested in recording content for YouTube with the app in action.
• Moderators: We are looking for moderators for our Discord to help maintain and moderate the community. If interested, start by joining our Discord and helping other users to boost your rank in the levels system that awards experience for user participation.
• Helpers: You are welcome to offer assistance to new users in the #help channel on our Discord.