How to create a status menu app with Platypus?

Select the 'Status Menu' interface in Platypus, configure your script, and build the app; it will run in the menu bar with output accessible via a dropdown menu. Ensure your script outputs text or HTML for display in the menu.

Platypus vs Automator for macOS automation?

Platypus is better for wrapping existing command line scripts into standalone apps with custom interfaces, while Automator is ideal for visual, drag-and-drop automation workflows without coding. Use Platypus when you need to distribute scripts as apps or require root privileges.

Can Platypus apps run without terminal access?

Yes, Platypus apps are native macOS bundles that run independently of the terminal, making them accessible to users unfamiliar with command line interfaces. They execute scripts in the background with graphical feedback as configured.

How to bundle support files with a script in Platypus?

Use the 'Support Files' section in Platypus to add additional resources like images or data files; these are included in the app bundle and accessible via relative paths in your script.

Is Platypus free for commercial use?

Yes, Platypus is open-source under the BSD 3-Clause license, allowing free use, modification, and distribution for commercial purposes without royalties, as long as license terms are followed.

Does Platypus require interpreters like Python to be installed on user systems?

Yes, if your script uses Python or other interpreters, users must have those runtimes installed; Platypus does not bundle interpreters, which can be a dependency hurdle for distribution.

Open-Awesome

Platypus

BSD-3-ClauseObjective-Cv5.5.0

Create native macOS applications from command line scripts with a graphical interface or command line tool.

Visit Website GitHub

3.4k stars197 forks0 contributors

What is Platypus?

Platypus is a macOS developer tool that converts command line scripts—such as shell scripts, Python, Perl, Ruby, or other interpreter-based programs—into native macOS applications. It wraps scripts in an application bundle with a lightweight binary, solving the problem of sharing scripts with users who are not comfortable with the terminal. This enables the creation of user-friendly apps for installers, droplets, administrative tools, and automations.

Target Audience

Developers and scripters on macOS who want to distribute command line tools as graphical applications, especially those targeting users unfamiliar with terminal interfaces or needing drag-and-drop functionality.

Value Proposition

Developers choose Platypus for its simplicity, extensive language support, and flexible interface options, allowing rapid creation of native macOS apps from existing scripts without learning GUI frameworks. Its long-term maintenance and command line tool for automation add reliability and integration capabilities.

Overview

Create native macOS applications from command line scripts.

Use Cases

Best For

Creating macOS installers or droplets from shell scripts
Building administrative tools with root privilege execution
Developing status menu items or login items from scripts
Sharing Python or Perl scripts as standalone applications
Automating app creation in CI/CD pipelines via command line
Making command line utilities accessible to non-technical users

Not Ideal For

Cross-platform projects requiring Windows or Linux application builds
Applications needing complex, custom graphical user interfaces beyond basic feedback windows
Scripts that rely on real-time terminal interaction or continuous user input during execution

Pros & Cons

Pros

Extensive Language Support

Works with over a dozen interpreters including shell, Python, Perl, Ruby, and Swift, allowing developers to wrap scripts in multiple languages without modification.

Flexible Interface Options

Offers pre-built interfaces like progress bars, text windows, droplets, WebKit HTML views, and status menu items, enabling rapid app creation without GUI coding.

Drag-and-Drop Functionality

Apps can accept files or text snippets via drag-and-drop, passing them as script arguments to create user-friendly droplets or tools.

Secure Privilege Execution

Integrates with macOS Security Framework to execute scripts with root privileges, making it suitable for administrative tools and installers.

Cons

macOS-Only Restriction

Exclusively targets macOS with no support for other operating systems, limiting its usefulness for cross-platform development or distribution.

Legacy Codebase Challenges

The author notes the code contains beginner mistakes and outdated structure from its 20-year history, which may affect maintainability and modern integration.

Limited GUI Customization

Interfaces are predefined and not fully customizable; developers cannot easily create complex, bespoke UIs beyond the provided options.

Frequently Asked Questions

Related Projects

Reactotron

A desktop app for inspecting your React JS and React Native projects. macOS, Linux, and Windows.

Stars15,591

Forks974

Last commit25 days ago

React Native Debugger

The standalone app based on official debugger of React Native, and includes React Inspector / Redux DevTools

Stars10,446

Forks816

Last commit2 years ago

Lepton

💻 Democratizing Snippet Management (macOS/Win/Linux)

Stars10,339

Forks477

Last commit19 hours ago

ImageOptim

GUI image optimizer for Mac

Stars9,977

Forks478

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub