Skip to content

Commit

Permalink
v1.2.10
Browse files Browse the repository at this point in the history
- Two new commands
- Now allows the user to take a screenshot of the current Android screen remotely
- Also creates a Logcat log file for real-time analysis
- Minor improvements to the GUI (actually works now, but still not 100% yet)
  • Loading branch information
Hifumi1337 committed Sep 23, 2022
1 parent d4511cf commit 988eba4
Show file tree
Hide file tree
Showing 3 changed files with 239 additions and 194 deletions.
18 changes: 12 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
# Droid
Droid is a remote communications script created to communicate with Android devices on the local network over the Android debug bridge (adb)

NOTE: Script does require Android debug bridge (adb) to be installed before

First release is now available! Versions for Linux and macOS are currently available.
NOTE: Script does require Android debug bridge (adb) to be installed on the system.

## Usage
```bash
./droid -ip 127.0.0.1
./droid -ip 127.0.0.1 -c
```

## Options
Expand All @@ -27,7 +25,10 @@ First release is now available! Versions for Linux and macOS are currently avail
-rmf, --rmfile | Remove a file from the Android device (set the absolute path using -loc)
-bl, --bluetooth | Start or stop bluetooth service for the Android device
-w, --wifi | Start or stop wifi service for the Android device
-g, --gui | A graphical user interface built to communicate an Android device (WIP) (data does not auto-populate)
-o, --output | Name of the output file when taking a screenshot (omit the extension)
-s, --screenshot | Take a screenshot of the current Android screen
-l, --log | Outputs Logcat logs in real time to a set file
-g, --gui | A graphical user interface built to communicate with an Android device (WIP) (data does not auto-populate)
```

I would recommend running this command before doing anything else to confirm you can successfully connect to the Android device on your network
Expand Down Expand Up @@ -60,4 +61,9 @@ You can `stop` the service by running this command (starting the service uses th
```bash
./droid -ip 127.0.0.1 -w=stop
```
NOTE: When turning the wifi off, if you are communicating with the Android device remotely, this will result in the device being disconnected and unusable until the network is re-established.
NOTE: When turning the wifi off, if you are communicating with the Android device remotely, this will result in the device being disconnected and unusable until the network is re-established.

This command will take a screenshot of the current Android screen while monitoring Logcat in real-time:
```bash
./droid -ip 127.0.0.1 -sl -o screenshot
```

0 comments on commit 988eba4

Please sign in to comment.