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. See the Build page for details.

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

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 Bundle to learn how.

You say your application isn't in the standard modulesets? How can that be? Easy. There are far too many for all of them to be included. But you can make your own moduleset and share it with others at ContributedModulesets. Look there before you start -- someone else might already have pitched in.

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 GtkQuartz 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.