Wireless Debugging Widget

Wireless Debugging Widget

Toggle Wireless Debugging (ADB over Wi-Fi) directly from your home screen with a single tap. No navigating through Developer options, no pulling down Quick Settings — just the switch you need, where you need it.

Built for Android developers who flash builds, run instrumentation tests, or connect to IDEs over the network throughout the day. Wireless Debugging Widget removes the repetitive friction of enabling and disabling ADB over Wi-Fi, turning a five-tap journey into one.

** How it works

The widget reads and writes Android's adb_wifi_enabled global setting. Once granted the required permission, tapping the switch flips Wireless Debugging instantly — the same effect as toggling it manually in Developer options, but without leaving the home screen.

Setup

Wireless Debugging Widget needs one-time setup because Android's Wireless Debugging flag is a protected system setting. Google restricts it to apps holding the WRITE_SECURE_SETTINGS permission, which cannot be granted through a standard install dialog — it has to be granted once from a computer via ADB.

The about screen inside the app walks you through the full setup:

1) Enable Developer options on your device.
2) Connect your device to a computer with ADB installed and run:

adb devices

3) Copy your device ID from the output, then run:

adb -s shell pm grant com.celestwatches.wirelessdebuggingwidget android.permission.WRITE_SECURE_SETTINGS

Replace with the ID from the previous step.

4) Add the widget to your home screen — one tap if your launcher supports it, or the standard long-press method.

Both commands are also displayed inside the app with one-tap copy buttons. Once set up, the widget works offline, with no accounts, no cloud sync, and no data collection.

If the widget doesn't respond to taps, re-run the grant command. Android scopes the WRITE_SECURE_SETTINGS permission to a specific install, so reinstalls, system updates, and backup restores can silently revoke it. Running the grant command again restores widget functionality immediately.

Note that the example commands work on stock Android and most mainstream devices, but some manufacturers (Xiaomi, Samsung, and others) layer additional restrictions on top of Android's permission system. If the command returns an error on your device, you may need to enable a secondary developer toggle or follow manufacturer-specific steps first — a quick search for your device model alongside "grant WRITE_SECURE_SETTINGS" will usually find the exact procedure.

Features

- One-tap toggle for Wireless Debugging from the home screen
- Material Design switch graphic that reflects the current state at a glance
- Automatic light and dark mode support — the widget adapts to your system theme
- Accessible: proper TalkBack integration with state announcements
- Compact 2×1 widget footprint that fits anywhere on your home screen
- Setup instructions and the required ADB command built into the app
- Graceful fallback to Developer options if the permission hasn't been granted

Requirements

- Android 11 (API 30) or higher — Wireless Debugging was introduced in Android 11
- A one-time ADB setup to grant the required system permission
- Developer options enabled on your device

Privacy

Wireless Debugging Widget does not collect, transmit, or store any personal data. The app has no user accounts, no analytics, no advertising, and no third-party SDKs. The only network activity is a periodic check (at most once per week) to populate the "More from CELEST" section inside the app — this fetches a list of other CELEST apps from celest-watches.com and caches the result locally.

About CELEST**

CELEST makes small, focused Android apps and Wear OS watch faces, with no subscriptions, no ads, and no tracking. Each product does one thing well — find us at celest-watches.com, or search for "CELEST" on Google Play.