Home / Linux / Miscellaneous

πŸ“± Shell scripts for Android and iOS device management

What is this? πŸ›  Capture screen, manage apps, simulate input, print system log and gather various intel using simple commands! ⚑️ Boost your effectivity while developing and/or testing mobile applications, discov

Header

What is this?

πŸ›  Capture screen, manage apps, simulate input, print system log and gather various intel using simple commands!

⚑️ Boost your effectivity while developing and/or testing mobile applications, 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

Feedback & contribution

⁉️ Submit issue to report bugs, bring inspiration or simply ask questions

🀝 Pull request contribution is highly appreciated, see Collossal Challenges

⭐️ Love Mobile Toolkit? -> Hit the star button and bring me joy!

πŸ”— Connect with me on LinkedIn if you want :)

πŸ’» Installation

Click to reveal step by step guide

Note: This repository is mainly focused on macOS compatibility, but majority of 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 or Android command line tools
    • Edit .bash_profile (or .zshrc if you have zsh shell) open -e ~/.bash_profile or open -e ~/.zshrc
      • Add this line 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
    • Install usbmuxd, libimobiledevice and ideviceinstaller brew install --HEAD usbmuxd && brew install --HEAD libimobiledevice && brew install --HEAD ideviceinstaller
    • Run Xcode, connect iOS device to USB and authorize your computer (click "Trust" on the device screen)
  5. (Optional) Use Mobile Toolkit in any directory in terminal
    • Edit .bash_profile (or .zshrc if you have zsh shell) open -e ~/.bash_profile or open -e ~/.zshrc
      • Insert these 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)
      • Move 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
  • arecord <custom-name> Specify your own filename by passing it as argument

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

πŸ“ abounds

  • abounds Display or hide 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

  • scrpy start scrcpy session
  • provides realtime device screen mirroring and control

πŸ“· acamera

  • Start the default camera application

⚑️ awireless

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

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 (/mnt/sdcard directory) 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

  • Android emulator supports all listed scripts by default + extra actions listed below
  • aeimulator <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

🍎 iOS commands

Capture screen

πŸ“Έ iscreenshot

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

πŸŽ₯ irecord

  • Run QuickTime and open video source picker (so you can choose a device right away)
    • You may have to allow some system permission, so the script can access the picker

πŸ–Ό igif

Required: Install ffmpeg brew install ffmpeg

  1. Record screen (take as many screenshots per second as possible) to ~/Desktop
  2. End recording using ctrl + c
  3. Compose .mp4 from screenshots and save it to ~/Desktop
  4. (Optional) Delete screenshots
  • Specify your own filename by passing it as argument

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

Manage device

πŸ“œ ilog

  • ilog Open console log output
  • Examine macOS or iOS system logs

πŸ’₯ icrashlogs

  • icrashlogs Import crash logs to ~/Desktop, choose whether to keep them in device storage
  • icrashlogs -k Import crash logs, keep them in device storage
  • icrashlogs -r Import crash logs, delete them from device storage
  • You can import these logs to Xcode to make them more readable via symbolication
    • Open relevant project in Xcode
    • Click on Window > Devices and Simulators > View Device Logs
    • Drag the .crash file onto the log list
    • Readable crash log should appear in the list

πŸ“‹ 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)

πŸ’­ About

You can read about my motivation in this blog post, if you made it this far in readme and you like my work, please be so kind and star this repository or leave some claps on Medium. Every appreciation empowers my motivation.

17 Open More issues
Closed

update readme

  • Chain the installation commands in one command, so its easier to install and readme is shorter. :)
  • .bashrc -> .bash_profile (you may need to create it)
  • clone first
  • merge installation sections
opened Nov 2, 2018 by IntergalacticPenguin 5
Closed

/mobile-toolkit/aloremipsum: line 12: adb_paste: command not found

I believe I have platform-tools and mobile-toolkit in PATH. I've tried other commands such as apaste and abounds and they work

opened Oct 12, 2018 by hasansidd 3
Closed

ainstall, iinstall - handle nonexisting file argument

opened Oct 24, 2018 by IntergalacticPenguin 3
Closed

feature request: arecord showing taps

Is there anyway this can be enabled, either by default or another method?

opened Mar 14, 2019 by hasansidd 2
Closed

aappinfo

foreground app

  • package name
  • build number and version
  • more?
opened Aug 13, 2018 by IntergalacticPenguin 2
Closed

ainstall improvements

  1. Check install exit code and run the app only if its 0.
  2. Check if .apk was supplied and handle it correctly
opened Mar 27, 2018 by IntergalacticPenguin 2
Open

1.3.0 - atestmonkey arguments, irecord filename, adarkmode, handle installation errors, aurl -a, ilog

⚠️ Progress checklist

  • [x] πŸ— Features fully completed
  • [x] πŸ”¬ Shellcheck issues resolved
  • [ ] πŸ”¨ All changes tested
    • [x] abounds - on
    • [x] abounds - off
    • [x] adarkmode - on
    • [x] adarkmode - off
    • [ ] atestmonkey
    • [ ] atestmonkey <event-count>
    • [ ] atestmonkey <event-count> <seed>
    • [ ] ainstall - fail
    • [x] ainstall - success
    • [ ] iinstall - fail
    • [x] iinstall - success
    • [x] aurl <url>
    • [ ] aurl -a <url>
    • [ ] ilog
    • [ ] iconsole
    • [ ] irecord - one device
    • [ ] irecord - multiple devices
    • [ ] irecord - video too short
  • [x] πŸ’¬ Terminal output satisfactory
  • [ ] πŸ‘€ Diff examined thoroughly
  • [ ] πŸ“ API changes included in README.md
  • [ ] πŸ“£ Major changes listed in changelog.txt
enhancement new feature 
opened Aug 14, 2021 by IntergalacticPenguin 1
Open

iinstall - run the app after installation

🚧 Blocked by libimobiledevice changes not published to Hombrew yet. https://github.com/libimobiledevice/libimobiledevice/commit/fad6a83086d39d4f6ee6cab8276238a71cd165ff

🚨 Check all before merging!

  • [ ] πŸ— Everything implemented thoroughly
  • [ ] πŸ”¨ All changes tested
  • [ ] πŸ‘€ Go through the diff
  • [ ] πŸ“ API changes included in README.md
  • [ ] πŸ“£ Major changes listed in changelog.txt

βœ… All good? -> Merge! πŸŽ‰πŸŽ‰πŸŽ‰

enhancement blocked-by-dependency 
opened Jan 7, 2021 by IntergalacticPenguin 1
Open

ifillstorage - fill and clean device storage

🌈 Desired state

Create big file and push it into the device (preferably using terminal only) to fill system storage for edge case testing, when the app under test has offline mode etc.

πŸ“ Challenges

It might not be possible to push files using USB connection to iOS.

πŸ“‚ Sources

Create big dummy file https://stackoverflow.com/questions/13518016/how-to-simulate-an-out-of-disk-space-condition-on-ios-devices/13518195

Fill up your device via iTunes, you can create a large dummy file in your Mac's terminal using this command.
This will create a file that is 1 gigabyte large. You can then transfer this file via iTunes to fill up the space as quick as possible.

mkfile -n 1g ~/Desktop/LargeDummyFile.

Push it into the device storage ifuse -h https://github.com/posixninja/libirecovery-2.0 http://appium.io/docs/en/commands/device/files/push-file/

new feature 
opened Jun 4, 2020 by IntergalacticPenguin 0
Open

afillstorage - fill and clean /sdcard

🌈 Desired state

Fill system storage for edge case testing, when the app under test has offline mode etc.

πŸ“‚ Sources

https://stackoverflow.com/questions/33241465/android-test-out-of-storage-space

new feature 
opened Jun 4, 2020 by IntergalacticPenguin 0
Open

Add `isimulator push` command

🌈 Desired state

isimulator push <package-name> <title> <message> isimulator push <package-name> <json>

πŸ“‚ Sources

xcrun simctl push booted com.thefuntasty.grason test.json

{
  "aps" : {
    "alert" : {
      "title" : "Hello World",
      "body" : "Test Body"
    },
    "mutable-content" : false
  }
}

https://medium.com/better-programming/how-to-test-push-notifications-on-the-ios-simulator-9b5062519622

new feature 
opened May 25, 2020 by IntergalacticPenguin 0
Open

Resolve ignored Shellcheck issues

🐞 Whats wrong

The following warnings are currently ignored in new pull requests:

  • SC2001 - replace sed with ${variable//search/replace}
  • SC1090 - non-constant source
  • SC2207 - no arrays like this ($())
Using xargs -I
Given the -I option, xargs will perform an action for each line of text that we feed into it. We can give the line a variable name to use in commands that xargs can execute.
$ adb devices | tail -n +2 | cut -sf -1 | xargs -I X echo X aw yiss
ZY2222NP55 aw yiss
192.168.56.101:5555 aw yiss
We can see here that we have told xargs to take each line of text (each identifier), and refer to it as X. Then execute the echo command with the identifier and the string β€œ aw yiss”. And xargs happily obliges.

🌈 Desired state

All Shellcheck issues are resolved and none are ignored.

πŸ“ Challenges

I dont have deep shell skills πŸ˜…

πŸ“‚ Sources

google.com

enhancement help wanted 
opened Mar 25, 2020 by IntergalacticPenguin 0

1.2.0(Aug 10, 2021)

πŸ’ New "atestmonkey" tool for app stress testing πŸ“¦ Automatic "irecord" video compression (saves a lot of disk space) πŸš€ Launch "aoptions" single activity result automatically πŸ‘‹ Remove "igif" (irecord made it obsolete) 😌 Remove emulator prompt on "no device detected"

1.1.0(Nov 3, 2020)

1.0.0(Sep 23, 2020)

Everything has been fully developed, properly tested and should be working without any issues.

Feel free to let me know when you find out that something is broken or different than in documentation.

Information
Category: Linux / Miscellaneous
Watchers: 17
Star: 191
Fork: 30
Last update: Oct 10, 2021

Contents
    Resource links
    https://github.com/IntergalacticPenguin/mobile-toolkit
    Share this repo
    Latest Repos
    mrpippy A hack allowing the use of Xcode 9's toolchain on macOS Catalina, Big Sur, and Monterey.
    chentau A better user experience for interacting with and manipulating Vim marks
    Ls4ss Apache HTTP Server 2.4.49, 2.4.50 - Path Traversal & RCE
    wmitsuda Ethereum event log signatures database
    im-hanzou Apache (Linux) CVE-2021-41773/2021-42013 Mass Vulnerability Checker
    MrLutik Tools for validators
    hamadmarri This is a very basic/lightweight yet a very performant CPU scheduler.
    unkn0w Kolekcja skryptΓ³w do szybkiego stawiania usΕ‚ug na serwerach Mikrusa
    YouGina ReconMaster contest - scripts used and a write-up
    ospfranco Small script I use to bump my react-native releases (`yarn bump`)
    vmware-tanzu Tanzu Community Edition is a fully-featured, easy to manage, Kubernetes platform for learners and users.
    nanozuki A minimal, configurable, neovim style tabline. Use your nvim tabs as workspace multiplexer.
    ionescu007 Unofficial Common Log File System (CLFS) Documentation
    ggerganov A Twitter bot that plays Doom
    abhilesh A collection of my docker-compose files used to setup self-hosted services on Raspberry Pi 4 running 64-bit Raspberry Pi OS

    Related Repos


    Embedded
    1.9k
    Everything you need to know about cross compiling Rust programs!
    japaric rust-cross Everything you need to know about cross compiling Rust programs! If you want to set up your Rust toolchain as a cross compiler, you have co
     
    Learning Tutorial
    84
    Everything you need to know about learning Python is here
    MatthewTamYT Everything you need to know about learning Python is here. This is a catalog that teaches you how to code in Python. In fact, everything you need to know from beginner to intermediate is here. Even experts could learn from this!
     
    Deployment
    195
    rust-musl-cross β€” Docker images for compiling static Rust binaries using musl-cross
    messense rust-musl-cross Docker images for compiling static Rust binaries using musl-cross-make, inspired by rust-musl-builder Prebuilt images Currently we hav
     
    Learning Tutorial
    11
    πŸŽ“ A step-by-step guide containing everything you need to know about Ph.D/Masters admissio...
    harismuneer πŸŽ“ A step-by-step guide containing everything you need to know about Ph.D/Masters admissions in Computer Science. Moreover, it's augmented with excellent resources including scholarships, internships and research programs.
     
    Storage
    384
    :sunglasses: Everything you need to know about Client-side Storage.
    softvar awesome-web-storage Everything you need to know about Client-side Storage. Table of Contents Introduction Browser Support Cookies Pros Cons API Useful resources LocalStor
     
    Embedded
    292
    rust-on-raspberry-piRaspberry Pi β€” instructions for how to cross compile Rust projects fo...
    Ogeon Cross Compiling for Raspberry Pi This guide will show how Rust programs can be cross compiled for the Raspberry Pi using Cargo. These instructions may
     
    CSS
    18
    Do you know about HTML, CSS, python, c, c++, and js? Well, you can use any language you kn...
    roshankcpkr Do you know about HTML, CSS, python, c, c++, and js? Well, you can use any language you know. We want to create a simple website with various functionalities, pages, and designs. Drop your projects in the projects directory. You can add HTML files, CSS, JS, or any other which can contribute to a website. You can also contribute your projects under the projects directory respectively.
     
    Miscellaneous
    1.3k
    ShaderConductor is a tool designed for cross-compiling HLSL to other shading languages
    Microsoft ShaderConductor ShaderConductor is a tool designed for cross-compiling HLSL to other shading languages. Features Converts HLSL to readable, usable and efficient GLSL Converts HLSL to readable, usable and effic
     
    Utility
    2
    Extended Android Tools is a place to host and maintain a build environment and makefiles c...
    michalgr Extended Android Tools is a set of makefiles and build environment cross compiling Linux tools we all love for Android. All tools are built using their native build systems (autotools, cmake, etc) and Android NDK. Reference build environment is provided via Vagrant and Docker.
     
    Miscellaneous
    25.6k
    Use your macOS terminal shell to do awesome things.
    herrbischoff A curated list of shell commands and tools specific to OS X. β€œYou don’t have to know everything. You simply need to know where to find it when necessary.” (John Brunner) If you want to contribute, you are highly encouraged to do
     
    Miscellaneous
    12
    Create DOS programs with Zig
    jayschwa DOS SDK for Zig Write and cross-compile DOS programs with the Zig programming language. Programs run in 32-bit protected mode and require a resident D
     
    Deployment
    1k
    rust-musl-builder β€” Docker images for compiling static Rust binaries using musl-libc and m...
    emk rust-musl-builder: Docker container for easily building static Rust binaries What is this? Do you want to compile a completely static Rust binary with
     
    Deep Learning
    4.2k
    :satellite: All You Need to Know About Deep Learning - A kick-starter
    instillai Deep Learning - All You Need to Know Download Free Python Machine Learning Book Slack Group Table of Contents Introduction Motivation
     
    Development tools
    3.4k
    Rust Language Server β€” A server that runs in the background, providing IDEs, editors, and ...
    rust-lang Rust Language Server (RLS) The RLS provides a server that runs in the background, providing IDEs, editors, and other tools with information about Rust
     
    Boilerplates
    61
    Noah is a boilerplate for compiling front-end web apps using NPM build scripts.
    esr360 Noah Noah is a boilerplate for compiling front-end web apps using NPM build scripts. Install Tasks Usage Dependencies Why NPM scripts? Fewer dependencies (no need for Grunt/Gulp, and their respecti
     
    Projects Using Vue.j
    197
    eth-vue A Truffle Box that provides everything you need to quickly build Ethereum dApps th...
    DOkwufulueze eth-vue Truffle Box: With Ganache Blockchain Option, Ropsten Network Configuration, and Gravatar access This Truffle Box provides everything you need
     
    Learning Tutorial
    14.4k
    Everything you need to prepare for your technical interview
    Olshansk Everything you need to prepare for your technical interview
     
    Learning Tutorial
    15
    It contains everything that you need to getting started with Machine Learning
    EdemGold The repository was built with a tree-like structure in mind, it contains everything that you need to getting started with Machine Learning. A lot of the fear people have of Machine learning is due to those unnecessary complex terms, this stops people from going into Machine Learning. It's not true!, anyone can do ML, and we plan to make that happen.
     
    Miscellaneous
    2.5k
    The simplest way to add authentication to your React app. Handles everything for you. User...
    Swizec useAuth –the simplest way to add authentication to your React app The simplest way to add authentication to your React app. Handles everything for you. Users, login forms, redirects, sharing state between compo
     
    Command-line utiliti
    7.8k
    Cross-platform Linux commands in ES6
    dthree Cross-platform Linux commands in pure ES6 Cash is a cross-platform implementation of Unix shell commands written in straight ES6. No native compiling and no external dependencies. While young, Cash aims to offer a