_**Note:** the reference documentation, listing and describing all the PennController commands, can be found [here][1]._ This wiki is meant as support material for workshops on *PennController beta 0.3*, which is included in each sample trial you sync from GitHub (see the *Setup* sections in each *Sample trial* page). If you would rather create a new project from scratch using PennController, you can directly download *PennController.js* [here][2] 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 0.3*. The library is known to **not** work with *Safari*. Avoid using *Internet Explorer* or *Edge*. Prefer **[Firefox][3]** or **[Chrome][4]**, 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][6] (alternatively, you also have the option of [downloading it][7] 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][8] 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*). ## Tutorials Congratulations, you are all set! You are now ready to start reading the tutorials and/or attend the workshop! Take a look at the [General Intro][9]. More advanced topics: - [Preloading resources][13] - [Using ZIP resources][14] - [Collecting audio recording samples][15] [1]: https://osf.io/e8npk/wiki/home/ [2]: https://github.com/PennController/penncontroller/blob/master/releases/beta0.3/PennController.js [3]: https://www.mozilla.org/en-US/firefox/new/ [4]: https://www.google.com/chrome/ [5]: https://cran.rstudio.com/ [6]: http://spellout.net/ibexfarm/newaccount [7]: https://github.com/addrummond/ibex [8]: https://github.com/addrummond/ibex/blob/master/docs/manual.md [9]: https://osf.io/vmjyx/wiki/01.%20General%20Intro/ [10]: https://osf.io/vmjyx/wiki/How%20to%20build%20PennController%20Trials/ [11]: https://osf.io/vmjyx/wiki/Sample%20experiment:%20Priming%20Design/ [12]: https://osf.io/vmjyx/wiki/Recruitment%20&%20Data%20collection/ [13]: https://osf.io/vmjyx/wiki/Preloading%20Resources/ [14]: https://osf.io/vmjyx/wiki/ZIP%20file%20preloading%20method/ [15]: https://osf.io/vmjyx/wiki/Collecting%20audio%20recordings/