1 | .Dd Tue Nov 6 2007 \" DATE
|
---|
2 | .Dt APPSWITCH 1 LOCAL \" Program name and manual section number
|
---|
3 | .Os appswitch 1.1
|
---|
4 | .Sh NAME
|
---|
5 | .Nm appswitch
|
---|
6 | .Nd switch, hide, show, quit, kill or list Mac OS X applications
|
---|
7 | .Sh SYNOPSIS
|
---|
8 | .Nm appswitch
|
---|
9 | .Op Fl sShHqkKlLPfF \" [-sShHqkKlLPfF]
|
---|
10 | .Op Fl c Ar creator \" [-c creator]
|
---|
11 | .Op Fl i Ar bundleID \" [-i bundleID]
|
---|
12 | .Op Fl a Ar name \" [-a name]
|
---|
13 | .Op Fl p Ar pid \" [-p pid]
|
---|
14 | .Op Ar path \" [path]
|
---|
15 | .Sh DESCRIPTION
|
---|
16 | .Nm
|
---|
17 | controls the ordering and visibility of Mac OS X application windows.
|
---|
18 | .Nm
|
---|
19 | can also list or kill running applications.
|
---|
20 | .Ss Matching options
|
---|
21 | Matching identifies one or more applications to manipulate.
|
---|
22 | .Bl -tag -width -indent
|
---|
23 | .It Fl c Ar creator
|
---|
24 | Match by creator (a four-character code, also known as a signature).
|
---|
25 | .It Fl i Ar bundle ID
|
---|
26 | Match by bundle identifier, usually consisting of the reversed dot
|
---|
27 | (.)-separated components of the application developer's Internet domain
|
---|
28 | name, followed by the application name. For example, the Finder's
|
---|
29 | bundle identifier is
|
---|
30 | .Ar com.apple.Finder .
|
---|
31 | Bundle identifiers are not case-sensitive.
|
---|
32 | .Pp
|
---|
33 | If you're extremely concerned about the speed of matching, any other
|
---|
34 | match method is faster than a match by bundle identifier.
|
---|
35 | .It Fl a Ar name
|
---|
36 | Match by application name. This is not a recommended match criterion
|
---|
37 | as applications may be renamed at any time.
|
---|
38 | .It Fl p Ar pid
|
---|
39 | Match by process identifier (PID), a positive integer.
|
---|
40 | .It Ar path
|
---|
41 | Match by bundle path. For packaged applications, this is the package
|
---|
42 | directory whose name typically has the .app extension, for example
|
---|
43 | .Ar /Applications/TextEdit.app
|
---|
44 | for the default installation location of TextEdit. For non-packaged
|
---|
45 | applications, this is the path to the executable itself.
|
---|
46 | .El
|
---|
47 | .Ss Application actions
|
---|
48 | These actions apply to the matched application. If multiple
|
---|
49 | applications match the supplied criteria, only the first matching
|
---|
50 | application is acted upon. The list option
|
---|
51 | .Fl l
|
---|
52 | displays all matching applications.
|
---|
53 | .Bl -tag -width -indent
|
---|
54 | .It Fl s
|
---|
55 | Show the application, making the application's windows frontmost. Do
|
---|
56 | not switch to the application.
|
---|
57 | .It Fl h
|
---|
58 | Hide the application's windows.
|
---|
59 | .It Fl q
|
---|
60 | Quit the application.
|
---|
61 | .It Fl k
|
---|
62 | Kill (force quit) the application. Sends the
|
---|
63 | .Dv SIGTERM
|
---|
64 | signal to the application, which the application may
|
---|
65 | ignore. Equivalent to selecting
|
---|
66 | .Dq Force Quit
|
---|
67 | from an application's menu in the Dock for the first time.
|
---|
68 | .It Fl K
|
---|
69 | Kill (force quit) the application. Sends the
|
---|
70 | .Dv SIGKILL
|
---|
71 | signal to the application, which the application may not ignore.
|
---|
72 | Equivalent to selecting
|
---|
73 | .Dq Force Quit
|
---|
74 | from an application's menu in the Dock for the second time.
|
---|
75 | .It Fl l
|
---|
76 | List applications in a format similar to that of
|
---|
77 | .Xr ps 1 .
|
---|
78 | The columns of the listing are as follows:
|
---|
79 | .Bl -tag -width indent
|
---|
80 | .It PSN
|
---|
81 | The process serial number of the application. Process serial numbers
|
---|
82 | are unique identifiers among both native Mac OS X and Classic
|
---|
83 | applications.
|
---|
84 | .It PID
|
---|
85 | The process identifier, a positive integer which uniquely identifies
|
---|
86 | native Mac OS X processes, usable with the
|
---|
87 | .Fl p
|
---|
88 | matching option. Because all Classic applications run inside
|
---|
89 | TruBlueEnvironment, a single Mac OS X process, their process
|
---|
90 | identifiers appear as -1.
|
---|
91 | .It TYPE
|
---|
92 | The four-character code identifying the process's type, usually
|
---|
93 | .Ql APPL
|
---|
94 | for most applications or
|
---|
95 | .Ql FNDR
|
---|
96 | for the Finder.
|
---|
97 | Classic applications include additional types such as
|
---|
98 | .Ql appe
|
---|
99 | and
|
---|
100 | .Ql APPC
|
---|
101 | for applications which perform the functions of extensions and control
|
---|
102 | panels, respectively. Depending on the Mac OS X version, non-packaged
|
---|
103 | applications may appear with no type or the type
|
---|
104 | .Ql ???? .
|
---|
105 | .It CREA
|
---|
106 | The four-character code identifying the application's creator, usable with the
|
---|
107 | .Fl c
|
---|
108 | matching option. Some Mac OS X applications have no creator, appearing
|
---|
109 | as
|
---|
110 | .Ql ???? ;
|
---|
111 | for these applications you must use the bundle identifier,
|
---|
112 | name or path as match criteria.
|
---|
113 | .It NAME
|
---|
114 | The user-visible application name, usable with the
|
---|
115 | .Fl a
|
---|
116 | matching option. This field is truncated to 20 characters; the
|
---|
117 | remainder of longer application names is not displayed.
|
---|
118 | .It PATH
|
---|
119 | The path to the application bundle, or to the application executable
|
---|
120 | if the application is not packaged, usable with the
|
---|
121 | .Ar path
|
---|
122 | matching option. This field is truncated to the window width, or to 80
|
---|
123 | characters if the window width cannot be determined.
|
---|
124 | .El
|
---|
125 | .It Fl L
|
---|
126 | List applications in a format similar to that of
|
---|
127 | .Xr ps 1 .
|
---|
128 | The columns of the listing are as above, but the path field is not
|
---|
129 | truncated to the window width, and a bundle identifier is added in
|
---|
130 | parentheses after the path, usable with the
|
---|
131 | .Fl i
|
---|
132 | matching option.
|
---|
133 | .It Fl P
|
---|
134 | Print the application's process identifier (PID), a positive integer
|
---|
135 | and unique identifier for all applications except Classic
|
---|
136 | applications.
|
---|
137 | .It Fl f
|
---|
138 | Switch to the application, bringing only the frontmost window of the
|
---|
139 | application to the front.
|
---|
140 | .El
|
---|
141 | .Ss Actions
|
---|
142 | These actions affect all applications currently running.
|
---|
143 | .Bl -tag -width -indent
|
---|
144 | .It Fl S
|
---|
145 | Show all applications, layering the windows of initially hidden
|
---|
146 | applications on top.
|
---|
147 | .It Fl H
|
---|
148 | Hide windows of all applications other than the matched application,
|
---|
149 | or the frontmost application if no application has been matched.
|
---|
150 | .It Fl F
|
---|
151 | Order the current application's windows to the front.
|
---|
152 | .El
|
---|
153 | .Sh SEE ALSO
|
---|
154 | .\" List links in ascending order by section, alphabetically within a section.
|
---|
155 | .\" Please do not reference files that do not exist without filing a bug report
|
---|
156 | .Xr open 1 ,
|
---|
157 | .Xr launch 1 ,
|
---|
158 | .Xr ps 1 ,
|
---|
159 | .Xr kill 1 ,
|
---|
160 | .Xr GetFileInfo 1
|
---|
161 | .Sh BUGS \" Document known, unremedied bugs
|
---|
162 | The
|
---|
163 | .Fl S
|
---|
164 | option may not work in Mac OS X 10.5 with Spaces enabled.
|
---|
165 | .Sh AUTHOR
|
---|
166 | .An "Nicholas Riley" Aq appswitch@sabi.net
|
---|
167 | .\" .Sh HISTORY \" Document history if command behaves in a unique manner
|
---|