Collecting App Logs

In this guide

App logs are important for troubleshooting. They provide a detailed view of how your app is behaving, which then helps with efficiently identifying issues. This guide will walk you through the process of obtaining and sharing your app’s logs.

Guidelines for Efficient Troubleshooting With App Logs

To get the most out of app logs when troubleshooting, please keep these guidelines in mind:

  • Collect app logs from the affected device. If you use multiple devices with Pocket Casts, make sure to get or share app logs from the device where you are primarily experiencing the issue you need help with. Logs from your other devices may not provide the necessary information to resolve your issue.
  • Collect app logs right after experiencing or replicating an issue. Timely app log collection is necessary to ensure that an issue is captured in the logs. The iOS app, for example, can only keep 1 to 3 days’ worth of logs, depending on app usage.
  • Add as much supplemental information as you can provide. Logs contain a lot of information. If you are sending us app logs, please share other details to help us check the correct portion of the logs. For example, you can share the following:
    • Date and approximate time you experienced the issue
    • Title of the episode you were listening to when you experienced the issue

Getting App Logs From the Web and Desktop Apps

If you are experiencing an issue with the Mac or Windows desktop apps or the web app, you can share app logs by following these steps:

  1. Click the Profile icon on the upper-right corner of the app’s screen.
  2. Click “Settings.”
  3. Click “Help.”
  4. Click “Send Feedback.”
  5. Make sure “Include debug logs” is enabled. You’ll know that “Include debug logs” is enabled if the toggle next to it is blue.
  6. After including as much additional information as you can about your issue in the message, click “Send.”
  7. Your support request will be sent to us with app logs attached.

Getting App Logs From Android and iOS

For both Android and iOS, you can collect app logs in two different ways:

  • Sending a Message From the App
  • Sharing the Log File From the App

Sending a Message From the Android or iOS App With Logs Attached

The most straightforward way to share app logs with support is by sending a message from the mobile apps. App logs will automatically be attached to the message.

You can reach out to support from the app by following these steps:

  1. Tap Profile.
  2. Tap Help & Feedback.
  3. Scroll down and tap “Contact Support.”
  4. Tap “Get Support.”
  5. Follow the prompts to send us an email.
  6. Your app logs should automatically be attached to the email you send.

If tapping “Get Support” opens a sharing menu with no email option (on Android, right after a brief loading message), your device most likely has no email app enabled — the “Get Support” button prepares your app logs and then needs an email app to send them. You can either enable an email app and try again, or get us the log file another way: pick any app in the sharing menu to save or send the prepared log file to yourself, then email the file to support@pocketcasts.com from another device, such as a computer, along with a description of your issue.

Sharing the Log File From the Android or iOS App

If you are unable to send a message from the app, or your message doesn’t go through, you can send your app’s log file (also called debug logs) directly from the Logs screen instead. This doesn’t use the Get Support screen, and it works on both Android and iOS:

  1. Tap Profile.
  2. Tap Help & Feedback.
  3. Tap the three-dot icon in the upper-right corner, then tap “Logs.”
  4. Tap the share icon in the upper-right corner, then choose your email app. The log file will be attached to the email automatically.
  5. Check that support@pocketcasts.com is already filled in as the recipient. If it isn’t, enter it.
  6. Add a description of your issue and send the email.

If you’re sending logs for an existing support request, please mention your ticket number in the email so we can connect your logs to it.

If you don’t have an email app set up on your device, you can copy your logs instead. Paste them into a note or a message to yourself, then email them to support@pocketcasts.com from another device, such as a computer:

  • Android: On the Logs screen, tap the copy icon in the upper-right corner.
  • iOS: Tap Profile > Help & Feedback > Contact Support > Get Support. When the “No email app found” sheet appears, tap “Copy Email.” This copies the support address, the subject, your device details, and a log ID our team uses to find the logs the app uploaded for you.

Getting App Logs From Android Automotive OS

On Android Automotive OS — the version of Pocket Casts that runs directly on your vehicle’s built-in head unit, with no phone connected — the in-app email and share options aren’t available. To send logs to support, view them on screen and take a photo of the screen with your phone or another camera.

  1. From the Pocket Casts screen on your vehicle’s display, tap the Settings cog.
  2. Scroll to the bottom of the page and tap “About.”
  3. Scroll to the bottom of the page and tap “Help & Feedback.”
  4. Confirm the screen shows a link to the support website, then tap the back arrow to return to the previous screen.
  5. Tap “Logs.”
  6. The logs will appear on screen. Take a photo with your phone or another camera and send the photo(s) to our support team.

If the log is longer than one screen, scroll through it and capture multiple photos so the full sequence is included.

Getting App Logs From CarPlay and Android Auto

CarPlay and Android Auto show Pocket Casts on your car’s display, but the app itself runs on your phone, so there are no separate car logs to collect (car logs, logs from my car). Your phone’s app logs already record when CarPlay or Android Auto connects and what happened during playback, so send the logs from your phone:

  1. Once you’ve safely parked or finished your drive, open Pocket Casts on the iPhone or Android phone you use with your car.
  2. Send your logs using the steps in Getting App Logs From Android and iOS above.
  3. In your message, say that the problem happened in CarPlay or Android Auto, and the date and approximate time it happened.

If Pocket Casts runs directly on your car’s built-in display with no phone connected, that’s Android Automotive OS. Use the Android Automotive OS steps above instead.

Getting App Logs From Wear OS (Pixel Watch, Galaxy Watch, and Other Android Smartwatches)

If you have an issue with the Pocket Casts app on a Wear OS watch, such as a Pixel Watch or Samsung Galaxy Watch, you can send the watch’s logs directly from the watch. These steps are for Android smartwatches. If you have an Apple Watch, see the Apple Watch (watchOS) section below instead.

Before you start, make sure that:

  • The watch app is logged in with a Pocket Casts Plus or Patron account. The “Help & feedback” option doesn’t appear on the watch while you’re logged out.
  • Pocket Casts is installed on the Android phone paired with your watch, and the phone is nearby.
  1. On your watch, open Pocket Casts, then scroll down and tap “Settings.”
  2. Scroll down and tap “Help & feedback,” then tap “Contact Support.”
  3. On your paired Android phone, a sharing menu opens. Choose your email app.
  4. The email is already addressed to support@pocketcasts.com, with your watch logs attached as a file named debug_wear.txt. Describe your issue and send the email.

Only the watch logs are attached. Your phone’s logs aren’t included in this email. If your issue also involves the Pocket Casts app on your phone, such as syncing between your phone and watch, send your phone’s logs separately using the Android steps above.

If you can’t log in to the watch app, you won’t be able to send watch logs. See I can’t log in to the Wear OS app for what to send instead.

Getting App Logs From Apple Watch (watchOS)

If you need to share Apple Watch logs, follow these steps:

  1. Open the Pocket Casts app on your Apple Watch.
  2. On your iPhone, go to Profile > Help & Feedback > Contact Support and tap “Get Support.”
  3. The email that opens has your Watch logs attached as a separate file (watch-debug.txt), alongside your iPhone logs (debug.txt). Write your message above the line and send the email.

If watch-debug.txt isn’t attached, or you’d rather send the Watch logs on their own: on your iPhone, tap Profile > Help & Feedback, tap the three-dot icon in the upper-right corner, then tap “Logs.” Choose “watchOS” at the top of the screen, then tap the share icon in the upper-right corner and send the file to support@pocketcasts.com.

Was this guide helpful for you?

Not quite what you were looking for? Contact Us