Dependencies Installation Windows - jackspaceBerkeley/pupil GitHub Wiki
The required Windows version for running Pupil v0.4 and higher is Windows 8.1. Windows 7 probably also works, but is not yet tested. You can either setup a 32-bit or a 64-bit python environment to run pupil, but you have to be consistent about the chosen architecture! We mainly develop with and therefore recommend 32-bit python. Please find the instructions for setting up Pupil below!
Running Pupil from source includes the installation of several dependencies. Please follow the instructions below. For discussion or questions on Windows installation head over to the Pupil Google Group. If you find any problems please raise an issue!
- Install 7-zip for extraction purposes.
- Install Visual Studio 2008 Professional (requirement for Cython)
- Download stdint.h and save it in
[Visual Studio Path]/VC/include/
- Install Visual C++ 2013 Redistributable
- Download and install version 2.7.6: Windows MSI installer
- Add your Python installation path to the PATH environment variable, e.g. "C:/Python27/"
Python extensions can be installed via pip. We recommend to download and install the pre-built wheel (*.whl) packages by Christoph Gohlke. Thanks for creating and sharing these packages!
To install an extension open command line with admin rights and run python -m pip install [PACKAGE_NAME.whl]
- SciPy: scipy‑0.15.1‑cp27*.whl
- PyOpenGL: PyOpenGL‑3.1.1*.whl
- Numpy: numpy‑1.9.2+mkl‑cp27*.whl
- OpenCV: opencv_python‑2.4.11‑cp27*.whl
- PyZMQ: pyzmq‑14.7.0‑cp27*.whl
- Cython: Cython‑0.22‑cp27*.whl
- psutil: psutil‑3.0.1‑cp27*.whl
- PyAudio: PyAudio‑0.2.8‑cp27*.whl
There are some further python extensions that are specific to pupil:
- Download 32-bit OR 64-bit Windows binaries.
- Unzip and search folder
vs-2013
containingglfw3.dll
. - Rename that folder to
external
and copy it topupil/pupil_src/shared_modules/
.
Download and install a gcc toolchain for windows. Make sure to select the x64 option. Apart from that use the default settings.
- Open install dir and navigate to
/bin
- copy/rename
mingw32-make
tomake
- Download and install Git. This enables you to download and update the Pupil source code and further extensions it needs.
- Add the
/bin
path of Git to the PATH environment variable, e.g.C:/Program Files (x86)/Git/bin
.
- Open the Git Bash and navigate to the directiory you chose for pupil.
- Run
git clone http://github.com/pupil-labs/pupil
(creates a sub-directory for pupil)
cd your_pupil_path/pupil/pupil_src/capture
python main.py
cd your_pupil_path/pupil/pupil_src/player
python main.py path_to_recording
- Clone PyAV to your system
git clone https://github.com/mikeboers/PyAV.git
- Make sure you have installed MinGW (32-bit) on your system including the gcc compiler. If you have multiple versions of gcc on your machine (e.g. due to Cygwin) make sure it's the first one to be found when traversing the PATH.
- Build ffmpeg for Windows 32-bit with
shared
enabled. The easiest way we found was to cross-compile ffmpeg with this script under Ubuntu 14.04 LTS. - Copy the resulting folder
ffmpeg.shared-install
to Windows and rename it toffmpeg_build
- Set the environment variable
PKG_CONFIG_PATH
to.../ffmpeg_build/lib/pkgconfig
- Setup pkg-config and its dependencies as done here.
- Copy the following ffmpeg DLLs to PyAV's
av
folder- avcodec-56.dll
- avdevice-56.dll
- avfilter-5.dll
- avformat-56.dll
- avutil-54.dll
- postproc-53.dll
- swresample-1.dll
- swscale-3.dll
- Copy the following DLLs from your MinGW
/bin
folder to PyAV'sav
folder- libgcc_s_dw2-1.dll
- libwinpthread-1.dll
- Build PyAV with
make build-mingw32
(you might need to installmsys
to use make). This step works with Python 2.7.6. For some reasons the newest version of Python does not work.