Synfig Studio :: Documentation - User contributions [en]

Dev:Mingw installation

2015-10-19T11:05:32Z

Eshikafe: /* GTKmm */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<pre> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </pre>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/synfig/synfig) - you can use [https://github.com/blackwarthog/synfig.git blackwarthog's] fork. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [https://wiki.gnome.org/Projects/gtkmm/MSWindows this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T16:05:58Z

Eshikafe: /* Updated Mingw */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<pre> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </pre>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/synfig/synfig) - you can use [https://github.com/blackwarthog/synfig.git blackwarthog's] fork. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T16:00:33Z

Eshikafe: /* Git */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/synfig/synfig) - you can use [https://github.com/blackwarthog/synfig.git blackwarthog's] fork. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Building On Mac OS X

2015-10-18T15:59:33Z

Eshikafe: /* Build using the native GTK port */

{{Title|Building On Mac OS X}}

{{Category|Building}}

== Build using the native GTK port ==

In order to build Synfig natively on Mac OS X using the native GTK port (as opposed to using X11), you will require the following:

* Mac OS X developer tools (i.e. [http://developer.apple.com/tools/xcode/ XCode])
* git ("git" on homebrew)
* subversion ("subversion" formula on homebrew)
* Git clone of the synfig source code repository (https://github.com/synfig/synfig.git) - you can use [https://github.com/blackwarthog/synfig.git blackwarthog's] fork

=== Boot strapping ===

First of all make sure you have a Terminal window open. This will be used in order to perform all the steps necessary to compile synfig.

This assumes you have the XCode developer tools installed. Next, you'll want to install the homebrew package manager. Visit [https://github.com/mxcl/homebrew/wiki/Installation the docs] for installation instructions. These will ''not'' work for Mac OS X Tiger users, so if you are on Tiger type at your command prompt:
<pre><nowiki>
curl -Lsf http://github.com/sceaga/homebrew/tarball/tiger | tar xz --strip 1 -C<your install directory, /usr/local/ recommended >
</nowiki></pre>

Now to install git and svn (assuming you've got the homebrew install directory in your path):

<pre><nowiki>
brew install git
brew install svn
</nowiki></pre>

=== Compilig GTK and other dependencies ===

Then you can install "gtkmm" with homebrew:

<pre><nowiki>
brew install gtkmm
</nowiki></pre>

You will also want gtk+:
<pre><nowiki>
brew install gtk+
</nowiki></pre>

Then you'll want libxml++, which is currently only available on the secondplanet fork of homebrew:
<pre><nowiki>
brew install libxml++
</nowiki></pre>

=== Synfig itself (Using homebrew and X11)===

You should now be able to follow the {{L|Dev:Build_Instructions}} to compile ETL, synfig-core, and synfig-studio. The only difference, of course, are the prefixes. To make all this easier the building can be done with homebrew. First, make sure you have secondplanet's fork of homebrew from github:

<pre><nowiki>
git clone git://github.com/secondplanet/homebrew ~/secondplanet-homebrew
# if you installed libxml++ as instructed above, this will already exist. If so, there is no need to execute this command.
cd ~/secondplanet-homebrew/
</nowiki></pre>

Then, build ETL by copying the etl formula and installing:

<pre><nowiki>
cd ~/secondplanet-homebrew/
git checkout -b etl remotes/secondplanet/etl
cp Library/Formula/etl.rb <homebrew install directory>/Library/Formula/
brew install etl
</nowiki></pre>

Then (assuming you are still on secondplanet's fork:

<pre><nowiki>
git checkout -b synfig remotes/secondplanet/synfig
cp Library/Formula/synfig.rb <homebrew install directory>/Library/Formula/
brew install synfig
</nowiki></pre>

And the same for synfigstudio:

<pre><nowiki>
git checkout -b synfigstudio remotes/secondplanet/synfigstudio
cp Library/Formula/synfigstudio.rb <homebrew install directory>/Library/Formula/
brew install synfigstudio
</nowiki></pre>

Assuming you manage to build it correctly, you should now be able to type the following in order for Synfig to pop up on your desktop:

<pre><nowiki>
synfigstudio
</nowiki></pre>

'''WORK IN PROGRESS''':Note though that this isn't the end of the story: we still need to package everything up into an .app so that the more sane of us can run Synfig without having to resort to opening a terminal. Some parts of these instructions are incomplete and are often changing. The package for etl is not part of the main homebrew fork as of this time, and neither are any other synfig packages.

'''TODO''': Describe how to properly package everything into an .app. <strike>Describe how to build "synfig" and "synfig-studio" with homebrew.</strike> Describe build process w/ gtk-osx.

=== Issues ===

There are currently numerous issues with Synfig with Imendio's GTK port. Watch out for:

* <strike>Window focus can sometimes be lost. If this happens, just select a window from another Mac OS X app and then select the Synfig window again.</strike>
* <strike>Menus do not function correctly.</strike>
* <strike>The file browser doesn't work, so you have to load files from startup.</strike>
* Sometimes mouse focus on windows is lost. To solve this, try moving the affected window. Failing that, you should still be able to use the keyboard to navigate.
* No input devices are enumerated by GTK.
* XCode project files exist, but they are currently broken. Thus we just use the terminal to compile everything.

[[File:Synfig_mac_X11.png|800px]]

== Troubleshooting ==

=== no "awk" ===

If you get an error during building homebrew formulae complaining that a program called "awk" cannot be found, then you should install the 'gawk' formula like so:

<pre><nowiki>
brew install gawk
</nowiki></pre>

=== "no command found" when running jhbuild ===

When using jhbuild, you might get an error back like this:

<pre><nowiki>
$ jhbuild meta-gtk-osx-core
jhbuild meta-gtk-osx-core: no command found
</nowiki></pre>

This is because you need to specify the "build" command when building a package, like so:

<pre><nowiki>
jhbuild build meta-gtk-osx-core
</nowiki></pre>

=== problem building "doxygen" via jhbuild ===

When building doxygen, you may get an error during the build process mentioning "lipo" failed to find a file. To fix this, you should go into the shell (option 4) when prompted, and enter the following:

<pre><nowiki>
./configure --prefix /opt/gtk --platform macosx-c++ --install /usr/bin/install
make && exit
</nowiki>
</pre>

Then when prompted again, choose "ignore error and continue to build" (option 2).

=== problems with external libraries ===

If your build doesn't find external graphics libraries (such as libpng), but you know they're installed, you may need to set some additional environment variables, like so:

<pre><nowiki>export CPPFLAGS=-I/opt/local/include
export LDFLAGS=-L/opt/local/lib
</nowiki></pre>

If you're using native GTK+, change "/opt/local" to "/opt/gtk".

==Multiple X11's==
If you get an error about display ports, you likely have multiple X11's installed. Just open up your favorite, click on the Applications > Customize… option, and then add an application with the name "synfigstudio" and command "synfigstudio" (w/out the quotes).

Dev:Building On Mac OS X

2015-10-18T15:55:15Z

Eshikafe: /* Build using the native GTK port */

{{Title|Building On Mac OS X}}

{{Category|Building}}

== Build using the native GTK port ==

In order to build Synfig natively on Mac OS X using the native GTK port (as opposed to using X11), you will require the following:

* Mac OS X developer tools (i.e. [http://developer.apple.com/tools/xcode/ XCode])
* git ("git" on homebrew)
* subversion ("subversion" formula on homebrew)
* Git clone of the synfig source code repository (https://github.com/synfig/synfig.git)

=== Boot strapping ===

First of all make sure you have a Terminal window open. This will be used in order to perform all the steps necessary to compile synfig.

This assumes you have the XCode developer tools installed. Next, you'll want to install the homebrew package manager. Visit [https://github.com/mxcl/homebrew/wiki/Installation the docs] for installation instructions. These will ''not'' work for Mac OS X Tiger users, so if you are on Tiger type at your command prompt:
<pre><nowiki>
curl -Lsf http://github.com/sceaga/homebrew/tarball/tiger | tar xz --strip 1 -C<your install directory, /usr/local/ recommended >
</nowiki></pre>

Now to install git and svn (assuming you've got the homebrew install directory in your path):

<pre><nowiki>
brew install git
brew install svn
</nowiki></pre>

=== Compilig GTK and other dependencies ===

Then you can install "gtkmm" with homebrew:

<pre><nowiki>
brew install gtkmm
</nowiki></pre>

You will also want gtk+:
<pre><nowiki>
brew install gtk+
</nowiki></pre>

Then you'll want libxml++, which is currently only available on the secondplanet fork of homebrew:
<pre><nowiki>
brew install libxml++
</nowiki></pre>

=== Synfig itself (Using homebrew and X11)===

You should now be able to follow the {{L|Dev:Build_Instructions}} to compile ETL, synfig-core, and synfig-studio. The only difference, of course, are the prefixes. To make all this easier the building can be done with homebrew. First, make sure you have secondplanet's fork of homebrew from github:

<pre><nowiki>
git clone git://github.com/secondplanet/homebrew ~/secondplanet-homebrew
# if you installed libxml++ as instructed above, this will already exist. If so, there is no need to execute this command.
cd ~/secondplanet-homebrew/
</nowiki></pre>

Then, build ETL by copying the etl formula and installing:

<pre><nowiki>
cd ~/secondplanet-homebrew/
git checkout -b etl remotes/secondplanet/etl
cp Library/Formula/etl.rb <homebrew install directory>/Library/Formula/
brew install etl
</nowiki></pre>

Then (assuming you are still on secondplanet's fork:

<pre><nowiki>
git checkout -b synfig remotes/secondplanet/synfig
cp Library/Formula/synfig.rb <homebrew install directory>/Library/Formula/
brew install synfig
</nowiki></pre>

And the same for synfigstudio:

<pre><nowiki>
git checkout -b synfigstudio remotes/secondplanet/synfigstudio
cp Library/Formula/synfigstudio.rb <homebrew install directory>/Library/Formula/
brew install synfigstudio
</nowiki></pre>

Assuming you manage to build it correctly, you should now be able to type the following in order for Synfig to pop up on your desktop:

<pre><nowiki>
synfigstudio
</nowiki></pre>

'''WORK IN PROGRESS''':Note though that this isn't the end of the story: we still need to package everything up into an .app so that the more sane of us can run Synfig without having to resort to opening a terminal. Some parts of these instructions are incomplete and are often changing. The package for etl is not part of the main homebrew fork as of this time, and neither are any other synfig packages.

'''TODO''': Describe how to properly package everything into an .app. <strike>Describe how to build "synfig" and "synfig-studio" with homebrew.</strike> Describe build process w/ gtk-osx.

=== Issues ===

There are currently numerous issues with Synfig with Imendio's GTK port. Watch out for:

* <strike>Window focus can sometimes be lost. If this happens, just select a window from another Mac OS X app and then select the Synfig window again.</strike>
* <strike>Menus do not function correctly.</strike>
* <strike>The file browser doesn't work, so you have to load files from startup.</strike>
* Sometimes mouse focus on windows is lost. To solve this, try moving the affected window. Failing that, you should still be able to use the keyboard to navigate.
* No input devices are enumerated by GTK.
* XCode project files exist, but they are currently broken. Thus we just use the terminal to compile everything.

[[File:Synfig_mac_X11.png|800px]]

== Troubleshooting ==

=== no "awk" ===

If you get an error during building homebrew formulae complaining that a program called "awk" cannot be found, then you should install the 'gawk' formula like so:

<pre><nowiki>
brew install gawk
</nowiki></pre>

=== "no command found" when running jhbuild ===

When using jhbuild, you might get an error back like this:

<pre><nowiki>
$ jhbuild meta-gtk-osx-core
jhbuild meta-gtk-osx-core: no command found
</nowiki></pre>

This is because you need to specify the "build" command when building a package, like so:

<pre><nowiki>
jhbuild build meta-gtk-osx-core
</nowiki></pre>

=== problem building "doxygen" via jhbuild ===

When building doxygen, you may get an error during the build process mentioning "lipo" failed to find a file. To fix this, you should go into the shell (option 4) when prompted, and enter the following:

<pre><nowiki>
./configure --prefix /opt/gtk --platform macosx-c++ --install /usr/bin/install
make && exit
</nowiki>
</pre>

Then when prompted again, choose "ignore error and continue to build" (option 2).

=== problems with external libraries ===

If your build doesn't find external graphics libraries (such as libpng), but you know they're installed, you may need to set some additional environment variables, like so:

<pre><nowiki>export CPPFLAGS=-I/opt/local/include
export LDFLAGS=-L/opt/local/lib
</nowiki></pre>

If you're using native GTK+, change "/opt/local" to "/opt/gtk".

==Multiple X11's==
If you get an error about display ports, you likely have multiple X11's installed. Just open up your favorite, click on the Applications > Customize… option, and then add an application with the name "synfigstudio" and command "synfigstudio" (w/out the quotes).

Dev:Mingw installation

2015-10-18T15:51:49Z

Eshikafe: /* Git */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/synfig/synfig). You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T15:45:26Z

Eshikafe:

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/blackwarthog/synfig.git). You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T15:42:44Z

Eshikafe: /* Git */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository (https://github.com/blackwarthog/synfig.git). You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://subversion.tigris.org Subversion]===

<s>Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.</s>

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T15:31:35Z

Eshikafe: /* Updated Mingw */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Step 2: Install the following packages using the MinGW Installer(see Figure 2)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Figure 2: Installing the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 3: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://subversion.tigris.org Subversion]===

<s>Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.</s>

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T15:28:34Z

Eshikafe: /* Updated Mingw */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup. You can uncheck the checkbox highlighted in green if you prefer to use the command line option to install the required MinGW packages (see Note 2)

[[File:Mingw-installation-step-1.png]]

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Step 2: Install the following packages using the MinGW Installer(see Figure 3)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Figure 3: Install the required packages

[[File:Mingw-installation.PNG]]

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 2: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://subversion.tigris.org Subversion]===

<s>Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.</s>

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Mingw installation

2015-10-18T15:22:22Z

Eshikafe: /* Updated Mingw */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

Step 1 - Download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)
Run mingw-get-setup.exe and follow the installation step (see Figure 1)

Figure 1: MinGW Setup

[[File:Mingw-installation-step-1.png]]

You can uncheck the check-box highlighted in green in Figure 1 if you prefer to use the command line option to install the required MinGW packages (see Note 2)

Note 1: You really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Required packages: Select the following packages from the installer (see Figure 3)
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 2: Windows command line option for installing the required MinGW packages
<code> mingw-get.exe install gcc g++ fortran msys-base mingw-developer-toolkit </code>

Figure 2: package installation from the Windows command line

[[File:Mingw-installation-cmd.PNG]]

Figure 3: Required packages

[[File:Mingw-installation.PNG]]

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://subversion.tigris.org Subversion]===

<s>Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.</s>

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

File:Mingw-installation-cmd.PNG

2015-10-18T15:08:14Z

Eshikafe: MinGW package installation from the Windows command line

MinGW package installation from the Windows command line

File:Mingw-installation-step-1.png

2015-10-18T15:07:02Z

Eshikafe: MinGW installation steps

MinGW installation steps

Dev:Mingw installation

2015-10-18T15:06:20Z

Eshikafe: /* Updated Mingw */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page!

Please you can also refer to this page: http://www.mingw.org/wiki/Getting_Started on how to install MingW

First - download [http://www.mingw.org/ MinGW] installer (mingw-get-setup.exe)

Run mingw-get-setup.exe (running in fact mingw-get-0.6.2-beta-20131004-1 as of Aug. 2015) and follow the installation step (Figure 1)
You can uncheck the check-box highlighted in green in the figure below if you prefer to use the command line option (see Note 3 for the command line option)

* MinGW base tools
* g++ Compiler
* g77 Compiler
* MinGW Make
* MSYS(both you will still have to go back and install later but this will be explained when the time comes)

Note 1: you really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Note 2: mingw-get-inst-20110316.exe provides the following options to choose:
* MinGW Compiler Suit
** C Compiler (selected always)
** C++ Compiler (select it)
** Fortran Compiler (select it)
* MSYS Basic System (select it)
* MinGW Developer Toolkit (select it)

Note 3: After installing Mingw, run the following command from the C:\MinGW\bin directory
* mingw-get install gcc g++ fortran msys-base mingw-developer-toolkit

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

[[File:Mingw-installation.PNG]]

===MSYS===
This is installed when you install mingw if you selected, if you feel so necessary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be unnecessary

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
=== [http://git-scm.com/ Git] ===
Synfig source is now stored in a git repository. You will need the git client to get it. Also, git is needed by the build scripts to receive the revision number of the source.
You can download the Windows git version from one of these page:

* http://git-scm.com/download
* http://msysgit.github.io

Get always the latest version available (version 1.9.5, link updated August 2015):
* https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe

After download and install (I recommend to install to custom folder C:\Git) you must add C:\Git\bin to the PATH. See here to know how to do that. http://www.mingw.org/wiki/Getting_Started (Environment Variables).

===[http://subversion.tigris.org Subversion]===

<s>Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.</s>

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.

The latest version as of August 2015 is 2.46:
* http://downloads.sourceforge.net/nsis/nsis-2.46-setup.exe (1.6 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\mingw\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
maybe this is useful to read too: http://live.gnome.org/gtkmm/MSWindows
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

File:Mingw-installation.PNG

2015-10-18T14:26:33Z

Eshikafe: Mingw required packages

Mingw required packages