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!

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:

OS Architecture libxdo version Date Test result
Debian GNU/Linux “jessie” (testing) amd64 3.20130111.1-3.1   ✓ success
Archlinux amd64 3.20150503.1 2015-11-16 ✓ 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+'

Release History

This version
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
(21.8 kB) Copy SHA256 Hash SHA256
Source None Mar 12, 2016

Supported By

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