Nudge adds configurable edge handles to Android. Use gestures to open volume controls, adjust brightness, run actions, or open custom button panels.

Download the latest release · User guide · Release history

This README describes the current source. Check each release's notes for the features included in its APK.

• 🚀 1. Quick start
• 📱 2. Demo
• ✨ 3. Features
• 🔒 4. Privacy
• 🛠️ 5. Development
• 📜 6. License
• 💬 7. Contact and support

1. Download and install the APK from GitHub Releases.
2. Open Nudge. Turn on Nudge accessibility on Home, then enable Nudge handles in Android settings.
3. Enable a handle in Handles, then turn on Enable Gestures on Home.
4. Swipe inward from the handle to open the native volume popup.

Nudge requires Android 12 or later. Brightness actions need Modify system settings access. Some sound actions need Do Not Disturb access.

HyperOS setup and native popup behavior vary by build. See setup and troubleshooting if Android blocks accessibility or opens the wrong panel.

TODO: Replace these descriptions with real screenshots or short recordings.

• Create independent handles on the left, right, or bottom edge.
• Adjust touch areas, visible handle size, color, opacity, position, and landscape placement.
• Assign Tap, Hold, Swipe and hold, and up to three successive swipe actions.
• Configure distances, direction, timing, and haptic feedback. Ordinary swipes and Swipe and hold have separate direction settings.
• Exclude selected apps, use optional full-screen soft hide, and allow use on the awake lock screen.

• Create reusable panels and open the same panel from several handles.
• Create hollow semicircular wheels in the Wheels tab, with up to six wedge buttons. Set both radii on one track, choose a highlight transition, or use Drag to pick. Wheels stay separate from panels.
• Choose fixed or scrollable layouts, vertical or horizontal direction, placement, animations, and outside-touch behavior.
• Add app shortcuts, volume and sound controls, brightness controls, Lock screen, Input Method, Screenshot, and native panel actions.
• Customize colors, opacity, button containers, built-in icons, and supported installed icon packs.
• Fit Wheel icons automatically, or choose their preferred size and position between the inner and outer edges.
• Set panel-wide active background and icon colors for supported toggle actions.
• Pause handles, hide their visible bars, or configure separate toggle and hide groups.

• Open Android's native volume popup and Nudge's custom brightness slider.
• Continue holding after a gesture to adjust volume or brightness with vertical movement.
• Set separate travel distances. Use an adjustable hold before swipe adjustment to prevent accidental changes.
• Use maximum, minimum, automatic, and stepped brightness actions, with configurable return brightness.
• Calibrate brightness manually or use optional automatic calibration when the native slider exposes a supported control.

• Preview placement with non-interactive guides. Save or cancel handle and panel edits.
• Drag slider thumbs to adjust settings. Track taps do not seek. Tap percentage and dp readouts to enter exact values.
• Pin configured actions to the Home screen through your launcher.
• Choose Adaptive, Transparent, or a custom background color for each panel button and Home shortcut. Home launchers can still add backgrounds to transparent shortcuts. Edit saved shortcuts without replacing their IDs.
• Use the Home accessibility switch or a Toggle accessibility shortcut to open setup or disable Nudge handles.
• Export and import JSON backups, including handles, panels, gesture bindings, and shortcut definitions.
• Check for updates when requested. Download an APK and review Android's installation prompt.

See the user guide for setup, gesture behavior, calibration, backups, and known limits.

• No account, ads, or analytics. Handles, panels, and controls work offline.
• Updates are requested by you. Update checks and APK downloads contact GitHub. Nudge does not upload settings or diagnostics.
• Settings stay in app storage. You choose where exported JSON backups are saved. Android may back up configuration through your system backup settings.
• Diagnostics remain local. Copied compatibility details can include app package names. Review them before sharing.
• No screen recording. The optional Screenshot action asks Android to capture and save an image. Nudge does not read that image. The normal handle service cannot inject touch gestures. The separate calibration service offers optional, disclosed presses on identified native brightness sliders to complete their releases.

The calibration service checks native control IDs and exact brightness labels. It does not read notification text, take screenshots, or record the screen. By default, it disables itself when a run ends or setup expires. You can keep it enabled and idle between runs, then disable it manually. It reads controls only during calibration. Profiles, recovery records, and both calibration service preferences are excluded from Android backup and JSON exports. See calibration and recovery.

• Git and Android Studio, or the Android command-line tools.
• Android SDK Platform 36 and Build Tools 36.0.0.
• JDK 17 or a newer version supported by Gradle 9.1. The existing local build uses JDK 24.
• The included Gradle wrapper. A separate Gradle installation is not required.

The project uses Kotlin, Jetpack Compose, Material 3, Coroutines, and DataStore. Dependency versions are in gradle/libs.versions.toml. The Android Gradle plugin's compatibility requirements cover the SDK, JDK, and Gradle versions.

git clone https://github.com/serogee/Nudge.git
cd Nudge
.\gradlew.bat :app:assembleDebug

Before building, set ANDROID_HOME to the SDK directory, or open the project in Android Studio to create local.properties. Set JAVA_HOME to your JDK when using the command line.

Open the project in Android Studio, sync Gradle, and run app on an Android 12+ device or emulator. The command-line APK is app/build/outputs/apk/debug/app-debug.apk.

Debug builds use com.modukey.app.debug; release builds use com.modukey.app. They install separately.

.\gradlew.bat :app:testDebugUnitTest :app:lintDebug :app:assembleDebug

On macOS or Linux, replace .\gradlew.bat with bash ./gradlew. Release scripts use PowerShell and Windows Android tools.

See development and releases for repository conventions, device checks, signing, and publication. Features under development belong in Unreleased; release notes are stored in docs.

Copyright (C) 2026 serogee and Nudge contributors.

Nudge is free software. You can redistribute it and modify it under the GNU General Public License, as published by the Free Software Foundation, either version 3 of the License or, at your option, any later version.

See LICENSE for the full terms. SPDX identifier: GPL-3.0-or-later.

Nudge is distributed without any warranty. Third-party components retain their own licenses and notices.

For bug reports, feature requests, or questions, open a GitHub issue.

For a device issue, include your Nudge version, phone model, Android version, MIUI or HyperOS build, navigation mode, and reproduction steps. Describe what you expected and what happened. You can copy compatibility details from Info; review them for private information before posting.