- | Home Screen |
- Ready Presets |
- Create Automation |
- Settings & About |
+ Home Screen |
+ Ready Presets |
+ Rule Builder |
+ Settings & Backup |
+ About Dialog |
 |
 |
-  |
+ |
+  |
 |
@@ -62,110 +114,184 @@ Most popular automation tools on Android are burdened with cloud requirements, a
---
-## 🚀 Key Features
+## 💡 How FlowPilot Works
+
+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) │
+└───────────────────────────┘ └───────────────────────────┘ └───────────────────────────┘
+```
+
+### Relatable Examples:
+- 🌙 **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.
+
+---
+
+## ⚡ 1-Tap Ready Presets
+
+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% | Turns on Battery Saver, disables Bluetooth, lowers brightness, enables Dark Mode |
+| 🔕 **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 |
+
+---
+
+## 🎛️ Feature Matrix
### 1. Triggers (Events)
-FlowPilot responds to a wide spectrum of hardware, system, and user events:
-- **Application:** App opened or closed (via low-overhead `UsageStatsManager` transitions).
-- **Power & Battery:** Charger plugged in / unplugged, battery drops below or rises above custom threshold percentage.
-- **Display & State:** Screen turned on / off, device unlocked.
-- **Time & Scheduling:** Daily, weekdays, weekends, or specific custom days and times.
-- **Connectivity & Radios:** Wi-Fi connected or disconnected (any or specific SSID), Bluetooth device connected or disconnected (bonded devices).
-- **Sensors & Motion:**
- - **Device Flip:** Phone placed face down on a surface or turned face up (dual physical validation: Proximity sensor + Gravity/Accelerometer Z-axis with 500ms debounce).
- - **Shake:** Firm shake detection with configurable sensitivity.
- - **Ambient Light:** Darker than or brighter than lux target with real-time sensor sampling.
-- **Location & Geofencing:** Enter or exit designated geographical areas (`GEOFENCE_ENTER`, `GEOFENCE_EXIT`) backed by Google Play Services `GeofencingClient` hardware geofencing. Event-driven battery behavior with zero CPU wake-locks while idle. Persistent DataStore event queueing (up to 50 events) ensures boundary transitions are never lost across engine or process restarts. Requires precise (`ACCESS_FINE_LOCATION`) and background (`ACCESS_BACKGROUND_LOCATION`) location permissions. Home screen displays live registration diagnostics and status (`REGISTERED`, `UNREGISTERED`, `TRANSITION_ENTER`, `TRANSITION_EXIT`, or error). Inbound transition coordinates are directly reused for location template variables (`${location.lat}`, `${location.lng}`, etc.), avoiding unnecessary fresh GPS lookups for notification-only or template-driven geofence actions.
-- **Hardware & Tags:** NFC tag scanned (hex UID matching).
-- **Communications:**
- - **Incoming/Outgoing Calls:** Ringing, answered, outgoing placed, and call ended states.
- - **SMS Messages:** Filtered by sender number and matching modes (contains keyword, exact match, prefix, or regex).
-- **Notifications:** Notifications received from selected installed apps with optional keyword filter.
+FlowPilot listens to a rich spectrum of hardware, radio, and system events:
+
+- 📱 **App Lifecycle:** App launched or closed (lightweight `UsageStatsManager` transitions).
+- 🔌 **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:** Firm shake detection with configurable sensitivity slider.
+ - **Ambient Light:** Lux drops below or rises above target threshold.
+- 📍 **Hardware Geofencing:** Enter or exit defined geographical zones using Google Play Services `GeofencingClient`. Zero idle battery drain, up to 50 persistent queued events across engine restarts, and coordinate reuse for template variables.
+- 🏷️ **NFC Tags:** Instant hex UID matching on physical tag scan.
+- 📞 **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.
---
### 2. Conditions (Logic Gates)
-Rules execute only when all specified conditions (AND semantics) are satisfied:
-- **Time Window (`TIME_BETWEEN`):** e.g., only run between 23:00 and 07:00, with full overnight midnight-crossing support.
-- **Days of the Week (`DAYS_OF_WEEK`):** Filter by weekdays, weekends, or custom day toggles.
-- **Battery Level:** Only if battery is $\ge$ or $\le$ threshold.
-- **Charger State:** Only while charging or discharging.
-- **Screen State:** Only while screen is on or screen is off.
-- **Wi-Fi State:** Only while connected to a specific Wi-Fi SSID.
+Rules execute only when all specified conditions (AND logic) are satisfied:
+
+- ⏳ **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).
---
### 3. Actions (Executors)
-Chain multiple sequential actions within a single rule, complete with custom drag-and-drop reordering and individual delay timers (0–300s):
-- **Connectivity (via Shizuku):** Toggle Wi-Fi, Mobile Data, Airplane Mode, Bluetooth, and Location.
-- **Display & Tools:** Toggle Flashlight (Torch), Dark Theme (Shizuku), Auto-rotate, Screen Brightness, Lock Screen (Shizuku), and Force Stop App (Shizuku).
-- **Sound & Alerts:** Do Not Disturb (DND) ON/OFF, Sound Profiles (Normal / Vibrate / Silent), Set Media Volume (0–100%), Play Tone/Custom Audio (1–60s duration), Vibrate (Pulse, Double Tap, Alert, Heartbeat, Triple Tap, SOS), and Show Notification.
-- **Speech Synthesis (TTS):** Speak custom voice message using Android offline TTS engine with rate control and on-device cache.
-- **Clock & Alarms:** Create system alarm, start background timer (1s–24h with `EXTRA_SKIP_UI`).
-- **Apps & Web:** Launch installed application, open website URL.
-- **Phone & SMS:** Open dialer, dial phone number, directly place phone call, send direct automated background SMS, prepare SMS draft.
-- **HTTPS Webhook:** Send outbound HTTPS requests (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `HEAD`) with headers, body, AES-256-GCM Keystore encrypted secrets, and live template variables (`${trigger}`, `${batteryPercent}`, `${isCharging}`, `${wifiSsid}`, `${time}`, `${timestamp}`, `${location.lat}`, `${location.lng}`, `${location.coords}`, `${location.maps_url}`).
+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, and GPS Location.
+- 🖥️ **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 voice alerts using Android's on-device TTS engine with speech rate control.
+- ⏱️ **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:
+ - `${trigger}`, `${batteryPercent}`, `${isCharging}`, `${wifiSsid}`, `${time}`, `${timestamp}`, `${location.lat}`, `${location.lng}`, `${location.coords}`, `${location.maps_url}`
---
-### 4. Ready-to-Use Presets (Recipes)
-FlowPilot includes pre-built one-tap templates to get started quickly:
-- 🌙 **Bedtime Routine:** At 23:30, enables Dark Mode, sets sound profile to Silent, turns on DND, and dims brightness to 10%.
-- 🔋 **Full Battery Protection (100%):** Announces unplug reminder via offline TTS and shows notification when battery finishes charging.
-- ⚡ **Battery Saver Emergency:** At 15% battery, turns on Battery Saver, disables Bluetooth, sets brightness to 15%, and enables Dark Mode.
-- 🔕 **Flip to Silence:** Turning phone face down activates Do Not Disturb with a confirmation pulse.
-- 🔦 **Shake for Flashlight:** Firm shake toggles the camera torch with haptic feedback.
-- 🎬 **Cinema / Night Reading:** Low ambient light (<5 lx) dims brightness and enables dark theme.
-- 🚗 **Leaving Home Mode:** Disconnecting from home Wi-Fi activates mobile data, sets normal ringer, and raises media volume to 80%.
-- 🏠 **Welcome Home Mode:** Connecting to home Wi-Fi disables mobile data and restores balanced settings.
-- 📍 **SMS Emergency Location Responder:** When incoming SMS matches secret keyword, acquires active GPS coordinates and replies with live Google Maps link.
+### 4. Smart Productivity & Controls
+- **Quick Settings Tile:** Toggle the automation engine or inspect live status directly from Android's notification shade.
+- **Material 3 Home Screen Widget:** Glance-powered 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.
+- **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.
+- **Conflict Warnings:** Automatic non-blocking analysis warning you when opposite state actions target the same trigger.
---
-### 5. Quick Controls & Widgets
-- **Quick Settings Tile:** Toggle the automation engine or view live status directly from Android notification shade.
-- **Home Screen Widget (Jetpack Glance):** Modern widget displaying active rule counts with one-tap pause/resume button.
-- **In-App Manual Test Run:** Test rule actions directly while editing with real parameters without needing to save first.
-- **Safe Rule Duplication:** Duplicate any rule from its list menu into an immediately editable, disabled copy. Configuration is preserved, runtime state is reset, and webhook secrets receive fresh Android Keystore ciphertext.
-- **Execution Run History:** Local persistent audit log of the last 100 executions with per-action outcomes rendered in the selected app language; credentials and phone numbers remain redacted/masked.
-- **Conflict warnings:** Before save or enable, exact matching trigger targets with opposing state actions are explained as likely or possible conflicts. Warning is non-blocking, links to conflicting rules, and requires a deliberate override. Analyzer does not claim full proof for arbitrary condition/time-window overlap.
+## 🛡️ Shizuku Setup Guide
+
+FlowPilot uses **Shizuku** to perform elevated actions (Mobile Data, Airplane Mode, GPS, Dark Mode, App Killing) safely without needing root.
+
+1. **Install Shizuku:** Get it from [Google Play](https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api) or [GitHub](https://shizuku.rikka.app/).
+2. **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:
+ ```bash
+ adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
+ ```
+3. **Authorize FlowPilot:** Open FlowPilot and tap **Grant** when prompted for Shizuku access.
+4. All elevated actions will now be unlocked and execute instantly!
---
-## 🛠️ Architecture & Tech Stack
+## 🔒 Privacy & Zero-Trust Promise
+
+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.
+- 📵 **No Cloud Synchronization:** Your automations, logs, and secrets never touch any third-party cloud.
+- 🛡️ **Hardware Keystore Protection:** Webhook secrets, tokens, and sensitive headers are encrypted with AES-256-GCM using hardware-backed Android Keystore keys.
+- 🙈 **Strict Log Sanitization:** Phone numbers, webhook credentials, and sensitive headers are masked across all UI screens and audit logs.
+
+### Transparent Permission Disclosures
+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.
+
+*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.*
+
+---
+
+## 📦 Backup & Recovery
+
+| 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.
+
+---
+
+## 🛠️ Tech Stack & Architecture
+
+FlowPilot follows modern Android architecture guidelines:
```
FlowPilot
├── app/src/main/java/com/flowpilot/app/
-│ ├── actions/ # Action executors (Shizuku, TTS, Webhook, Audio, System, Phone)
-│ ├── data/ # Models, JSON Serialization, DataStore Repository, Backup/Restore
-│ ├── engine/ # Foreground AutomationService, BroadcastReceivers, Sensor Trackers
-│ ├── glance/ # Jetpack Glance Home Screen Widget implementation
+│ ├── 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
+│ ├── glance/ # Jetpack Glance Home Screen Widget
│ ├── quicksettings/ # System Quick Settings Tile Service
│ ├── shizuku/ # Shizuku AIDL IPC client bridge
-│ └── ui/ # Jetpack Compose UI (Theme, Screens, Components, Pickers)
+│ └── ui/ # Jetpack Compose UI (Material 3 Theme, Screens, Components)
└── app/src/test/ # Deterministic JUnit unit test suites
```
- **Language:** Kotlin 2.2.10
-- **UI Framework:** Jetpack Compose & Material 3
-- **Concurrency:** Kotlin Coroutines & StateFlow
-- **Persistence:** Android Jetpack DataStore (Preferences & JSON serialization)
-- **Security:** Android Keystore (AES-256-GCM encrypted webhook credentials at rest)
-- **System Control:** Shizuku AIDL IPC Bridge
-- **Widgets:** Android Jetpack Glance (Compose-style App Widgets)
-- **Compatibility:** Min SDK 26 (Android 8.0 Oreo) — Target / Compile SDK 36 (Android 16)
+- **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:** Jetpack Glance
+- **Target SDK:** Android 16 (API 36) • **Min SDK:** Android 8.0 (API 26)
---
-## 📥 Build & Installation
+## 📥 Build from Source
### Prerequisites
-- JDK 17 (Eclipse Temurin or OpenJDK)
-- Android SDK with Platform 36 and Build-Tools 36.0.0+
+- JDK 17 (OpenJDK or Eclipse Temurin)
+- Android SDK (Platform 36, Build-Tools 36.0.0+)
- Git
-### Build from Source
```bash
# Clone the repository
git clone https://github.com/emi-ran/flowpilot.git
@@ -178,72 +304,32 @@ cd flowpilot
./gradlew assembleDebug
```
-The compiled APK will be located at:
+Compiled APK output:
```text
app/build/outputs/apk/debug/app-debug.apk
```
-### Backup & Restore
-
-- **Normal JSON export/share:** Portable sanitized rule data. Webhook URL, headers, and body are omitted; normal imports disable imported rules before Merge or Replace.
-- **Encrypted full backup:** Choose **Encrypted full backup** in Settings, or when sharing one rule. A password of at least six characters encrypts all rule data, including webhook configuration, phone/SMS fields, and enabled state.
-- **Portable format:** AES-256-GCM authenticated encryption with PBKDF2-HMAC-SHA256 key derivation (100,000 iterations), random salt, and random IV. A wrong password or modified backup is rejected before rules are changed.
-- **Restore:** Select an encrypted backup, enter its password, then choose Merge or Replace. Secrets are re-encrypted with the receiving device's Android Keystore after import.
-- **Scope:** Execution history, temporary geofence diagnostics/queue state, engine state, Android permissions, Shizuku state, and TTS audio cache are not included.
-
-### Install to Device via ADB
+Install directly to your connected device:
```bash
adb install -r app/build/outputs/apk/debug/app-debug.apk
```
---
-## 🛡️ Shizuku Integration Guide
-
-Certain privileged actions (toggling Mobile Data, Airplane Mode, GPS, Dark Mode, or Force Stopping apps) require **Shizuku** to run elevated commands without root access.
-
-1. Install [Shizuku](https://shizuku.rikka.app/) from Google Play or GitHub.
-2. Start Shizuku via **Wireless Debugging** (Android 11+) or via ADB from a computer:
- ```bash
- adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
- ```
-3. Open **FlowPilot** -> When prompted, grant Shizuku permission to FlowPilot.
-4. All Shizuku-gated actions will now show as **Available** and execute seamlessly.
-
----
-
-## 🔒 Privacy & Permissions Notice
-
-FlowPilot operates on a **zero-trust privacy model**:
-- **No Telemetry or Cloud Sync:** The app contains no crash reporters, analytics endpoints, remote ad SDKs, or cloud synchronization.
-- **Configured Data Sharing:** User-configured Webhooks, SMS actions, and exports can send only data you choose.
-- **Location:** Used strictly locally to read current Wi-Fi SSID, register hardware geofence boundaries via Google Play Services `GeofencingClient`, and optionally inject coordinates into user-defined Webhooks or SMS replies.
-- **Phone & SMS:** Used only to trigger automations on call states or user-specified SMS text patterns. Phone numbers are masked in all logs and history.
-
-### Distribution and restricted permissions
-
-FlowPilot declares `QUERY_ALL_PACKAGES` because its user-facing App Picker calls `PackageManager.getInstalledApplications()` and filters launchable packages for app triggers and app-targeted actions. Removing it breaks this core picker on Android versions that limit package visibility. `RECEIVE_SMS` is used by `SmsReceiver` for incoming SMS triggers; `SEND_SMS` is used by `SmsExecutor` for user-configured direct SMS actions. `ACCESS_BACKGROUND_LOCATION` is used by Google Play Services hardware geofencing (`GeofencingClient`) for zero-battery background boundary detection and by `LocationFetcher` when active rules need coordinates while the activity is not visible; `FOREGROUND_SERVICE_LOCATION` authorizes the location foreground-service subtype. Location is not collected continuously via polling when no rule needs it.
-
-These permissions are restricted or policy-sensitive on Google Play. This repository does **not** claim Play compliance or guaranteed approval. No Play-specific permission-reduced flavor exists: removing these declarations would disable core features. Any Play release requires current policy review, required declarations, accurate Data safety disclosures, and Google approval. Until then, distribute builds through GitHub releases, F-Droid, or sideloading. Users should install only builds from sources they trust.
-
----
-
## 🤝 Contributing
-Contributions, bug reports, and suggestions are welcome!
-- Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
-- Found a bug? Open an issue using the [Bug Report](https://github.com/emi-ran/flowpilot/issues/new?template=bug_report.md) template.
-- Have a feature idea? Share it via [Feature Request](https://github.com/emi-ran/flowpilot/issues/new?template=feature_request.md).
+Contributions, bug reports, and ideas are welcome!
+- Check out [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
+- Found a bug? Open a [Bug Report](https://github.com/emi-ran/flowpilot/issues/new?template=bug_report.md).
+- Want to propose a new trigger or action? Submit a [Feature Request](https://github.com/emi-ran/flowpilot/issues/new?template=feature_request.md).
---
## 📄 License
-FlowPilot is free and open-source software licensed under the **GNU General Public License v3.0 (GPL-3.0)**.
-See the [LICENSE](LICENSE) file for complete details.
-
----
+FlowPilot is free and open-source software licensed under the **[GNU General Public License v3.0 (GPL-3.0)](LICENSE)**.
-Made with ❤️ for Android Power Users
+
+ Made with ❤️ for Android Power Users
diff --git a/README.tr.md b/README.tr.md
index 80be4fc..825278b 100644
--- a/README.tr.md
+++ b/README.tr.md
@@ -2,168 +2,296 @@
# ⚡ FlowPilot
-**Gizlilik odaklı, çevrimdışı ve hafif Android otomasyon motoru.**
+### Gizlilik odaklı, pil dostu ve hafif Android otomasyon motoru — rootsuz.
+Olay odaklı tetikleyiciler, Shizuku ile ayrıcalıklı sistem yetkileri ve akıcı Material 3 arayüzüyle cihazınızı zahmetsizce otomatikleştirin. Telemetri yok, bulut hesabı zorunluluğu yok ve arka planda gereksiz pil tüketimi yok.
+
+
+
+[](https://github.com/emi-ran/flowpilot/releases)
+[-34A853?logo=android&logoColor=white)](https://developer.android.com)
+[](https://kotlinlang.org)
+[](https://developer.android.com/jetpack/compose)
+[](https://shizuku.rikka.app)
+[](#-gizlilik-ve-s%C4%B1f%C4%B1r-g%C3%BCven-ilkesi)
[](LICENSE)
-[-brightgreen.svg)](https://developer.android.com)
-[](https://kotlinlang.org)
-[](https://developer.android.com/jetpack/compose)
-[](https://shizuku.rikka.app)
-[](https://mi.com)
-[](#kaynak-koddan-derleme)
-[🇹🇷 Türkçe](README.tr.md) • [🇺🇸 English](README.md)
+[**🇹🇷 Türkçe**](README.tr.md) • [**🇺🇸 English**](README.md)
+
+
+
+
+
+ 
+
+
+
+ 
+
+
+
+ 
+
+
+
+ 
+
+
---
> [!NOTE]
-> **📱 Cihaz Uyumluluğu & Topluluk Testi Bilgilendirmesi:**
-> FlowPilot bağımsız bir geliştirici tarafından geliştirilmekte olup, geliştiricinin şahsi cihazı olduğu için şu an **öncelikli olarak Xiaomi HyperOS (Xiaomi 15T Pro)** üzerinde geliştirilmiş ve bizzat test edilmiştir. Proje genelinde standart Android API'lerine ve en iyi pratiklere sadık kalınmıştır; ancak diğer üretici arayüzlerinde (Google Pixel, Samsung One UI, OxygenOS, Motorola vb.) henüz test imkanı olmamıştır. Farklı cihazlardaki test raporlarınız, hata bildirimleriniz ve geliştirmeleriniz (Pull Request) memnuniyetle karşılanır!
-
-## 🌟 Neden FlowPilot?
+> **📱 Cihaz Uyumluluğu & Topluluk Testi Bilgilendirmesi**
+> FlowPilot bağımsız bir açık kaynak projesidir ve bizzat geliştiricinin kişisel cihazı olan **Xiaomi HyperOS (Xiaomi 15T Pro)** üzerinde günlük olarak geliştirilip test edilmektedir. Proje genelinde standart Android Jetpack ve sistem API'lerine titizlikle uyulmuş, CI doğrulamasında ise **API 35 Android Emulator** ile çalışma zamanı sözleşmeleri denetlenmektedir.
+>
+> Farklı üretici arayüzleri (Samsung One UI, Google Pixel, Motorola, OxygenOS vb.) arka plan kısıtlamalarını farklı uygulayabildiğinden, test geri bildirimleriniz, cihaz deneyimleriniz ve katkılarınız (Pull Request) memnuniyetle karşılanır!
-Android ekosistemindeki popüler otomasyon araçlarının büyük kısmı zorunlu bulut hesapları, agresif telemetri/izleyiciler, pili tüketen sürekli yoklama (polling) servisleri ve karmaşık arayüzlerle doludur.
+---
-**FlowPilot** bu durumu kökten değiştirir:
+## 🌟 Neden FlowPilot?
-- 🔒 **Varsayılan Olarak Gizli:** Telemetri veya bulut eşitlemesi yoktur. Yapılandırılmış Webhook, SMS ve dışa aktarma işlemleri yalnızca seçtiğiniz verileri gönderebilir.
-- ⚡ **Pil Dostu & Olay Odaklı:** İşlemciyi sürekli uyanık tutan gereksiz döngüler yoktur. Sensörler (ivmeölçer, yakınlık, ortam ışığı) ve yayın alıcıları yalnızca aktif bir kural ihtiyaç duyduğunda dinamik olarak devreye girer.
-- 🛡️ **Shizuku Entegrasyonu:** Mobil Veri, Uçak Modu, GPS ve Koyu Tema gibi sistem düzeyindeki ayarları root erişimine gerek kalmadan güvenli ADB yetkileriyle kontrol edin.
-- 🎨 **Modern Material 3 Tasarımı:** Dinamik Aydınlık ve Koyu tema, akıcı animasyonlar ve yüksek erişilebilirlik standartlarına sahip saf Jetpack Compose mimarisi.
-- 🔊 **Çevrimdışı Metin Okuma (TTS):** İnternet bağlantısı gerektirmeyen, cihaz üzerinde önbelleklenen yüksek kaliteli sesli duyuru altyapısı.
-- 🔄 **Açık Ekosistem:** Otomasyon kurallarını güvenli JSON olarak dışa aktarın/paylaşın veya parola şifreli tam yedeklerle Birleştirme / Üzerine Yazma seçeneklerini kullanın.
+Geleneksel Android otomasyon uygulamaları genelde karmaşık arayüzler, sürekli arka plan döngüleriyle pili bitiren servisler veya zorunlu bulut üyelikleriyle gelir. **FlowPilot bu anlayışı değiştirmek için geliştirildi.**
+
+
+
+
+
+ 
+
+
+
+ 
+
+
+
+ 
+
+
