Movie Component

The Movie component allows movie files to be played from a variety of formats (e.g. mpeg, avi, mov).

The movie can be positioned, rotated, flipped and stretched to any size on the screen (using the Units for the window and stimuli given).



Everything in a PsychoPy® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

start :

The time that the stimulus should first appear. See Defining the onset/duration of components for details.

stop :

Governs the duration for which the stimulus is presented (if you want to cut a movie short). Usually you can leave this blank and insert the Expected duration just for visualisation purposes. See Defining the onset/duration of components for details.


The filename of the movie, including the path. The path can be absolute or relative to the location of the experiment (.psyexp) file.

forceEndRoutine :

If checked, when the movie finishes, the routine will be ended.


How should the stimulus look? Colour, borders, etc.


Vary the transparency, from 0.0 = invisible to 1.0 = opaque


How should the stimulus be laid out? Padding, margins, size, position, etc.


Movies can be rotated in real-time too! This specifies the orientation of the movie in degrees.


The position of the centre of the stimulus, in the units specified by the stimulus or window

size[sizex, sizey] or a single value (applied to both x and y)

The size of the stimulus in the given units of the stimulus/window.

spatial unitsdeg, cm, pix, norm, or inherit from window

See Units for the window and stimuli


How should stimulus play? Speed, volume, etc.

backendmoviepy, avbin, opencv

What Python package should be used to play the movie?

no audiobool

Tick to mute audio

loop playbackbool

Should video loop on completion?

See also

API reference for MovieStim

Back to top