Skip to content
Cinaura Docs

Capture a log

When you report a bug, a log is the single most useful thing you can send. It shows what Cinaura was actually doing at the moment something went wrong. Cinaura doesn’t export logs from inside the app, so you capture one from a computer using ADB (Android Debug Bridge). It’s a one-time setup of about 10 minutes.

What you’ll need

Section titled “What you’ll need”
  • A computer (Windows, macOS, or Linux) on the same network as your TV.
  • The Android platform-tools installed on that computer, which provide the adb command. Download them from Google and unzip somewhere handy, or install via your package manager (brew install android-platform-tools on macOS).

Step 1: Enable Developer options on the TV

Section titled “Step 1: Enable Developer options on the TV”

  1. On the TV, open Settings → Device Preferences → About (the exact path varies slightly by device).

  2. Scroll to Build and select it seven times. A message confirms that developer mode is now on.

Step 2: Turn on debugging

Section titled “Step 2: Turn on debugging”

  1. Go back to Settings → Device Preferences → Developer options.

  2. Turn on USB debugging.

  3. If your device lists Wireless debugging (or Network debugging), turn that on too. This is what lets the computer connect over Wi-Fi, which most TV boxes need since they rarely have a usable data USB port.

Step 3: Connect ADB from your computer

Section titled “Step 3: Connect ADB from your computer”

Open a terminal on your computer and connect to the TV by its IP address (replace the example with yours):

Terminal window
adb connect 192.168.1.50:5555

The first time, the TV shows an Allow USB debugging? prompt. Accept it (tick “Always allow from this computer”). If adb connect succeeds you’ll see connected to 192.168.1.50:5555.

Step 4: Capture the log

Section titled “Step 4: Capture the log”

  1. Clear the old log buffer so the capture is focused:

    Terminal window
    adb logcat -c

  2. Start recording to a file:

    Terminal window
    adb logcat > cinaura-log.txt

  3. Reproduce the problem on the TV: open the item that won’t play, trigger the failing sync, whatever it is.

  4. Back on the computer, press Ctrl+C to stop recording. You now have cinaura-log.txt in the folder you ran the command from.

Step 5: Send it to us

Section titled “Step 5: Send it to us”

Attach cinaura-log.txt along with a short description of what you did and what went wrong via the contact page.