« | Main | »

About the JILRun Example Script

By Jewe | January 1, 2014

About the JILRun Example Script.

I have included an example script application in the archive, just to show what can be done with the JILRun runtime environment. It is a “Slide Show” application that will work with even the largest amount of image collections.

In order for the script to work, you’ll need IrfanView installed in your “Program Files” or “Program Files(x86)” directory.

Why a slide show script?

Well, it’s just an example of what can be done. I’ve made this because none of the image viewers I tried can handle large amounts of image files very well. Plus, I wanted a slightly different way how randomized slideshows are implemented.

The application will randomly pick one folder at a time and then show a predefined number of images from that folder in consecutive order. Once the number of images have been shown, another folder is randomly picked. The script will make sure every folder is only shown once.


The application uses folder lists in XML format. Next to other settings, each XML file contains a list of folders with image files. You can understand a folder list as a “slide show theme”. You could have a file for “Houses”, one for “Cats” and one for “Landscapes” for example.

In order to easily create such an XML file, there is a script called “MakeFolderList”. Just specify one or more directories that contain image files to this script. The script will recursively search these directories and add them to a new XML file.

You can also have MakeFolderList perform a regular expression search in order to filter for specific file names. See the file “Example.folders.xml” to learn more about that.


If you have specified tags to the image folders contained in one XML file, you will probably want to copy these over to another XML file that may also contain some of those image folders.

This can be done by using the “MergeTags” script. Just specify the source XML file and the destination XML file as parameters.

If an image folder is tagged in both files, their tags are combined and stored in the destination file. Nothing will be overwritten or lost.


To run a slide show, simply run the RandomShow script and specify the XML file of the folder list you wish to view.

To do this from the command-line prompt, open “CMD” from the start menu and go to the directory where you have extracted the archive. For simplicity, I’m assuming you have placed the tool in the directory “C:\jilrun”.

If you decide to extract the archive into your “Program Files” or “Program Files (X86)” folder, make sure to set write permission to that directory. Otherwise “MakeFolderList” will not be able to save anything.

Alternatively, you can also move the “Example” folder to your “My Documents” folder. The script is programmed so that it will save XML files in the same directory where the script is.

REM Change to the example folder:
> cd \jilrun\example
REM Run jilrun with MakeFolderList.jc and your "My Pictures" folder as arguments:
> C:\jilrun\jilrun.exe makefolderlist.jc c:\users\myname\pictures
REM This will create "pictures.xml" in your example folder. Start it like this:
> C:\jilrun\jilrun.exe randomplay.jc pictures.xml

While you can do all this from the command-line prompt, it would be easier to make shortcuts in LaunchPad for this.

Topics: docs | Comments Off on About the JILRun Example Script

Comments are closed.