Skip to content

Repository files navigation

ZaimDroid

Security Tool Authorized Testing Platform

ZAIM TECH // ANDROID SECURITY LAB

ZaimDroid is a Windows command-line utility for Android security testing, mobile awareness demonstrations, and authorized device administration through ADB and scrcpy.

It helps students, developers, and security testers inspect their own Android devices, understand debugging exposure, and document controlled security-lab exercises.

Rules Of Engagement

Only use ZaimDroid in a legal, controlled environment:

  • Test devices you own or have written permission to assess.
  • Get consent before mirroring screens, opening cameras, recording, or running commands.
  • Use a private lab network for wireless debugging.
  • Do not use the tool to access, monitor, record, or control another person's device.
  • Remove test recordings and sensitive device data after an exercise.

You are responsible for following all applicable laws, policies, and organizational rules.

Security And Awareness Uses

ZaimDroid can support safe demonstrations and defensive work such as:

  • Showing why USB debugging should be disabled when it is not needed.
  • Demonstrating the difference between an authorized and unauthorized ADB state.
  • Inspecting device properties and installed packages on a test phone.
  • Reviewing the risks of wireless debugging on an untrusted network.
  • Recording a consented test scenario for training or incident documentation.
  • Practicing mobile-device assessment workflows in a personal lab.

ZaimDroid is not an exploit framework, credential-stealing tool, or permission-bypass utility.

Capabilities

  • Connect to an Android device over USB.
  • Connect to an authorized device using its serial number.
  • Connect over a TCP/IP address.
  • Mirror and control the device with scrcpy.
  • Test the front or back camera.
  • Record the screen or camera output to output.mp4.
  • Record camera video with microphone input when supported by the device.
  • List installed Android packages.
  • Display Android device properties.
  • Send authorized ADB shell commands.
  • Disconnect ADB connections.

Requirements

  • Windows 10 or newer.
  • The built ZaimDroid Windows executable.
  • An Android device with USB debugging enabled.

The executable already contains the required application files. You do not need to install Python, ADB, scrcpy, or separate DLL files.

Installation

Download for Windows

  1. Download the ZaimDroid Windows executable.
  2. Place it in a folder of your choice.
  3. Connect your authorized Android device and unlock it.
  4. Run the executable.
  5. Accept the USB debugging authorization prompt on the device.

The main menu contains these options:

Option Action
1 Connect to a device by serial number, IP address, or USB
2 Open camera and recording options
3 Disconnect ADB connections
4 Display device information
5 List installed apps/packages
6 Send a command through adb shell
7 Exit the program

USB Connection

  1. Enable Developer options and USB debugging on the Android device.
  2. Connect the device with a USB cable.
  3. Run the ZaimDroid .exe file.
  4. Choose 1, then choose 3. Connect via USB.

If the device is not shown, restart ZaimDroid, reconnect the device, and make sure the device is authorized.

Wireless Connection

Use wireless debugging only on a network you trust and only for devices you are authorized to manage.

  1. Enable wireless debugging on the Android device.
  2. Find the device IP address and ADB port.
  3. Start ZaimDroid and choose 1, then 2. By IP address.
  4. Enter an address such as 192.168.1.100:5555.

The device and computer must normally be connected to the same network. If Android displays a pairing code or pairing port, complete that pairing using the Android platform-tools workflow first.

Wireless Menu Options

  • By IP address: enter the complete address in the format device-ip:5555, for example 192.168.1.100:5555.
  • Enable wireless connection: connect by USB first, choose this option, then disconnect the USB cable and run adb connect <device-ip>:5555 from an authorized terminal.

Camera and Recording

Choose 2. Access camera from the main menu. Available actions include:

  • Front camera.
  • Back camera.
  • Front or back camera recording.
  • Camera with microphone input.
  • Screen recording.

Recordings are written to output.mp4 in the current working directory. A later recording can replace an earlier file with the same name, so rename recordings you want to keep.

Camera and microphone options depend on the Android version, device permissions, and the bundled scrcpy version.

Authorized Security Checks

The command menu sends input through adb shell. Examples for your own test device:

getprop ro.product.model
wm size
df -h
pm list packages

These read-only examples are suitable for a personal test device:

getprop ro.product.model
getprop ro.build.version.release
settings get global adb_enabled
wm size
df -h
pm list packages

Review the output as test evidence, and avoid commands that delete data, change security settings, install unknown software, or modify a device unless you fully understand their effect and have permission.

Safe Testing Workflow

  1. Define the device, purpose, and test window.
  2. Confirm written authorization and user consent.
  3. Prefer USB debugging on a private test setup.
  4. Record only the evidence needed for the exercise.
  5. Disconnect the device and disable debugging when finished.
  6. Delete sensitive recordings and document the findings.

Troubleshooting

Required files cannot be found

Download the complete ZaimDroid Windows release again. The ADB and scrcpy files are bundled with the executable package.

Device is unauthorized

Unlock the device, accept the USB debugging prompt, then run the connection option again.

No device is listed

Try another USB cable or port, confirm USB debugging is enabled, and restart ZaimDroid.

scrcpy does not start

Download the complete ZaimDroid Windows release again and check that the connected device is authorized.

Camera or microphone fails

The device may not expose the requested camera/audio source to scrcpy. Check Android permissions and verify that the bundled scrcpy version supports the selected feature.

Support The Project

If ZaimDroid is useful to you, please star the repository and share it with others.

Made with love by Zaim Sheali.

License

No license has been specified yet. Add a license before distributing ZaimDroid publicly.

About

ZaimDroid is a Windows command-line utility for Android security testing, mobile awareness demonstrations, and authorized device administration through ADB and scrcpy.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages