Dependencies Installation Windows - jackspaceBerkeley/pupil GitHub Wiki

System Requirements

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!


Install Dependencies

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!

Utils

  • Install 7-zip for extraction purposes.

Visual C++ Runtime

Python (32-bit OR 64-bit)

  • Download and install version 2.7.6: Windows MSI installer
  • Add your Python installation path to the PATH environment variable, e.g. "C:/Python27/"

General Python Extensions

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:

Setup GLFW.

  • Download 32-bit OR 64-bit Windows binaries.
  • Unzip and search folder vs-2013 containing glfw3.dll.
  • Rename that folder to external and copy it to pupil/pupil_src/shared_modules/.

Install GCC

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 to make

Install Git

  • 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.

Clone Pupil source code

  • 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)

Run Pupil!

Capture

cd your_pupil_path/pupil/pupil_src/capture
python main.py

Player [not tested yet]

cd your_pupil_path/pupil/pupil_src/player
python main.py path_to_recording

Setup PyAV, a Player-only Dependency [for wheel creation]

  • 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 to ffmpeg_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's av folder
    • libgcc_s_dw2-1.dll
    • libwinpthread-1.dll
  • Build PyAV with make build-mingw32 (you might need to install msys to use make). This step works with Python 2.7.6. For some reasons the newest version of Python does not work.
⚠️ **GitHub.com Fallback** ⚠️