Downloading, Compiling, and Installing Ipe - otfried/ipe-wiki GitHub Wiki

Downloading Ipe

Binary Ipe packages are available for a number of platforms:

Windows

A Windows package for Ipe is available from the homepage.

Mac OS X

A Mac OS X app for Ipe is available from the homepage.

If you have homebrew installed, you can install Ipe by simply saying:

brew install --cask ipe

Linux

Ipe is included in several Linux distributions, including Debian, Ubuntu, Linux Mint, openSuse, etc. You can install Ipe through the distribution's package manager.

It takes a while for a new Ipe version to make into a distribution, especially the long-term stable distributions. If you want to use the new features of the cutting edge Ipe version, you can either compile Ipe yourself (see below), or use the packages available from the homepage.

Compiling and Installing Ipe

Linux

Debian, Ubuntu, Mint

Download and uncompress the file with the source code. Then, type the following commands. (Change 7.x.y to the current Ipe version, e.g. 7.2.27.)

sudo apt-get install build-essentials checkinstall
sudo apt-get install qt6-base-dev qt6-base-dev-tools
sudo apt-get install libqt6svg6
sudo apt-get install libfreetype6-dev libcairo2-dev libjpeg8-dev
sudo apt-get install libpng-dev liblua5.4-dev zlib1g-dev
sudo apt-get install libspiro-dev libgsl-dev curl
cd src
make IPEPREFIX=/usr/local
sudo checkinstall --pkgname=ipe --pkgversion=7.x.y --backup=no \
	 --fstrans=no --default make install IPEPREFIX=/usr/local
sudo ldconfig

Finally, you might add a menu item pointing to /usr/local/bin/ipe.

Archlinux

If you have yaourt installed:

yaourt -S ipe --noconfirm

Nix / NixOS

This is very outdated.

Use the packaged derivation from nixpkgs :

nix-env -iA nixos.ipe

Mac OSX

Since Ipe 7.2.1, the Ipe app available on the Ipe homepage is a small download and fully self-contained. Most Ipe users should use this rather than trying to compile Ipe themselves. Otherwise, see the instructions in the macos.txt file in the source distribution.

Windows

These instructions are for a very outdated version and will not work for a recent Ipe version.

The following step-by-step guide describes how to compile Ipe 7.1.8 under Windows.

  1. Download and install MSYS (a collection of GNU utilities such as bash, make, gawk): http://www.mingw.org/wiki/msys. Install at least the msys-base and msys-patch packages. This guide assumes you select C:\MinGW as installation directory, MSYS will be at C:\MinGW\msys\1.0.

  2. Download and install Win-builds (GCC compiler and many third party libraries): http://win-builds.org/doku.php/download_and_installation_from_windows. During installation select Cygwin or MSYS, i686, and C:\MinGW\msys\1.0 as installation directory. Be sure to deselect the Lua 5.1 package, because Ipe will need Lua 5.2.

  3. Download Lua 5.2.x Windows x86 DLL and Includes: http://luabinaries.sourceforge.net/download.html. Extract the file to C:\MinGW\msys\1.0\opt\lua52.

  4. Download the Ipe 7.1.8 source code and extract it to C:\MinGW\msys\1.0\home.

  5. Download the patch http://www.chzsoft.de/storage/ipe-7.1.8-compile-on-windows.diff and save it in C:\MinGW\msys\1.0\home. This fixes several issues with the compilation of Ipe 7.1.8 under Windows:

    • Add ipe.exe.manifest erroneously omitted from the source distribution.
    • Use libjpeg instead of TurboJPEG for the Windows version as well.
    • Fix code so that gestures can be used under Windows 7 and above but the resulting binary still runs under Windows XP and Vista.
    • Adapt paths in the Makefile to this tutorial.

  6. Start the MSYS shell by running C:\MinGW\msys\1.0\msys.bat.

  7. Enable the Win-builds toolchain by typing

     source /opt/windows_32/bin/win-builds-switch

  8. Change into the Ipe directory and apply the patch:

     cd /home/ipe-7.1.8
 patch -p0 < ipe-7.1.8-compile-on-windows.diff

  9. Compile Ipe:

     cd src
 make

  10. The resulting binaries are now in /home/ipe-7.1.8/mingw/bin. You will need lua52.dll from C:\MinGW\msys\1.0\opt\lua52 as well as libcairo-2.dll, libgcc_s_sjlj-1.dll, libwinpthread-1.dll, libfontconfig-1.dll, libexpat-1.dll, libfreetype-6.dll, libpng14-14.dll, libz-1.dll, libpixman-1-0.dll, libstdc++-6.dll, libjpeg-9.dll from C:\MinGW\msys\1.0\opt\windows_32\bin to run these binaries.