Let's walk through the process of getting Cinder running on your Mac OS X machine. You'll need XCode 3.1 or later, which you can download from Apple right here. If you don't already have a free ADC account, you'll first need to create one, which you can do here.
If you are using one of our packaged releases, you already have everything you need.
Let's try opening and building one of the samples. From the Finder, navigate to the cinder/samples/QuickTime folder and open xcode/quickTimeSample.xcodeproj by double-clicking it. From the Run menu select the Run item. Xcode will take a few seconds to build the sample and then it should launch. You'll be greeted by a standard Mac open dialog box. Navigate to a QuickTime movie on your hard drive and open it. You should see your movie begin playing back in the app's window. Hit the 'o' key to open a different movie file, or you can just drag & drop one from the Finder.
While not strictly necessary, if you would like to be able to step into Cinder's own code during your debug process, you'll want to build Cinder with debug symbols. This is straightforward - just open xcode/cinder.xcodeproj in XCode and build the Debug configuration for the Cinder target. If you are doing iOS development you'll want to do the same thing for the cinder_iphone and cinder_iphone_sim targets.
TinderBox is our GUI tool for creating Cinder projects quickly and easily. It can generate Xcode as well as Visual C++ 2008 and 2010 projects. It is located at cinder/tools/TinderBox in our packaged releases. A guide to creating projects using TinderBox is available here.