The tutorial has moved to our new website:

Note: the reference documentation, listing and describing all the PennController commands, can be found here.

This wiki is meant as support material for workshops on PennController 1.1, which is included in each sample trial you will sync from GitHub, as described in the Setup sections of each Sample trial page. If you would rather create a new project from scratch using PennController, you can directly download PennController.js here and upload the file under js_includes in your Ibex project.

Requirements / Preparation

Web Browswer

First of all, you need to make sure that you are using a web browser that is compatible with PennController beta 1.0. Avoid using Internet Explorer or Edge. As for Safari, the library will only work with most recent versions of the browser. Prefer Firefox or Chrome, ideally in their desktop versions (i.e., not Android / iOs). We are working on a cross-browser / cross-platform development of PennController, but it is still limited for the moment. Nonetheless, we have never fallen short of participants even with such requirements (just make sure you invite them to use the proper browsers).

Ibex account

You can create an account on Ibex Farm (alternatively, you also have the option of downloading it and running locally or on your own server).
Simply follow the instructions on the page. Ibex Farm does not share your email with anyone and never sends you emails other than for password retrieval purposes.

Once you have created your account, you can create a new project by clicking Create a new experiment. When you click the link of the experiment you created, you arrive on a page listing folders ending with _includes (boldface) for most of them, and files ending with .html, .css or .js. It can be a good idea to take a look at Ibex’s documentation to get a better understanding of the structure of a project, but keep in mind that PennController trials do not follow the same conventions as built-in types of trials (what Ibex calls controllers).


Congratulations, you are all set! You are now ready to start reading the tutorials and/or attend the workshop!

Let’s start with creating our first sample trial.