Overview

wdotool.py is a simple replacement for xdotool suitable for Wayland desktops. It uses Gnome Remote Desktop and libEI APIs to synthesize keyboard and mouse input.

Setup instructions

The following instructions assume an externally-managed Python environment:

• Install Python dbus and venv:

  sudo apt install python3-dbus python3-venv

• Set up a virtual environment:

  This command creates a new directory called venv within your current directory:

  python3 -m venv --system-site-packages venv

• Activate it:

  . venv/bin/activate

• Install snegg (libEI Python bindings):

  pip3 install git+http://gitlab.freedesktop.org/whot/snegg

Using the tool

• Activate the virtual environment:

  . venv/bin/activate

• Run:

  ./wdotool.py [options] (specify the path if you're in a different directory from the script)

• Help:

  ./wdotool.py --help

• Deactivate the virtual environment:

  When finished, deactivate the environment by closing the shell or by running this command:

  deactivate

Examples

• Click at a location:

  ./wdotool.py --move_to 100 100 --click

• Wait a few seconds to give the user time to select a window, then scroll it:

  ./wdotool.py --sleep 3 --scroll_discrete 1

• Type "Hello World", assuming a US English keyboard for which 42 is the left Shift key and the other constants below are the letters of "hello world":

  shCopy

  ./wdotool.py \
    --key_down 42 \
    --type 35 \
    --key_up 42 \
    --type 18 38 38 24 57 \
    --key_down 42 \
    --type 17 \
    --key_up 42 \
    --type 24 19 38 32