Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Cross Platform GUI Test Automation tool.

Project Description

This library supports UI-related testing using Python on Windows and Mac OS. (Only Python x86 is supported)

How to use examples:

  • Calculator:
from uisoup import uisoup

calculator = uisoup.get_window('Calculator')

calculator.drag_to(50, 50, x_offset=30, y_offset=5)
b1 = calculator.find(c_name='btn2')
ba = calculator.find(c_name='btnAdd')
b2 = calculator.find(c_name='btn3')
be = calculator.find(c_name='btnEquals')
  • Notepad:
from uisoup import uisoup

# You can use wildcard in names such as "?" and "*".
notepad = uisoup.get_window('*Notepad')

kc =
uisoup.keyboard.send(kc.SHIFT.modify(kc.KEY_H), kc.KEY_E, kc.KEY_L,
                     kc.KEY_L, kc.KEY_O, kc.SPACE, kc.KEY_W, kc.KEY_O,
                     kc.KEY_R, kc.KEY_L, kc.KEY_D,

Also adds ui-inspector script that allows you to inspect UI elements. Just type it in terminal.


UISoup 2.5.5 (released 01 Jun 2017)

  • Fixes: fix issue #19 that blocks __str__ method of element.

UISoup 2.5.4 (released 14 Apr 2017)

  • Additions: added support for Python3.
  • Additions: docstrings were updated.

UISoup 2.4.3 (released 15 Apr 2015)

  • Additions: fixed mouse double click.

UISoup 2.4.2 (released 8 Apr 2015)

  • Additions: updated with smooth mouse move.
  • Additions: updated with delay between key press in Keyboard.send() method.

UISoup 2.4.1 (released 4 Mar 2015)

  • Mac OS Additions: added new element role “AXLink”.
  • Mac OS Additions: fixed issue when we getting fail on execution “get attribute “AXURL” of UI element” string.

UISoup 2.4 (released 5 Feb 2015)

  • Mac OS Additions: fixed issue when we can’t work with windows that have double quotes in name.

UISoup 2.2 (released 16 Dec 2014)

  • Mac OS Additions: added ability to see AXDialog windows.
  • Mac OS Additions: fixed issue when incorrect applescript specifier was constructed.

UISoup 2.0 (released 20 Jun 2014)

  • Mac OS Additions: added version for Mac OS.

UISoup 1.0 (released 28 Mar 2014)

  • Windows Additions: initial version for Windows.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(24.8 kB) Copy SHA256 Hash SHA256
Source None Jun 1, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting