Diagnostic Logs & App Crash Reports

An app crash occurs when the Switcher Studio app exits, either by returning to the home screen or closing the app entirely. When this occurs, Switcher Studio records that a crash occurred. If you experience an app crash, please send the report to the Switcher Studio Support team. They may ask you to enable Diagnostic Logs, which will better help the Switcher Engineering team troubleshoot the issue.

Sending a Crash Report

Step 1: Accessing the Crash Report

  • Open the Switcher Studio app.

  • Tap Profile.

  • Tap Diagnostic Data.

Step 2: Send the crash report

  • Tap the session with Crashed next to it.

    • This will prompt the share dialog, which provides options to send the file.

  • Use your Mail app to email the file to support@switcherstudio.com. If you have not already been communicating with the Support team, be sure to include information about what you were doing when the crash happened (i.e. if you were using a specific feature or asset type), and details of your setup (device type, how many devices you had connected, and if you were using external audio).

Enabling Diagnostic Logs

The Support team may request that you enable Diagnostic Logs as a way to help the Engineering team better understand what is causing the app to crash. When you enable the logs, Switcher automatically captures app activity for four hours (unless you disable it).

To enable the logs:

  • Open Switcher Studio.

  • Tap the menu icon (three lines) in the top-left corner.

  • Tap Diagnostic Data.

  • Tap the toggle button next to Diagnostic Logs.

    • When enabled, the button is blue and to the right of the toggle bar.

  • Tap OK.

  • Close the app and reopen it in order to start the logging process.

    • You will see a Log label when you reopen the app that indicates it's enabled.

  • Continue streaming or do a test stream to recreate the issue.

  • Once your issue has been recreated end the stream and close the app.

  • Reopen Switcher

  • Go back to the diagnostic data menu.

  • Tap Sessions.

  • Tap on the most recent session (the one below the current session labeled "In Progress")

  • Send the session log to support@switcherstudio.com

Note: Diagnostic logging only stays on for 4 hours. If you are unable to recreate the issue please enable logging before all of your streams until the error occurs and then send us the log file afterward.