Skip to main content

Utils

Please read the Material Usage Rules on this site.

This action offers a collection of different functions that will come in handy when working on your project.

How do you add utilities to your project?​

Right-click → Add Action → Android → Utils

Add utility

Available utilities​

Console command (ADB Shell)​

ADB shell

This action isn't a literal ADB command.

Think of it more like a console or terminal for the emulator. You enter all commands without 'ADB Shell' at the start.

This utility works a lot like the Terminal Emulator for Android app. Basically, it lets you run built-in Android console Linux commands.

There's a 10-second timeout for this action. If your command hasn't finished in that time, the action will end with an error (it'll exit via the red branch).

Example commands:

  • ls -la /sdcard/Download — lists all files and directories at /sdcard/Download.
  • pm list packages — lists all installed apps.
  • pm list packages -3 — lists only third-party apps.

Command example

Save the result to a variable​

Here you'll need to specify an existing variable or create a new one to store the result.

Sending/receiving files and folders​

This utility also lets you run commands for sending and receiving files to and from the device:

  • Send a folder: adb push "c:\MyFolder" /sdcard/.
  • Send a file: adb push "{-Project.Directory-}myFile.txt" /sdcard/myFileNewName.txt.
  • Get a folder: adb pull /sdcard/myFolder c:\Users\Public.
  • Get a file: adb pull /sdcard/myFile.txt "{-Project.Directory-}myFileNewName.txt".
The first path in your command is where you're copying from, the second is where you're copying to.

Set Geo-location​

This utility lets you spoof the device's location.

Geolocation

Available options:​

  • Latitude. Allowed values: -90 to 90.
  • Longitude. Allowed values: -180 to 180. You can use decimals, either with a period [.] or comma [,] as the separator. For example, New York's latitude and longitude: 40.7143 and -74.006

WiFi Settings​

WiFi

This action lets you change the WiFi network name (SSID) the emulator is "connected" to.

Reset Google Advert ID​

Advert

This utility resets the device's advertising identifier.

Get structure of elements (XML)​

XML

Lets you get the on-screen element structure as an XML string. It's the same info as you see in the
Element Tree Window, just as a single XML string. You can then process this with the JSON and XML Handling action.

Some useful attributes you can get from an element:​

  • position and size (the bounds attribute),
  • displayed text (the text attribute),
  • whether the element is visible (displayed attribute).

Scaling​

This action lets you scale: Zoom Out (shrink) or Zoom In (enlarge).

Pinch/Zoom

Available options:​

  • Coordinates. The point relative to which the scaling will happen.
  • Factor. How much you want to zoom in/out.

Send SMS to the device​

This utility fakes sending an SMS to the device.

SMS

Available options:​

  • Phone. Sender's phone number.
  • Message. The message text you want to send.
There needs to be a messaging app installed on the device.

For example, Google Messages, LineageOS Messaging, or any other.

Get ADB connection setting​

Connection Info

This action lets you get the address and port of the connected device. Useful if you need to run specific ADB commands: adb -s serial mdns services

Get device clipboard​

Get Clipboard

Lets you save the device's clipboard contents to a variable.

Set clipboard on device​

Lets you set the clipboard contents on the device.

Set Clipboard

Then, using the Keyboard Emulation action, you can paste the clipboard into any field with the {AndroidKeys.PASTE} macro.

Execute SQLite3 Query​

This action lets you run a SQL query on the device database. The first time you run it, all the necessary files will be automatically installed on your device depending on its architecture.

SQL Query

Available options:​

  • Database path. The full path to the file. For example: /data/data/com.android.providers.contacts/databases/contacts2.db.
  • Query. The SQL query, like SELECT * FROM contacts.
  • JSON-formatted response. If you enable this, the query result will come back as JSON (which you can read using the JSON and XML Handling action). Otherwise, you'll get an array of strings separated by a pipe (|) character.

Execute Frida script​

A utility for running a Frida script. On the first launch, all required files will be installed on your device automatically, depending on architecture. Then, the Frida server will start.

Frida Script

Available options:​

  • App name. The app you want to inject the script into.
  • Script. The script's contents. Macros are supported.