- 1Build using the native GTK port
- 2Troubleshooting
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. 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 blackwarthog's fork
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. XCode) git ('git' on homebrew) subversion ('subversion' formula on homebrew).
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.
- Synfig Studio is a vector based 2D animation program. It is designed to be capable of producing feature-film quality animation. It eliminates the need for tweening, preventing the need to hand.
- Synfig Studio is a free and open-source 2D animation software, designed as powerful industrial-strength solution for creating film-quality animation using a vector and bitmap artwork. It eliminates the need to create animation frame-by frame, allowing you to produce 2D animation of a higher quality with fewer people and resources.
- Synfig is a free and open-source software licensed under GNU GPL v3. The sources are available on GitHub.
This assumes you have the XCode developer tools installed. Next, you'll want to install the homebrew package manager. Visit 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:
Now to install git and svn (assuming you've got the homebrew install directory in your path):
Synfig Studio 2d Animation
Compilig GTK and other dependencies
Then you can install 'gtkmm' with homebrew:
You will also want gtk+:
Then you'll want libxml++, which is currently only available on the secondplanet fork of homebrew:
Synfig itself (Using homebrew and X11)
Synfig Studio
You should now be able to follow the 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:
Then, build ETL by copying the etl formula and installing:
Then (assuming you are still on secondplanet's fork:
And the same for synfigstudio:
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:
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. Describe how to build 'synfig' and 'synfig-studio' with homebrew. Describe build process w/ gtk-osx.
Issues
There are currently numerous issues with Synfig with Imendio's GTK port. Watch out for:
Synfig Studio Open
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.Menus do not function correctly.The file browser doesn't work, so you have to load files from startup.- 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.
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:
'no command found' when running jhbuild
When using jhbuild, you might get an error back like this:
This is because you need to specify the 'build' command when building a package, like so:
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:
Then when prompted again, choose 'ignore error and continue to build' (option 2).
problems with external libraries
Synfig Tutorial
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:
Synfig 2d
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).