Skip to content

rshk/python-libxdo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python bindings for libxdo

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

Documentation is hosted on Read The Docs:

http://python-libxdo.readthedocs.org/

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:

https://rshk.github.io/python-libxdo

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!')

Compatibility

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

Installation

The package is available on pypi https://pypi.python.org/pypi/python-libxdo/

Install via pip:

pip install python-libxdo

Install the tarball directly from github:

pip install https://github.com/rshk/python-libxdo/tarball/master

Install in development mode from git:

pip install -e 'git+https://github.com/rshk/python-libxdo.git#egg=python-libxdo'