Home>Programming related>Other source code
Download

Header

What is its purpose?

? Control Android & iOS devices: Capture screen, manage apps, simulate input, examine system logs etc.

⚡️ Speed++ Are you an app developer or a tester? Boost your effectivity, discover new tools!

All features

? Control Android and iOS devices or Emulators/Simulators using terminal commands

? Take screeshots, change device settings, gather app & device information

Manage mobile applications - install, restart, wipe data and much more

? Handle multiple devices effortlessly - select from list or target all connected devices

⏳ Save your precious time - stop doing repetitive tasks manually

Automatic update - get new features and fixes ASAP

Table of contents

? Maybe you just want to skip to Installation?

? Android Commands

  • Capture screen
    • ? ascreenshot
    • ? arecord
  • Control device
    • ✏️ apaste
    • aurl
    • ? adarkmode
    • ? atalkback
    • ? abounds
    • ? aanimationspeed
    • ? afontscale
    • ? acontrol
    • ? acamera
    • ⚡️ awireless
    • apowerbutton
  • Manage packages
    • alaunch
    • aappinfo
    • ? akill
    • ? aerase
    • ? ainstall
    • ? auninstall
    • awipe
    • ? apermissionreset
    • ? agoogleplay
    • ? abuildproject
  • Manage device
    • aoptions
    • alog
    • ? acheckdevice
    • ? aservices
    • ♻ areboot
    • aemulator
    • ? atestmonkey

? iOS Commands

  • Capture screen
    • ? iscreenshot
    • ? irecord
    • ? iquicktime
  • Manage applications
    • ? iinstall
    • ? iuninstall
    • ilaunch
    • ? ikill
  • Manage device
    • ioptions
    • ilang
    • ilog
    • ? icheckdevice
    • ♻ ireboot
    • isimulator
    • ? iconsole

? Do you want to share Feedback or Contribute?

Installation

Click here to reveal step by step guide ↓

Note: This tool targets macOS for compatibility, but most interactions should work on any Unix system.

  1. Open terminal
  2. Clone this repository git clone https://github.com/IntergalacticPenguin/mobile-toolkit.git
  3. Setup Android tools
    • Download and install Android Studio and Android command line tools (using Android Studio SDK manager)
    • Edit .zshrc (or .bash_profile if you have bash shell) open -e ~/.zshrc
      • Insert this line at the end PATH=$PATH:/Users/dummyuser/Library/Android/sdk/platform-tools export PATH
      • Don't forget to replace "dummyuser" with your account username
      • Use full path to the "platform-tools" directory
    • Allow USB debugging on your device, connect it and authorize your computer (click OK on the device screen)
  4. Setup iOS tools
    • Install latest Xcode and iOS command line tools using App Store
    • Install Homebrew package manager
    • Run Xcode, connect iOS device to USB and authorize your computer (click "Trust" on the device screen)
    • Run any script i.e. iscreenshot, installation of all required tools will be initiated automatically (jq and go-ios)
  5. Add Mobile Toolkit to $PATH, it is mandatory for iOS scripts and it will let you run scripts in any directory
    • Edit .zshrc (or .bash_profile if you have bash shell) open -e ~/.zshrc
      • Insert the following lines at the end
        PATH=$PATH:/Users/dummyuser/mobile-toolkit/android
        PATH=$PATH:/Users/dummyuser/mobile-toolkit/ios
      • Don't forget to replace "dummyuser" with your account username
      • Use full path to the "mobile-toolkit" directory (where you cloned this repository)
      • Add export PATH to the end of the file

? Android Commands

Capture screen

? ascreenshot

  • ascreenshot Save screenshot to ~/Desktop
  • ascreenshot -a Take screenshot on all connected devices

? arecord

  1. arecord Record screen
  2. End recording using ctrl + c
  3. Save screen video footage to ~/Desktop
  4. Records audio by default on devices running Android 12 and up (when using Scrcpy version 2.0.0 or higher)
  • arecord <custom-name> Specify your own filename by passing it as argument
  • arecord -l Use legacy -l option to record using ADB instead of Scrcpy

Control device

✏️ apaste

apaste "[email protected]" password1 "5005 1002 3332 1112" "2/19" 5004

  • apaste <text> Insert text into currently focused field
  • apaste "[email protected]" password1 Every additional argument will be inserted into subsequent field
  • apaste "This is sample multi-word text." use "" to insert multi-word text into one field
  • apaste -l Insert "Lorem Ipsum paragraph"
  • apaste -a <input-text> Insert any text input (options displayed above) on all connected devices
  • apaste -a -l Insert "Lorem Ipsum paragraph" on all connected devices

aurl

  • aurl "google.com" Open link in web browser or corresponding application
  • aurl -a "google.com" Open link in web browser or corresponding application on all connected devices

? adarkmode

  • adarkmode Toggle system dark mode

? atalkback

  • atalkback Toggle TalkBack screen reader accessiblity option

? abounds

  • abounds Toggle UI layout bounds
  • App restart may be necessary on lower APIs

? aanimationspeed

  • aanimationspeed set slower animation speed or restore default
  • aanimationspeed <speed> set animation speed multiplier

? afontscale

  • afontscale set large font scale (1.3x bigger than default) or restore default
  • afontscale <scale> set font scale multiplier

? acontrol

  • acontrol start scrcpy session
  • Provides realtime device screen mirroring and keyboard+mouse control

? acamera

  • Start the default camera application

⚡️ awireless

  • Enable or disable wireless ADB connection
  • Use ADB and toolkit without having USB cable attached

apowerbutton

  • Lock/Unlock the device (send Power button key event)
  • Useful to unlock the device after the screen is locked automatically

Manage packages

alaunch

  • alaunch List third-party apps and choose one to run it
  • alaunch -s List all available apps (including os pre-installed) and choose one to run it
  • alaunch com.dummy.package.name.app Run app by package name

aappinfo

  • aappinfo List foreground app information
    • Package name
    • Version
    • Last update
    • minSdk and targetSdk
    • Permissions
  • (Optional) Open application settings
  • aappinfo com.dummy.package.name.app Target specific app by passing package name as argument

? akill

  • akill Restart the foreground app
  • akill com.dummy.package.name.app Target specific app by passing package name as argument

? aerase

  • aerase Delete all local data of the foreground app and restart it
  • aerase com.dummy.package.name.app Target specific app by passing package name as argument

? ainstall

  • ainstall some-app-file.apk Install and run .apk
  • ainstall -a some-app-file.apk Install and run .apk on all connected devices

? auninstall

  • auninstall Uninstall third-party app, choose from the list
  • auninstall com.dummy.package.name.app pass package name as argument
  • auninstall -w Uninstall all-third party packages
    • Skips some essential apps, edit IGNORED_PACKAGES in this script to customize the list to your needs

awipe

  • Wipe internal storage and delete all third-party apps

? apermissionreset

  • Revoke ALL GRANTED runtime permissions for ALL apps
    • You'll have to handle permission requests upon opening almost any app

? agoogleplay

  • agoogleplay "Dummy App" Search for "Dummy App" on Google Play
  • agoogleplay Search for currently foreground app on Google Play

? abuildproject

  • abuildproject Build, install and run Android project located in current directory
  • abuildproject <relative-path> Build, install and run Android project located in <relative-path>

Manage device

aoptions

  • aoptions Open system settings on a specific activity
  • You can choose from quick presets
    • Developer settings
    • Locale settings
    • Date & time
    • Wifi settings
    • Storage management
    • Power usage
    • Root settings activity
  • aoptions A Choose from exhaustive list of all available options
  • aoptions 1,2,3... | dev | locale | date | wifi | storage | power Use a preset, choose one

alog

  • alog Print system log output
  • alog -f <package-name> Filter log by package name

? acheckdevice

  • Print genereal device information
  • Perform basic safety-checks and toggle "testing firendly" settings
    • 10 minutes screen timeout
    • Highest brightness
    • Automatic date
    • Disabled notification sounds
    • Internet connectivity and WIFI name
    • Font scale
    • enUS locale
  • (Optional) Search for the device on GSMArena

? aservices

  • Print running background services
  • Search for more information via Google

♻ areboot

  • Reboot the device

aemulator

Required: Make terminal use Android Studio Java

  • Edit .bash_profile (or .zshrc if you have zsh shell) open -e ~/.bash_profile or open -e ~/.zshrc

  • Add the following line at the end of the file export JAVA_HOME='/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home'

  • Android emulator supports all listed scripts by default + extra actions listed below

  • aemulator <option> Handle various Android emulator activites

    • start - choose and launch installed emulator
    • gprs | edge | 3g - simulate network latency, choose one
    • call <number> - receive fake call
    • sms <number> <text> - receive fake sms
    • gps <lat> <long> - set manual GPS location
    • battery <0-100> - set battery level
    • telnet <command> - call command via telnet
      • example commands event | redir | sensor | physics | finger | rotate | fold | unfold... see Android emulator documentation for more information

? atestmonkey

  • atestmonkey Default test with random seed and 15000 input events
  • atestmonkey <event-count> Test with random seed and custom input event count
  • atestmonkey <event-count> <seed> Test with custom seed and custom event count
  • Perform automated stress test using Application Excersciser Monkey
  • You can end test prematurely using ctrl^c or atestmonkeykill in case something goes wrong
  • App under test needs to be pinned to fullscreen mode to prevent unwanted interactions elsewhere
  • Screen pinning button location is directly tied to OS version and device manufacturer skin.
    • It may be tricky to turn on, see examples below:

    • Google Nexus 5 (Android 6)
      You need to bring the app window to foreground, the button is located in bottom right corner.

    • Google Pixel 3 (Android 11)
      You need to click on the app icon, the button is located in popup menu.

? iOS Commands

Capture screen

? iscreenshot

  • iscreenshot Save screenshot to ~/Desktop
  • iscreenshot -a Take screenshot on all connected devices

? irecord

Required: Install videosnap -> download and install videosnap-0.0.8.pkg
Required: Install ffmpeg brew install ffmpeg

  1. irecord Record screen
  2. End recording using ctrl + c
  3. Video footage is saved to ~/Desktop
  4. File is compressed using ffmpeg

? iquicktime

  • Run QuickTime and open video source picker (so you can choose a device right away)
    • You may have to allow security system permission, so the script can access QuickTime application
  • This is a fallback script for irecord on M1 macs as it is currently not working

Manage applications

? iinstall

  • iinstall some-app-file.ipa Install .ipa (make sure to use properly signed build)
  • iinstall -a some-app-file.ipa Install .ipa to all connected devices

? iuninstall

  • iuninstall Uninstall third-party app, choose from the list
  • iuninstall com.dummy.package.name.app pass bundle name as argument
  • iuninstall -w Uninstall all third-party packages
    • Skips some essential apps, edit IGNORED_PACKAGES in this script to customize the list to your needs

ilaunch

  • ilaunch List third-party apps and choose one to run it
  • ilaunch -s List os pre-installed apps and choose one to run it
  • ilaunch com.dummy.bundle.id.app Run app by bundle id

? ikill

  • ikill List third-party apps and choose one to restart
  • ikill -s List os pre-installed apps and choose one to restart
  • ikill com.dummy.bundle.id.app Target specific app by passing bundle id as argument

Manage device

ioptions

  • ioptions Open system settings application

ilang

  • ilang <lang> Change the device language to different one, according to ISO-639 (i.e. "cs")
  • ilang Change the device language to different one, choose from a list of all supported

ilog

  • ilog Print system log output

? icheckdevice

  • Print device information
  • (Optional) Search for the device on GSMArena

♻ ireboot

  • Reboot the device

isimulator

  • Simulator has limited functionality (no camera, biometrics, Appstore...), but offers some extra options, unavailable on physical iOS devices
  • isimulator <option> Handle various simulator related activites
    • start - choose and launch installed simulator
    • screenshot - save screenshot to ~/Desktop
    • record - save screen recording to ~/Desktop (full resolution and frame rate, without QuickTime hassle)
    • paste <text> - insert text into pasteboard
    • import <file> - import image or video to simulator gallery app
    • log - print simulator log
    • url <url> - open link in web browser or corresponding application
    • wipe - wipe all simulator data
    • battery <0-100> - set battery level displayed in status bar (no functional impact)
    • time <hh:mm> - set time displayed in status bar (no functional impact)

? iconsole

  • iconsole Examine iOS or macOS system logs using Console application

Feedback & Contribution

⁉️ Submit an issue to report any bugs, request a feature or ask questions.
? Pull requests are highly appreciated, see the issue board.
Also visit my NoMo project and leave a star.
? Find me on LinkedIn or Twitter.

Expand
Additional Information
Related Applications
Recommended for You
Related Information All