SikuliX and Java Getting Started Video

Automation Testing Published on:

I recently spoke with the main developer and maintainer of SikuliX, Raimund Hocke, on Episode 40 of my TestTalks podcast. What's cool about SikuliX is that it allows you to automate anything you see on your screen using image-based testing. After speaking with Raimund I thought it would also be helpful to create a quick video to show you just how easy it is to get started with SikuliX.

After you try this example, be sure to listen to Raimund Hocke: Getting Started with SikuliX Image-Based Testing on TestTalks for a deeper dive into SikuliX.

For this illustration, I'll be using Java and Maven.

Create a new Maven project then add the SikuliX repository information in your pom.xml file. Since SikuliX is still under development, you'll need to add the location to the snapshot stored on OSSRH:













Next add the SikuliX and JUnit dependency information in your pom.xml file:









Next create a new class named DemoTest

Create a new folder in your project named images

Open up the DemoTest class and add the following import statements:

import org.sikuli.script.*;

import static org.junit.Assert.*;

Right click on your project and Run as Maven Install

Create a Screen instance. The Screen allows you to click on regions within the screen:

    Screen s = new Screen();

Open up your Calculator and capture images for all the areas of the Calculator that you want to interact with. For this example I'm clicking on 8 * 3 = and verifying the total of 24. Save your images to the images directory we created earlier. (I'm using Snagit to get the images.)

Next let's add the actions we want to perform against the Calculator. Pretty much everything we are doing is a click, so add the following:

import org.sikuli.script.*;

static org.junit.Assert.*;

class DemoTest {

void main(String[] args) {

        Screen s = new Screen();

     try {





            assertNotNull(“Verify correct value”, s.exists(“images/result.png”));    

        } catch (FindFailed e) {    





I also added an assertNotNull to verify the value that I expected to exist (24).

Right click on the and run as a Java Application

If everything goes as planned you should have no errors in your console output!

I hope this helps and whets your appetite for learning more about image-based testing using SikuliX. (Note: An excellent resource for learning more is Raimund's SikuliX website.)

Leave a Reply

Your email address will not be published.

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

  1. I got the error

    Exception in thread “main” java.lang.NoSuchMethodError: org.sikuli.basics.Debug.logx(ILjava/lang/String;Ljava/lang/String;[Ljava/lang/Object;)V
    at org.sikuli.script.Screen.log(
    at org.sikuli.script.Screen.initScreens(
    at org.sikuli.script.Screen.(
    at com.mindtree.demo.SikuliDemo.main(

  2. Thanks for sharing this. In a windows based browse dialog window if we need to type in the path of a file, can we use sikulix

{"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}

Latest Automation Trends: Top 13 Predictions for 2023

Posted on 01/04/2023

Welcome to my annual Latest Automation Trends: Top 13 Predictions for 2023 article. ...

Chrome Selenium Driver in Visual Studio C#

Posted on 12/21/2022

I'm sure you've all heard of Selenium by now. It's a popular tool ...

15 Reasons Why You Should (or shouldn’t) Automate a Test

Posted on 12/20/2022

Just because you can automate tests doesn’t necessarily mean that you should. In ...