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.