DYE (Design Your Experiment) - PsyToolkit Listening Test Designer

Audio Files
Forced Choice
Likert Scales
Instructions
Settings

Import Stimulus List

Single file (Excel/CSV/TXT) for random order, or ZIP archive with multiple files for predefined presentation orders.

Browse...

Upload MP3 Files

Browse...

Stimulus List

Metadata Columns

Select columns to include in PsyToolkit output:

Enable Forced Choice

Number of choices:

Number of rows:

Horizontal spacing:

Vertical spacing:

Button height (px):

Timeout (ms):

Response Options

Enter text labels or upload images for each choice:

Enable Likert Scale(s)

Note: Likert scales are implemented using PsyToolkit's rate command, which displays scales only during response collection. When combining Likert scales with forced choice buttons, or using multiple Likert scales, these elements will appear sequentially rather than simultaneously in the final experiment.

Number of scales:

Global Settings

Automatic vertical spacing

Same item style for all scales

Item shape:

Item color:

Upload item image:

Browse...

Item size (px):

Item spacing (px):

Default label font size:

Scale Configuration

Instructions Page

Create the instructions shown before the listening test.

Display instructions before running task

Input method:

Rich text editor Upload image

Background color:

Default text color:

Use the 'Live Preview' panel (right side) and select 'Instructions' to see the formatted preview.

The rich text editor supports fonts, sizes, colors, and formatting. Use the toolbar to style your text.

Upload instructions image (PNG):

Browse...

Recommended size: 800 x 600 pixels. The image will be displayed as-is in PsyToolkit.

Default Colors

These colors will be used as defaults for all elements.

Text color:

Button background:

Image background:

Likert item color:

Color presets

Audio Settings

Loop audio playback

If enabled, stimuli will play continuously until the participant responds.
Note: Response timeouts are configured separately for forced choice and Likert scales in their respective tabs.

Display Settings

Resolution:

Fullscreen display in PsyToolkit

Resolution can only be changed for new projects. Fullscreen mode displays the experiment in full browser window.

Experimental: Using a resolution other than the default 800×600 is still experimental. Please check that the display in the Live Preview and in PsyToolkit matches your expectations.

Export Settings

Task name (for PSY code):

Used as the task identifier in the generated PsyToolkit code.

Block name:

About

PsyToolkit Listening Test Designer
A Shiny application for creating listening tests compatible with the PsyToolkit platform.

Generated files include:

code.psy - PsyToolkit experiment script
PNG images for instructions and response buttons
INFO.txt - Generation information

For more information about PsyToolkit, visit: psytoolkit.org

Live Preview
Export
Help

Preview page:

Show alignment grid

Grid color:

Y: -300 (bottom) to +300 (top) | X: -400 (left) to +400 (right) | Center = (0, 0)

Element Order & Position

Offset Conflict

The elements being reordered have custom Y offsets. Moving them may cause overlap.

How would you like to handle the offsets?

Reset offsets to zero for swapped elements

Keep offsets with their elements (most likely to cause overlap)

Keep offsets at their positions (swap offsets between reordered elements)

Export PsyToolkit Experiment

Generated Images Preview

Instructions
Response Buttons
Likert Elements

Generated PsyToolkit Code

Show/hide code preview