Skip to main content

Python bindings for libxdo

Project description

libxdo is the library behind xdotool, a tool to “fake keyboard/mouse input, window management, and more”.

This package aims to provide ctypes-based Python bindings (and a more pythonic way to use the C library, of course..)

WARNING The project is still work in progress! Only a small part of the library is supported, and tests / documentation are missing. Use with care (and make sure to report any issue you should find!)


Documentation is hosted on Read The Docs:

Note: there currently is a problem building the documentation on RTD due to missing libxdo library (which makes importing xdo.xdo fail). For this reason, a (locally-generated) copy of the documentation is hosted on github pages:

Example usage

Ask the user to click a window with the mouse, then write “Python rocks!” to that window.

from xdo import Xdo
xdo = Xdo()
win_id = xdo.select_window_with_click()
xdo.enter_text_window(win_id, 'Python rocks!')


The library is currently tested on:



libxdo version


Test result

Debian GNU/Linux “jessie” (testing)



✓ success





✓ success


The package is available on pypi

Install via pip:

pip install python-libxdo

Install the tarball directly from github:

pip install

Install in development mode from git:

pip install -e 'git+'

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

python-libxdo-0.1.2a1.tar.gz (21.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page