Psynteract OpenSesame integration

Easily build real-time interactive experiments with OpenSesame.

This repository provides the OpenSesame integration of the psynteract library. The documentation of the package can be found in its own repository.

---

psynteract-os is developed jointly by Pascal Kieslich and Felix Henninger, with a focus on the OpenSesame integration and the underlying Python library and backend, respectively. It is published under the GNU General Public License (version 3).

Installation

Please select which version to install depending on which OpenSesame version you are using:

• For OpenSesame versions up to 3.2.8, install the latest stable version
• For OpenSesame versions 3.3.0 or later, install the current development version

Latest stable version

To install the latest release, please run the following commands in OpenSesame's debug window:

import pip
pip.main(['install', '--process-dependency-links',
  'https://github.com/psynteract/psynteract-os/archive/stable.zip'])

You'll need to restart OpenSesame after the installation for the plugins and extension to work.

If the installation fails due to missing write access, you may have to run OpenSesame with administrator privileges for the installation (on Windows, right-click the OpenSesame program icon and select Run as Administrator).

If you are using a recent version of OpenSesame for Mac OS, you might need to change the installation command and replace it with the following command (as OpenSesame for Mac OS uses a newer version of the pip package):

import pip._internal
pip._internal.main(['install', '--process-dependency-links',
  'https://github.com/psynteract/psynteract-os/archive/stable.zip'])

The installation of plugins is covered in more detail in the OpenSesame documentation, which also covers alternate methods. To install the package manually, please download the archive attached to the latest release. In this case, you'll need to install psynteract-py and its dependencies manually.

Release notes for the latest version are available, as for all previous releases.

Development version

To install the latest development version in OpenSesame 3.3.0 or later, please follow the above instructions, replacing the command with the following (which is still entered in OpenSesame's debug window):

!pip install https://github.com/psynteract/psynteract-os/archive/master.zip

Citation

Please drop us a line if you've used the library: We sincerely love to hear from our users!

If you use psynteract in your published research, we kindly ask that you cite the associated article as follows:

Henninger, F., Kieslich, P. J., & Hilbig, B. E. (2017). Psynteract: A flexible, cross-platform, open framework for interactive experiments. Behavior Research Methods, 49(5), 1605-1614. doi:10.3758/s13428-016-0801-6

Acknowledgments

We would like to thank Anja Humbs at the University of Mannheim Chair of Experimental Psychology for her help in selecting the icons and testing the plugins, Luisa Horsten and Sina Klein at the University of Landau Cognition Lab, and Hosam Alqaderi and Susann Fiedler at the Max Planck Institute for Research on Collective Goods, Bonn, for testing the software and providing valuable feedback.

This work was supported by the University of Mannheim’s Graduate School of Economic and Social Sciences, which is funded by the German Research Foundation.

Shoulders of giants

Psynteract depends heavily on several additional libraries. In particular, we are indebted to the authors of and contributors to PyCouchDB (written by Andrey Antukh) and Requests (by Kenneth Reitz and collaborators). The OpenSesame integration also incorporates our own Python library.

Of course, none of this would be possible without the excellent work of the OpenSesame development team led by Sebastiaan Mathôt.

The icons for psynteract-os are based on the Moka Icon Theme (by Sam Hewitt), and contain elements from the Faenza Icon Set (by Titheum), both of which make us look undeservedly professional.