Lightweight Android companion for CashPilot — monitors passive income apps running on your phone and reports their status to the CashPilot fleet dashboard.
CashPilot Android detects which passive income apps are installed and running on your device using three complementary Android APIs (no root required):
| API | Signal | Latency |
|---|---|---|
| NotificationListenerService | App's foreground service notification is active | Instant |
| NetworkStatsManager | App is transferring data (bytes tx/rx per app) | ~2h buckets |
| UsageStatsManager | App was recently in foreground | ~2h buckets |
It sends periodic heartbeats to your CashPilot server, so you get a unified fleet view of both Docker containers and Android apps.
11 passive income services with Android apps:
EarnApp, IPRoyal Pawns, MystNodes, Traffmonetizer, Bytelixir, ByteBenefit, Grass, Titan Network, Nodle Cash, Uprock, Wipter
- Install the APK on your Android device (Android 8.0+)
- Grant permissions when prompted:
- Notification Access — detects running apps via their persistent notifications
- Usage Access — reads per-app activity and network stats
- Battery Optimization exemption — prevents Android from killing the heartbeat service
- Open Settings in the app and enter:
- Your CashPilot server URL (e.g.,
https://cashpilot.example.com) - Your fleet API key (
CASHPILOT_API_KEYfrom the server's environment)
- Your CashPilot server URL (e.g.,
CashPilot Server (fleet dashboard)
^
| HTTPS POST /api/workers/heartbeat (Bearer auth)
|
CashPilot Android
├── HeartbeatService (foreground, periodic POST)
├── AppNotificationListener (instant app detection)
├── AppDetector (UsageStats + NetworkStats)
└── Jetpack Compose UI (dashboard + settings)
./gradlew assembleDebug
# APK at app/build/outputs/apk/debug/app-debug.apk- Kotlin + Jetpack Compose
- Ktor HTTP client
- Kotlinx Serialization
- DataStore Preferences
- WorkManager (future: periodic sync when app is backgrounded)
- Material 3 + Dynamic Color
All app status data is sent only to your own CashPilot server. The app makes one additional request to api.ipify.org to display your public IP on the dashboard — this only happens after both server URL and API key are configured. No other third-party services are contacted.
- Android 8.0+ (API 26)
- CashPilot server v0.2.49+
GPL-3.0-or-later