186

How do I set up a shell script to execute from the Mac OSX dock? It seems that simply creating a shortcut will open the file in my editor. Is there a flag I need to set somewhere to tell it to run instead of opening it for editing?

3

12 Answers 12

217

You could create a Automator workflow with a single step - "Run Shell Script"

Then File > Save As, and change the File Format to "Application". When you open the application, it will run the Shell Script step, executing the command, exiting after it completes.

The benefit to this is it's really simple to do, and you can very easily get user input (say, selecting a bunch of files), then pass it to the input of the shell script (either to stdin, or as arguments).

(Automator is in your /Applications folder!)

Example workflow

13
  • 7
    @dbr, GUI button pusher! :) Just kidding, that is a good suggestion! Commented Nov 11, 2008 at 18:20
  • Yeah, it was an excellent suggestion :) I've even written Automator actions for some of my apps and I still forget about it in times like this :)
    – Jason Coco
    Commented Nov 11, 2008 at 23:42
  • I can't get this to work with nohup, a la "nohup /usr/bin/myscript & ; disown -a && exit 0". I need the app/workflow to run a script and exit immediately. Any ideas? :-)
    – hourback
    Commented Jan 23, 2010 at 3:02
  • 3
    @martineau If you open the application by doing open -a SomeAppThing.app --args --etc=2 it should focus. Alternatively you can focus it using Applescript (e.g osascript -e 'tell application "Google Chrome" to activate')
    – dbr
    Commented Feb 8, 2014 at 2:20
  • 2
    Note: if your script is launching a GUI app which will remain open for a while, this will show a constantly-spinning gear icon in the taskbar until the app is closed. One work-around is to add ` &>/dev/null &` to the launching-line of the script so Automator doesn't wait around.
    – ewall
    Commented Aug 12, 2015 at 1:23
61

If you don't need a Terminal window, you can make any executable file an Application just by creating a shell script Example and moving it to the filename Example.app/Contents/MacOS/Example. You can place this new application in your dock like any other, and execute it with a click.

NOTE: the name of the app must exactly match the script name. So the top level directory has to be Example.app and the script in the Contents/MacOS subdirectory must be named Example, and the script must be executable.

If you do need to have the terminal window displayed, I don't have a simple solution. You could probably do something with Applescript, but that's not very clean.

16
  • 2
    You don't happen to know if there is an easy way to have files passed as arguments to the shell script? For files opened using "open with...".
    – Fuzzy76
    Commented Jun 14, 2011 at 12:05
  • 11
    For anyone trying to do this--the name of the app must exactly match the script name. So it really has to be example.sh.app, not just example.app. You will get a warning about damaged app if these do not match
    – Kip
    Commented Aug 15, 2013 at 2:35
  • 1
    To clarify -- I'm an OSX noob -- you mean just create a folder structure like the one shown in your example with the script file placed in it as shown?
    – martineau
    Commented Jan 27, 2014 at 21:37
  • 4
    @martineau Yes, that's correct. If you create a folder whose name ends in .app and with that structure, it will be treated as an executable Application. If you want to look at the contents of that folder in the Finder, you'll need to right click on it and select "view package contents" (because double-clicking on it would run the application). In the Terminal, it will just appear to be a folder. (I'm not sure if Finder will let you rename the folder to .app by itself; you may need to do the rename in the Terminal.) Commented Jan 27, 2014 at 21:48
  • 2
    I just attempted this, and received an error in El Capitan (10.11) of: "You can't open .... because powerpc applications are no longer supported." :D That's quite interesting!
    – AllenH
    Commented Oct 9, 2015 at 9:49
56

On OSX Mavericks:

  1. Create your shell script.
  2. Make your shell script executable:

    chmod +x your-shell-script.sh
    
  3. Rename your script to have a .app suffix:

    mv your-shell-script.sh your-shell-script.app
    
  4. Drag the script to the OSX dock.
  5. Rename your script back to a .sh suffix:

    mv your-shell-script.app your-shell-script.sh
    
  6. Right-click the file in Finder, and click the "Get Info" option.
  7. At the bottom of the window, set the shell script to open with the terminal.

Now when you click on the script in the dock, A terminal window will pop up and execute your script.

Bonus: To get the terminal to close when your script has completed, add exit 0 to the end and change the terminal settings to "close the shell if exited cleanly" like it says to do in this SO answer.

7
  • Nice, this worked for me, any way to chance the icon I wonder. FYI: ALso step 7 is referring to the file and not the menu item ...
    – Mike Q
    Commented Apr 26, 2017 at 21:29
  • the way nice! just all .sh with open terminal.
    – iHTCboy
    Commented Sep 15, 2017 at 8:27
  • @stiemannkj1, Does this show the icon while the app is running? Is there anyway to hide it?
    – Pacerier
    Commented Dec 15, 2017 at 21:10
  • 2
    If you remove .sh suffix, it will run in a terminal in MacOS Catalina by default. Otherwise it will try to run it in XCode.
    – vwvan
    Commented Nov 16, 2020 at 2:52
  • 1
    Supernice trick! works when you remove .sh. You can add program icon by opening cmd+i (info box) and drag a photo to it Commented Feb 20, 2022 at 6:43
19

I know this is old but in case it is helpful to others:

If you need to run a script and want the terminal to pop up so you can see the results you can do like Abyss Knight said and change the extension to .command. If you double click on it it will open a terminal window and run.

I however needed this to run from automator or appleScript. So to get this to open a new terminal the command I ran from "run shell script" was "open myShellScript.command" and it opened in a new terminal.

2
  • wonderful, thanks! Now all need want to make it a perfect solution would be a way to close the terminal window when the script completes.
    – Peter M
    Commented Sep 1, 2011 at 16:50
  • 1
    well if you have close window on exit selected in the terminal preferences you can add the exit command to your script and you'll have what you want. Commented Sep 6, 2011 at 15:40
7

As long as your script is executable and doesn't have any extension you can drag it as-is to the right side (Document side) of the Dock and it will run in a terminal window when clicked instead of opening an editor.

If you want to have an extension (like foo.sh), you can go to the file info window in Finder and change the default application for that particular script from whatever it is (TextEdit, TextMate, whatever default is set on your computer for .sh files) to Terminal. It will then just execute instead of opening in a text editor. Again, you will have to drag it to the right side of the Dock.

4
  • 1
    NOTE: This works like a champ in OS X 10.10 Yosemite. I cannot comment on 10.9
    – Bryan Ash
    Commented Sep 4, 2015 at 14:57
  • 1
    Works on 10.11. Thank you!
    – user5490797
    Commented May 17, 2016 at 14:46
  • Works on 10.12 too! Perhaps my comment about 10.9 was incorrect, but I noticed that you need to make sure you drag it to the part of the dock below the separator. I have no way to re-test 10.9 unfortunately. Commented Dec 5, 2016 at 18:54
  • No need to add it to the Dock. It can be run from the desktop. But there can be no extension. Make it executable and you can just double-click. This is the simplest option I've seen. Commented Oct 18, 2017 at 22:29
6

In the Script Editor:

do shell script "/full/path/to/your/script -with 'all desired args'"

Save as an application bundle.

As long as all you want to do is get the effect of the script, this will work fine. You won't see STDOUT or STDERR.

1
  • 2
    I would suggest: "Save as an application BUNDLE". The bundles launch much faster than applications.
    – e.James
    Commented Nov 21, 2008 at 21:06
5

I think this thread may be helpful: http://forums.macosxhints.com/archive/index.php/t-70973.html

To paraphrase, you can rename it with the .command extension or create an AppleScript to run the shell.

1
  • On Snow Leopard at least, adding a .command extension to a script makes it run in the terminal if you double-click it, but for some reason you still can't drag it into the dock. dbr's and Jeremy's suggestions both worked for me, though.
    – Jo Liss
    Commented Dec 3, 2010 at 13:25
5

As joe mentioned, creating the shell script and then creating an applescript script to call the shell script, will accomplish this, and is quite handy.

Shell Script

  1. Create your shell script in your favorite text editor, for example:

    mono "/Volumes/Media/~Users/me/Software/keepass/keepass.exe"

    (this runs the w32 executable, using the mono framework)

  2. Save shell script, for my example "StartKeepass.sh"

Apple Script

  1. Open AppleScript Editor, and call the shell script

    do shell script "sh /Volumes/Media/~Users/me/Software/StartKeepass.sh" user name "<enter username here>" password "<Enter password here>" with administrator privileges

    • do shell script - applescript command to call external shell commands
    • "sh ...." - this is your shell script (full path) created in step one (you can also run direct commands, I could omit the shell script and just run my mono command here)
    • user name - declares to applescript you want to run the command as a specific user
    • "<enter username here> - replace with your username (keeping quotes) ex "josh"
    • password - declares to applescript your password
    • "<enter password here>" - replace with your password (keeping quotes) ex "mypass"
    • with administrative privileges - declares you want to run as an admin

Create Your .APP

  1. save your applescript as filename.scpt, in my case RunKeepass.scpt

  2. save as... your applescript and change the file format to application, resulting in RunKeepass.app in my case

  3. Copy your app file to your apps folder

2

Exact steps to achieve that in macOS Monterey 12.3

  1. Open Automator
  2. File -> New
  3. Choose Application
  4. Go to Library -> Utilities
  5. Double-click Run Shell Script
  6. Type in whatever command you want to run. For example, try the command to toggle Dark Mode:
osascript -e 'tell app "System Events" to tell appearance preferences to set dark mode to not dark mode'
  1. File -> Save
  2. Drag the saved file to the Dock, done!
1
  • 1
    Simple and to-the-point answer! Commented May 6, 2022 at 0:00
0

pip install mac-appify

I had trouble with the accepted solution but this command worked for me.

Install

pip install mac-appify

Run

/opt/local/Library/Frameworks/Python.framework/Versions/2.7/bin/appify ~/bin/webex_start.sh ~/Desktop/webex.app
-1

Adding to Cahan's clear answer ... to open a shell script from the dock without passing any arguments to it, try:

open [name of your script].scpt"

example:

open "//Users/user/Library/Mobile Documents/com~apple~ScriptEditor2/Documents/myScript.scpt"

-3

Someone wrote...

I just set all files that end in ".sh" to open with Terminal. It works fine and you don't have to change the name of each shell script you want to run.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.