How to gather logs and open an issue
Symfonium supports many providers, players, playback modes, devices, and Android configurations. Because every setup is different, most issues cannot be diagnosed from a description alone.
To investigate and fix an issue, support needs logs generated while the problem happens.
Logs are mandatory for support issues.
What to include in your issue
When opening an issue, please include:
- what happened;
- what you expected to happen;
- the exact steps needed to reproduce the issue;
- the provider involved, if any: Plex, Emby, Jellyfin, Subsonic, Navidrome, local files, cloud storage, SMB, WebDAV, etc.;
- the player involved, if any: local device, Chromecast, UPnP/DLNA, Android Auto, Bluetooth, USB DAC, etc.;
- logs generated while the issue happens.
Without logs, support usually cannot see what happened or fix the issue.
Generate and send logs from the app
The easiest way to send logs is to use Share logs with support from inside Symfonium.
Important: Debug mode can slow down the app and logs can take a lot of space.
Disable debug mode when you have finished reproducing the issue.
- Open Symfonium.
- Go to Settings.
- Open Advanced.
- Enable Debug mode.
- Reproduce the issue while debug mode is enabled.
- As soon as the issue has happened, press Share logs with support.
Symfonium will prepare the logs and let you send them to support.
Passwords and authentication tokens are automatically redacted from the logs.
If you use Share logs with support from the app, you do not need to manually upload the logs.
Read or save the logs yourself before sending them
The logs are not hidden from you. You can inspect, save, export, or share them yourself from Manage Symfonium generated files.
You cannot retrieve the generated log file directly from the Share logs with support action. That action is meant to send the logs to support.
To access the files yourself:
- Open Symfonium.
- Go to the root Settings page.
- Open Manage Symfonium generated files.
- Find the generated log file.
- Use the available actions to export, share, upload, or delete it.
From this screen you can:
- upload the file securely to support;
- share the file with another app;
- export the file to your phone Downloads folder;
- delete old generated files.
This is the correct place to get the log files if you want to read them before sending them.
If the app froze or Android reported an ANR, this screen may also contain ANR reports. Those reports are useful for investigating freezes and should be sent with the logs when available.
Manual upload
You only need to manually upload logs if you did not use Share logs with support from inside the app.
Manual upload is useful when:
- you exported the logs from Manage Symfonium generated files;
- you want to read the logs before sending them;
- you need to send additional files, such as media samples, screenshots, videos, or server logs;
- the normal Share logs with support flow did not work on your device.
To manually upload a file, use:
Only support can access files uploaded through this page, and uploaded files are automatically deleted after usage.
When uploading manually, use the description field to identify your issue.
Good descriptions include:
- your forum username;
- the issue title;
- a unique identifier that you also mention in your forum post.
Example:
Forum user: myusername
Issue: Chromecast stops after first track
This is important because support needs to match the uploaded file with your forum issue.
Do not paste full logs directly in the public forum.
Open the support issue
After sending or uploading the logs, open a support issue on the forum.
Fill the template completely.
For log description:
- If you used Share logs with support this the text you entered in the upload dialog.
- If you manually uploaded logs, this is the upload description you used.
Example:
Description: myusername - Chromecast stops after first track
Common mistakes to avoid
- Do not open an issue without logs.
- Do not generate logs before reproducing the issue.
- Do not forget to disable debug mode after reproducing the issue.
- Do not paste full logs publicly on the forum.
- Do not manually upload logs if you already shared them successfully from the app.
- Do not write only “it does not work”; include steps and context.
Summary
- Enable Settings > Advanced > Debug mode.
- Reproduce the issue.
- Press Share logs with support to send logs directly from the app.
- Open a forum issue and mention that logs were shared from the app.
- Use Manage Symfonium generated files only if you want to read, export, share, delete, or manually upload the generated files.
- Use https://upload.symfonium.app/ only if you did not send the logs from the app or if you need to provide additional files.
- Disable debug mode.