Mac Run App From Terminal With Arguments

Calling Command-Line Tools

  1. Run Application From Terminal
  2. Open App From Terminal Mac

Open Terminal (several ways) On the Mac, the Terminal app is kinda buried, probably perhaps because those who use a MacOS laptop just for social media probably won’t need a Terminal. But if you’re a developer, it’s hard to get away from using a CLI. There are different ways to open a Terminal command line.

In AppleScript, the do shell script command is used to execute command-line tools. This command is implemented by the Standard Additions scripting addition included with OS X.

Note

The Terminal app in /Applications/Utilities/ is scriptable and provides another way to execute command-line tools from scripts.

Executing Commands

Mac Run App From Terminal With Arguments

The direct parameter of the do shell script command is a string containing the shell code you want to execute, as demonstrated in Listing 39-1, which simply lists a directory.

APPLESCRIPT

Listing 39-1AppleScript: Executing a simple shell command that lists the contents of a directory
  1. do shell script 'ls /Applications/'
  2. (*
  3. --> Result:
  4. 'App Store.app
  5. Automator.app
  6. Calculator.app
  7. Calendar.app
  8. ...'
  9. *)

Since the direct parameter of do shell script is a string, you can concatenate it with other strings at run time. Listing 39-2, for example, concatenates a shell command to a previously defined parameter value.

APPLESCRIPT

Run Application From Terminal

Listing 39-2AppleScript: Concatenating a command with a value
  1. set theHostName to 'www.apple.com'
  2. do shell script 'ping -c1 ' & theHostName

Quoting Strings

The shell uses space characters to separate parameters and gives special meaning to certain punctuation marks, such as $, (, ), and *. To ensure that strings are treated as expected—for example, spaces aren’t seen as delimiters—it’s best to wrap strings in quotes. This process is known as quoting. If your string contains quotes, they must also be escaped (preceded by a / character) so they are interpreted as part of the string. Listing 39-3 shows an example of an error occurring as a result of a parameter that contains a space.

APPLESCRIPT

Listing 39-3AppleScript: An error resulting from a string containing a space
  1. set thePath to '/Library/Application Support/'
  2. do shell script 'ls ' & thePath
  3. --> Result: error 'ls: /Library/Application: No such file or directoryrls: Support: No such file or directory' number 1

The easiest way to quote a string is to use the quoted form property of the text class, as demonstrated in Listing 39-4. This property returns the string in a form that’s safe from further interpretation by the shell, regardless of its contents.

Mac

APPLESCRIPT

Listing 39-4AppleScript: Quoting a string to prevent errors

Open App From Terminal Mac

  1. set thePath to quoted form of '/Library/Application Support/'
  2. --> Result: '/Library/Application Support/'
  3. do shell script 'ls ' & thePath
  4. (*
  5. --> Result:
  6. 'App Store
  7. Apple
  8. ...
  9. '
  10. *)
Run application from terminal

More Information

For more information about the do shell script command, see Commands Reference in AppleScript Language Guide and Technical Note TN2065.

Copyright © 2018 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2016-06-13