Macaca inspector for Apple Mac

Appium inspector is not great in helping us to inspect the mobile elements in the iOS >9.3 and now current iOS version is in beta build of 10.3(At that time of writing this blog 😉 )

Apple stopped supporting UIAutomation in which iOS build taken from the XCODE 7.X. XCUITEST playing a major role to manage the UI Automation for the latest iOS application .APP build using XCODE 8.x

This blog posting helps you to inspect the mobile elements of Native, Hybrid and Mobile Web specific mobile/web elements using the open source utility of Macaca inspector, which is an perfect alternative for Appium Inspector in respect to iOS Automation in Mac;

I have used the real iPhone 6s device with iOS 10.2;

GitHub URL:

Please follow the below step to install the Macaca inspector in your Mac;

$ npm install app-inspector

Please follow the below step to invoke the Macaca Inspector in your machine in which it will install the webdriver agent in the real device and it will show the mobile screen with the element information in the safari browser;

$ ./node_modules/.bin/app-inspector -u

$ ./node_modules/.bin/app-inspector -u 6EE5E44A-F4F2-4A8A-AB5C-7A7FC9CC3512


Once executing the above command, you could see the above console window with the success response message of 200 including the connected device information of UDID and port number.

Now the mobile screen will be displayed in the safari browser and click the appropriate mobile/web element to visualise the element information in the right pane as stated below;

I have tried to capture the MobiKwik mobile element information using the Macaca Inspector;


Please note, webdriver agent is available under the node_modules of appium and it will be downloaded to your Mac while downloading the appium setup based on the below command;

$ npm install appium

4 thoughts on “Macaca inspector for Apple Mac

  1. Hey , I have followed same steps above and I haven’t got any success message.

    Error here ,
    HM5003604:.bin skumar$ app-inspector -u XXXXXXXXXXXXXXX
    >> xctest-client start with port: 8900
    >> WebDriverAgent version: 1.1.6
    >> app-inspector:66:44 [master] pid:85988 undefined
    (node:85988) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: >> app-inspector:66:44 [master] pid:85988 undefined
    (node:85988) DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.


  2. Hi ,

    I am trying to run an app file on macaca browser for inspecting mobile element. I am getting following error. The browser starts up saying waiting for device to start up.Can you please help.

    I am using iphone 6 simulator , not a real device.

    xctest-client.js:201:16 [master] pid:82949 xctest client exit with code: 65, signal: null
    xctest-client.js:115:18 [master] pid:82949 simulator log process exit with code: null, signal: SIGKILL .

    These are versions of software installed in my MAC
    macaca-doctor version: 2.0.5

    Node.js checklist:

    node env: /usr/local/bin/node
    node version: v8.9.2

    iOS checklist:

    Xcode Command Line Tools is ready, version: 2349.
    xcodebuild version: 9.2
    iproxy[usbmuxd] is installed at: /usr/local/bin/iproxy
    ios_webkit_debug_proxy is installed at: /usr/local/bin/ios_webkit_debug_proxy
    carthage is installed, version: 0.27.0


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s