边缘手势
5.3.1 · GitHub
More about this app
Edge-gesture app built on accessibility plus Shizuku: edge swipes, back-tap, floating music and task panels, freeform and app-kill actions.
EdgeGesture
An Android app built on the accessibility service — edge gestures, back double-tap, expand panel, launch blocking and more.
English | 简体中文
EdgeGesture (边缘手势) lets you drive the phone with edge swipes and taps or double-taps on the back of the device, launch apps from an expand panel, and block unwanted app launches.
Features
Edge gestures
- Three edges — independent trigger areas for the left, right and bottom edges
- Up to 3 segments per edge — every segment carries its own action set
- 9 actions per segment — swipe and long-press-swipe in three directions, plus tap / double tap / long press
- Custom trigger area — edge width, height / position percent and segment count, with a live preview
- Double swipe — in fullscreen or landscape mode two consecutive swipes are required to trigger
- Vibration feedback on trigger
- Statistics — gesture-trigger and launch-block counts over 1 / 7 / 30-day periods
Back double tap
Detects double taps on the back of the device with the accelerometer, using a heuristic signal-processing algorithm.
- Sensitivity (1–10) and detection range (1–10) tuning
- Working modes — always active, screen off, screen on
- Pause while charging to avoid accidental triggers
- Shares the same action set as edge gestures
Actions
| Category | Actions |
|---|---|
| System navigation | Back, Home, Recents, Previous app |
| Media | Previous track, Next track |
| System | Flashlight, Voice assistant, Power menu, Lock screen, Screenshot |
| Window | Freeform window |
| Panel | Expand panel |
| Shortcut | Alipay scan, WeChat scan |
| App | Launch app — bind any installed app as the target |
| Other | Delay reminders (custom minutes), None |
Expand panel
- System controls — brightness (written through
WRITE_SETTINGS, converted with the same HLG gamma curve as AOSP) and alarm / ring / media volume sliders - App shortcuts — 8 slots, tap to launch instantly
- Freeform launch — each slot can be toggled to open in a freeform (mini) window
- Icon cache — app icons are cached while scanning the app list
Launch blocker
Built on the accessibility service, optionally assisted by Shizuku.
- Global switch plus per-rule enable; each rule has an optional launcher and a required target app (both entered as a package name, matched by substring)
- Only active while the gesture service itself is enabled
- Block timing — immediate, slight delay (500 ms) or delayed (1000 ms)
- On blocking, the launcher app is brought back to the foreground
- Kill the launcher on every hit (fumble protection: at most 5 consecutive kills, then a 15 s cooldown)
- Optionally kill the target process, and control whether system apps may be terminated
- Process killing uses Shizuku, so it stays inert without it
App switch blacklist
- Filters the apps that should not show up when switching to the previous app
- Auto-initializes with system apps and the app itself on first launch; permission-aware, with a
PackageManager+<queries>fallback whenQUERY_ALL_PACKAGESis unavailable - Listens for app install / uninstall and updates automatically
Settings
- Theme — light, dark or follow system, switched with a circular-reveal transition
- Language — 简体中文, English or follow system; hot-switched in-app without recreating the activity, and applied at cold start through the persisted locale
- Gesture config — import / export a JSON file covering edge gestures, back double-tap, trigger-area options and launch-block rules
- Donate, about (author / version / project link) and the Shizuku state
Permissions
Permission cards live on the main page and show their grant state; the whole group collapses once everything is granted. Tapping a card opens the system page and starts a 500 ms poll that refreshes state and brings the app back to the foreground as soon as the permission is granted. Required by feature:
- Accessibility service — core system-level gesture handling
- Display over other apps — trigger area and expand panel
- Notification — keeps the gesture service running in the background
- Battery optimization — ignored so the service stays alive
- Query installed apps — full app list scanning
- Write system settings — brightness slider in the expand panel
In-app updates
An update check runs when the app returns to the foreground (at most once per day); in the single-column layout the version number can also be tapped to check on demand. The GitHub Releases API is queried over OkHttp; the APK is fetched with DownloadManager into the app-private directory and installed through FileProvider — only after its SHA-256 matches the digest published by GitHub, otherwise the file is discarded.
Crash logs
Uncaught exceptions and handled exceptions are written to daily log files under the app-specific external directory, keeping the most recent 3 days.
Tech Stack
| Layer | Technology |
|---|---|
| Language | Kotlin 2.4.21 |
| UI | Jetpack Compose (BOM 2026.09.00) + Material 3 |
| Adaptive layout | androidx.window 1.5.1 (WindowSizeClass) |
| DI | AndroidX ViewModel factories + app-level singletons |
| Navigation | Navigation 3 — navigation3-runtime / navigation3-ui 1.2.0 (type-safe NavKey) |
| State | DataStore Preferences 1.3.0 + StateFlow / MutableStateFlow |
| Permissions | Shizuku 13.1.5 + custom UserService (AIDL) |
| Network | OkHttp 5.5.1 |
| Serialization | kotlinx.serialization 1.12.0 |
| Hidden API bypass | hidden-api-bypass 6.2 (freeform windowing mode) |
| Build | AGP 9.5.0, Gradle 9.8.2, refreshVersions, JDK 21 |
Project Structure
.
├── app/
│ └── src/main/
│ ├── aidl/com/edgegesture/evilgodxu/service/ # ICommandService (Shizuku UserService)
│ ├── kotlin/com/edgegesture/evilgodxu/
│ │ ├── data/
│ │ │ ├── app/ # AppRepository (app list + icon cache), DataConfigManager
│ │ │ ├── gesture/ # Gesture / expand-panel settings, GestureStatsManager
│ │ │ ├── launchblock/ # Launch-block rules
│ │ │ ├── permission/ # PermissionMonitor
│ │ │ └── shizuku/ # ShizukuManager
│ │ ├── log/ # CrashLogManager
│ │ ├── navigation/ # NavGraph (Navigation 3 type-safe keys)
│ │ ├── screens/
│ │ │ ├── gesture/ # Main page + edge config
│ │ │ │ ├── components/ # Shared page components
│ │ │ │ └── service/ # Accessibility service + overlays
│ │ │ │ └── expandpanel/
│ │ │ ├── backtap/ # Back double tap
│ │ │ ├── blacklist/ # App switch blacklist
│ │ │ ├── expandpanel/ # Expand panel settings
│ │ │ ├── launchblock/ # Launch blocker
│ │ │ └── settings/components/
│ │ ├── service/ # CommandUserService
│ │ ├── ui/ # adaptive/ (window size class) + theme/
│ │ ├── update/ # UpdateManager / UpdateViewModel / UpdateDialog
│ │ ├── utils/localization/ # In-app locale manager
│ │ ├── MainActivity.kt
│ │ └── MyApplication.kt
│ └── res/ # Resources (values / values-en)
├── archive/removed-features/ # Archived removed features (source + integration snapshots)
├── gradle/
│ ├── libs.versions.toml # Version catalog
│ └── wrapper/
├── LICENSE
├── NOTICE
├── build.gradle.kts
├── settings.gradle.kts
└── gradle.properties
Architecture
The app follows MVVM with unidirectional data flow: state flows down from ViewModel → UiState → UI while events flow up from the UI to the ViewModel. Shared data logic lives in data/ behind repository-style objects (settings, app list, launch-block rules, permissions, Shizuku), wired together by AndroidX ViewModel factories and app-level singletons.
Gesture and overlay capabilities sit in screens/gesture/service/:
EdgeGestureAccessibilityService detects edge swipes, edge taps and background taps and dispatches actions through AccessibilityActionExecutor. Each overlay (edge trigger area, expand panel) is a system window hosted by its own manager, mostly as a ComposeView, coordinated from the accessibility service.
Settings persist in DataStore (gesture_settings, settings, launch_block). Optional system-level operations — stopping an app process, freeform windowing — go through Shizuku's CommandUserService or the hidden-API bypass, and simply stay inactive when Shizuku is unavailable.
Getting Started
Prerequisites
- JDK 21
- Android Studio (latest stable recommended)
- Android SDK with API 37 (
compileSdk)
Build
git clone https://github.com/Evilgodxu/EdgeGesture.git
cd EdgeGesture
# Debug APK
./gradlew assembleDebug
# Release APK (requires signing config, see below)
./gradlew assembleRelease
APKs are emitted as EdgeGesture-<versionName>-arm64.apk under app/build/outputs/apk/. Only the arm64-v8a ABI is built. The release build enables minification and resource shrinking.
Release Signing
The release build reads signing credentials from local.properties in the project root:
KEYSTORE_PASSWORD=your_store_password
KEY_ALIAS=your_key_alias
KEY_PASSWORD=your_key_password
The keystore is expected at jh.keystore in the project root (adjust storeFile in app/build.gradle.kts if needed). Both files are git-ignored — never commit them.
License
AGPL-3.0 © 2026 Evilgodxu
How Shizuku is used
Can stop blocked app launches via `am stop-app` through Shizuku.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku is used to enforce user configured app launch block rules by stopping app processes with shell privilege.
- Block unwanted app launches: when an opened app matches a block rule, the matching target app is stopped and the app returns to the previous app or home screen, using the
am stop-appshell command through Shizuku. When the rule enables launcher killing, the launcher app that started the blocked launch is also stopped the same way, with limits on repeated kills.
Android APIs or commands used
am stop-app
Notable details
Without Shizuku, launch blocking only navigates away to the previous app or home screen without stopping the blocked or launcher app process.
Changelog
What's new for version 5.3.1
重点修复:上一个应用
- 修复「在桌面触发时跳到了更早的应用」:桌面及切换黑名单内的应用不再占用历史位置,从这些地方触发会回到最近使用的应用。
- 修复「某些情况下触发完全无响应」:输入法、系统面板等临时窗口不会再占据「上一个应用」,避免切换目标变成无法启动的包。
- 现在按最近使用历史定位:在应用内触发回溯一格,切换后可继续触发在两个应用间来回。
- 没有更早的应用可回退时保持无操作。
启动拦截
- 终止相关开关在未获得 Shizuku 授权时统一回落为关闭并引导授权,不再出现「需要权限却显示已开启」的状态。
设置页
- 版本号下方新增「日志」入口,可直接分享今日日志(今日无日志会提示)。
其它修复
- 修复切换应用语言时可能导致的启动崩溃。
内部改进(不影响使用)
- 迁移到手动依赖注入与仓库分层,应用实例单一起源。
- 统计改为由数据派生,移除内存副本与手动同步。
- 更新模块、规则弹窗、手势与设置页面按职责拆分。
本次版本号:
versionCode 24 / versionName 5.3.1,发布产物EdgeGesture-5.3.1-arm64.apk。
Permissions
20 permissions requested