Common GUI controls for OS X scripting
Objective-C C
Latest commit 35e80c4 Dec 21, 2015 @markcarver markcarver Merge pull request #79 from gitter-badger/gitter-badge-1
Add a Gitter chat badge to


Join the chat at

cocoaDialog is an OS X application that allows the use of common GUI controls such as file selectors, text input, progress bars, yes/no confirmations and more with a command-line application. It requires no knowledge of Cocoa, and is ideal for use in shell and Perl scripts (or Ruby, or Python, or... etc).

To get the most up-to-date cocoaDialog, you can either fork cocoaDialog on GitHub and build it yourself. Or you can download the latest beta release on the right. Be forewarned, beta releases might not have complete documentation (it can change quickly). They may also contain bugs or cause cocoaDialog to not work at all. If you have comments, suggestions, questions, problems or bugs, patches, etc - please submit them through Issues on GitHub.

Documentation and Screenshots

Visit the documentation page for screenshots and an overview of available command-line options.

Have a look at the examples page to see some examples of using cocoaDialog.

Mailing Lists

cocoadialog-announce This is a low volume, moderated list for announcements about new versions and features. List archives and subscription form

cocoadialog-users This is a list for anybody to post questions, help other users, discuss what you would like to see in future versions, etc. List archives and subscription form


If you have comments, suggestions, questions, problems or bugs, patches, etc - please submit them through Issues on GitHub If you have a problem or would like to see something added, chances are someone else does too. I warmly welcome any feedback.


A lot of people have helped out with cocoaDialog over the years, and any omissions are simply due to my bad memory. So please submit a pull request to add yourself to this list.

  • Mark A. Stratman
  • Mark Carver
  • Alexey Ermakov
  • Allan Odgaard
  • Wout Mertens
  • Alex Gray

Copyright and License

cocoaDialog is Copyright © 2004, Mark A. Stratman (

It is licensed under the GNU General Public License. 
You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.