📱 XGesture — The Ultimate Android Gesture & One-Handed Productivity Suite

All-in-One Open-Source Alternative to Samsung One Hand Operation+ (OHO+), Quick Cursor & FooView
Edge Panels · Reachability Floating Cursor · Floating Ball OCR & Reverse Image Search · Shake & Back-Tap Gestures · Notification & OTP Manager · App Freezer · Freeform Window · Shizuku & LSPosed

English | 简体中文 | 日本語

XGesture is a universal system-level gesture and single-handed productivity suite designed for all Android 12+ devices across all OEMs. Built on Accessibility Services with flexible multi-privilege modes (Shizuku, Root / KernelSU / Magisk, and optional LSPosed integration), it brings desktop-grade control and effortless reachability to modern large-screen phones.

Easily trigger 50+ system actions via customizable multi-angle screen-edge swipes, reachability floating pointers, multi-functional floating ball, device shaking, desk-flipping, or back-tap gestures. Deeply integrates 100% offline on-device OCR, word segmentation (CppJieba), and reverse image search aggregation—delivering high-efficiency overlay launchers, app freezing, OTP verification code extraction, notification management, and OEM freeform windows on top of any app, completely free from ads and cloud trackers.

• Package Name: com.slideindex.app
• Current Version: 1.33.0 (versionCode 68)
• Requirements: Android 12+ (API 31+)
• License: AGPL-3.0 License

📥 Download & Installation

🌟 Core Features

The app features four main navigation tabs: 🏠 Home · 📳 Motion · 🔔 Notification · 🧩 Extensions.

🏠 Home — Edge Gestures, Floating Ball & Customization

1. Edge Gestures

• Triggers & Aesthetics: Highly responsive left/right/top/bottom edge triggers, supporting bubble, capsule, wave animations, and haptic feedback.
• Custom Layout & Landscape Triggers: Freely adjust trigger position, height, thickness, angle, and segments; supports dedicated landscape trigger handles for gaming and media viewing.
• Smart Anti-Mistouch: Auto-hide in landscape/lock screen/home screen, with per-app exclusion lists and foreground switching blacklists.
• Corner Radial Menu: Swipe from bottom-left or bottom-right corners to summon a radial menu with real-time Gaussian blur and action grouping.
• OEM Freeform Integration: Deeply adapts to native Android Freeform, Xiaomi MIUI/HyperOS Small Window, and Meizu Flyme Small Window.

2. 50+ Configurable Gesture Actions

3. 🔮 Floating Ball (OCR, Image Search & Gestures)

Operates independently from the Floating Pointer, combining joystick navigation with screen OCR pointers.

• Accessibility & Offline Multi-Engine OCR: Extracts text via accessibility nodes first, seamlessly falling back to local offline OCR (ML Kit / Tesseract / PaddleOCR ONNX).
• Text Selection Panel: One-click search, translate, segmentation (CppJieba), select all, remove spaces, and copy; supports region clipping and shared image OCR history.
• Search Aggregation: Customizable search engines, grid sorting, search history, prefix aliases, and deep links; supports importing from GestureEVO / SearchEVO.
• Reverse Image Search: Summon multi-engine reverse search (Google, Yandex, TinEye, SauceNAO, IQDB, 3D-IQDB, ASCII2D, trace.moe, AnimeTrace, Copyseeker) with built-in WebView preview.
• Pin to Screen: Pin screenshots or text cards as top-level floating windows with pinch-to-zoom and drag support.
• Appearance & Tuning: Custom themes, images, GIFs, and slideshows; adjustable pointer sensitivity and OCR tolerance.

4. Theme & Appearance

• Miuix Design System: Comprehensive adoption of Miuix UI (HyperOS style) with collapsible TopAppBar, virtualized grouped cards, overscroll damping, and haptic feedback.
• Material You Dynamic Coloring: Automatically extracts wallpaper colors via MaterialKolor on Android 12+, generating 9 palette styles injected into MiuixTheme.
• Blur & Performance: Bottom navigation and floating overlays support Gaussian blur and progressive blur; can be disabled to completely eliminate scroll sampling overhead.

📳 Motion & Device Gestures — Shake, Flip & Back-Tap

• 6-Direction Shake Recognition: Distinguishes left/right flip, forward/backward flip, and quick side shakes; supports per-app custom actions and sensitivities.
• Desk-Flip Mute: Place face-down on a flat surface while screen is on to trigger lock screen and silent mode.
• Back-Tap Gestures (BackTap): Accelerometer-based back-cover double-tap recognition supporting 50+ actions, screen on/off/always trigger policies, sensitivity tuning, and charging guard.
• Scenario Rules: Screen on/locked activation policies, app blacklists/whitelists, independent sensitivity thresholds, and vibration feedback.

🔔 Notification — Reminders, History & OTP

• Multi-Style Reminders: Intercepts notifications with Dynamic Island cards, heads-up popups, side bubbles, or screen danmaku; supports "Open Latest Message on Unlock" (with whitelist and confirm policies).
• Notification History & Filtering: Categorizes active, history, and hidden notifications with multi-dimensional regex and keyword archiving.
• OTP Verification Center: Automatically detects verification codes in SMS and app notifications with regex extraction, clipboard auto-copy, and auto-fill; optional LSPosed module for system-level SMS injection.

🧩 Extensions — Utility Tools & Backup

📸 Key Interfaces & Interaction Preview

Corner Radial Menu	Circle Launcher (FV Style)	Quick Launcher (Grid)
Floating Pointer (Joystick)	Shell Command Panel (Shizuku)	Clipboard History / Stash
App Index (Pinyin Rail)	Widget Floating Panel	Pin Screenshot Window

🔗 External Invocation

Open XGesture panels from other apps, Tasker, MacroDroid, or adb. In-app reference: Extensions → Shortcuts & actions → External Invocation (tap to copy).

Prerequisites: Search panel, stash, and clipboard require the sidebar and accessibility service. Notification hub requires notification listener access.

Deeplinks (recommended)

Format: xgesture://open/<path>?q=<optional query>

Examples:

# Open search panel
adb shell am start -a android.intent.action.VIEW -d "xgesture://open/search-panel"

# Open search panel with prefill
adb shell am start -a android.intent.action.VIEW -d "xgesture://open/search-panel?q=weather"

Intent actions (advanced)

Use when there is no matching URI, or when you need an explicit component. Package name: com.slideindex.app.

Examples:

# Open search panel with prefill
adb shell am start -a com.slideindex.app.action.OPEN_SEARCH_PANEL \
  -n com.slideindex.app/.service.SearchPanelTrampolineActivity \
  --es q "weather"

# Toggle edge gesture master switch
adb shell am start -a com.slideindex.app.action.TOGGLE_GESTURE \
  -n com.slideindex.app/.service.ToggleGestureTrampolineActivity

💡 Design Philosophy & Comparisons

Standing on the Shoulders of Giants

Android has seen legendary tools that shaped mobile navigation and productivity:

• Samsung One Hand Operation+ (OHO+) perfected multi-angle edge triggers and smooth system gestures.
• Quick Cursor introduced thumb-friendly screen reachability via intuitive floating cursors.
• FooView (FV) pioneered floating-ball universal OCR, search aggregation, and floating window shortcuts.

Why XGesture?

While we deeply admire these pioneering tools, modern Android users frequently face fragmentation:

• Vendor Lock-in: OHO+ is one of the most beloved gesture tools ever created, but it remains exclusive to Samsung One UI. Non-Samsung users on Pixel, Xiaomi, Motorola, Sony, etc., have long sought a genuine alternative.
• Open Source & Privacy-First: Proprietary utilities often carry cloud-dependent OCR and closed ecosystems. XGesture is 100% AGPL-3.0 open-source, bundling offline on-device OCR (PaddleOCR ONNX / ML Kit) that respects user privacy.
• Unified Navigation: Rather than running multiple separate tools for edge gestures, single-handed pointers, and floating OCR, XGesture brings them together into a unified, coherent experience with fluid Miuix animations.

🛠️ Tech Stack

📐 Architecture

The app adopts a Multi-Module layered architecture following MVVM + UDF patterns:

                              ┌─────────────────────────────┐
                              │          :app (Root)        │
                              └──────────────┬──────────────┘
                                             │
                      ┌──────────────────────┼──────────────────────┐
                      ▼                      ▼                      ▼
           ┌──────────────────────┐┌──────────────────────┐┌──────────────────────┐
           │   :feature:settings  ││     :feature:otp     ││   :feature:shake     │
           │   :feature:apps      ││ :feature:notification││   :feature:message   │
           └──────────┬───────────┘└──────────┬───────────┘└──────────┬───────────┘
                      │                       │                       │
                      └──────────────────────┼───────────────────────┘
                                             ▼
           ┌──────────────────────────────────────────────────────────────────────┐
           │ :core:gesture       :core:ocr          :core:translate  :core:autofill│
           │ :core:overlay-layout:core:native-engine:core:monitoring :core:common │
           └──────────────────────────────────┬───────────────────────────────────┘
                                             ▼
                                  ┌───────────────────────┐
                                  │   :vendor:ppocr-sdk   │
                                  └───────────────────────┘

1. Service Coordination & Overlay Rendering: SlideIndexAccessibilityService intercepts global gestures and dispatches system events, while overlays are managed by OverlayLayout and independent WindowManagers.
2. Dynamic Engine Loading: OCR, translation, and segmentation engines support both Full and Lite packaging modes; native .so libraries and models can be extracted at runtime.
3. Privileged Pipelines: Shizuku IPC (rootless privilege), Root fallback executor (LibSu), and LSPosed module collaborate to provide seamless background clipboard monitoring and process lifecycle control.

📂 Project Structure

.
├── app/                                 # Host Application: DI assembly, JNI C++ bridge, and main UI
│   └── src/main/
│       ├── cpp/                         # C++17 JNI Sources (CppJieba bridge)
│       └── java/com/slideindex/app/
│           ├── activity/                # Top-level Activities & transparent interaction layers
│           ├── backtap/                 # Back-tap gestures
│           ├── clipboard/               # Clipboard history & Shizuku background monitor
│           ├── gesture/                 # Core gesture service & overlay trigger bars
│           ├── overlay/                 # System overlay window managers
│           ├── search/                  # Text & reverse image search aggregator
│           ├── shell/                   # Shell command executor
│           ├── ui/                      # Compose UI, Miuix themes, and dynamic colors
│           └── xposed/                  # LSPosed module entry & hooks
├── core/                                # Core modules & engines
│   ├── autofill/                        # OTP autofill framework
│   ├── common/                          # Extensions, shared models, and utilities
│   ├── gesture/                         # Gesture recognition algorithms & event bus
│   ├── monitoring/                      # Performance tracing & memory monitoring
│   ├── native-engine/                   # Offline native engine distribution & asset extraction
│   ├── notification/                    # Notification interception & processing
│   ├── ocr/                             # Multi-engine OCR dispatcher (ML Kit / Tesseract / ONNX)
│   ├── overlay-layout/                  # Overlay layout rendering core
│   └── translate/                       # Multi-language translation & language detection
├── feature/                             # Business feature modules
│   ├── apps/                            # App scanner, icon caching, and launchers
│   ├── message/                         # Heads-up notification & danmaku rendering
│   ├── notification/                    # Notification history & archiving
│   ├── otp/                             # Verification code extraction & statistics
│   ├── settings/                        # Settings, preferences backup, and DataStore
│   └── shake/                           # Sensor shake & desk-flip algorithms
├── vendor/
│   └── ppocr-sdk/                       # PaddleOCR SDK binding & ONNX Runtime
├── gradle/libs.versions.toml             # Dependency catalog
└── RELEASE_NOTES.md                     # Release changelog

🚀 Building & Compilation

Requirements

• JDK 25
• Android Studio (Ladybug or newer recommended)
• Android SDK (API 37 compileSdk) & NDK 28+

Build Commands

# Clone the repository
git clone https://github.com/qpst4/XGesture.git
cd XGesture

# Build Full Debug APK (with built-in offline engines)
./gradlew assembleFullDebug

# Build Lite Release APK (compact version)
./gradlew assembleLiteRelease

🌍 Help Translate

Contribute in-app UI translations on Weblate — no Git required. See CONTRIBUTING.md.

💬 Community & Feedback

Welcome to join the community discussions and provide feedback or feature requests:

💖 Sponsor & Support

If you find XGesture helpful in your daily workflow, consider buying the developer a cup of coffee ☕! Your generous support is the greatest motivation for ongoing development and OEM adaptations.

📜 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPLv3).

🤝 Acknowledgements

Special thanks to the following open-source projects for their architecture, inspiration, and code references (see THIRD_PARTY_NOTICES.md for details):

• SideGesture — Edge gesture and overlay architecture reference
• EdgeGesture — Expand panel, alarm reminder, screen translation, universal copy, and back-tap gesture reference
• EdgeX & FanFreeform — Honeycomb launcher and App Freezer architecture reference
• ClipboardListener & ClipShare — Android 10+ background clipboard listening architecture
• Root Activity Launcher — Non-exported activity launching scheme
• Circle To Search — Multi-engine reverse image search strategy
• Nova Text — Floating ball OCR and word selection interaction
• XposedSmsCode — OTP SMS Hook and verification code extraction rules
• Miuix — Elegant Material & Miuix style Compose UI component library

📝 Changelog

For complete release history, see RELEASE_NOTES.md and CHANGELOG.md.

新增

• 智能截图手势：新增 SMART_SCREENSHOT 动作，支持选区裁剪与矩形 / 椭圆 / 1:1 形状切换；顶部提供内置图片编辑器（画笔标注、撤销），底部提供保存相册、复制、分享、原位 1:1 钉图与取词 OCR
• 截图防残影：触发时静默压制全部浮层并隐藏手势动画指示器
• 边角轮盘编辑按钮开关：新增「显示快捷编辑按钮」，关闭后隐藏轮盘外侧的编辑入口
• 圆环启动器设置页：扩展页新增「圆环启动器」入口，按横 / 竖轴分别配置圈数、半径、工具栏与图标形状，支持两轴外观 / 槽位联动，并可直接调起悬浮窗就地编辑
• 圆环启动器工具栏开关：新增「显示操作工具栏」，关闭后隐藏收起 / 移动 / 编辑 / 设置 / 输入法按钮

变更

• 自由窗口适配：自由窗口 3 更名为「HarmonyOS / MagicOS」并补下发启动 stackId；OriginOS 新增分享代理启动通道；标准模式在小米设备上按 0.7（竖屏）/ 0.555（横屏）补偿启动边界
• 屏幕翻译标注为实验性：标题追加 (experimental)，描述补充需先安装翻译引擎与语言模型（四语言同步）
• 单击 / 双击不提供触发模式：这两类固定为松手触发，槽位页移除「触发模式」行，触钮列表不再显示模式标签

修复

• 双击在「即时触发」下失效：IMMEDIATE 分支在抬手时提前返回，早于双击判定；单击穿透亦被静默丢弃。现单击 / 双击固定走松手触发，不读槽位模式与侧边默认，滑动与长按行为不变
• 快捷启动器误建文件夹：拖拽合并悬停时长 350ms → 900ms，抽为共享常量 QuickLauncherDragTiming.FOLDER_MERGE_DWELL_MS
• 智能截图复制与分享失败：修正 FileProvider 路径（新增 screenshot_cache）与 Intent 授权