Sideloading and Traffic Inspection on Google TV Streamer: A QA Setup Guide

Yug Patel — Tue, 10 Mar 2026 23:32:32 +0000

Motivation

When testing streaming applications on Android-based TV devices, establishing a reliable workflow for APK deployment and network traffic inspection is essential. This guide covers the full configuration process for Google TV Streamer — from enabling developer access through to routing device traffic through Charles Proxy for API validation and debugging.

Prerequisites

Before proceeding, ensure the following conditions are met:

Charles Proxy is installed and activated with a valid license
Charles SSL certificate has been downloaded and trusted on your test machine. If this has not been completed, navigate to Help > SSL Proxying > Install Charles Root Certificate in Charles and follow the prompts before continuing
Google TV Streamer has Developer Mode enabled (see Part 1 if not yet configured)
The test machine running Charles and the Google TV Streamer are connected to the same local network

Part 1: Enable Developer Options and ADB Debugging

Developer Mode must be unlocked before any ADB-based workflows or proxy configurations can be established.

1.1 — Enable Developer Mode

Navigate to Settings > System > About and select "Android TV OS Build" seven consecutive times. The device will confirm that Developer Options have been enabled.

Return to Settings, where a new Developer Options entry will now be visible. Enter that menu and toggle on "Enable developer options".

1.2 — Enable ADB Debugging

Within Developer Options, enable both USB Debugging and Wireless Debugging. Wireless Debugging is required to establish an ADB connection over the local network without a physical USB cable.

Part 2: ADB Connection and APK Installation

With developer access configured, the device is ready to accept ADB connections and sideloaded application packages.

Step 1: Obtain Required Tools

Open the Wireless Debugging menu on the device and record the displayed IP address and port — this will be used to establish the ADB connection. It will appear in the format 192.168.x.x:XXXXX (e.g., 192.168.0.10:12345).

Download the Android SDK Platform Tools for your operating system from the official Android developer site:

https://developer.android.com/tools/releases/platform-tools

Under the Downloads section, select the appropriate package for your OS. Extract the downloaded archive to a local directory of your choice. This extracted folder (typically named platform-tools) will serve as your working directory for all ADB commands.

Once extracted, place the target .apk file directly into the root of the platform-tools folder. This ensures the adb install command can reference the file without needing to specify a full file path.

Step 2: Connect via ADB and Install the APK

Open a terminal session and navigate to the root of the platform-tools directory. It is important that the terminal is opened at this exact location, as the ADB commands and APK file must be in the same directory.

Run the following command, substituting the IP address and port recorded in Step 1:

adb connect 192.168.0.10:12345

If the device presents an authorization prompt on-screen, approve it before proceeding. Once the connection is confirmed in the terminal, install the application package by running:

adb install app.apk

Replace app.apk with the exact filename of your APK. A success message will be displayed in the terminal upon completion. The application is now installed on the device and ready for testing.

Part 3: Charles Proxy Configuration

To inspect network traffic originating from the Google TV Streamer, the device must be configured to route its traffic through Charles Proxy running on the test machine. Before proceeding, confirm that Charles is open and running, and that the Charles SSL certificate has been downloaded and trusted (see Prerequisites).

Configure the Device Proxy

On the Google TV Streamer, navigate to Settings > Wi-Fi and tap on the active Wi-Fi connection. Scroll down to Proxy Settings and set the mode to Manual. Enter the following values:

Field	Value
Hostname	Local IP address of your test machine
Proxy Port	`8888`
Bypass Hosts	Leave blank or retain defaults

To locate your machine's local IP address, open Charles and navigate to Help > Local IP Address. It will typically appear in the format 192.168.x.x. Enter this value in the Hostname field on the device.

Once saved, return to Charles — traffic from the Google TV Streamer should now begin appearing in the session.

Recommended: Disable OS Proxy in Charles

By default, Charles may also capture traffic from the host machine itself. To isolate only the device traffic, navigate to Proxy in the Charles menu bar and uncheck macOS Proxy (or Windows Proxy, as applicable).

This step is recommended for any targeted testing session, as it removes noise from background processes on your computer and ensures the Charles session reflects only what the Google TV Streamer is sending and receiving. This is particularly useful when validating API calls, inspecting request and response payloads, or investigating network-layer defects.

Summary

Following this setup, your test environment will support:

Wireless APK deployment via ADB for rapid build installation across test cycles
Full network traffic visibility through Charles Proxy for API validation, payload inspection, and network-layer defect investigation

This configuration is well-suited for functional, integration, and regression testing workflows on Google TV Streamer and other Android-based streaming platforms.

Forem: Yug Patel