Windows Spy Tutorials

Starting in Katalon Studio version 7.0, you can spy objects on a Windows desktop application.

  1. To start capturing test objects on a Desktop application, Click the Spy Windows Object icon on the main toolbar of Katalon Studio.

  2. The Spy Windows Objects dialog box is displayed. Specify the information at the CONFIGURATIONS section.

  • Configuration: where you can view and edit the WinAppDriver URL and Desired Capabilities.

  • Application File: the absolute path to the Windows Executable File (*.exe) of the testing machine. For Windows users, click Browse... button to locate the application file.

    The Start button is enabled after the Application File text box is filled.

    Click Start when you're done with the settings.

  1. The specified Windows application is deployed and opened on a testing machine.

  2. The Screen View dialog box is displayed to show the current screenshot of your application on the testing machine.

    All the Windows objects in that screenshot are analyzed and organized in a tree at the Screen Objects section.

    Click on any object in that tree and it's highlighted in the Screen View accordingly.

  3. Select any objects in the tree by checking on the checkboxes on the left of an intended element to add it to the Object Repository. The selected object is displayed in the Captured Objects Section. You're recommended to rename objects in the Object Properties Section.

    Here you can customize the locator of a captured object by modifying it in the Locator tab of Object Properties and clicking Highlight to verify if the new locator correctly identifies the intended object on Screen View.

  4. All of the selected objects above are captured at the Captured Objects section.

  5. You can stop the application or start another application if needed. To reload the Screen View as well as the details in Spy Desktop Utility, simply click on the Refresh Screen button.
    When you’re done with spying, click Add to Object Repository to save the captured objects in Katalon Studio.

  6. You will be prompted to save the captured objects in the Object Repository of Katalon Studio. Select a preferred location, then click OK to continue.

  7. The captured objects are added to the preferred Object Repository Folder accordingly.

  8. Click OK at the bottom of the dialog box to finish your spying session.


    1. Remember not to lock your screen while spying, recording or executing a test on a desktop application.
    2. You're recommended not to run multiple applications simultaneously.
    3. To start a UWP application, the application's execute file should be:
    • ApplicationID if your app is published on Microsoft store
    • PackageFamilyName!Application ID if your app is still in development.