Skip to content

Python client to build scripts made of adb commands through a simple interface

License

Notifications You must be signed in to change notification settings

Alexs784/android-simple-adb

Repository files navigation

Android simple adb

Description

This is a Python desktop application that allows creating scripts of adb commands.

What is a script in this case? A database object with a group of commands chosen by the user.

How to use

The app will try to auto-detect if the Android SDK is installed in the default directory. If it does not find it, the first screen will ask to add the Android SDK location (both full user path and abbreviate one (~) are supported). Screenshot 2021-03-21 at 21 13 50

After that, we get to the home screen: here we can both view saved scripts or create one.

Opening a script (both creating or opening an existing one) will show the current steps (adb commands) added to it and give you a few options:

  • Run the script on the currently selected device (devices shown are the ones currently connected to the machine)
  • Save the script (choose a name)
  • Duplicate the script (including its steps)
  • Add steps to the scripts (enabled once you choose a device from the relative menu)
  • Drag and drop steps added to a script to change the order of execution
  • View and delete a step of the script
Screenshot 2024-01-03 at 19 07 21

Clicking on "Add step" will open a list of available steps that can be added to the script: Screenshot 2021-03-21 at 21 22 34

Choosing a step may or may not ask extra parameters (depending on if the step requires them). After choosing the desired one(s) and adding them, going back we will have an overview of what steps we did add Screenshot 2021-06-13 at 23 31 45

From here we can run the script (once we selected a connected device), save it, add more steps, reorder them or delete existing ones. We can also run the script on a different device by changing the target one.

Clicking on a step added to a script will show the adb commmand that that step executes and offers the option to delete the step from the current script: Screenshot 2021-03-28 at 20 05 56

Currently supported (tested) platforms:

  • MacOS Big Sur
  • MacOS Sonoma

What's next

  • Test Windows support
  • Test Linux support
  • Improve step's parameter input UI by adding parameter descriptions
  • Option to see each step's adb command(s)
  • Option to delete a step from a script
  • Option to delete a script
  • Option to duplicate a script
  • Option to search adb commands
  • Support more adb commands
  • Auto-detect Android SDK

About

Python client to build scripts made of adb commands through a simple interface

Resources

License

Stars

Watchers

Forks

Packages

No packages published