docs » EnsureApp

Maximize the application on the current space if it is not maximized already.

Move the window to appear under the provided frame as if it were a menu. This

No-op, will do no action other than moving window to the space and focusing

Table with "Set" of all app names configured for EnsureApp.

Table containing each application's name and it's desired configuration. The

Table containing the default configuration to be used for any app that is not

Logger object used within the Spoon. Can be accessed to set the default log

EnsureApp specific log level override, see hs.logger.setLogLevel for options.

hs.timer for moving an app's first window after being opened via EnsureApp.

Ensure the existence of a window from appName in the current Space.

• appName - Name of the application to ensure.
• actionConfig - Optional actionConfig table with action-specific information.
  • moveMenuBar- hs.menubar to move under with action=move.

• None

• The application name must be one recognized by macOS. hs.applications.find way to discover this.
• The default action is to move the most recently accessed window in any space corresponding to this application to the current space and focus it.
  • This can be configured with defaultAppConfig.
• Refer to EnsureApp.apps for information on how to add additional app-specific configurations like space precedence.

(Callback) Ensure the existence of a window from appName in the current Space.

• appName - Name of the application to ensure.
• actionConfig - Optional actionConfig table with action-specific information.
  • moveMenuBar- hs.menubar to move under with action=move.

• None

• This is a utility class for mapping app ensures to things like menu bars.
• Refer to EnsureApp.apps for information on how to configure apps.

Returns whether or not app name is configured for EnsureApp.

• app - App name to check.

• A boolean representing whether or not the app is configured for EnsureApp.

Get a list of all app names currently configured in EnsureApps.

• spaceID - Optional space ID. If provided, WindowCache will be queried to find apps present in the provided space. These will then be placed at the beginning of the list before the rest of the configured apps are filled. This is useful for things like Lightspot.spoon.

• A table representing the names of all configured app names, with recent apps in the current space being prioritized if spaceID is provided.

• WindowCache window access history does not persist through Hammerspoon reloads.

Given a spaceID, return the name of all configured apps present in the space.

• spaceID - ID of an hs.space to retrieve ensured app names for.

• A table representing the names of all ensured apps currently present in the space, ordered by most recent first.

Spoon initializer method for EnsureApp.

• None

• None

Spoon start method for EnsureApp.

• None

• None

Spoon stop method for EnsureApp.

• None

• None