Table Of Contents

Previous topic

Contributing to the project

Next topic

Getting Started

Quick links

Installation

Like many python modules PsychoPy is built and dependent on a number of other libraries (OpenGL, numpy...). Details on how to install those are below.

Windows:

If you’re new to python then you probably want to install the standalone package. This includes a copy of python and all the dependent libraries (if you do have python already installed, that won’t be touched by this installation). Once installed, you’ll now find a link to the PsychoPy application in >Start>Progams>PsychoPy2. Click that and then on the demos menu to get going.

You should make sure you have reasonably current drivers for your graphics card (download the latest from the vendor, rather than using the pre-installed windows drivers).

The standalone installer adds the PsychoPy folder to your path, so you can run the included version of python from the command line etc. If you have your own version of python installed as well then you need to check which one is run by default, and change your path according to your personal preferences.

Mac OS X:

There are different ways to install PsychoPy on a mac that will suit different users

  • Intel Mac users (with OS X v10.5) can simply download the standalone application bundle (the dmg file) and drag it to their Applications folder. The app bundle contains its own independent python and all the dependencies and will not interact with anything else on your system (except its own preferences).

  • Users of macports can install PsychoPy and all its dependencies simply with:

    sudo port install py25-psychopy

    (thanks James Kyles for that).

  • For PPC macs (or for intel mac users that want their own custom python for running PsychoPy) you need to install the dependencies and PsychoPy manually. The easiest way is to use the Enthought Python Distribution. It’s free (for academic use) and the only things it misses are avbin (if you want to play movies) and pygame (for sound reproduction). You could alternatively manually install the ‘framework build’ of python and download all the dependencies below. One advantage to this is that you can then upgrade versions with:

    sudo /usr/local/bin/easy_install-2.5 -N -Z -U psychopy

Linux:

For Debian users, PsychoPy is in the Debian packages index so you can simply do:

sudo apt-get install psychopy

For Debian-based distributions (e.g. Ubuntu):

  1. Add the following sources in Synaptic, in the Configuration>Repository dialog box, under “Other software”:

    deb http://neuro.debian.net/debian karmic main contrib non-free
    deb-src http://neuro.debian.net/debian karmic main contrib non-free
  2. Then follow the ‘Package authentification’ procedure described in http://neuro.debian.net/

  3. Then install the psychopy package under Synaptic or through sudo apt-get install psychopy which will install all dependencies.

For non-Debian systems you need to install the dependencies below manually and then PsychoPy (with easy_install?).

Thanks to Yaroslav Halchenko for his work on the Debian package.

Dependencies

If you want to install each library individually rather than use the simple distributions of packages above then you can download the following. Make sure you get the correct version for your OS and your version of Python.

  • Python (2.4.x or 2.5.x, NOT version 3)
  • setuptools
  • numpy (version 0.9.6 or greater)
  • scipy (version 0.4.8 or greater)
  • pyglet (version 1.1 or greater)
  • pygame (for playing sounds. Must be version 1.8 or greater)
  • pywin32 (only needed for Windows)
  • wxPython (version 2.8 or greater)
  • Python Imaging Library (easier to install with setuptools/easy_install)
  • matplotlib (for plotting stuff)
  • winioport (to use the parallel port, win32 only)
  • ctypes (this is already included in python 2.5)
  • lxml (needed for printing saving builder experiment files)

Please send feedback to the mailing list.