{"id":15108634,"url":"https://github.com/sveinbjornt/platypus","last_synced_at":"2025-04-11T06:21:57.464Z","repository":{"id":41553764,"uuid":"1534955","full_name":"sveinbjornt/Platypus","owner":"sveinbjornt","description":"Create native Mac applications from command line scripts.","archived":false,"fork":false,"pushed_at":"2024-09-09T13:34:31.000Z","size":91024,"stargazers_count":2969,"open_issues_count":44,"forks_count":176,"subscribers_count":60,"default_branch":"master","last_synced_at":"2025-04-03T14:58:42.167Z","etag":null,"topics":["application","application-bundle","cocoa","command-line-app","gui-application","macos","objective-c","osx","platypus","scripting","scripts"],"latest_commit_sha":null,"homepage":"https://sveinbjorn.org/platypus","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sveinbjornt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://paypal.me/sveinbjornt","sveinbjorn.org/donations"]}},"created_at":"2011-03-28T02:18:11.000Z","updated_at":"2025-04-03T10:18:57.000Z","dependencies_parsed_at":"2023-10-03T01:49:03.998Z","dependency_job_id":"a798e9ab-8142-437e-892c-3325a8121af4","html_url":"https://github.com/sveinbjornt/Platypus","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2FPlatypus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2FPlatypus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2FPlatypus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sveinbjornt%2FPlatypus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sveinbjornt","download_url":"https://codeload.github.com/sveinbjornt/Platypus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247024149,"owners_count":20870940,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application","application-bundle","cocoa","command-line-app","gui-application","macos","objective-c","osx","platypus","scripting","scripts"],"created_at":"2024-09-25T22:20:34.663Z","updated_at":"2025-04-03T15:06:57.335Z","avatar_url":"https://github.com/sveinbjornt.png","language":"Objective-C","funding_links":["https://paypal.me/sveinbjornt","sveinbjorn.org/donations","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=BDT58J7HYKAEE"],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n[![Language](https://img.shields.io/badge/language-objective--c-lightgrey)]()\n[![Release](https://shields.io/github/v/release/sveinbjornt/Platypus?display_name=tag)]()\n[![Build](https://github.com/sveinbjornt/platypus/actions/workflows/macos.yml/badge.svg)]()\n\n\u003cimg style=\"float: right; margin-left: 30px; margin-bottom: 20px;\" width=\"196\" height=\"196\" src=\"Documentation/images/platypus.png\" align=\"right\"\u003e\n\n# Platypus\n\n**Platypus** is a developer tool that creates native Mac applications \nfrom command line scripts such as shell scripts or Python, Perl, Ruby, \nTcl, JavaScript and PHP programs. This is done by wrapping the script in an \n[application bundle](https://en.wikipedia.org/wiki/Bundle_(OS_X)) along \nwith a slim app binary that runs the script.\n\nPlatypus makes it easy to share scripts and programs with people who are \nunfamiliar with the command line interface. Native, user-friendly \napplications can be created with a few clicks. It is very easy to \ncreate installers, droplets, administrative applications, login items, \nstatus menu items, launchers and automations using Platypus.\n\n## Features\n\n* Supports shell scripts, Python, Perl, Ruby, PHP, Swift, Expect, Tcl, \nAWK, JavaScript, Dart, AppleScript or any other user-specified interpreter\n* Apps can display graphical feedback of script execution as a progress bar, \ntext window with script output, droplet, WebKit HTML rendering or status item menu\n* Apps support receiving dragged and dropped files or text snippets, which are\nthen passed to the script as arguments\n* Apps can execute scripts with root privileges via the macOS Security Framework\n* Apps can register as handlers for URI schemes and send user notifications\n* Apps can be configured to run in the background (LSUIElement)\n* Set own application icon or select from presets\n* Set app's associated file types, identifier, version, author, etc.\n* Graphical interface for bundling support files with the script\n* Command line tool for automation and build process integration\n* \"Profiles\" can be used to save app configurations\n* Built-in script editor, or linking with external editor of choice\n* Extensive [documentation](Documentation/Documentation.md) and many built-in\nexamples to help you get started\n* Generates slim and speedy native applications that launch and run quickly\n* Fast, responsive native app written in Objective-C/Cocoa\n\n## Install\n\n\u003ca href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=BDT58J7HYKAEE\"\u003e\u003cimg align=\"right\" src=\"https://www.paypalobjects.com/WEBSCR-640-20110306-1/en_US/i/btn/btn_donate_LG.gif\" \u003e\u003c/a\u003e\n\nPlatypus is free, open source software and has been continuously developed \nand maintained for over 20 years. **If you find this program useful, \nplease [make a donation](https://sveinbjorn.org/donations).**\n\n* **[⇩ Download Platypus 5.4.1](https://sveinbjorn.org/files/software/platypus.zip)** \n(Intel/ARM 64-bit, 10.11 or later, ~4.5 MB)\n\nPlatypus can also be installed via [Homebrew](https://brew.sh) (may not be latest version):\n\n```shell\n$ brew install --cask platypus\n```\n\n## Links\n\n* [Platypus Documentation](Documentation/Documentation.md)\n* [Platypus Website](https://sveinbjorn.org/platypus)\n* [man `platypus`](https://sveinbjorn.org/files/manpages/platypus.man.html)\n* [Platypus Appcast XML feed](https://sveinbjorn.org/files/appcasts/PlatypusAppcast.xml)\n* [Old Versions](https://sveinbjorn.org/files/software/platypus)\n\n## Screenshots\n\n### Platypus main window\n\u003cimg src=\"Documentation/images/basic_interface.png\" width=\"664\"\u003e\n\n### Interfaces\n\nPlatypus lets you select one of several different user interfaces for your script.\n\n#### Progress Bar Interface\n\u003cimg src=\"Documentation/images/interface_progressbar.png\" width=\"438\"\u003e\n\n#### Text Window Interface\n\u003cimg src=\"Documentation/images/interface_textwindow.png\" width=\"469\"\u003e\n\n#### Web View Interface\n\u003cimg src=\"Documentation/images/interface_webview.png\" width=\"508\"\u003e\n\n#### Status Menu Interface\n\u003cimg src=\"Documentation/images/interface_statusmenu.png\" width=\"369\"\u003e\n\n#### Droplet Interface\n\u003cimg src=\"Documentation/images/interface_droplet.png\" width=\"294\"\u003e\n\n## Building Platypus\n\nTo build Platypus, run the following command from the repository root \n(requires Xcode build tools):\n\n```shell\n$ make build_unsigned\n```\n\nThe resulting application bundle is created in the `products` directory.\n\n## Some notes on the code\n\nPlatypus is very old software, dating back to the early days of \nMac OS X, around 2003, when I was first learning to use Objective-C \nand the Cocoa APIs. I made many beginner mistakes, some of which remain \nin the structure of the code. This software has since gone through \nabout three dozen significant versions. It has been patched, bugfixed,\nstreamlined to include new features and was transitioned over to \nmodern Objective-C some years ago. It's not how I would write it today.\n\nWith these caveats in mind, here is the BSD-licensed source code to Platypus.\n\n## BSD License \n\nCopyright (c) 2003-2024 Sveinbjorn Thordarson \n\u0026lt;\u003ca href=\"mailto:\"\u003esveinbjorn@sveinbjorn.org\u003c/a\u003e\u0026gt;\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\nlist of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice, this\nlist of conditions and the following disclaimer in the documentation and/or other\nmaterials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its contributors may\nbe used to endorse or promote products derived from this software without specific\nprior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\nIN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,\nINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\nNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\nARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE\nPOSSIBILITY OF SUCH DAMAGE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsveinbjornt%2Fplatypus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsveinbjornt%2Fplatypus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsveinbjornt%2Fplatypus/lists"}