The Preferences dialog allows to adjust general settings for different parts of PsychoPy®. The preferences settings are saved in the configuration file userPrefs.cfg. The labels in brackets for the different options below represent the abbreviations used in the userPrefs.cfg file.
In rare cases, you might want to adjust the preferences on a per-experiment basis. See the API reference for the Preferences class here.
PsychoPy® can use one of two ‘backends’ for creating windows and drawing; pygame, pyglet and glfw. Here you can set the default backend to be used.
Default units for windows and visual stimuli (‘deg’, ‘norm’, ‘cm’, ‘pix’). See Units for the window and stimuli. Can be overridden by individual experiments.
Should windows be created full screen by default? Can be overridden by individual experiments.
When the window is created, should the frame of the window and the mouse pointer be visible. If set to False then both will be hidden.
Paths for additional Python packages can be specified. See more information on paths here.
Set flac audio compression.
This list determines the addresses available in the drop-down menu for the Parallel Port Out Component.
These settings are common to all components of the application (Coder and Builder etc)
Display tips when starting PsychoPy®.
Do you want large icons (on some versions of wx on macOS this has no effect)?
Determines which view(s) open when the PsychoPy® app starts up. Default is ‘last’, which fetches the same views as were open when PsychoPy® last closed.
Reset preferences to defaults on next restart of PsychoPy®.
Save any unsaved preferences before closing the window.
Enable features for debugging PsychoPy® itself, including unit-tests.
Language to use in menus etc.; not all translations are available. Select a value, then restart the app. Think about adding translations for your language.
Select whether to automatically reload a previously opened experiment at start-up.
If this option is selected, the scripts will use more complex code, but the advantage is that there is less of a chance that name conflicts will arise.
A list of folder path names that can hold additional custom components for the Builder view; expects a comma-separated list.
A list of components to hide (e.g., because you never use them)
Location of Builder demos on this computer (after unpacking).
Name of the folder where subject data should be saved (relative to the script location).
If selected, the “Flow” section will be shown topmost and the “Components” section will be on the left. Restart PsychoPy® to activate this option.
If selected, PsychoPy® always shows the Readme file if you open an experiment. The Readme file needs to be located in the same folder as the experiment file.
Upper limit on how many components can be in the Favorites menu of the Components panel.
A list of font names to be used for code display. The first found on the system will be used.
A list of font names to be used for comments sections. The first found on the system will be used
A list of font names to be used in the output panel. The first found on the system will be used.
An integer between 6 and 24 that specifies the font size for code display in points.
An integer between 6 and 24 that specifies the font size for output display in points.
Do you want to show the source assistant panel (to the right of the Coder view)? On Windows this provides help about the current function if it can be found. On macOS the source assistant is of limited use and is disabled by default.
Show the output panel in the Coder view. If shown all python output from the session will be output to this panel. Otherwise it will be directed to the original location (typically the terminal window that called PsychoPy® application to open).
Should PsychoPy® fetch the files that you previously had open when it launches?
Specify which shell should be used for the coder shell window.
Specify which character sequence should be used to encode newlines in code files: unix = n (line feed only), dos = rn (carriage return plus line feed).
The proxy server used to connect to the internet if needed. Must be of the form http://111.222.333.444:5555
PsychoPy® should try to deduce the proxy automatically. If this is True and autoProxy is successful, then the above field should contain a valid proxy address.
Allow PsychoPy® to ping a website at when the application starts up. Please leave this set to True. The info sent is simply a string that gives the date, PsychoPy® version and platform info. There is no cost to you: no data is sent that could identify you and PsychoPy® will not be delayed in starting as a result. The aim is simple: if we can show that lots of people are using PsychoPy® there is a greater chance of it being improved faster in the future.
PsychoPy® can (hopefully) automatically fetch and install updates. This will only work for minor updates and is still in a very experimental state (as of v1.51.00).
Maximum time in seconds to wait for a connection response.
Select your choice of audio library with a list of names specifying the order they should be tried. We recommend [‘PTB’, ‘sounddevice’, ‘pyo’, ‘pygame’] for lowest latency.
Latency mode for PsychToolbox audio. See PTB Audio Latency Modes.
Some of PsychoPy’s audio engines provide the option not to use portaudio but go directly to another lib (e.g. to coreaudio) but some don’t allow that.
The name of the audio driver to use.
A list of parallel ports. The default is ['0x0378', '0x03BC'].
The name of the Qmix pump configuration to use. The default is 'qmix_config'.
There are many shortcut keys that you can use in PsychoPy®. For instance did you realise that you can indent or outdent a block of code with Ctrl-[ and Ctrl-] ?