OS X developer tool that creates application bundles from scripts
Objective-C Shell Lex Groff Other
Latest commit 6edf784 Nov 17, 2016 @sveinbjornt Builds with XCode 8.1
Permalink
Failed to load latest commit information.
Application Updated to recommended project settings in XCode 8, silenced compiler… Oct 13, 2016
CommandLineTool Fixed issue #78 where bundled file args were not working in command l… Oct 5, 2016
Documentation Merge branch 'master' of https://github.com/sveinbjornt/Platypus Oct 3, 2016
Examples Got rid of text encoding settings and upped version to 5.2 Mar 6, 2016
Frameworks/Sparkle.framework Updated to latest Sparkle not vulnerable to MITM Feb 19, 2016
Icons Added preset support for Swift interpreter + refactored ScriptAnalyse… Dec 17, 2015
OCLint Added OCLint build target + install script for tools it depends on Mar 3, 2016
Platypus.xcodeproj Builds with XCode 8.1 Nov 17, 2016
ScriptExec Updated to recommended project settings in XCode 8, silenced compiler… Oct 13, 2016
Shared Updated to recommended project settings in XCode 8, silenced compiler… Oct 13, 2016
Sparkle Lots of minor refactoring Feb 13, 2016
.gitignore Added OCLint build target + install script for tools it depends on Mar 3, 2016
.gitmodules Slimmed down the Iconfamily-related code Dec 6, 2015
CHANGES.txt Fixed #72, console log spamming due to missing CFBundleTypeRole Oct 5, 2016
Common.h Updated formatting and minor rev to docs Oct 3, 2016
Common.m Got rid of text encoding settings and upped version to 5.2 Mar 6, 2016
PrefixHeader.pch Lots of minor refactoring Feb 13, 2016
README.md Updated formatting and minor rev to docs Oct 3, 2016
build_release.sh Prepped for 5.1 release - updated appcast + version history Feb 6, 2016
make_examples.pl Fixed bug in perl script that builds examples where it would fail if … Mar 3, 2016
src_loc_stats.sh Strip leading whitespace in wc output using sed in LOC count script Jan 12, 2016
uncrustify.cfg Some cleanup, updated docs for GitHub, removed some unnecessary files Jun 14, 2015

README.md

Platypus

Platypus is an OS X developer tool that creates native Mac applications from interpreted scripts such as shell scripts or Perl and Python programs. This is done by wrapping the script in an application bundle directory structure along with an application binary that runs the script.

Platypus makes it easy to share scripts and programs with those unfamiliar with the command line interface. Native user-friendly applications can be created with a few clicks. It is very easy to create installers, administrative applications, login items, status menu items, launchers, automations and droplets using Platypus.

Documentation

Screenshot

Platypus Screenshot

Some notes on the code

Platypus is very old software, dating back to the early days of Mac OS X. It was originally written in C using the Carbon APIs, but later transitioned to Cocoa during the time I was learning to use Objective-C and the Cocoa APIs. I made many beginner mistakes, some of which remain in the code. The software has gone through over three dozen significant versions. It has been patched, bugfixed, streamlined to include new features and was recently transitioned over to modern Objective C.

With these caveats in mind, here is the BSD-licensed source code to Platypus.

License

Copyright (c) Sveinbjorn Thordarson <sveinbjornt@gmail.com> All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Hexley Icon

Hexley DarwinOS Mascot Copyright (c) 2000 Jon Hooper. All Rights Reserved.