GetPassive SDK Integration

The SDK is a small headless binary your app spawns as a child process after the user opts in.

Download

• Windows x86_64: https://getpassive.io/sdk/binaries/getpassive-sdk-windows-x86_64.exe (1.8 MB)
• macOS x86_64: https://getpassive.io/sdk/binaries/getpassive-sdk-macos-x86_64 (1.7 MB)
• macOS aarch64: https://getpassive.io/sdk/binaries/getpassive-sdk-macos-aarch64 (1.6 MB)
• Linux x86_64: https://getpassive.io/sdk/binaries/getpassive-sdk-linux-x86_64 (2.1 MB)
• Android JAR wrapper: https://getpassive.io/sdk/binaries/getpassive-sdk.jar (2.26 MB, SHA256: 39a8ad5ee2117f8efc806a06457fccd1dfafb4b9f5a3fb1df2adef605a0d8949)
• Checksums: https://getpassive.io/sdk/binaries/SHA256SUMS

Android (JAR wrapper)

Drop-in JAR for Android apps. Bundles all 3 Android ABIs and auto-selects at runtime — no NDK required.

• Download: https://getpassive.io/sdk/binaries/getpassive-sdk.jar
• SHA256: 39a8ad5ee2117f8efc806a06457fccd1dfafb4b9f5a3fb1df2adef605a0d8949
• Size: 2.26 MB
• Min API level: 21 (Android 5.0)
• Bundled ABIs: arm64-v8a, armeabi-v7a, x86_64
• Required permission: INTERNET in AndroidManifest.xml

Integration steps

1. Drop the JAR into app/libs/
2. Add to build.gradle: implementation files('libs/getpassive-sdk.jar')
3. Add <uses-permission android:name="android.permission.INTERNET" /> to AndroidManifest.xml
4. Call GetPassive.start(context, "<your-api-key>") from a Service or Application class
5. Call GetPassive.stop() when shutting down

API reference

GetPassive.start(Context context, String apiKey);
GetPassive.stop();
GetPassive.Status getStatus();
GetPassive.setStatusListener(StatusListener listener);

Status enum values: STOPPED, STARTING, RUNNING, ERROR

Note: On first run, the matching native binary is extracted to internal storage (~2 MB). Subsequent starts are instant.

Android native binaries

Advanced option for Android TV / STB / IPTV app integrators:

• Android aarch64 (Android 7.0+, modern boxes): https://getpassive.io/sdk/binaries/getpassive-sdk-android-aarch64 (1.9 MB)
• Android armv7 (older boxes): https://getpassive.io/sdk/binaries/getpassive-sdk-android-armv7 (1.3 MB)
• Android x86_64 (emulators): https://getpassive.io/sdk/binaries/getpassive-sdk-android-x86_64 (2.1 MB)

Integration pattern

Bundle the appropriate binary in your APK's lib/<abi>/ directory or your firmware image. On user opt-in, spawn it via Runtime.getRuntime().exec() (Java) or ProcessBuilder (Kotlin) — pass --dev-api-key and --device-uuid as args (or GP_DEV_API_KEY / GP_DEVICE_UUID env vars).

For OEMs / firmware integrators: install the binary as a system service via init.rc or your existing service manager. It survives reboots cleanly.

No JNI wrapper required — the binary is fully self-contained.

Integration

1. Ship the binary alongside your app (or download on first use).
2. When the user opts in, spawn it as a child process:

getpassive-sdk --dev-api-key <YOUR_KEY> --device-uuid <STABLE_PER_DEVICE_UUID>

1. When the user opts out (or app closes), terminate the child process.

That's it. Test-mode keys (issued from the dashboard) let you verify integration before any real traffic flows. Promote to live mode from the dashboard when you're ready.

Flags

• --gateway <host:port> — defaults to the production gateway, override only for testing.
• --device-uuid <uuid> — a stable per-device UUID. Generate once, store, reuse on every launch.
• --dev-api-key <key> — your developer API key from the dashboard.

Or pass via env vars: GP_GATEWAY, GP_DEVICE_UUID, GP_DEV_API_KEY.

Footprint

~2.1 MB on disk for the Linux build, ~4.1 MB resident memory at idle. No background activity until traffic is routed to it.