Project

xdo

0.02
Repository is archived
No commit activity in last 3 years
No release in over 3 years
XDo is a library to automate your mouse, fake keyboard input and manipulate windows in a Linux X server environment. It's wrapped around a lot of command line tools (see requirements) of which xdotool is the main one, the others are usually installed. It's designed to work only with Ruby 1.9.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 2.0
 Project Readme

Automations

First, this is the general README. READMEs for au3 and xdo exist in their subdirectory.

What’s Automations?

Automations is a project targeting input automation for Ruby. You can simulate mouse and keyboard input, access windows as objects and do some other nice things you would have to do by hand otherwise. This is also the main point why the Automations project exists: It aims at helping you to automize (hence the name) some long process for which you probably just sit in front of your screen and hit Enter, select something, hit Enter again, click a button, and so on. If you don’t want to do this over and over again, then Automations is the solution to a Ruby programmer.

What’s needed?

Currently, the Automations project supports both Linux X Server systems and the Microsoft® Windows® platform. If you want to run Automations on Windows®, you need to download the au3 gem. It’s based on the C interface of the AutoIt scripting language, so you’ll need the DLL file AutoItX3.dll which can be easily obtained by downloading AutoIt and then copying the file from the AutoItX subdirectory into your Ruby installation’s bin directory. After that, you should be able to start using au3 by doing a require "au3".

For Linux X Server systems you need, beside the xdo gem, command line tools like xdotool. (see the Wiki for a full list). Ubuntu and Debian users may try to obtain that tools via aptitude, apt-get, the Synaptic GUI or whatever package manager you prefer. Others will have to compile xdotool. Get it from http://www.semicomplete.com/projects/xdotool/ and follow the instructions in the INSTALL file.

Example of usage

Windows®

require "au3"
AutoItX3.move_mouse(100, 100)
AutoItX3.send_keys("AB{ESC}c") #Sends A, B, [ESC], and c
win = AutoItX3::Window.new("Paint")
win.move(25, 25)
win.close

Linux

require "xdo/mouse"
require "xdo/keyboard"
require "xdo/xwindow"
XDo::Mouse.move(100, 100)
XDo::Keyboard.simulate("AB{ESC}c") #Sends A, B, [ESC], and c
xwin = XDo::XWindow.from_name("README")
xwin.move(25, 25)
xwin.close

What’s planned for the future?

  • An equivalent API. XDo::Mouse should have an equivalent AutoItX3::Mouse.
  • Getting rid of AutoIt. Currently I try to conquer the Windows API for that purpose.
  • Getting rid of xdotool. I’m currently working on this in a separate repo, look at http://www.github.com/Quintus/imitator.
  • Combining au3 and xdo into a single gem.

Contact

If you want to contact me, for whatever reason, bugs, contributing, just email me at
sutniuq@@gmx@net.

Initia in potestate nostra sunt, de eventu fortuna iudicat.