An app that enables persistent legacy ADB (port 5555) from within a device without user input.
Important
V2 uses raw code and libraries instead of binaries blobs
- This allows everything to be open source / transparent / auditable and easily compiled as well as give more fine grained control over the process
V2 would not be possible without some help from others:
- MuntashirAkon LibADB Android <-- This is a very useful library including its dependencies and other repos by MuntashirAkon
- tvQuickActions Pro by tvDev <-- tvDev kindly gave me a hint on how to do on-device pairing
tvQuickActions is an awesome app and you should check it out (I am not affiliated in any way)
Please Note:
I am in no way an Android developer and I pieced this together with ideas from other peoples hard work so please don't be upset at any of the code, it works for me and I am sharing it to hopefully help others, If you can improve it please do so.
Also feel free to add any suggestions for improvements.
All apks can be found under releases: https://github.com/nozza87/Auto_ADB/releases
Otherwise you can compile yourself from source
if at any point you get errors, re-read this and try again or reboot your device and start again from step 1.
If it still doesn't work then open an issue here with as many details and any error messages or logs.
-
On your Android device go to 'Settings -> Developer options' and enable both 'Wireless debugging' and 'USB Debugging'. (if they exist)
(select [Always Allow] if prompted on your device)
-
On your Android device open "Auto ADB" and make sure both 'USB Debugging' and 'Wireless Debugging' toggles are on.
Check the toggle states (this will confirm everything is working)
-
On your Android device in 'Auto ADB' press '[ENABLE LEGACY ADB]'
-
On your Android device go to 'Settings -> Accessibility -> Auto ADB Pairing Code Reader -> Enable'
(select [OK] if prompted on your device)
-
On your Android device go back to 'Auto ADB' press '[ENABLE LEGACY ADB] again'
-
On your Android device go to 'Settings -> Developer options -> Wireless debugging -> Pair device with pairing code'
(select [Always Allow] if prompted on your device)
-
On your Android device once you see "Pairing code found" go back to 'Auto ADB' press '[ENABLE LEGACY ADB] again'
(You can check you are paired under 'Settings -> Developer options -> Wireless debugging -> PAIRED DEVICES' you should see "nozza87@Auto-ADB")
-
On your Android device while still in 'Auto ADB' check the info window for current adb connections (you should be connected to both wireless & legacy adb)
-
{Optional} If you device support USB debugging then on your Android device in 'Auto ADB' press (or via developer settings) 'disable "Wireless Debugging" once legacy is enabled'
(Wireless debugging is no longer needed)
-
If everything is ok up until this point then you can enable "Start 'Auto ADB' on system boot" & "[ENABLE LEGACY ADB] when opening the app"
These aren't required if you are happy to open the app and manually run '[ENABLE LEGACY ADB]' to re-enable legacy ADB (port 5555) after a reboot.
- All going well your device should now have legacy ADB running on port 5555 and should automatically re-enable it after a reboot
You should never need to repeat these steps unless pairing or wireless debugging on your network is revoked
- Profit?
-
Since the ADB TLS port is random each time, mDNS discovery is used in order to detect it within the app, if your network blocks this, this tool won't work.
-
The 'legacy' mode, which allows unauthorized connections with an on-device prompt, needs to be paired to set up for the first time, so that the embedded ADB client can be allowed to enable the mode by itself in the future.
-
ADB Device Fingerprint: 81:66:b5:ee:c8:b3:30:7f:2f:eb:a0:02:67:c1:4f:72 - nozza87@Auto-ADB
-
This app was designed and tested for Android TV but should work on other devices.
-
The text on the left side of the app will change colour to signal its state:
🟩 - Green means this permission / option is in the right state
🟨 - Yellow means this permission / option is the wrong state but isn't required
🟥 - Red means this permission / option is in thw wrong state
sequenceDiagram
participant ADB as Auto ADB<br>App
participant AD as Android<br>Device
participant LD as Legacy<br>Device
LD --x AD: Legacy Device cannot connect
Note over AD: Manually Enable ADB<br>(both usb & wireless)
Note over AD: Accept System Popup(s) if any (Always Allow)
AD ->> ADB: Open "Auto ADB"
ADB ->> AD: Press [ENABLE LEGACY ADB]
Note over AD: 'Settings -> Accessibility -> Auto ADB Pairing Code Reader -> Enable'
Note over AD: Select [OK] if prompted
AD ->> ADB: Go back to "Auto ADB"
ADB ->> AD: Press [ENABLE LEGACY ADB]
Note over AD: 'Settings -> Developer options -> Wireless debugging -> Pair device with pairing code'
Note over AD: Accept System Popup(s) if any (Always Allow)
AD ->> AD: Wait for "Pairing code found" toast
Note over AD: Check Auto ADB is paired<br>'Settings -> Developer options -> Wireless debugging -> PAIRED DEVICES'<br>you should see "nozza87@Auto-ADB"
AD ->> ADB: Go back to "Auto ADB"
Note over ADB: Check the info window for current adb connections<br>(you should be connected to both wireless & legacy adb)<br>Legacy adb was auto enabled after pairing
Note over ADB: All permissions should now be green as they were also auto enabled afer pairing
LD ->> AD: Connect devices via legacy ADB
Note over AD: Accept System Popup(s) if any
opt Disable Wireless Debugging
Note over ADB: If you device supports USB debugging then select<br>'disable "Wireless Debugging" once legacy is enabled'<br>(Wireless debugging is no longer needed)
Note over ADB: If everything is ok up until this point then you can enable<br>"Start 'Auto ADB' on system boot" &<br>"[ENABLE LEGACY ADB] when opening the app"<br>These aren't required if you are happy to open the app and manually run<br>'[ENABLE LEGACY ADB]' to re-enable legacy ADB (port 5555) after a reboot.
ADB ->> AD: Close Auto ADB
end
loop : Repeat from here once initial config complete after reboot
AD ->> ADB: "Auto ADB" will run on boot if enabled<br>otherwise open "Auto ADB"
ADB ->> AD: [ENABLE LEGACY ADB] will be pressed automatically if enabled<br>otherwise Press [ENABLE LEGACY ADB]
Note over AD: Accept System Popup(s) if any<br>(shouldn't be)
LD ->> AD: Connect devices via legacy ADB
Note over AD: Accept System Popup(s) if any
end