AVOKE an open-source web-based experimentation toolbox for evoking audiovisual responses

AVOKE Logo

About

AVOKE is a free and open-source toolbox for creating web-based behavioural experiments. Built on top of the popular jsPsych library, AVOKE makes it easy to design experiments that use audiovisual stimuli—including videos, animations, and even YouTube clips—with precise timing and reliable data collection. Whether you’re a student, researcher, or hobbyist, AVOKE helps you build experiments quickly without needing advanced coding skills. It includes clear documentation, ready-to-use components, demo examples, and tools for collecting responses such as keypresses or webcam recordings. All features have been developed following community standards for code reusability and comprehensive documentation, and have been validated through numerous tests developed using simulate functions. We invite you to explore, use, and contribute to AVOKE to help make web experiments more creative, accessible, and reproducible!.

For more information and documentation, please visit https://github.com/beatlab-mcmaster/AVOKE.

Audio-visual-response

This plugin allows for displaying an image and playing an audio file simultaneously, and records responses generated with a button click. The included parameters allow for adjustment of trial duration, visual stimuli size, time delay before the button can be interacted with and more. The trial can be set to end when a button response is received or after the audio stimulus is finished playing.

Audio-visual-response Demo

Stimulus-matrix-display

This plugin implements a stimulus matrix display trial used for eyetracking experiments and other research studies. A target ('E' by default) appears in random locations on a customizable grid layout. The target can optionally be rotated using user-defined angles, or displayed without rotation. Participants respond with arrow keys (for rotated targets) or by clicking on targets when clickable mode is enabled. The plugin supports flexible grid sizes, both text and image targets, and uses standardized research stimuli (CFD, IAPS databases).

Stimulus-matrix-display Demo

Path-animation-display

This plugin presents an image target that moves along a path with a shape and pace determined by the experimenter. The target will begin moving after a keypress and the trial will end when the target finishes travelling along the path.

Path animation display Demo

Youtube-response

This plugin is for displaying a YouTube stream or video and records responses generated with a button click.

Youtube-response Demo

Video-capture-extension/Video-capture-setup

This extension allows for video recording in jsPsych experiments, particularly designed for webcam eye-tracking. Video files are output in .mp4 format.

Video-capture-extension Demo

Example Experiments

Below are some classic experimental paradigms replicated using AVOKE components. These examples provide open materials to demonstrate the toolbox in action and help you get started building your own experiments from scratch.

McGurk Effect

The McGurk effect is a perceptual illusion that highlights how auditory and visual information are integrated during speech perception. In this experiment, participants are presented with randomly paired audio and visual stimuli and asked to identify the perceived syllable. This implementation is built with AVOKE's audio-visual-response plugin.

McGurk effect study: McGurk & MacDonald (1976). https://doi.org/10.1038/264746a0
Experiment stimuli sourced from: Magnotti et al. (2020). https://doi.org/10.1016/j.cortex.2020.10.002

Posner Cueing Task

The Posner cueing task is a classic paradigm in attention research that investigates the spatial orienting of attention. In this experiment, participants are presented with a cue indicating the likely location of a target stimulus, allowing researchers to measure the effects of spatial attention on reaction times and accuracy. This implementation is built with AVOKE's stimulus-matrix-display plugin.

Posner Cueing Task with Webcam Video Capture

Same as the standard Posner cueing task, but with webcam video capture enabled to record videos during the fixation trial. This implementation is built with AVOKE's stimulus-matrix-display plugin along with the video-capture extension and setup plugin.