Giter VIP home page Giter VIP logo

adb-remote-control's Introduction

ADB Remote Control

ADB Remote Control allows you to control your adb-connected device from your PC. It enables clicks and drags with the mouse and normal keyboard inputs.

To show the image of the phone's screen, a screenshot is taken regularly. The rate can be configured (see Config).

This project was inspired by adbcontrol and Adb-Remote-Screen, none of which were easy enough for me to adapt to my needs. It was completely written from scratch.

How to Run

Download the latest release jar.

From the command line run java -jar adb-remote-control.jar

Compiling

Go into the src/ directory and execute javac de/oberien/adbremotecontrol/Main.java. To build the .jar file, after compiling, execute jar -cvfe adb-remote-control.jar de.oberien.adbremotecontrol.Main **/*.class. Depending on your shell, you might need to set the correct glob options.

Functionality

Mouse:

  • Left mouse button click for tapping on android
  • Left mouse button drag for swiping on android
  • Right mouse button click for long-tap on android
  • Right mouse button drag for draganddrop on android

Keyboard:

  • All ASCII characters from (including) 32 to (excluding) 127 are sent as text. These are all printable ascii characters including lowercase, uppercase, numbers and normal special chars.
  • Return (Enter) is sent.
  • Pressing Esc emulates a Back key event.
  • Pressing Insert emulates the android Home key.
  • Pressing Menu emulates a Power key press.
  • The following keys work as expected during text input:
    • Backspace and Del
    • Up, Down, Left and Right
    • Home/Pos1 and End
    • Page Up and Page Down
  • Ctrl+d emulates 500 Backspace presses and can be used to quickly erase a large text.
  • Ctrl+v pastes the clipboard as text.

Config

If needed you can create a config file called config.properties. The format of the file is imageFormat=png.
Currently the following keys are supported:

  • adbPath: The path to the adb binary. Defaults to just calling adb without a path.
  • timeout: The time between having received a screenshot and taking the next one in ms. Defaults to 1 ms.
  • imageFormat: png or jpg. JPG ist faster, but might be of worse quality. Defaults to jpg.

Building

To manually build and run this project, go into the src directory and execute

javac de/oberien/adbremotecontrol/Main.java
java de.oberien.adbremotecontrol.Main 

Troubleshooting

Signal

In Signal screenshots are disabled by default. This means that while having Signal open, the displayed image of the phone won't change. Follow this tutorial to enable screenshots and therefore make ADB Remote Control work with Signal.

License

Licensed under either of

at your option.

adb-remote-control's People

Contributors

einaram avatar micer avatar oberien avatar schlomo avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.