FORUMS
Remove All Ads from XDA

[APP][2.2+] Remote ADB Shell

485 posts
Thanks Meter: 428
 
By cgutman, Senior Member on 22nd July 2013, 03:15 AM
Post Reply Email Thread
Overview
Remote ADB Shell is a simple terminal app that allows you to connect to the ADB shell service of another Android device over the network. This works in the exact same way that the "adb shell" command works on a computer. Because this app uses a native implementation of the ADB protocol in Java, it does not require root on either device or any 3rd party apps on the target device. The devices simply speak the same protocol to each other that they would to a computer running the ADB client from the Android SDK.

Features
  • Command history (accessible by long pressing the command box)
  • Send Ctrl+C (accessible by long pressing the terminal view)
  • Auto-scroll (with toggle accessible by long pressing the terminal view)

Screenshots


Instructions
IMPORTANT: Android 4.2.2+ devices use RSA keys to authenticate the ADB connection. These devices will need to be plugged in to a computer the first time you connect to them (from each device with this app installed). This allows them to display the public key acceptance dialog, which you must accept (and check "Always allow from this computer").

To configure a stock un-rooted target, plug the target device into a computer and run "adb tcpip 5555". This will start ADB listening on port 5555 on the target device. The device can then be unplugged and will remain configured properly until reboot.

For devices that are rooted (although it's not required), you can install one of the several "ADB WiFi" apps to enable the ADB server to listen over the network. Devices with a custom ROM may have an option to enable ADB over the network in the Developer Options pane of Settings. Using either of these methods will properly configure ADB for network access with this app. The extra step for 4.2.2+ is still required for the initial connection.

To connect to your remote Android device, type in the IP address of the device and the port number (5555 from the example above) in Remote ADB Shell. Tap Connect and it will attempt to connect to the device and start up the terminal.

Notes
This app is unique because it runs a custom ADB implementation that I wrote from scratch in Java. I plan to open-source my ADB implementation on GitHub or Google Code once I give it a bit of cleanup and documentation. Using this custom ADB implementation means that I don't require an ADB binary or root on the device running the app. Because it speaks standard ADB, it doesn't require anything special on the target either.

Please post feature requests or suggestions here and I'll do my best to work on them.

Download
The app is available on Google Play for free. https://play.google.com/store/apps/d...remotedebugger
The Following 6 Users Say Thank You to cgutman For This Useful Post: [ View ] Gift cgutman Ad-Free
 
 
3rd October 2016, 09:33 PM |#2  
Account currently disabled
Thanks Meter: 37
 
More
Hi, cgutman - I actually have a feature request.

But first, let me say thank you for providing this featureset in an app I already have gotten a fair amount of use out of it.

Backstory:

I use adb shell commands to automate repetitive processes on a Fire TV (Android Settop Box, connected to a TV, runs apps), like launching certain apps, performing certain actions - and so on.

I actually have about 20 actions across multiple Applescript apps on the Mac that allow me to remote controll apps like Spotify or Pandora - and your app allows me to do that from an Android device (smartphone) as well.

That said - I run into two major speedbumps.

Without a "Bookmarks" feature (store a certain shell script, give it a name, be able to edit it, execute it on click), so far I can only effectively cycle through two scripts (using the "recent history" feature in your app) - and I'd like to be able to use 20+ scripts eventually. A bookmark list (sorted by name) would be great for my purpose.

Second - to really be able to speed up the use of those items a launcher shortcut feature would be great. It could look up and reference the bookmark entries from the suggestion above - or let you set an IP and enter a command in the shortcut dialogue (Terminal Emulator does it that way). Maybe even with an auto exit option (although "&& exit" works just as well right now (*yay*) - but people would have to know to use it). Also it should allow you to name the shortcut, before creating it.

The reason why this would be great is to reduce steps. Right now I have to open the app, connect to the remote Android device, longpress on the command line entry field, select a history item, press enter - press OK once the app has finished the script, then exit the app.

It would be great to be able to automate all of this down to one launcher shortcut click.

To give you an Idea - what I am using the app for currently - here is one of the scripts I wrote today:

Code:
monkey -p com.netease.cloudmusic 1 && sleep 5 && input tap 960 978 && sleep 0.8 && input keyevent 19 && input keyevent 19 && input keyevent 19 && sleep 0.3 && input keyevent 20 && input keyevent 20 && input keyevent 20 && sleep 0.3 && input tap 50 960 && sleep 0.8 && exit
This opens the netease app and starts the "daily recommended" playlist.

Code:
input tap 60 100 && sleep 0.8 && input tap 60 100 && sleep 0.8 && input tap 60 100 && sleep 0.8 && input tap 1444 1030 && sleep 0.8 && exit
This exits the app cleanly - and so on...

Again - I've set up dozens of scripts like that on my Mac to be able to navigate Pandora, and spotify - to pull files, make screenshots, and so on and so forth. If you could implement said features (again - Terminal Emulator has them.. ) - your app would allow me to realize the same functionality on my smartphone.

Thank you for reading through my posting and contemplating the idea -

so long

h.

edit: Also thank you for already exiting the session cleanly (adb disconnect) once you type in exit. The Fire TV only allows one adb session at a time, so this is great.
4th October 2016, 04:09 AM |#3  
Account currently disabled
Thanks Meter: 37
 
More
Found a way to make the app a little more usable "as is" for my purposes in the meantime. Part of my problem was, that the shell scripts turned out quite complex - so I couldnt run several of them - because they weren't instantly recognizable on the run history level.

The temporary workaround for me was to move the commands as shell scripts to a folder (I named "shell") in /system on the target device and make them executable. That way the history in Remote ADB Shell stays cleaner and is better parseable by humans.

This is what it looks like now:

http://i.imgur.com/AuGFZ0a.png
4th October 2016, 05:56 AM |#4  
Junior Member
Thanks Meter: 0
 
More
Just right. Thank you.
1st February 2017, 05:36 PM |#5  
Love this app! However I would like to ask if it were possible to send adb commands from outside the app using apps like Tasker. This could already simply be done by sending your app and intent with the ip, port and command.
The Following User Says Thank You to Humpie For This Useful Post: [ View ] Gift Humpie Ad-Free
23rd February 2017, 05:46 PM |#6  
I just created a Tasker Plugin myself using the AdbLib library! Have a look if you like https://play.google.com/store/apps/d...=com.ADBPlugin
The Following User Says Thank You to Humpie For This Useful Post: [ View ] Gift Humpie Ad-Free
8th October 2017, 03:10 PM |#7  
m4f1050's Avatar
Senior Member
Thanks Meter: 201
 
More
Trying to connect to my phone but I am not getting device authorization messages.
16th September 2018, 07:35 AM |#8  
Junior Member
Thanks Meter: 0
 
More
Great application, thank you.
My task:
- - the device has no Root
- in the directory / tmp there is a binary file su and SuperSU.apк for this device
- How to launch an "adb root shell tcpip:5555" using your application on the this device?
may be:?
1) adb tcpip:5555
2) adb root
3) adb tcpip:5555
4) adb remount
5) "adb shell"
6) or without "adb shell" -> adb pull ... adb pushh... adb reboot...
This is possible?
Or is this impossible in principle?
Post Reply Subscribe to Thread

Tags
adb, app, network, shell, terminal

Guest Quick Reply (no urls or BBcode)
Message:
Previous Thread Next Thread
Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes