Documentation

How to Download and Install WinAppDriver

Windows Application Driver (WinAppDriver) is a service developed by Microsoft that enables Selenium-like UI test automation for Windows applications. It allows users to interact with desktop applications.

Before installing WinAppDriver, you must enable Developer Mode on your system. Here’s how you can do it:

Enable Windows Developer Mode

1. Open the Settings app in Windows.
2. Navigate to Update & Security > For Developers.
3. Select Developer mode to enable it.

Note: These steps apply to Windows 10 and Windows 11. The steps to enable Developer Mode may vary based on your Windows version. For detailed instructions, refer to Microsoft’s official guide: Enable Developer Mode on Windows

Download and Install WinAppDriver

To use the WinAppDriver for desktop automation, follow these steps to download and install it:

Download the installer

Visit the following link to download the latest version of WinAppDriver: WinAppDriver Download

Run the Installer

1. Locate the downloaded file (e.g., WindowsApplicationDriver_1.2.1.msi) in your Downloads folder.
2. Double-click the downloaded file to launch the installer.
3. Follow the on-screen instructions to complete the installation.

Note: You may be asked to enter administrator credentials during the installation.

Run WinAppDriver

To use the driver with a desktop application such as Excel, follow these steps:

1. Navigate to the installation folder. The default location is:

C:\Program Files (x86)\Windows Application Driver\WinAppDriver.exe

Note: The installation path may vary depending on your system configuration.

2. Copy path of the exe file. To do so, right-click the .exe file and select Copy as Path.

3. Locate the Desktop Application:
   • Open File Explorer on your system.
   • Navigate to the folder where the target application is installed (e.g., Excel). Typically, the path is:
     C:\Program Files\Microsoft Office\root\Office16

Note: The exact path may vary depending on your version of Windows and Microsoft Office.

4. Open the Command Prompt (CMD).

5. Run the Driver:
   • In the Command Prompt window, paste the full path to the exe file that you copied earlier in step 2, enclosed in double quotes.
     C:\Program Files (x86)\Windows Application Driver\WinAppDriver.exe
   • Press Enter to start the driver.

Note: The WinAppDriver runs on the default IP address (127.0.0.1) and port (port 4723 here), so make sure no other application is using this IP-port combination to avoid conflicts.

To change the default IP address or port number, click here to learn how to configure IP address and port.

Make sure the driver is running before you start executing desktop automation.

Configuring IP Address and Port

By default, WinAppDriver run on:

• IP Address: 127.0.0.1
• Port Number: 4723

To avoid conflicts or to suit your environment, you can update the IP address, port number, or both.

Change Port Number Only

1. Navigate to the folder where the WinAppDriver.exe file is located.
2. Open Command Prompt in that directory.
3. To update the Port number when launching the WinAppDriver, use the following command structure in Command Prompt:

WinAppDriver.exe [Custom PORT]

Note: Replace [Custom PORT] with the custom port number you’re using (e.g., WinAppDriver.exe 4725).

4. Hit Enter key.

Update Only the IP Address (uses default port)

1. Navigate to the folder where the WinAppDriver.exe file is located.
2. Open Command Prompt in that directory.
3. To update the IP address when launching the WinAppDriver, use the following command structure in Command Prompt:

WinAppDriver.exe [Default PORT] [Custom IP_ADDRESS]

Note: Replace [Default PORT] with the default port number and [Custom IP_ADDRESS] with the custom IP address you’re using (e.g., WinAppDriver.exe 4723 10.10.32.10).

4. Hit Enter key.

Update Both IP Address and Port

1. Navigate to the folder where the WinAppDriver.exe file is located.
2. Open Command Prompt in that directory.
3. To update the IP address when launching either the WinAppDriver, use the following command structure in Command Prompt:

WinAppDriver.exe [Updated PORT] [Updated IP_ADDRESS]

Note: Replace [Custome PORT] and [Custom IP_ADDRESS] with the custom port number and IP address you’re using (e.g., WinAppDriver.exe 4725 10.10.32.10).

4. Hit Enter key.

Launching a Desktop Application for Automation

Once the driver is running, go back to your HuLoop automation and use the Open Desktop Application action to launch and automate your target desktop application.