Automate your device with event-driven triggers, privileged system actions via Shizuku, and a fluid Material 3 interface. No telemetry or cloud accounts, with battery-efficient demand-driven listeners.
-34A853?logo=android&logoColor=white){kind=icon}
Note
📱 Device Compatibility & Community Testing Notice
FlowPilot is an independent open-source project, actively developed and primary-tested on Xiaomi HyperOS (Xiaomi 15T Pro). Strict adherence to standard Android Jetpack and system APIs is maintained throughout the codebase; CI runs the JVM unit suites, Android lint, debug/release builds, and the SDK-free contract scripts in scripts/, so device and OEM behavior is verified by hand and by community reports.
Because OEM skins (Samsung One UI, Google Pixel, Motorola, OxygenOS, etc.) implement background process limits differently, your test reports, feedback, and pull requests are warmly welcomed!
Most Android automation tools force you to choose between steep complexity, heavy battery drain, or intrusive cloud logins. FlowPilot was built to fix this.
|
No constant CPU wake-locks or polling loops. Hardware sensors (accelerometer, proximity, light) and broadcast receivers register only when an active rule needs them and unregister instantly when idle. |
No analytics, no telemetry, no remote accounts. Optional update checks query GitHub only when enabled and can be turned off in Settings. Webhooks and SMS actions send only the data you explicitly configure. |
|
Harness the power of Shizuku to toggle Mobile Data, Airplane Mode, GPS, Dark Mode, and Force Stop apps using elevated ADB permissions—without rooting or voiding warranties. |
Crafted completely in native Jetpack Compose. Experience fluid 60/120 FPS transitions, dynamic Material You theming, haptic feedback, and glanceable Home Screen widgets. |
|
Let your phone speak notification text, SMS codes, caller names, battery levels, and other trigger data with on-device TTS. Messages synthesize on demand and are cached offline—zero internet required. |
Export portable sanitized JSON rules to share with friends, or secure your entire library with AES-256-GCM password encryption (PBKDF2 with 100,000 iterations). |
| Home Screen | Ready Presets | Rule Builder | Settings & Backup | About Dialog |
 |
 |
 |
 |
 |
FlowPilot follows a clear, intuitive 3-step mental model:
┌───────────────────────────┐ ┌───────────────────────────┐ ┌───────────────────────────┐
│ 1. TRIGGER │ │ 2. CONDITIONS │ │ 3. ACTIONS │
│ "When this happens" │ ───► │ "Only if all match" │ ───► │ "Do this in order" │
│ (e.g., Arrive at Work) │ │ (e.g., Weekdays Only) │ │ (Silent + Turn on Wi-Fi) │
└───────────────────────────┘ └───────────────────────────┘ └───────────────────────────┘
- 🌙 Bedtime Routine: When the clock strikes 23:30 ➔ Only if charging ➔ Turn on Silent Mode, enable Dark Theme, and dim brightness to 10%.
- 🔋 Full Charge Alert: When battery reaches 100% ➔ Speak "Phone is fully charged, please unplug" and show notification.
- 🔕 Flip to Silence: When phone is placed face-down on a desk ➔ Immediately enable Do Not Disturb with a subtle confirmation pulse.
Start automating instantly with built-in recipes designed for everyday life:
| Preset | Trigger | Key Actions |
|---|---|---|
| 🌙 Bedtime Routine | Time reaches 23:30 | Enables Dark Mode, sets Silent profile, turns on DND, dims screen to 10% |
| 🔋 Full Battery Protection | Battery reaches 100% | Speaks offline unplug voice reminder & pushes persistent notification |
| ⚡ Battery Saver Emergency | Battery drops below 15% while unplugged | Turns on Battery Saver, disables Bluetooth, lowers brightness, enables Dark Mode |
| ☀️ Morning Wake Up | Charger unplugged OR screen on (weekdays 05:00–10:00) | Turns off DND, restores normal sound, sets brightness to 70% |
| 🌙 Night Quiet | 23:00 schedule OR screen off (22:00–08:00) | Turns on DND, silences sound profile, drops media volume to 20% |
| 🚗 Morning Commute | Home Wi-Fi lost OR charger unplugged (06:00–10:00) | Enables Mobile Data, restores normal sound, sets media volume to 80% |
| 🎯 Focus / Work Mode | Weekdays 09:00, not on home Wi-Fi | Turns on DND and switches sound to vibrate |
| 🌃 Night Screen Dimming | Screen on 00:00–06:00 with battery below 60% | Dims brightness to 10%, enables Dark Theme |
| 🔕 Flip to Silence | Phone placed face-down | Dual sensor check (Proximity + Gravity Z-axis) enables DND with a haptic pulse |
| 🔦 Shake for Flashlight | Firm phone shake | Toggles rear camera torch with tactile haptic feedback |
| 🎬 Cinema / Night Reading | Ambient light drops < 5 lx | Dims brightness to minimum and switches system to Dark Theme |
| 🚗 Leaving Home Mode | Disconnected from Home Wi-Fi | Enables Mobile Data (Shizuku), sets Normal ringer, raises volume to 80% |
| 🏠 Welcome Home Mode | Connected to Home Wi-Fi | Disables Mobile Data (Shizuku) to save power and restores balanced settings |
| 📍 SMS Emergency Responder | Incoming SMS with secret phrase | Locks GPS coordinates and replies with a live Google Maps location link |
FlowPilot listens to a rich spectrum of hardware, radio, and system events:
A rule can combine up to five independently configured triggers with OR semantics (for example App opened OR Wi-Fi connected). Add, remove and reorder them in Create/Edit. All sources share one rule cooldown and execute the same ordered actions; history identifies the matched source. Existing single-trigger rules and JSON stay compatible.
- 📱 App Lifecycle: App launched or closed (lightweight
UsageStatsManagertransitions). - 🔌 Power & Battery: Charger plugged in / unplugged, battery level rises above or drops below custom percentage.
- 💡 Screen & State: Screen turned on/off, device unlocked.
- ⏰ Schedule & Time: Daily, weekdays, weekends, or specific days and exact times.
- 📶 Connectivity: Wi-Fi connected/disconnected (any or target SSID), Bluetooth device connected/disconnected.
- 🔄 Sensors & Motion:
- Device Flip: Face-down on table or turned face-up (Proximity + Gravity Z-axis with 500ms debounce).
- Shake: Shake detection with a per-rule strength slider (6–32 m/s²) under the trigger settings; one shake produces one trigger.
- Ambient Light: Lux drops below or rises above target threshold.
- 📍 Hardware Geofencing: Enter or exit defined geographical zones using Google Play Services
GeofencingClient. Uses no idle CPU wake-lock, keeps up to 50 queued events across engine restarts, and reuses recent transition coordinates for location template variables. Older coordinates trigger a fresh lookup or leave location values empty. - 🏷️ NFC Tags: Instant hex UID matching on physical scans. Foreground ReaderMode scans run matching rules automatically; background Android discovery opens FlowPilot and requires explicit confirmation before any matching NFC automation runs.
- 📞 Phone & SMS: Call ringing, answered, outgoing dialed, call ended; SMS received with keyword, prefix, regex, or exact sender matching.
- 🔔 Notifications: Incoming notifications from selected apps with keyword filtering. FlowPilot's own status notifications and HyperOS volume/headphone UI notifications are ignored, and notification rules ask the system to rebind the listener if Android leaves it unbound after an in-place update or OEM process kill.
Rules execute only when their conditions pass. Combine them with AND or OR, nest groups, and negate any group with NOT:
- ⏳ Time Window: Run only between specific hours (e.g., 23:00 to 07:00), with full midnight-crossing support.
- 📅 Days of the Week: Restrict to weekdays, weekends, or custom individual days.
- 🔋 Battery Level: Require battery to be
$\ge$ or$\le$ a specific threshold. - ⚡ Charging State: Require device to be currently charging or discharging.
- 📲 Screen State: Require screen to be on or off.
- 📶 Wi-Fi Network: Require connection to a specific Wi-Fi network (SSID).
- 🧩 Nested Logic: Group conditions with per-group AND/OR, negate a group, and nest up to four levels.
Chain multiple actions in any custom sequence with drag-and-drop ordering and individual delays (0–300s):
- 🌐 Connectivity (via Shizuku): Toggle Wi-Fi, Mobile Data, Airplane Mode, Bluetooth, GPS Location, and Wi-Fi Hotspot (Android 16+).
- 🖥️ Display & Device: Toggle Flashlight (Torch), Dark Theme (Shizuku), Auto-rotate, Brightness level, Lock Screen (Shizuku), and Force Stop App (Shizuku).
- 🔊 Sound & Alerts: Do Not Disturb (DND) toggle, Sound Profiles (Normal / Vibrate / Silent), Media Volume (0–100%), Custom Audio playback (1–60s duration), Haptic Patterns (Pulse, Double Tap, Alert, Heartbeat, Triple Tap, SOS), and Rich Notifications.
- 🗣️ Offline Speech (TTS): Speak custom messages using Android's on-device TTS engine with speech rate control. The voice picker includes System default (the phone's offline TTS voice, or the best offline fallback) and previews sample text in the selected voice's language. Templates can include trigger data such as
${notification.text|stripPrefix:"tts"|trim},${sms.otp},${call.state}, and${batteryPercent}; audio is synthesized on demand and cached. - ⏱️ Clock & Timers: Set system alarm or start a background timer (1s–24h).
- 🚀 Apps & Web: Launch installed app or open web URL.
- 💬 Phone & SMS: Open dialer, place direct phone call, send automated background SMS, or prepare SMS draft.
- 🔗 HTTPS Webhook: Send outbound HTTP requests (
GET,POST,PUT,PATCH,DELETE,HEAD) with custom headers, JSON body, AES-256-GCM Keystore encrypted secrets, and dynamic template variables. - 🧩 Template Variables: Use
${...}in speech, notification, webhook, SMS, phone, URL, alarm, and timer text. Every template-capable action field opens the same trigger-aware picker with filters (trim,stripPrefix,drop,truncate,lower,upper,default,urlencode,jsonescape). Global values include${trigger},${trigger.index},${batteryPercent},${isCharging},${wifiSsid},${time},${timestamp}, and${rule.name}.
- Quick Settings Tile & Engine Notification: Toggle the automation engine or inspect live status directly from Android's notification shade. Engine status and startup-failure notifications follow FlowPilot's English, Turkish, or system-language setting even after a background restart.
- Material 3 Home Screen Widget: Native
AppWidgetProvider(RemoteViews) widget displaying active rule counts with a one-tap pause/resume button. - In-App Live Test Run: Test any rule action directly inside the editor before saving to verify parameters.
- Per-Rule Home-Screen Shortcuts: Pin a launcher shortcut from Edit → Advanced. Tapping it reloads the rule and asks before running, with disabled or deleted rules blocked; no silent execution. On HyperOS, FlowPilot opens the Home screen shortcuts permission page when that permission is denied.
- Safe Rule Duplication: Clone any rule into an immediately editable disabled copy with freshly encrypted webhook credentials.
- Execution Run History: Local persistent audit trail of the last 100 executions with masked sensitive details. Raw provider errors, private URIs, local paths, credentials, and phone numbers are not persisted.
- Conflict Warnings: Automatic non-blocking analysis warning you when opposite state actions target the same trigger.
- First-Launch Guided Tour: A six-step spotlight walkthrough (welcome, presets, create, engine status, settings, done) highlights each area on first launch and skips the create step when rules already exist. Skip it at any time; completion is remembered on the device and the tour can be replayed from Settings → Replay tutorial.
FlowPilot uses Shizuku to perform elevated actions (Mobile Data, Airplane Mode, GPS, Dark Mode, App Killing) safely without needing root.
- Install Shizuku: Get it from Google Play or GitHub.
- Start Shizuku Service:
- On Android 11+ (Wireless Debugging): Start directly on your phone using Developer Options > Wireless Debugging (no PC required).
- Via PC (ADB): Run the following command:
adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
- Authorize FlowPilot: Open FlowPilot and tap Grant when prompted for Shizuku access.
- All elevated actions will now be unlocked and execute instantly!
FlowPilot is engineered with an uncompromised commitment to user privacy:
- 🚫 Zero Telemetry: No Firebase Analytics, no Sentry, no remote crash reporters, and zero tracking SDKs.
- 🔄 Optional Update Checks: When enabled, FlowPilot reads the public GitHub Releases API at most once a day and sends no account or device identifier. Disable it in Settings; manual checks remain available.
- 📵 No Cloud Synchronization: Your automations, logs, and secrets never touch any third-party cloud.
- 🛡️ Android Keystore Protection: Webhook secrets, tokens, and sensitive headers are encrypted with AES-256-GCM using Android Keystore keys, hardware-backed when supported by the device.
- 🙈 Strict Log Sanitization: Phone numbers, webhook credentials, and sensitive headers are masked across all UI screens and audit logs.
FlowPilot declares sensitive permissions solely to power explicit automation features:
QUERY_ALL_PACKAGES: Required to list installed apps in the App Trigger and App Launcher pickers on Android 11+.RECEIVE_SMS&SEND_SMS: Used exclusively by the SMS trigger and direct SMS responder actions.ACCESS_BACKGROUND_LOCATION: Powers zero-battery hardware geofencing (GeofencingClient) and injects coordinates only into user-configured automations.FOREGROUND_SERVICE_LOCATION: Required by Android 14+ to keep geofencing and active location tasks compliant while running in the background.REQUEST_INSTALL_PACKAGES: Used only to open Android's installer for an APK downloaded from the official FlowPilot GitHub release after the user taps Download & Install. FlowPilot never downloads or installs unattended.
Note: FlowPilot does not seek Google Play approval because these uncompromised permissions are essential for core automation functionality. Download verified APKs directly from GitHub Releases.
Releases built by GitHub Actions publish a build provenance attestation for the signed APK. Verify the artifact you downloaded against this repository:
gh attestation verify FlowPilot-vX.Y.Z.apk --repo emi-ran/flowpilot
apksigner verify --print-certs FlowPilot-vX.Y.Z.apk
sha256sum FlowPilot-vX.Y.Z.apkgh attestation verify(GitHub CLI 2.49+) confirms that this repository's release workflow attested the APK digest, and prints the source commit. Releases published before the attestation step was added have no attestation.apksigner verify --print-certsmust reportSigner #1 certificate SHA-256 digest: f1e45d3a669954ddfb858d5d3a964a2fa7ba3d00bcb0e65b5ced1ca6d5a79f2b.sha256summust match the published.sha256asset and the checksum in the release notes.
If any check fails, do not install the APK. Gradle dependency checksums, repository filters, and the complete procedure are documented in docs/SUPPLY_CHAIN.md.
| Mode | Format | Security | Ideal For |
|---|---|---|---|
| Sanitized JSON | Plain JSON | Webhook URLs & credentials stripped | Sharing automation rules with friends or online communities |
| Encrypted Backup | Encrypted Container | AES-256-GCM + PBKDF2 (100k iterations, salt + IV) | Full backup including secrets, phone numbers, and enabled states |
Restoring is effortless: choose your file, enter your password, and select Merge or Replace. Secrets are automatically re-encrypted with your new device's local Android Keystore.
Imported plain JSON rules are disabled; encrypted restores retain their enabled state. TTS audio is not included in backups. Speech templates are portable and synthesize on first play; legacy rules with no text need a new message after import.
FlowPilot follows modern Android architecture guidelines:
FlowPilot
├── app/src/main/java/com/flowpilot/app/
│ ├── actions/ # Executors: Shizuku, Audio, TTS, Webhook, SMS, System
│ ├── analysis/ # AutomationConflictAnalyzer and logic checks
│ ├── data/ # Models, JSON Serialization, DataStore Repositories, Backups
│ ├── engine/ # Foreground AutomationService, Receivers, Sensor Trackers
│ ├── permission/ # Capability checks and setup state
│ ├── quicksettings/ # System Quick Settings Tile Service
│ ├── shortcut/ # Per-rule home-screen shortcuts
│ ├── ui/ # Jetpack Compose UI (Material 3 Theme, Screens, Components, Tutorial Overlay)
│ ├── update/ # In-app update check, download, and install flow
│ └── widget/ # Home Screen widget (AppWidgetProvider + RemoteViews)
└── app/src/test/ # Deterministic JUnit unit test suites
- Language: Kotlin 2.2.10
- UI Toolkit: Jetpack Compose & Material 3
- Async Runtime: Kotlin Coroutines & StateFlow
- Storage: Jetpack DataStore (Preferences & JSON)
- Encryption: Android Keystore (AES-256-GCM)
- Privileged Bridge: Shizuku AIDL IPC
- Widgets: Native AppWidget (
AppWidgetProvider+RemoteViews) - Target SDK: Android 16 (API 36) • Min SDK: Android 8.0 (API 26)
- JDK 17 (OpenJDK or Eclipse Temurin)
- Android SDK (Platform 36, Build-Tools 36.0.0+)
- Python 3 (for the SDK-free contract checks)
- Git
# Clone the repository
git clone https://github.com/emi-ran/flowpilot.git
cd flowpilot
# Run unit tests
./gradlew testDebugUnitTest
# Run all SDK-free contract checks
for script in scripts/*.py; do python "$script" || exit 1; done
# Assemble debug APK
./gradlew assembleDebugCompiled APK output:
app/build/outputs/apk/debug/app-debug.apk
Install directly to your connected device:
adb install -r app/build/outputs/apk/debug/app-debug.apkDebug builds install as FlowPilot Dev with application ID com.flowpilot.app.debug; the release app keeps com.flowpilot.app, so both can stay installed side by side. Grant Shizuku, notification access, and any other privileged permission to the debug app separately. Debug builds skip release update checks.
Contributions, bug reports, and ideas are welcome!
- Check out CONTRIBUTING.md to get started.
- Found a bug? Open a Bug Report.
- Want to propose a new trigger or action? Submit a Feature Request.
FlowPilot is free and open-source software licensed under the GNU General Public License v3.0 (GPL-3.0).
Made with ❤️ for Android Power Users