Quick Start to SikuliX (Sikuli Script)

What is SikuliX?

SikuliX automates anything you see on the screen of your desktop computer running Windows, Mac or some Linux/Unix. It uses image recognition powered by OpenCV to identify and control GUI components. You can both automate desktop or web applications regardless of any technology. It is useful when there is no easy access to a GUI’s internal or source code.

Sikuli was an open-source research project at the User Interface Design Group at MIT.

For more information, please visit http://www.sikulix.com/

How to Install Sikuli?

First you should install JAVA JRE 7 or 8. Then, go to http://www.sikulix.com/ and click to button under Get it section.


Then, it redirects you to Launchpad.net website (https://launchpad.net/sikuli/sikulix/1.1.0) and on that site click to sikulixsetup-1.1.0.jar


Then, you should save SikuliX setup .jar file into a folder. I prefer to create a SikuliX folder under C drive and save in under this folder.


Then, double click to sikulixsetup-1.1.0.jar file. You will see below window and select checkbox-1 and click “Setup Now”.


Then, Silulix-Setup: question popup will appear and click “Yes”.


Then, you will install Jython version 2.7.0


Then, you will see below screens and finally SikuliX will be installed.



Then, you will click OK button in below popup.


Then you will see below warning screen. It tells us Setup have ended successfully.


Also, we can open SikuliX-1.1.0-SetupLog.txt file and check status of installation.


Finally, our folder structure will be like that.


When you click sikulix.jar, Sikulix will start.



How to Use SikuliX?

I will show you a very basic example that shows you how to use SikuliX. When you open SikuliX IDE, on the right pane, you can see three sections. Find, Mouse Actions and Keyboard Actions. These are the main functionalities and I listed their explanation on below picture.


In below example, I will open Chrome browser and go to www.swtestacademy.com and then when it is open, I will prompt a popup that says “Congrats! You opened swtestacademy.com”.


Test Result:


Reference Tutorials and Documentations





Video Tutorial Series

1- Intro & Setup: https://www.youtube.com/watch?v=VdCOg1bCmGo

2- The Basics: https://www.youtube.com/watch?v=I-UYoezac4Q

3- Conditional Automation: https://www.youtube.com/watch?v=vuqfDdPlI88

4- Conditional Looping: https://www.youtube.com/watch?v=Bb513yh6RGE

5- Game Example: https://www.youtube.com/watch?v=xTTIikzxFfc

By |2018-12-04T22:59:04+00:00February 17th, 2016|Test Automation|4 Comments

About the Author:

Onur Baskirt is a senior IT professional with 10+ years of experience. He worked at Bahçesehir University, ST Microelectronics, Huawei and Ericsson as a research assistant, design verification engineer, and software test leader. Also, he worked as software test leader and software operations manager at Turkey's biggest technology retailer, Teknosa. After Teknosa, he worked as Head of Software Testing and Manager of two Development Teams at Kariyer.net. Now, he is working as a Senior Technical Consultant at Emirates Airlines in Dubai. His current research areas are technical software testing, programming, and computer science. Formerly, he has several research works and papers on digital chip design & verification. His hobbies are sport, dancing, traveling, and nutrition. You can find detailed information about him on his linked-in page.


  1. Mehmet September 2, 2016 at 3:37 pm - Reply

    pratik ve güzel bir anlatım olmuş teşekkürler.

    • Onur Baskirt September 2, 2016 at 8:09 pm - Reply

      Ben teşekkür ederim Mehmet. Makaleyi beğendiğine çok sevindim. Faydası olduysa ne mutlu.

  2. Yunus November 8, 2017 at 8:24 am - Reply

    well done Onur, great thanks

Leave A Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.