Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Alexs784 authored Jan 3, 2024
1 parent 8cfadda commit 86ead99
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,36 +2,36 @@

## Description

This is a simple python desktop application that allows creating _scripts_ of `adb` commands.
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 first screen is the following one, where you need to add your Android SDK location (both full user path and abbreviate one (`~`) are supported).
**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).
<img width="912" alt="Screenshot 2021-03-21 at 21 13 50" src="https://user-images.githubusercontent.com/4242258/111919566-fa09d380-8a8a-11eb-9025-f22794996acf.png">

After that you get to the home screen: here you can both view saved scripts or create one.
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 order of execution
- Drag and drop steps added to a script to change the order of execution
- View and delete a step of the script

<img width="912" alt="Screenshot 2021-06-13 at 23 20 07" src="https://user-images.githubusercontent.com/4242258/121822604-3f135f80-cca0-11eb-93af-1aa6e0988599.png">
<img width="912" alt="Screenshot 2024-01-03 at 19 07 21" src="https://github.com/Alexs784/android-simple-adb/assets/4242258/03644030-0b08-4985-a91d-70e372ec50f7">


Once you select a device and click on "Add step", you will be able to choose the desired step(s):
Clicking on "Add step" will open a list of available steps that can be added to the script:
<img width="912" alt="Screenshot 2021-03-21 at 21 22 34" src="https://user-images.githubusercontent.com/4242258/111919686-8fa56300-8a8b-11eb-851b-e17b179458fe.png">

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
<img width="912" alt="Screenshot 2021-06-13 at 23 31 45" src="https://user-images.githubusercontent.com/4242258/121822619-52bec600-cca0-11eb-9135-92abf258f191.png">


From here we can run the script, 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.
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:
<img width="912" alt="Screenshot 2021-03-28 at 20 05 56" src="https://user-images.githubusercontent.com/4242258/112762685-4318d500-9001-11eb-8fd8-eea5a18584a0.png">
Expand All @@ -53,4 +53,4 @@ Clicking on a step added to a script will show the adb commmand that that step e
- [x] Option to duplicate a script
- [ ] Option to search adb commands
- [ ] Support more adb commands
- [ ] Auto detect Android SDK
- [x] Auto-detect Android SDK

0 comments on commit 86ead99

Please sign in to comment.