GTK-OSX

Build, Bundle, and Integrate GTK+-2 Applications and Libraries on Macintosh OSX

GTK-OSX is a build system to easily build GTK+-2 libraries and applications, along with all of the dependencies, on OSX. It uses the JHBuild program and custom modulesets tailored for OSX.

Before you start, make sure that you meet the Prerequisites. Download and run gtk-osx-build-setup.sh, open a terminal session, and run a few commands and you've got your app built. Detailed instructions, warnings, and work-arounds are provided on the Build page. Read it carefully!

Some projects have used GTK-OSX to port their applications or libraries to OSX and have told us about it. Read about them at Success Stories.

Of course, once you've built an app, you don't want to be opening a terminal session all the time to run it, you want to have a pretty icon in Finder to double-click. Read Bundling to learn how.

Next, you want your application's menu to be on the menubar on the top of your screen not on the application's window. That's a bit more work and requires some programming. Have a look at Integrate for to get started.

Support is available from mailing lists and a forum; tickets are tracked here in Trac.

Please Help!

If you can help out, or just want to see the latest source code, visit Developers. Follow the links to learn more about Gtk Quartz and GtkQuartzEngine.

Bugs

There are plenty. Please do use this Trac for reporting Gtk-OSX bugs, or proposing enhancements. Be as specific as you can, and provide as much information as you can. Always include what kind of Mac you're using, and make sure that there's no way your Gtk-OSX application can see your Fink or MacPorts installation if you have one.

But do recognize that there's nothing we can do about bugs in the programs or libraries you're building. If you have a problem with a Gtk+ function not working right under OSX, don't tell us. We can't do anything about it. File a bug report on the appropriate library's bug tracker and pester the developers on their mailing list to fix it.

Also recognize that building a Gtk+ application isn't always straightforward, and the default options might not work for your particular application. There are plenty of ways to customize your build. If you're having trouble, ask on the forum or user's mailing list for support rather than just firing off a bug report. Bug reports which are really support requests will just be closed as invalid with instructions to go to the forum or mailing list.

A more complete description is available at the Home Page; GTK-OSX is managed on SourceForge's Project Page.