ydotool

Generic Linux command-line automation tool (no X!)

Forked to try to clean up the code and use a single GNU Makefile instead of CMake and convert to C code to avoid need for extra C++ libraries (libevdevPlus and uInputPlus), by using uinput directly from the linux kernel.

Contents

• Usage
• Examples
• Notes
• Build

Usage

In most times, replace x with y. :P

Currently implemented command(s):

• type - Type a string
• key - Press keys
• mouse - Move mouse pointer to absolute position
• click - Click on mouse buttons
• touch - Touch
  • tap - Tap for Touch
  • swipe - Swipe for Touch

Examples

Type some words:

ydotool type 'Hey guys. This is Austin.'

Switch to tty1:

ydotool key ctrl+alt+f1

Close a window in graphical environment:

ydotool key Alt+F4

Move mouse pointer to 100,100:

ydotool mouse 100 100

Mouse right click:

ydotool click 2

Touch screen:

ydotool touch tap 800 600

ydotool touch swipe 800 600 850 650 1000

Notes

Runtime

This program requires access to /dev/uinput. This usually requires root permissions.

You can use it on anything as long as it accepts keyboard/mouse/whatever input. For example, wayland, text console, etc.

About the --delay option

ydotool works differently from xdotool. xdotool sends X events directly to X server, while ydotool uses the uinput framework of Linux kernel to emulate an input device.

When ydotool runs and creates an virtual input device, it will take some time for your graphical environment (X11/Wayland) to recognize and enable the virtual input device. (Usually done by udev)

So, if the delay was too short, the virtual input device may not got recognized & enabled by your graphical environment in time.

In order to solve this problem, I made a persistent background service, ydotoold, to hold a persistent virtual device, and accept input from ydotool. When ydotoold is unavailable, ydotool will work without it.

Build

Dependencies

• make
• gcc

Compile

make -j $(nproc)

Install

sudo make install

Yocto Support

Copy the recipe to meta layers
add the package to local.conf
bitbake

Connect the USB to i.MX8 and PC
run "adb_init"
This will make adb up.

Then Launch "uinput_init"
This will make necessary setup for the Java application to work

Make sure the uinput driver is added to the kernel

Launch the java app