muandrew/androidtool-mac

One-click screenshots, video recordings, app installation for iOS and Android

Android tool for Mac

Download

Download the latest version here

• Unzip AndroidTool.zip
• Copy AndroidTool.app to your Applications folder
• Right click AndroidTool and choose Open

What's this?

Android tool lets you do common Android designer and developer tasks in one click:

• Take screenshots
• Take screen videos
• Install (sideload) APKs without the Play Store
• Take bug reports
• Use common scripts
• Do all of the above on all devices connected to your Mac, in one click

Recording video

Requirements

• MacOS 10.9 Mavericks for Android features
• MacOS 10.10 Yosemite for iOS features
• Android 4.4 or newer for screen recording
• Android 4.3 or newer for screenshots (could work on older devices, please report)
• No Android or iOS SDK required (whaat)

Android Tool outputs both mp4 and an animated gif. The animated gif can be placed in a Google Docs document or an email.

Installing apps

Double click any APK file on your hard drive and Android Tool pops up asking you onto which device you want to install it.

Plain old screenshots

Take screenshots of one or all devices connected to your mac - in one click, or by pressing cmd-shift-S

Your own scripts

Add your own perfect bash shell scripts to the scripts folder and execute them on a single device, or all devices connected to your Mac. See the example script in the scripts folder how to target a the user-selected device.

Questions?

• Open an issue!

Thanks

Morten Just

For this project. Find the original project and his contacts here.

Farhad Khairzad

For the OBB installer script

adb, fastboot, aapt

The following binaries are covered under the Apache License, Version 2.0.

• adb: Android Debug Bridge version 1.0.39; Version 0.0.1-4500957; NOTICE
• fastboot: 0.0.1-4500957; Android NOTICE
• aapt: Android Asset Packaging Tool; v0.2-4507799; build-tools 27.0.3; NOTICE

FFmpeg

This software uses code of FFmpeg licensed under the LGPLv2.1 and its source can be downloaded here

ImageMagick

Licensed under the ImageMagick License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

 http://www.imagemagick.org/script/license.php

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

libimobiledevice

https://www.libimobiledevice.org/

Compiled on Mac OSX 10.13.4 with OpenSSL 1.0.2o
libimobiledevice f37b592788bffcb9a70d211aef8b1f84751114ca LGPL-2.1
libusbmuxd 724e70fb52ba45291dc73a2e369c0c5bae0ec2e LGPL-2.1
libplist ec9ba8bff6a4469aa75f6d570ab5109c061c6a9e LGPL-2.1

Tested on Mac OSX 10.13.3 with 11.3 6s plus and 10.3.3 5s

androidtool-mac's Issues

Crash when opening .apk files

Hi, Thanks for the 64-bit version of this tool! I did notice that when opening an .apk though it crashed the app. The exception seen in Console.app is:

Thread 0 Crashed:: Dispatch queue: com.apple.main-thread
0   com.mortenjust.AndroidTool    	0x0000000105ea5a55 0x105e79000 + 182869
1   com.mortenjust.AndroidTool    	0x0000000105ea304b 0x105e79000 + 172107
2   com.apple.AppKit              	0x00007fff230a9d9a -[NSApplication _doOpenFile:ok:tryTemp:] + 341
3   com.apple.AppKit              	0x00007fff230b6546 __71-[NSApplication(NSAppleEventHandling) _openURLs:withCompletionHandler:]_block_invoke.155 + 293
4   com.apple.AppKit              	0x00007fff230b6318 withWindowOrderingObserverHeuristic + 473
5   com.apple.AppKit              	0x00007fff230b5e91 -[NSApplication(NSAppleEventHandling) _openURLs:withCompletionHandler:] + 1279
6   com.apple.AppKit              	0x00007fff22f5d599 __69-[NSApplication(NSAppleEventHandling) _handleAEOpenDocumentsForURLs:]_block_invoke + 887
7   com.apple.AppKit              	0x00007fff22dca621 __90-[NSDocumentController(NSInternal) _autoreopenDocumentsFromRecords:withCompletionHandler:]_block_invoke + 52
8   com.apple.AppKit              	0x00007fff22dca442 -[NSDocumentController(NSInternal) _autoreopenDocumentsFromRecords:withCompletionHandler:] + 315
9   com.apple.AppKit              	0x00007fff22dca2df __97-[NSDocumentController(NSInternal) _autoreopenDocumentsIgnoringExpendable:withCompletionHandler:]_block_invoke_3 + 95
10  com.apple.AppKit              	0x00007fff22dc9eca -[NSDocumentController(NSInternal) _autoreopenDocumentsIgnoringExpendable:withCompletionHandler:] + 590
11  com.apple.AppKit              	0x00007fff22c500af -[NSApplication _reopenWindowsAsNecessaryIncludingRestorableState:completionHandler:] + 249
12  com.apple.AppKit              	0x00007fff22f5d197 -[NSApplication(NSAppleEventHandling) _handleAEOpenDocumentsForURLs:] + 236
13  com.apple.AppKit              	0x00007fff22c4fb53 -[NSApplication(NSAppleEventHandling) _handleCoreEvent:withReplyEvent:] + 741
14  com.apple.Foundation          	0x00007fff2118f056 -[NSAppleEventManager dispatchRawAppleEvent:withRawReply:handlerRefCon:] + 308
15  com.apple.Foundation          	0x00007fff2118eec6 _NSAppleEventManagerGenericHandler + 80
16  com.apple.AE                  	0x00007fff26207ed9 0x7fff261fb000 + 52953
17  com.apple.AE                  	0x00007fff262075f4 0x7fff261fb000 + 50676
18  com.apple.AE                  	0x00007fff26200260 aeProcessAppleEvent + 452
19  com.apple.HIToolbox           	0x00007fff286c3612 AEProcessAppleEvent + 54
20  com.apple.AppKit              	0x00007fff22c4a276 _DPSNextEvent + 2048
21  com.apple.AppKit              	0x00007fff22c485af -[NSApplication(NSEvent) _nextEventMatchingEventMask:untilDate:inMode:dequeue:] + 1366
22  com.apple.AppKit              	0x00007fff22c3ab0a -[NSApplication run] + 586
23  com.apple.AppKit              	0x00007fff22c0edf2 NSApplicationMain + 816
24  com.mortenjust.AndroidTool    	0x0000000105e7bf99 0x105e79000 + 12185
25  libdyld.dylib                 	0x00007fff20351621 start + 1

Screenrecord fail. Can't open '/sdcard/<filename.mp4'.

Hi,
First, thanks for the nice tool.
I'm new to Android world so, please be patient.
I've installed, and taking screenshot's work fine. (so i think i've done correctly the activation of usb debugging).
Trying to screeRECORD, does fail. Always saying that it can't open file /sdcard/<filename...mp4

I found a wiki with troubleshooting, and doing it from command line, like:

09:40 $ /Applications/AndroidTool.app/Contents/Resources/adb shell screenrecord /sdcard/screen.mp4
The max width/height supported by codec is 1920x1088

^C
09:41 $ /Applications/AndroidTool.app/Contents/Resources/adb pull /sdcard/screen.mp4
[100%] /sdcard/screen.mp4

does result in a ok capture .mp4 file.

Is there something i could look at the app config that could help find why from the app it doesn't work?

Thanks,

Add brew support

Nice keeping this alive! Possible to add homebrew support? :)

Thank you!

Thank you!

Just wanted to quickly drop by and say thank you for your work here. Made screen recording a silly bug on the device SO easy and straightforward.

You made my day!

Every delegate relationship is probably a reference cycle

None of the delegate properties are weak, but the objects in question are owned by their delegates.

Only 3 minute screen recording time

If possible please increase the recording time upto 2 hours

User Scripts: how to get output?

Hi,

first of all thanks for keeping this program alive! I find it really useful.
This is more of a question, I'm trying to make a user script that would download and install latest APK of an app for me.
Is there a way to see the output of the script when running from within AndroidTool? I can make the script work in shell, but when running from the app it always ends prematurely and I have no idea where the problem is in that case.

Thanks!

Script not running

Script is stuck on finished, and the log file is 0kb.
Also when checking in the terminal it's last line is Application Support/AndroidTool/UserScripts/Take Bugreport.sh: line 21: /Applications/AndroidTool.app/Contents/Resources/adb: No such file or directory