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
  • Viewing Log Data
  • iPhone
  • macOS

Was this helpful?

  1. Help

Troubleshooting

Things to try if you run into trouble installing, etc…

PreviousVirtualizing macOSNextContributing

Last updated 2 years ago

Was this helpful?

Provenance-Emu is a small team of volunteers. First check to see if your problem has already been explained.

If you're having issues with the app, the best help you'll get is your own debugging. Don't be a special ❄, Provenance has an assortment of ways to help troubleshoot:

  • 💢Troubleshooting and ⚠️Known Issues sub-sections on the wiki pages.

  • Try debugging it yourself, see below…

Viewing Log Data

iPhone

Crash logs

  1. Go to Settings app -> Privacy -> Analytics -> Analytics Data.

  2. Search for Provenance log files and tap.

You can use the share button to send the log data to our Discord #help channel if you have the Discord iOS app installed.

macOS

Live app logging with NSLogger OS X app

Preferred Method

NSLogger runs on both OS X and iOS devices and can be used to see log data from Provence in real time provided both the viewer and device running Provenance are reachable on the same network via Bonjour.

  1. Open the downloaded app on desktop.

  2. Make sure device(s) are on the same network as your computer.

  3. Open Provenance app on your device.

  4. The NSLogger window will automatically appear.

Tips

  • You can filter with the search bar on the upper right

  • You can filter by specific severity code classes on the bottom right button All levels | All tags

    • Level 0 is Error, <= 1 Error & Warning, <= 2 Errors, Warnings and Info... up to 3 Debug, 4 Verbose.

    • Command + 0 through 4 to quickly change the severity filter

  • You can view the exactly File + Line number the log lines are genered from by making the the f button on the bottom toolbar is highlight as selected.

Crash Reports via XCode

  1. Open XCode

  2. Choose Window -> Devices & Simulators

  3. Select your iOS or tvOS device (plug in if not available over WiFi)

  4. Click View Device Logs to view logs (may take a minute to download logs)

Live app logging via XCode

  1. Build and run the app via XCode

  2. If the console (bottom shelf of XCode) isn't displayed, clock View -> Debug Area -> Show Debug Area

  3. If the right panel of the console isn't visable click the icon on the far lower right of the bottom debug shelf.

You should see Provenance debugging statements as you run the app.

App must be started from within XCode for text to appear.

Provenance uses to collect and send log data to various locations. One of which is the Open Source log viewer application, .

Download the latest releases of .

NSLogger screenshot
FAQs
Frequently Asked Questions
CocoaLumberjack
NSLogger
NSLogger.app