Gathering app logs

By default, if the app crashes, you will see a dialog with the option to send the crash report to your Jellyfin server. It will use whichever server the app was last connected to. Additionally, you can send logs manually.

Quick steps

1. Open the Android TV app
2. Perform the steps that cause the issue
3. If the app crashes, send the crash report to your server
4. Check your server's admin Dashboard->Logs for the logs

Including the logs in a bug report is a great way to help developers diagnose and fix issues.

Always review the logs before sharing them publicly to ensure they do not contain any personal information!

Playback issue?

Starting with v0.4.2, you can send relevant media info to the server for debugging.

On any media item, go to "More"->"Send media info log to server". It will be available in the server logs, but also in the app logs, so you can find it with the instructions below.

Always review the logs before sharing them publicly to ensure they do not contain any personal information!

Privacy

Privacy is very important! The app will never send logs without your consent. If you choose to do so, the logs are only sent to your Jellyfin server.

The logs usually do not contain any personal information, but they will contain information such as:

• The device model, manufacturer & Android version
• The app version
• The app's settings
• The date and time including your time zone
• The URL of your server
• Possibly the UUIDs of your servers, users, or media items

Always review the logs before sharing them publicly to ensure they do not contain any personal information!

Verbose

You can increase the verbosity of logs with a toggle in Settings->Advanced Settings->Verbose logging

You should only use this to capture extra information for debugging specific issues because it can impact performance.

Detailed instructions

The app logs can be sent to your Jellyfin server in two ways: via a crash report or manually.

App crash report

If the app crashes, a dialog will be shown allowing the user to send the crash report to the currently configured server.

You can disable the crash reporting feature in the app's advanced settings if you do not want to be prompted to send crash reports.

Manual log collection

The app logs can be sent to your server manually by following these steps:

1. Open the app
2. Perform the steps that cause the issue
3. Open the app's settings
4. Select Send logs near the bottom of the advanced settings

Advanced

Debug logs in app

You can open the debug view by clicking on the app version 3 times on the settings page. This will display a page with:

1. All of the app settings
2. All of the user's server-side settings imported from the current server
3. Some additional debug information
4. Logcat logs from the app

Use adb/logcat

If you are comfortable with the command line, you can use ADB and logcat to gather logs from the device directly. There are more options for searching and filtering this way.