How to simulate key press and mouse movement in Linux

Have you ever dreamed of your computer doing stuff automatically for you? Probably not if you just watched Terminator. But except for that, scripting and task automation are every power user's dreams. If a lot of solutions exist today to fit such goal, it is sometimes hard to pick the simple, smart, and efficient one out of the lot. I cannot pretend to have found it myself, but in the mean time, my preference goes to neat software called xdotool. Its approach is intuitive as it stands as an X11 automation tool. In other words, xdotool can simulate key presses and even mouse events from reading a text file.

Installation of Xdotool on Linux

For Ubuntu, Debian or Linux Mint, you can just do:

$ sudo apt-get install xdotool

For Fedora, use yum command:

$ sudo yum install xdotool

For CentOS user, the package is available in EPEL repo. After enabling EPEL repo, simply use yum command as above.

For Arch user, the package is available in the Community repo:

$ sudo pacman -S xdotool

If you cannot find xdotool for your distribution, you can always download it from the official website.

Basic Usage of Xdotool

As intuitive as it is, xdotool remains a scripting application. Hence you have to know the syntax in order to use it properly. Rest assured though, the syntax is very simple and quick to pick up, relative to the extent of the program's features.

First, it is very easy to simulate key press. From the terminal, you can type the command:

$ xdotool key [name of the key]

If you want to chain two keys, use the "+" operator between them. So:

$ xdotool key alt+Tab

will switch window for you.

To have xdotool type for you, use the type command:

$ xdotool type ''

That's already enough for basic key pressing. But one of the many strengths of xdotool is its ability to put the focus on a particular window. It can fetch the right window, and then type in it, preventing all your recorded keystrokes to just vaporize in thin air. For this, the simplest command is:

$ xdotool search --name [name of the window] key [keys to press]

This will search through the opened window for one with the name matching the search, give it the focus, and then simulate the key pressing.

A bit more advanced, but very useful, xdotool can simulate mouse movement and click. With:

$ xdotool mousemove x y

you can place the cursor at coordinates (x,y) of your screen (in pixels). You can also combine it with the "click" argument:

$ xdotool mousemove x y click 1

This will move the mouse to (x,y), and click with the left button. The "1" represents the left button of the mouse, "2" would be the scroll wheel, "3" the right button, etc.

Finally, once you have your commands in mind, you might want to actually dump it in a file to edit and play. For that, there is more than one syntax. You can write is a bash script:


xdotool [command 1]
xdotool [command 2]

Or you can use:

$ xdotool [filename]

where you write your commands in a separate file and plug its name as the argument.


As a bonus to this post, here is a concrete example of xdotool in action. You may or may not have heard of Bing, the Microsoft's search engine. In the latter case, you have then never heard of Bing Rewards: a program that allows you to trade Bing points for Amazon's and other gift cards. To earn those points, you can do up to 30 searches a day on Bing, each search giving you 0.5 point. In other words, you have to make Bing your default search engine, and use it every day.

Or, you can use this xdotool script, which will automatically give focus to Firefox (replace it with your favorite navigator), and perform a search using the fortune command to generate some random words. In about 30 seconds, all your daily searches will be done.


for i in {1..30} 
  WID=`xdotool search --title "Mozilla Firefox" | head -1` 
  xdotool windowfocus $WID 
  xdotool key ctrl+l 
  xdotool key Tab 
  SENTENCE="$(fortune | cut -d' ' -f1-3 | head -1)" 
  xdotool type $SENTENCE 
  xdotool key "Return" 
  sleep 4 

To conclude, I really like xdotool even if its full capabilities extend way beyond the scope of this post. It is a really approachable way to scripting and task automation. The downside is that it probably is not the most efficient one. But again, it does the job, and isn't too much of a bother to learn.

What are your thoughts on xdotool? Do you prefer another automation tool to it? And why? Let us know in the comments.

Subscribe to Xmodulo

Do you want to receive Linux FAQs, detailed tutorials and tips published at Xmodulo? Enter your email address below, and we will deliver our Linux posts straight to your email box, for free. Delivery powered by Google Feedburner.

Support Xmodulo

Did you find this tutorial helpful? Then please be generous and support Xmodulo!

The following two tabs change content below.

Adrien Brochard

I am a Linux aficionado from France. After trying multiple distributions, I finally settled for Archlinux. But I am always trying to improve my system by stacking up tips and tricks.

Latest posts by Adrien Brochard (see all)

7 thoughts on “How to simulate key press and mouse movement in Linux

  1. I like the behaviour of tilda very much: F1 and it appears, F1 and it disappears. So I emulate it for the editor. I assigned this script to a key:

    wid=`xdotool search --onlyvisible --name 'Sublime Text'`
    if test "$wid" = ""
    exec sublime_text &
    actual=`xdotool getactivewindow`
    if test $wid = $actual
    xdotool windowminimize $wid
    xdotool windowactivate $wid

  2. This tool sounds handy for programmers where they want to run a set of tests on code, for example send a user name and password to a login screen, then once logged in, execute a menu command, then enter some info into a screen, then do something else, and finally end the program with an expected result.

  3. I have a script in Ubuntu which opens firefox and automatically opens a particular website which is set as home page but since i'm running it on a slow thin client sometimes the browser loads up a blank page. By pressing firefox home button the home page appears. I've tried to use the following; xdotool key alt+Home but nothing happens. Does anyone know how to map home keyboard button in xdotool?

Leave a comment

Your email address will not be published. Required fields are marked *