python pyobjc utility for macOS for displaying dialogs using .nib files
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples Added ImageView Example (#5) Jan 31, 2018
.gitignore Added "Setup Assistant" example (#3) Apr 14, 2017
LICENSE Update Jul 5, 2017


Nibbler is a Python PyOjbC utility for displaying dialogs using .nib files.


The best way to play with nibbler is to download this git repo and play with the two example files.

  1. Download this repo:

    git clone
    cd nibbler/examples
  2. Now you can choose between running the and scripts.

Getting Started

Now that you've seen what nibbler does from the examples you'll likely want to build your own dialog box. To get started you'll need:

  • A Mac with Python (fortunately all modern Macs come with this built-in)
  • The PyObjC bridge (again comes built-in)
  • Xcode (available from the MAS or Apple Developer Portal)

Once the requirements above are meet we're able to create our dialog.

  1. Launch Xcode.
  2. From your menu bar select File > New > File....
  3. For the correct template in Xcode 8, select macOS and in User Interface select Window.
  4. Click Next and you'll be prompted to save your file. Select a name and location.
  5. Now we need to get this file into a .nib file. From your menu bar select File > Export.... Make sure and change your File Format to Interface Builder Cocoa NIB.
  6. Now you need to write the python code to connect your elements.


  • Make sure and give all of your UI elements in Xcode a static identifier. Xcode by default sets identifiers to Automatic however that does not work with nibbler.
  • Printing your content handles is very helpful: print n.nib_contents
  • Printing your views can also help with troubleshooting: print n.views
  • Consult Apple's macOS Human Interface Guidelines for the authoritative source on the correct usage of UI elements.
  • Consult Apple's Start Developing iOS Apps (Swift):Build a Basic UI for a tutorial on building a UI in Xcode.