Skip to main content


Project description


WADLibrary is a Application testing library for Robot Framework that utilizes Win App Driver.

This library was created to be able to work with multi-window use cases compared to Appium.

Getting Started

System Requirements

  • Windows 10 PC
  • Python 3
  • Robot Framework

Install the package

pip install robotframework-wadlibrary

Setting up WinAppDriver

  1. Download Windows Application Driver installer from
  2. Run the installer on a Windows 10 machine where your application under test is installed and will be tested
  3. Run WinAppDriver.exe from the installation directory (E.g. C:\Program Files (x86)\Windows Application Driver)

Windows Application Driver will then be running on the test machine listening to requests on the default IP address and port ( WinAppDriver.exe can be configured to listen to a different IP address and port as follows:

WinAppDriver.exe 4727
WinAppDriver.exe 4725
WinAppDriver.exe 4723/wd/hub

Note: You must run WinAppDriver.exe as administrator to listen to a different IP address and port.

Running the Demo

This repo includes a demo that runs a automated script with Windows 10s included calculator and paint app. To run the demo you don't need to start up WinAppDriver beforehand since the test will do it on its own. Note that if you have installed the driver in a non-default path you have to submitt the driver path with the driver_path variable in the import.

You can also start the driver manually for debugging or just to see the driver output. Follow the intructions inside the test file and start the driver manually before running any tests.

path_to_repo/Demo robot wadlibrary_demo.robot

Useful tools

This is my first python package so many things are not fixed yet, such as requirements.

Looking for Keyword Documentation? There is none! (Yet) For now you'll have to simply look in the keyword file.

I've included a simple demo that shows how to use the main feature (compared to appium), i.e. switching between windows.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robotframework-wadlibrary-20.6.4.tar.gz (5.9 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page