open(1) Mac OS X Darwin customization open(1) NAME open - command-line equivalent of double-clicking to open OS X applica- tions, files, urls, x-windows unix programs, preference panes and directories. This is an enhanced version (a superset) of Apple's open command, and (unlike Apple's version) uses a powerful and nuanced cus- tomizable command completion mechanism for the open command. SYNOPSIS open [ -aeFfpswxh ] [ application-name ] file ... DESCRIPTION The open function augments Apple's distributed open command with a super-set of functionality. It opens a file (or a directory, Prefer- ence Pane, Application, Widget or URL), just as if you had double- clicked the file's icon. The augmented version incorporates a powerful zsh command completion system. If no application name is specified, the default application as determined via LaunchServices is used to open the specified files. This works with a programmed command completion for all OS X Application names. This mechanism in turn relies on mdfind in 10.4 and above, or an up-to-date locatedb in 10.3. The distributed function enable_faster_open can be run to aid the user in taking full advantage of the open completion mechanism and ensures that it operates optimally. In 10.4 this is done with a dedicated launchd item, and in 10.3 it is done using the locatedb. If the file is in the form of a URL, the file will be opened as a URL. If the name of a PreferencePane is given with the -p flag, System Pref- erences will open to that pane. This works with a command completion for each installed PreferencePane. You can specify one or more file names (or pathnames), which are inter- preted relative to the shell or Terminal window's current working directory. For example, the following command would open all Word files in the current working directory: open *.doc OPTIONS -a foo [bar] Opens application foo [and file bar] -d bar Opens file with default application -e bar Force the file bar to open with TextEdit -f Reads piped input and opens with TextEdit. -F bar Force the file bar to open with edit function. -p bar.prefPane Open named System Preferences preference pane. -s bar Force the file bar to open with sudo open. -w [foobar] Open the Widget named foobar -x foo [bar] Force the program foo to open [file bar] with open-X11. -h Obtain program help info. FILES ~/.zsh/zshapplist An updatable listing cache of Application names to be used for completing the open -a command. See comp_appgetter(1) and enable_faster_open(1) for further details. _open _mac_applications _mac_files_for_application _retrieve_mac_apps _comp_appgetter enable_faster_open are all zsh functions that must be in the $fpath array for the elaborate _open completion system to work properly. EXAMPLES open -a Microsoft\ Word or open -a "Microsoft Word" opens the applica- tion named 'Microsoft Word' open -a Wor <tabkey> completes the line replacing Wor with Microsoft\ Word open -a Microsoft\ Word foo.doc opens the file 'foo.doc' using the application named 'Microsoft Word' open -p Accounts.prefPane opens the Preference Pane 'Accounts' in 'Sys- tem Preferences' open -p Acco <tabkey> completes with ' open -p Accounts.prefPane ' open . opens a finder window in the current directory. open /Volumes/Macintosh HD/foo.txt opens the document in the default application for its type (as determined by LaunchServices). open /Volumes/Macintosh HD/Applications/ opens that directory in the Finder. open -a TextEdit /Volumes/Macintosh HD/foo.txt' opens the document in the application specified (in this case, TextEdit). open -e /Volumes/Macintosh HD/foo.txt opens the document in TextEdit. open http://www.apple.com/ opens the URL in the default browser. open file://localhost/Volumes/Macintosh HD/foo.txt opens the document in the default application for its type (as determined by LaunchSer- vices). open file://localhost/Volumes/Macintosh HD/Applications/ opens that directory in the Finder. HISTORY Apple's open command first appeared in NextStep, and is distributed in OS X Darwin. The open function was written as a shell-script wrapper for Apple's open to include additional functionality, and has been incorporated, along with an elaborate set of command completions, as a zsh function in the zsh-templates package. The completions for the open command were written by Motoi Washida (Nov 12, 2004 CVS version) and subsequently modified by W. G. Scott, Wataru Kagawa and others. AUTHORS The open command is Copyright (c) 2001 Apple Computer, Inc. All Rights Reserved. The open shell script is a wrapper for the original open program, which remains unaltered. The open shell script (and zsh func- tion) was written by W. G. Scott and is public domain. The _open command completion function was re-written by W. G. Scott based on that of Motoi Washida. The other functions that _open depends on were written entirely by Motoi Washida, except for comp_appgetter which was written by W. G. Scott. SEE ALSO open-x11(1), comp_appgetter(1), enable_faster_open(1) sudo_open(1) edit(1) Mac OS X January 4, 2005 open(1)