Skip to content

How to gather logs and open an issue

An effective support report has two parts: a clear description and fresh logs captured while the problem occurs. Symfonium runs across many media providers, playback methods, devices, and Android configurations, so the same symptom can have different causes.

  1. Go to Settings > Advanced and enable Debug mode.
  2. Reproduce the complete problem once.
  3. Disable Debug mode.
  4. Select Share logs with support immediately afterward and enter a recognizable description.
  5. Open a support issue and include the exact description used for the logs.

Check the documentation and search existing support topics for the same symptom. If the behavior already exists but is not working as expected, continue with a support report. If you are asking for new or different behavior, make a feature request instead.

Prepare one clear sequence that reproduces one problem. Capturing several unrelated issues in the same logs and topic makes each one harder to investigate.

Share logs with support is the fastest and preferred way to send current logs from Symfonium.

  1. Open Symfonium and go to Settings > Advanced.
  2. Enable Debug mode.
  3. Reproduce the complete sequence once, including the action that starts it. If possible, note the approximate time when the problem occurs.
  4. Disable Debug mode so Symfonium stops writing to the log file.
  5. Select Share logs with support immediately afterward, enter a recognizable description such as your forum username and a short issue title, then send the logs.

Debug mode and Share logs with support in Symfonium advanced settings

Symfonium prepares and uploads the logs securely. Passwords and authentication tokens are automatically redacted. If the upload succeeds, do not upload the same logs manually.

For an intermittent issue, leave debug mode enabled only until the problem occurs, disable it, then share the logs as soon as possible.

Logs show what the app recorded, but support still needs your context to find the relevant event and understand the expected behavior. Include:

  • A short, specific title
  • What happened and what you expected instead
  • The exact steps needed to reproduce the issue
  • Whether it happens every time or only under certain conditions
  • The approximate time when you reproduced it for the uploaded logs
  • Your device, Android version, and Symfonium version
  • The media provider and server version involved, when relevant
  • The playback method or output involved, such as the local device, Chromecast, UPnP/DLNA, Android Auto, Bluetooth, or a USB DAC
  • The exact description used when sharing or uploading the logs

Keep one problem per topic. Screenshots or a short video can clarify a visual or timing issue, but they do not replace diagnostic logs.

The direct sharing action uploads current logs but does not give you the generated archive. Open Manage Symfonium generated files when you need to inspect, export, or manually upload a log file yourself.

  1. Open Symfonium.
  2. Go to the root Settings page.
  3. Open Manage Symfonium generated files.
  4. Find the relevant log file.
  5. Use the available action to upload, share, export, or delete it.

Manage Symfonium generated files in Symfonium settings

Symfonium generated logs and ANR report files

This screen can also contain ANR reports when the app froze or Android reported that it was not responding. Include the relevant ANR report with the logs when one is available.

Use manual upload only when:

  • You want to read the logs before sending them
  • Share logs with support failed or reports that the archive is larger than 100 MB
  • You need to send an ANR report or additional files, such as a media sample, screenshot, video, or server log

Use a description that support can match to your forum topic:

Forum user: myusername
Issue: Chromecast stops after first track
  • Do not open a technical support issue without fresh logs that contain the complete reproduction.
  • Do not paste log contents into the public topic. Use the secure sharing options described above.
  • Do not write only “it does not work.” Explain what happened, what you expected, and how to reproduce it.
  • Do not assume that uploading files creates a support request or notifies support.
  • Do not leave Debug mode enabled while sharing the logs or after capturing the problem.
  • Do not manually upload the same logs if Share logs with support already succeeded.

Sign in to the forum, open the Support category, select New Topic, and follow the reporting wizard. Keep the provided template and complete every relevant section.

State whether you shared the logs from the app or uploaded them manually, and include the exact description used for the upload.