Testing on Windows

• install Python 3

  • let the installer set up the PATH environment variable

• install MSYS2

  • set the user environment variable MSYS2_PATH_TYPE to inherit

  • always run the "MSYS2 MinGW 64-bit" shell

  • edit /etc/nsswitch.conf and insert windows between db_home: and cygwin (source)

  • add the Git for Windows repository by adding the following to /etc/pacman.conf (source):

    [git-for-windows]
    Server = https://dl.bintray.com/$repo/pacman/$arch
    SigLevel = Optional
    

  • upgrade packages:

    pacman -Syu
    

  • install additional packages:

    pacman -S tar unzip make mingw-w64-x86_64-git mingw-w64-x86_64-tk
    

  • add the following to your .bashrc to fix gitk and git-gui (`source`_):

    export GIT_GUI_LIB_DIR=/c/msys64/usr/share/git-gui/lib
    

  • configure git to not perform CRLF convesion:

    git config --global core.autocrlf input
    git config --global core.eol lf
    

• install poppler utils

  • either install through pacman:

    pacman -S mingw-w64-x86_64-poppler
    

  • or get the binaries from http://blog.alivate.com.au/poppler-windows/ and add the bin path to your PATH

• install ImageMagick

  • (The ImageMagick available from MSYS2 repositories is broken)
  • keep "Add application directory to your system path" ticked
  • tick "Install legacy utilities (e.g. convert)"