gitwtfhub

wtf is android-dex?

shrey113/android-dex — explained in plain English

Analysis updated 2026-08-13

1,237HTMLAudience · generalComplexity · 3/5Setup · moderate

TL;DR

A Flutter desktop app that mirrors an Android phone into a full desktop experience over USB or Wi-Fi, no root required.

Mindmap

mindmap
  root((Android DEX))
    What it does
      Desktop shell for Android
      App mirroring and control
      Audio and media streaming
    Tech stack
      Flutter
      ADB
      scrcpy
    Use cases
      Wireless desktop experience
      Multi-app view
      Media center controls
    Audience
      Android power users
      Desktop enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Mirror and control Android apps from a Windows, macOS, or Linux desktop over Wi-Fi or USB.

REASON 2

Run multiple Android apps side by side in a desktop-style interface without rooting the phone.

REASON 3

Stream phone audio and manage media playback from the desktop app.

What's in the stack?

FlutterJavaKotlinADBscrcpy

How it stacks up

shrey113/android-dexx4gking/3x-ui-upgradecclank/cell-architecture-studio
Stars1,2371,1431,332
LanguageHTMLHTMLHTML
Last pushed2026-06-17
MaintenanceMaintained
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencegeneralops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires enabling Developer Options and USB or Wireless Debugging on the Android device first.

Wtf does this do

Android DEX turns an Android phone into something resembling a desktop computer, letting a person mirror apps, control the phone, stream audio, manage media, and run multiple Android apps at once from a Windows, macOS, or Linux computer, connected either over USB or Wi-Fi. It works without rooting the phone and is powered by the screen mirroring tool scrcpy, paired with wireless ADB, Android's device debugging protocol. The project ships as a desktop app built with Flutter, alongside a companion project called ADB Device Manager that handles picking and connecting to devices. Downloads are provided as ready made packages for Windows, macOS, and Linux on the project's releases page. Under the hood, Android DEX is built from three parts that must each confirm readiness before the desktop interface unlocks. The desktop side app, written in Flutter, starts an ADB connection and two small local servers, then pushes a Java program to the phone and starts it as a logic engine. Once that engine responds that it is ready, the desktop app checks whether a companion Android app is installed, installs it if missing, and starts a background service on the phone that confirms readiness over a WebSocket connection. Only once both parts confirm readiness does the full desktop interface unlock, including extended notification and media handling. Setting it up needs a computer running Windows 10 or later, macOS 11 or later, or a modern Linux distribution, plus an Android phone running Android 8.0 or later. ADB is bundled with the app, so no separate driver install is needed. The steps are to enable developer options by tapping the build number several times in phone settings, turn on USB debugging, then either plug the phone in over USB or enable wireless debugging for Wi-Fi, and launch the app, which shows a boot progress bar before unlocking the desktop view. If the connection does not succeed automatically, a button appears during startup to open the device manager and pick a device manually without restarting. The project also includes separate documentation files covering its architecture, boot flow, reconnection handling, data model, error handling, and internal modules for anyone wanting more detail.

Yoink these prompts

Prompt 1
Walk me through setting up wireless ADB and connecting my Android phone to Android DEX.
Prompt 2
Explain the three-layer handshake Android DEX uses before the desktop UI unlocks.
Prompt 3
Help me troubleshoot a failed connection using Android DEX's Select Device screen.

Frequently asked questions

wtf is android-dex?

A Flutter desktop app that mirrors an Android phone into a full desktop experience over USB or Wi-Fi, no root required.

What language is android-dex written in?

Mainly HTML. The stack also includes Flutter, Java, Kotlin.

How hard is android-dex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is android-dex for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.