Skip to content

Prompt the user to select a window on macOS, mimicking the native screenshot utility

Notifications You must be signed in to change notification settings

karaggeorge/mac-window-select

Repository files navigation

mac-window-select

Prompt the user to select a window on macOS, mimicking the native screenshot utility

Requires macOS 10.12 or later. macOS 10.13 or earlier needs to download the Swift runtime support libraries.

Install

$ npm install mac-window-select

Usage

const selectWindow = require('mac-window-select');

selectWindow({appsToIgnore: ['iTerm2']}).then(console.log);

// {
//   canceled: false,
//   window: {
//     ownerName: 'Google Chrome',
//     name: 'karaggeorge/mac-window-select: Select a window on macOS, mimicking the native screenshot utility',
//     y: 23,
//     x: 1920,
//     width: 1920,
//     height: 1057,
//     number: 141349,
//     pid: 69132
//   }
// }

const process = selectWindow().then(console.log);

process.cancel();

// {
//   canceled: true,
//   window: undefined
// }

Demo

API

selectWindow(options?: {appsToIgnore: string[]}): PCancelable<Object>

Trigger the UI to prompt the user to select a window.

Returns PCancelable<Object> - Object contains the following:

  • canceled Boolean - whether or not the process was canceled, either by the user or by calling .cancel()
  • window Object - window that was selected. Will be undefined if the process is canceled or if the module is not supported

The returned promise is an instance of PCancelable, so it has a .cancel() method which can be used to kill the process

options.appsToIgnore

Array of app names to ignore. If an app is in this list, it will be ignored and the app below it will be used instead.

Note: Use this if you want your own app to not be selectable

selectWindow.isSupported

Will be true if the module is supported (based on macOS version).

Limitations

Currently, there's no way to track the keyboard events, since the script never steals focus from the previously focused app. If you want Escape to cancel, you have to track it in your app and call the cancel() method on the returned promise.

Related

  • mac-focus-window - Focus a window and bring it to the front on macOS
  • mac-windows - Provide Information about Application Windows running

License

MIT

About

Prompt the user to select a window on macOS, mimicking the native screenshot utility

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published