Apple TV Logs

For investigating some issues, we may ask you to share your logs. There are two logs most commonly of interest in these situations:

  • Logs from the Apple TV device
  • Logs from your Plex Media Server.

Logs from the Apple TV Device

When you need to retrieve logs from the Apple TV app, there are a couple of ways to do so. If your Apple TV is connected to the internet, then using "Network Logging" is usually the simplest way, though the information that can be logged is limited. You can also gather the logs manually by connecting the Apple TV device to your computer and running a utility that reads and captures the logs directly.

Network Logging

When you enable network logging in the Apple TV app, all log messages from the Apple TV app will be sent to a logging service for the next 20 minutes. A handful of members of the Plex team have access to those logs and can pull them up without you having to download or upload anything. Only the Plex team has access to the logs though, so other forum members won't be able to help you.

Enable Network Logging

To Enable Network Logging:

  1. Sign In: Make sure you've signed in with your Plex account in the app.
  2. Enable Network Logging: Enable the network logging, which is found under Settings > Send Logs to Plex

Reproduce and Report the Issue

Reproduce the issue you're having. Network logging only lasts for 20 minutes, so reproduce the problem right after turning it on.

Post a description of the problem in the forums if you haven't already. Then just let us know your Plex username and about when you turned on the logging (the time and time zone) so we can find it.

Related Page: Plex Support Forums

Apple TV Console Logs

You can use third-party tools to access logs on most operating systems. To do so, you'll need to connect your Apple TV to your computer using a USB Type-C (USB-C) cable.

OS X

On OS X systems, you can use Lemonjar's iOS Console app to easily access the logs.

Related Page: Lemonjar: iOS Console

Once the "iOS Console" app is installed:

  1. Start by force-closing the Plex app on your Apple TV device
  2. Open the iOS Console app
  3. Connect your Apple TV device via a USB-C Cable
  4. A window will open with your console logs
  5. Click the Clear Display button
  6. On the Apple TV device, launch Plex
  7. Reproduce the issue you're reporting
  8. Choose the File > Export Logs... from the app menubar and save the file with a descriptive name

Once you have the log file, you can attach it to a post on the support forums.

Related Page: How do I attach files in the forums?
Related Page: Plex Support Forums

Windows

On Windows systems, you can use Tinksky's iTools app to access the device logs.

Related Page: Softonic: iTools for Windows

Once the iTools app is installed:

  1. Start by force-closing the Plex app on your Apple TV device
  2. Open the iTools app
  3. Connect your Apple TV device via a USB-C Cable and ensure it appears in iTools
  4. Choose Advanced on the left under your Apple TV device
  5. Select System Logs to open a window with the device console logs
  6. On the Apple TV device, launch Plex
  7. Reproduce the issue you're reporting
  8. Choose the Save in the window save the file with a descriptive name

Once you have the log file, you can attach it to a post on the support forums.

Related Page: How do I attach files in the forums?
Related Page: Plex Support Forums

Plex Media Server Logs

Your Plex Media Server keeps a log file that's often useful: "Plex Media Server.log". Where exactly the file is stored depends on your operating system.

Related Page: Plex Media Server log files