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
Information
Category: Linux / Miscellaneous
Watchers: 21
Star: 255
Fork: 36
Last update: Feb 5, 2023
Resource links
https://github.com/IGPenguin/mobile-toolkit

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.

13 Open More issues
Closed

iinstall - launch the app after installing

Following code is "working" but the app will crash almost always in few seconds after launch, I can:

  • launch it multiple times to boost the odds for app to remain running (ugly) libimobiledevice Issue
  • try to find another tool for launching iOS apps using bundle id (didnt find any yet)
echo "๐Ÿ” Detecting bundle id..."
unzip "$PWD/$1" &> /dev/null
APP_FILENAME=$(ls $PWD/Payload)
BUNDLE_ID=$(grep "$PWD/Payload/$APP_FILENAME/embedded.mobileprovision" -a -e "[.]com[.]" | sed 's/.[^.]*\.//' | sed 's/\<.*$//')
rm -rf "$PWD/Payload"
echo "โŒ›๏ธ Installing $BUNDLE_ID"
ideviceinstaller -i "$1" &> /dev/null #make silent
echo "๐Ÿš€ Launching..."
idevicedebug run $BUNDLE_ID
new feature blocked-by-dependency 
opened Feb 7, 2019 by IGPenguin 5
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 IGPenguin 5
Closed

Switch to "go-ios" from "libimobiledevice"

๐Ÿž Whats wrong

libimobiledevice tool is not being supported actively by its authors.

๐ŸŒˆ Desired state

Unlock more possibilities to implement new features and optimize scripts. New features could include launching and killing installed apps and much more! ๐Ÿ™€

๐Ÿ“ Challenges

Rework all iOS scripts from scratch with different open source utility.

๐Ÿ“‚ Sources

https://github.com/danielpaulus/go-ios

new feature 
opened Oct 20, 2021 by IGPenguin 3
Closed

ainstall, iinstall - handle nonexisting file argument

opened Oct 24, 2018 by IGPenguin 3
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

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 IGPenguin 2
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 IGPenguin 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 IGPenguin 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 IGPenguin 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 IGPenguin 0
Open

Homebrew distribution

๐Ÿž Whats wrong

The installation process is too complicated.

๐ŸŒˆ Desired state

brew install mobile-toolkit

๐Ÿ“ Challenges

I have not done anything like this yet.

๐Ÿ“‚ Sources

https://kylebebak.github.io/post/distribute-program-via-homebrew www.google.com

help wanted new feature 
opened Dec 11, 2019 by IGPenguin 2
Open

aurl - support urls file for deeplink testing

lines=($(cat "deeplink_urls")) # make array from file

enhancement 
opened Nov 23, 2019 by IGPenguin 0

1.3.1(Nov 24, 2022)

๐Ÿ”Ž README.md was updated with table of contents and better formatting github.com/IntergalacticPenguin/mobile-toolkit

โญ๏ธ Be among the first to check out my new project! igpenguin.github.io/nomo

๐Ÿ”ฅ Stay tuned for new iOS commands or switch to github.com/danielpaulus/go-ios

1.3.0(Dec 20, 2021)

๐Ÿ’ฃ Substitued libimobiledevice with go-ios in all iOS scripts ๐Ÿš€ Added ilaunch, ikill, ioption, ilang, atalkback, adarkmode ๐Ÿ iinstall runs the installed app automatically ๐ŸงŸโ€โ™€๏ธ Reintroduced iquicktime as irecord fallback for M1 macs โšฐ๏ธ Removed icrashlogs (perhaps temporarily, depends on go-ios maintainer) ๐Ÿฉน Fixed Android 12 foreground package detection โœจ Added new iOS device translations

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.

Contents

    osy Launch JIT enabled iOS app with a second iOS device
    jaredrummler A small Android library to get the market name of an Android device.
    facebookarchive A library that analyzes an Android device's specifications and calculates which year the device would be considered "high endโ€.
    Place1 wg-access-server is a single binary that provides a WireGuard VPN server and device management web ui
    deviceplane Open source device management for embedded systems and edge computing
    KieronQuinn Tap is a port of the double tap on back of device gesture from Android 11 to any ARM v8 device
    kawaiizenbo iOS device App manager for Windows
    Ekhoo Light weight tool for detecting the current device and screen size written in swift.
    andrealufino Swift library to easily check the current device and some more info about it.
    aloisdeniel Approximate how your app looks and performs on another device.
    androidmalware Use Android as Rubber Ducky against another Android device
    music4kid view iOS app sandbox file system on real device, share files via airdrop
    nladuo Control your Android device via python scripts.
    ozamed This is a place where you can find python scripts. You can contribute by giving your scripts written in python which you think are awesome.
    ItsKaitlyn03 An experimental Nintendo Switch emulator for Android!
    remobile A android like toast for android and ios, android use native toast, ios use UIView+Toast
    markjaquith WordPress plugin for fluent management of scripts and styles.
    aidevjoe A simple iOS sandbox file browser, you can share files through AirDrop
    nystudio107 Shell scripts to manage database backups, asset backups, file permissions, asset syncing, cache clearing, and database syncing between Craft CMS environments
    rust-embedded-community usb-device - Experimental device-side USB stack for embedded devices
    matomo-org The Universal Device Detection library will parse any User Agent and detect the browser, operating system, device used (desktop, tablet, mobile, tv, cars, console, etc.), brand and model.
    Share this repo

    Related Repos


    Miscellaneous
    14
    the ultimate compact fzf gh extension
    gennaro-tedesco the ultimate compact fzf gh extension Installation โ€ข Usage โ€ข Customisation โ€ข Feedback gh-f is the ultimate, compact and snappy fzf extension for gh cl
     
    Miscellaneous
    6
    MacOS Wallpapers for linux desktop
    vinceliuice MacOS Wallpapers for linux desktop WhiteSur (Big Sur) Wallpapers Monterey Wallpapers Installation Install Gnome Backgrounds (wallpaper will change acc
     
    Miscellaneous
    3
    A docker bundle with *arr apps ready to deploy on your linux machine.
    bolchisb Plex Home Media integrations This package is created for those who are not experts in linux servers and docker. If you follow these steps you'll be ab
     
    Miscellaneous
    3
    Vim-textobj-string is a Vim plugin to provide text objects to select a string
    rbtnn vim-textobj-string is a Vim plugin to provide text objects (as and is by default) to select a string.
     
    Miscellaneous
    3
    automatically quote arguments to commands like `git commit -m`
    ianthehenry zsh-autoquoter zsh-autoquoter is a zle widget ("zsh plugin") that will automatically put quotes around arguments to certain commands. So instead of ha
     
    Miscellaneous
    34
    PyTorchCV: A PyTorch-Based Framework for Deep Learning in Computer Vision.
    donnyyou PyTorchCV: A PyTorch-Based Framework for Deep Learning in Computer Vision @misc{CV2018, author = {Donny You ([email protected])}, howpubl
     
    Miscellaneous
    276
    Documentation on building a HTTPS stack in AWS with HAProxy
    jvehent Guidelines for HAProxy termination in AWS Document status NOT READY $Revision: $ @ 2022-01-14 19:00 PST Author Julien Vehent Review CloudOps Table of
     
    Miscellaneous
    8.3k
    Spinnaker is an open source, multi-cloud continuous delivery platform for releasing softwa...
    Spinnaker Welcome to the Spinnaker Project Spinnaker is an open-source continuous delivery platform for releasing software changes with high velocity and confid
     
    Miscellaneous
    52
    A must-have configuration for Spacemacs users after defecting to Vim
    yetone ๐Ÿช My Neovim Configuration ๐Ÿš€ A must-have configuration for Spacemacs users after defecting to Vim If you want the power of VSCode, the interactivity
     
    Miscellaneous
    12
    This repo is for firmware updates, software files, and other important resources for the M...
    Takiiiiiiii Miyoo Mini Firmware and Configured SD This repository contains a debloated and improved SD card image for the Miyoo Mini. Latest Firmware Update Packa
     
    Miscellaneous
    7
    This app is created that using with Shell Script and Zenity Library.
    kaansertel CV Hazฤฑrlama (Shell Script - Zenity Kรผtรผphanesi) Linux Araรงlarฤฑ ve Kabuk Programlama dersi kapsamฤฑnda,Shell script ve Zenity Kรผtรผphanesi kullanฤฑlarak
     
    Miscellaneous
    7
    Docker container for PlexAutoSkip
    mdhiggins PlexAutoSkip Official Docker Container Docker container for PlexAutoSkip Version Tags Tag Description latest Stable release Usage docker-compose ple
     
    Miscellaneous
    29
    An open source meme???
    KCGD Open source spiderman meme Haha spiderman make a presentation lol Install gimp This meme requires gimp, install through install_deps.sh chmod +x insta
     
    Miscellaneous
    35
    Script to patch iOS app so we can later use it on Apple Silicon devices.
    Co2333 AppleSiliconUIKitPatch Script to patch iOS app so we can later use it on Apple Silicon devices. App should be decrypted if was downloaded from App Sto
     
    Miscellaneous
    20
    dots configured after setting up NixOS on tmpfs
    Sam1431 ฮป Idempotent Dotfiles SETTING UP NIXOS , MY WAY NixOS with tmpfs (Sway WM) Disclaimer: This is not a community framework or distribution. It's a priva