The Tellurium Automated Testing Framework (Tellurium) is a UI module-based web automated testing framework. The UI module is a collection of UI elements you group together. Usually, the UI module represents a composite UI object in the format of nested basic UI elements. For example, the Google search UI module can be expressed as follows,

ui.Container(uid: "GoogleSearchModule", clocator: [tag: "td"], group: "true"){
InputBox(uid: "Input", clocator: [title: "Google Search"])
SubmitButton(uid: "Search", clocator: [name: "btnG", value: "Google Search"])
SubmitButton(uid: "ImFeelingLucky", clocator: [value: "I'm Feeling Lucky"])

The UI module makes it possible to build UI elements' locators at run time. The framework does Object to Locator Mapping (OLM) automatically at run time so that you can define UI objects simply by their attributes, i.e., Composite Locators denoted by the "clocator". Furthermore, Tellurium uses the Group Locating Concept (GLC) to exploit information inside a collection of UI components to help finding their locators and the GLC is denoted by the "group" attribute in the above UI module.

Tellurium is really easy to use and maintain, here I like to show you how to create a new Tellurium test
project and run the test cases in 5 minutes or less.

First, you should add Tellurium repository to your Maven settings.xml file, usually it is at Your_Home/.m2/.

<name> Public Snapshot Repository</name>
<name> Public Releases Repository</name>

Then run the following maven command to create a new Tellurium test project "deom",

mvn archetype:create -DgroupId=example -DartifactId=demo -DarchetypeArtifactId=tellurium-junit-archetype

Then open the project up with IDE, for example, IntelliJ IDEA using the following steps,

New Project > Import project from external model > Maven > Project directory > Finish

You should see the project includes the following files,


Where TelluriumConfig.groovy is Tellurium configuration file, GoogleSearchModule is the sample UI module file
, and GoogleSearchTestCase is the sample Tellurium test file. You should check Groovy setting in your project
and make sure its version is 1.6.0. After that, you are ready to run the sample test file.

What is the next? You can use Tellurium Firefox Plugin (TrUMP) to automatically generate UI modules for you
and add your own test methods there. TrUMP is available from Tellurium web site at

or you can download it directly from Firefox addons site at

If you run into any problems with the examples, please post them to Tellurium user group at

A more detailed presentation "10 minutes to Tellurium" is available online at