HIDWiggle - Android USB HID Mouse Jiggler

June 2, 2026 · View on GitHub

HIDWiggle - Android USB HID Mouse Jiggler

Open-source USB HID mouse jiggler for rooted Android devices with Linux ConfigFS support
HIDWiggle turns a supported Android device into a real USB mouse gadget and sends subtle pointer movement to keep a connected host awake. It includes configurable motion patterns, scheduling windows, USB identity settings, live diagnostics, and logs for controlled, local-first use.

Overview

Real USB HID mouse emulation:
- Uses Linux USB Gadget and ConfigFS to expose the Android device as a mouse to the connected host.
Human-like movement engine:
- Micro wiggle, random drift, square, figure-eight, and pulse patterns with configurable interval, amplitude, jitter, randomness, and human-like variation.
Practical scheduling:
- Time windows, auto-stop, and pause rules for screen-off, charging, and low-battery states.
USB identity controls:
- Configure VID/PID, manufacturer, product, serial number, and max power; includes a USB ID lookup database.
Diagnostics and logs:
- Root, UDC, ConfigFS, active gadget state, HID writer readiness, and native log streams for troubleshooting.

Note: HIDWiggle requires root and a physical Android device whose kernel supports USB gadget mode through ConfigFS. Emulators cannot validate USB HID behavior.

Features

Mouse Jiggler Dashboard
- Start and stop HID mouse movement from a focused control surface.
- See active state, root status, USB gadget readiness, and movement status at a glance.
- Keeps operation local: no accounts, no tracking, no ads.
Movement Modes
- Built-in patterns: micro, random drift, square, figure-eight, and pulse.
- Tune interval, amplitude, randomness, jitter, and human-like behavior.
- Preview movement behavior before running it against a host.
Scheduler
- Define allowed time windows by day and time.
- Optional auto-stop duration.
- Pause rules for screen off, charging, and low battery.
USB Gadget Identity
- Configure VID/PID and USB string descriptors.
- Set manufacturer, product, serial number, and max power.
- Search embedded usb.ids data to inspect vendor/product identifiers.
Test Mode
- Enable the mouse gadget without automatic movement.
- Send manual left/right/up/down movement, button clicks, and scroll reports.
- Useful for validating host enumeration and HID report delivery.
Diagnostics & Logs
- Inspect root availability, ConfigFS paths, UDC status, bound gadgets, and HID device nodes.
- Stream native backend logs from the Kotlin service layer.
- Copy diagnostics for issue reports or device compatibility notes.

Requirements

Rooted Android device with a working su implementation.
Linux USB Gadget and ConfigFS support in the device kernel.
A UDC exposed under /sys/class/udc.
ConfigFS mounted under /sys/kernel/config/usb_gadget or /config/usb_gadget.
HID gadget support that can create device nodes such as /dev/hidg*.
A physical USB data connection to the host. Charge-only cables will not work.

Installation

Download the latest APK from Releases:

Install the application:
- Enable installation from unknown sources if needed.
- Grant root when prompted by your root manager.
Launch and configure:
- Open HIDWiggle.
- Confirm root and USB gadget readiness on the dashboard.
- Review USB identity settings if the host requires specific descriptors.
- Use Test Mode first to validate that the host sees the Android device as a mouse.

Usage

Running the Mouse Jiggler

Connect the Android device to the target host with a data-capable USB cable.
Open HIDWiggle and verify that root and USB gadget support are available.
Pick a movement mode and adjust interval/amplitude as needed.
Start movement from the dashboard.
Stop movement from the app when finished, or use Panic Stop if the gadget needs a quick unbind.

Scheduling Movement

Open Scheduler.
Add or edit allowed time windows.
Configure auto-stop and pause rules.
Save the schedule and start the jiggler when the device is connected to the host.

Testing HID Reports

Open Test Mode.
Enable the mouse gadget.
Send directional movement, click, and scroll reports.
Check Logs and Diagnostics if the host does not respond.

Screenshots

Build and Run

Prerequisites:

Flutter stable toolchain
Android SDK configured for Flutter
A rooted physical Android device for runtime validation

Steps:

flutter pub get
flutter run

Release builds:

Configure a proper release signing setup before publishing.
The current Gradle release build uses debug signing for local convenience.

Troubleshooting

Root check fails:
- Verify Magisk/SU policy and grant root to HIDWiggle.
No UDC found:
- Confirm /sys/class/udc contains a controller and the device supports USB device mode.
Host does not see a mouse:
- Use a data cable, try another USB port, and validate descriptors in USB identity settings.
/dev/hidg* is missing:
- The kernel or ROM may not include the HID gadget function.
Gadget remains bound after a failure:
- Use Panic Stop, then reconnect USB if needed.

Security Notes

HIDWiggle changes how the Android device presents itself over USB while active.
Root access and ConfigFS writes can affect ADB, charging behavior, and other USB gadget functions.
Use it only on systems you own or are authorized to test.

App	What it does
IR Blaster	Control and test infrared functionality for compatible devices.
USBDevInfo	Inspect USB device details and behavior to understand what's connected.
GadgetFS	Manage rooted Android USB gadget roles with ConfigFS.
TapDucky	Run controlled DuckyScript HID workflows on supported rooted devices.
HIDWiggle	Keep a connected host awake with Android-powered USB HID mouse movement.
AKTune	Adaptive Android kernel auto-tuner for CPU/GPU/scheduler/memory/I/O.

HIDWiggle - Android USB HID Mouse Jiggler