Command Line

To execute slides (e.g., helloworld.pptx), type the following in the command line:

$ java -jar sikuli-slides-1.5.0.jar execute helloworld.pptx

Executing Remote Files

If the file is hosted on a remote web server, you can execute it by supplying the URL to that remote file as an argument. Sikuli Slides will try to download the file for you and executing it. For instance, suppose helloworld.pptx is hosted at the URL http://silides.sikuli.org/helloworld.pptx, you can execute this remote file as follows:

$ java -jar sikuli-slides-1.5.0.jar execute http://slides.sikuli.org/helloworld.pptx

If the file is a Google Presentation hosted on Google Drive, you can execute it by supplying its public sharing link. Make sure you have already set the file’s sharing setting as “Anyone who has the link can view”. This enables Sikuli Slides to download the file for you.

$ java -jar sikuli-slides-1.5.0.jar execute \\
   https://docs.google.com/presentation/d/1w48gExh5oLIT0J8xYXR1RxpqTrZTXJC8OR4UXxShTQ8/edit?usp=sharing

Options

There are several command line options that can be set to control the execution behavior of Sikuli Slides.

Option Description

-minscore

The minimum similarity score for a target to be considered as a match. It's a 10-point scale where 1 is the least precise search and 10 is the most precise search (default is 7).

-screen

The id of the connected screen/monitor (default is 0).

-wait

The maximum time to wait in milliseconds to find a target on the screen ( default is 5000).

-parameters

Parameters as name=value pairs joined by semi-colons. See Parameters for more details.

-range

The range of the slide(s) to execute. For instance,

  • -range 1

    executes only slide 1

  • -range 2-4

    executes slide 2 to 4

  • -range 2-

    executes slide 2 till the end

Note that the slide number is 1-based.

-bookmark

The bookmark from which to start executing.

-log

The level of log messages to print to the console. Choices are ALL, TRACE, DEBUG, INFO, WARN, ERROR, OFF (default: INFO).