Monitor your Android device in real time, either from the terminal or through a web dashboard you can open on any device on your network.
This project has two parts. The first is MYADB, a terminal monitor built with Rich that shows your connected Android devices, their battery, storage, Android version, and boot mode, all live updating in your terminal. The second is ADB Dashboard, a web version of the same thing, where you spin up a local server and open the dashboard from any browser on any machine.
- Python 3.8 or higher
- ADB (Android Debug Bridge) installed somewhere on your machine
- A USB cable and USB debugging enabled on your phone
Python packages needed:
pip install rich fastapi uvicorn
The first time you run either MYADB or the dashboard server, it will ask you for the path to your adb.exe. Once you give it a valid path it saves it to a .adbpath file in the same folder, so you never have to enter it again.
If you already know your ADB path you can pass it as an argument:
python MYADB.py C:\platform-tools\adb.exe
Or just run it and follow the prompt:
python MYADB.py
Plug in your phone, make sure USB debugging is on, then run:
MYADB.exe
You will see a live updating table in your terminal showing every connected device with:
- Device serial number
- Connection status
- Battery level
- Android version
- Boot mode (System, Recovery, Fastboot)
- Storage used and free
Press Ctrl+C to stop.
The dashboard runs a local web server so you can see your phone's status from any browser on any device on the same network, or even over the internet if you use a tunnel.
Start the server:
python server.py
Then open a browser and go to:
http://localhost:8080
To open it from another device on your network, replace localhost with your PC's local IP address. For example:
http://192.168.1.50:8080
To find your local IP on Windows run ipconfig and look for IPv4 Address.
The dashboard refreshes automatically every 3 seconds. No need to reload the page.
If you want to reach your dashboard from outside your home network, the easiest way is ngrok.
Install ngrok from https://ngrok.com, then with the server already running open a second terminal and run:
ngrok http 8080
It will give you a public URL like https://abc123.ngrok.io that tunnels straight to your local server. Anyone with that link can see the dashboard.
ADBDashboard/
├── MYADB.py # terminal monitor
├── server.py # FastAPI web server
├── adb.py # all ADB data fetching logic
├── ADBHelpfuls.py # ADB path finding helpers
├── static/
│ ├── index.html # dashboard page
│ ├── style.css # dashboard styles
│ └── script.js # dashboard polling logic
└── .adbpath # saved ADB path (created on first run)
Go to Settings, then About Phone, and tap Build Number seven times to unlock Developer Options. Then go to Settings, Developer Options, and turn on USB Debugging. Connect your phone and accept the authorization prompt that appears on screen.
"No devices connected" shows on the dashboard
Make sure you accepted the USB debugging authorization popup on your phone after plugging it in. Run adb devices in your terminal to confirm the device shows up.
ADB path not found
Pass the path manually when running: MYADB C:\path\to\adb.exe
Dashboard not loading from another device Make sure your firewall is not blocking port 8080. On Windows you may need to add an inbound rule for it.
Storage shows N/A Some devices restrict access to storage info over ADB. This is a device level permission thing and not something that can be worked around without root.
GPL 3.0 (Will stay with me forever)