The 2-minute Difference Testing tutorial with our demo application

If you have downloaded the ReTest demo, then you have a zip file. After unzipping you will find three folders:

  1. retest contains all data from ReTest and should remain unchanged.
  2. retest-workspace contains all the work data from ReTest: Configurations, action sequences, tests, suites, reports, log files, ...
  3. system-under-test contains the application to be tested, in this case a small demo.

Open the folder retest and, depending on the operating system, doubleclick the file retest-gui.bat (Windows) or (Linux / Mac). Then ReTest should start and the start screen should open. If you encounter any problems, please contact or send an e-mail to

ReTest start screen

As you can see, the menu is on the left. It can be displayed and hidden by clicking on the ReTest logo. To the bottom of the menu you will find a link to our support. In the right section you will see a small explanation, which changes depending on the menu point currently open and gives help and tips. These explanations can be displayed and hidden in the menu of the ... button in the upper right corner by clicking on 'Show description'.

Capture and convert a test

To capture a small test, simply click on "Record Action Sequence" in the menu.

ReTest View 'Record Action Sequence'

In the view that opens, you can e.g. click on "Start recording". Then the login window of our demo application opens.

SUT login screen

Here you can login with user name "Max" and password "ReTest". Now e.g. try to edit a value in the table. Click on "Stop application" and then "Save ..." to save your new test under any name.

Then click "Convert Action Sequence" from the menu.

ReTest View 'Convert Action Sequence'

This view allows you to re-run your newly-recorded action sequence. This will convert it to an executable suite and provide it with status information about the SUT. To do so, select your created action sequence and press "Convert action sequence". You can now see how ReTest replays the sequence.

Test and review

Now you can run your suite by selecting the "Run suite" menu item.

ReTest View 'Run Suite'

Select your newly created suite and press "Run Suite". The suite is replayed again - and afterwards the "Review test report" menu item is opened automatically and the execution results of your suite are displayed.

ReTest View 'Execute Suite'

In the left part of the view you can see a tree structure, which you can expand by clicking on the tree items. At the top level, you see suites, then tests, then individual actions, then changed UI elements. As you can see, we also use color coding: Green means there was no change after the execution of a test step, yellow means there were changes.

As you can see, there were already changes - so the first three test steps are highlighted in yellow. Open the tree structure and navigate, e.g. to the first action "Start SUT".

ReTest View 'Review Report'

As you can see, the changes come from the display of the time on the login dialog of the SUT. Since time changes continuously, it makes no sense to accept this change. Instead, click the "Ignore" check box in the table column to permanently ignore the text attribute of this element, or ignore the entire UI element and all child elements permanently by clicking on the "Ignore element permanently" checkbox.

ReTest View 'Review Report' with Ignored Attribute

In both cases, you can see how the complete report now turns green, since ReTest automatically applies the same changes to all affected UI elements. To apply these changes permanently, click "Apply Changes".

ReTest Dialog der an einen 'Commit' erinnert.

A small dialog box will appear that shows all the changed files in detail, and reminds you to "commit" them should you have a version management system for your tests.

Click again on the "Execute Suite" menu item and run your suite again.

ReTest View 'Review Report' without changes

As you can see, the suite is completely green - meaning there were no changes. If you want to see which elements and attributes are currently ignored by ReTest, just click on the "Ignore UI element" menu item.

ReTest View 'Ignore UI element' with the elements just added

Next, you can record more complex tests and suites and interactively debug your recordings. Or you can complete our 2 minute Surili tutorial with the ReTest Demo.