Mobile apps

Spectral can capture traffic from Android apps by patching their APKs to trust user-installed CA certificates, then routing traffic through the MITM proxy.

Note

iOS is not currently supported. Android is the only mobile platform with a supported capture workflow.

Prerequisites

• adb — Android SDK Platform Tools, for communicating with the device
• java — JDK, for signing patched APKs
• A connected Android device or emulator with USB debugging enabled

Workflow overview

The full workflow is: find the package, pull the APK, patch it, install it, push the certificate, then capture traffic through the proxy. Each step has a dedicated CLI command.

Find the package

Search for a package by name:

spectral android list spotify

This lists matching package names installed on the connected device (e.g., com.spotify.music).

Pull the APK

Download the APK from the device:

spectral android pull com.spotify.music

For single APKs this produces com.spotify.music.apk. Some apps use split APKs — these are downloaded into a directory named com.spotify.music/.

Use -o to specify a custom output path.

Patch the APK

On Android 7 and later, apps only trust system CA certificates by default and ignore user-installed ones. The patch command modifies the APK to add a network security configuration that trusts user CAs, then re-signs it:

spectral android patch com.spotify.music.apk

This produces com.spotify.music-patched.apk (or a -patched/ directory for split APKs).

Note

Patching requires java on the system PATH. The apktool and uber-apk-signer JARs are downloaded automatically on first use. The patched APK is signed with a debug key, so it cannot be installed alongside the original — uninstall the original first.

Install the patched APK

spectral android install com.spotify.music-patched.apk

For split APKs, pass the directory:

spectral android install com.spotify.music-patched/

Push the certificate

Push the mitmproxy CA certificate to the device:

spectral android cert

This copies ~/.mitmproxy/mitmproxy-ca-cert.pem to the device's SD card as a .crt file. You can pass a custom certificate path as an argument. If you haven't run mitmproxy before, run it once to generate the certificate, then retry.

After pushing, install the certificate on the device: Settings > Security > Install from storage > CA certificate, then select the uploaded file.

Warning

On Android 7+, user-installed CA certificates are only trusted by apps that explicitly opt in via their network security configuration. The spectral android patch command modifies apps to trust user CAs — you must use the patched APK for interception to work.

Capture traffic

Configure the device to use the proxy. Go to Settings > Wi-Fi, long-press your network, edit the proxy settings to point to your machine's IP address on port 8080.

Then start the proxy as usual:

spectral capture proxy -a spotify -d "*.spotify.com"

Use the app on the device. The proxy captures all traffic from the patched app. Press Ctrl+C to stop. The capture is stored in managed storage.