AdbVortex lets you share your computer’s internet connection with any Android device connected via ADB, directly from IntelliJ IDEA or Android Studio.
It’s a simple and elegant proxy controller that creates an HTTP bridge between your desktop and your Android device — perfect for testing backend APIs, staging servers, or internal environments that aren’t publicly accessible.
- 🧩 One-click Start/Stop HTTP proxy for ADB-connected devices
- 🔍 Automatic device detection via
adb devices - ⚙️ Real-time connection logs inside the IDE Tool Window
- 🚀 Ideal for backend testing, QA, and debugging within restricted networks
| Item | Details |
|---|---|
| Default proxy | 127.0.0.1:8080 |
| Supported devices | Single device (stable). Multi-device support experimental. |
| Platform | IntelliJ Platform Plugin — works in IntelliJ IDEA & Android Studio |
| Icon | src/main/resources/icons/adbvortex_32.png (recommended 32×32 px) |
- The plugin starts a lightweight HTTP proxy on your computer (default port
8080). - It runs ADB commands to route traffic:
adb reverse tcp:<PORT> tcp:<PORT> adb shell settings put global http_proxy 127.0.0.1:<PORT>
- The device sends HTTP requests through your host machine, allowing apps on the device to access
localhostservices on your computer.
⚠️ For HTTPS traffic, use a proxy that supportsCONNECTor install a trusted certificate.
AdbVortex focuses on HTTP proxying for local development and testing.
- Download the
.zipfrom the Marketplace. - In Android Studio:
Settings → Plugins → Install Plugin from Disk. - Select the downloaded file and restart the IDE.
- Open this project in IntelliJ IDEA or Android Studio.
- Run the Gradle task Run Plugin (
runIde) to launch a sandbox IDE instance. - In the sandbox IDE, open the AdbVortex Tool Window:
- Pick a port (default
8080). - Click Start (ensure the device appears in
adb devices). - On the device, open an HTTP URL or test your app — traffic flows through your PC.
- Pick a port (default
- Click Stop to clear proxy settings and shut down the local proxy.
- Displays real-time logs and device connection status.
- The top toolbar can list connected devices — edit
AdbVortexToolWindowFactoryto customize. - If logs reach the top and overlap controls, enable auto-scroll or add padding/margins in the layout.
- Verify that the
adbbinary used by IntelliJ matches your system’sadb. - Restart ADB:
adb kill-server && adb start-server
- Reconnect the USB cable or confirm the debug authorization prompt on the device.
- Check firewall/antivirus rules.
- Confirm device proxy with:
adb shell settings get global http_proxy
- Some HTTPS apps with certificate pinning won’t work through a plain HTTP proxy.
AdbVortex/
├── build.gradle.kts
├── settings.gradle.kts
├── gradle.properties
├── LICENSE
├── src/main/resources/META-INF/plugin.xml
├── src/main/resources/icons/adbvortex.svg
└── src/main/kotlin/com/pensa/adbvortex/...
MIT License
© 2025 Carlos Javier Torres Pensa — pensa.com.ar
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The Software is provided “as is”, without warranty of any kind, express or implied,
including but not limited to the warranties of merchantability, fitness for a
particular purpose, and noninfringement.
If you find AdbVortex useful and want to support its development, you can:
Your support helps keep the vortex spinning 🌪️ — thank you!
🌀 AdbVortex — by Carlos Javier Torres Pensa
Bridging Android and Desktop worlds, one proxy at a time.