const activeWindow = require('active-win');

(async () => {
	console.log(await activeWindow(options));
	/*
	{
		title: 'Unicorns - Google Search',
		id: 5762,
		bounds: {
			x: 0,
			y: 0,
			height: 900,
			width: 1440
		},
		owner: {
			name: 'Google Chrome',
			processId: 310,
			bundleId: 'com.google.Chrome',
			path: '/Applications/Google Chrome.app'
		},
		url: 'https://sindresorhus.com/unicorn',
		memoryUsage: 11015432
	}
	*/
})();

API

activeWindow(options?)

options

Type: object

screenRecordingPermission (macOS only)

Type: boolean
Default: true

Enable the screen recording permission check. Setting this to false will prevent the screen recording permission prompt on macOS versions 10.15 and newer. The title property in the result will always be set to an empty string.

activeWindow.sync(options?)

Result

Returns a Promise<object> with the result, or Promise<undefined> if there is no active window or if the information is not available.

platform (string) - 'macos' | 'linux' | 'windows'
title (string) - Window title
id (number) - Window identifier
bounds (Object) - Window position and size
- x (number)
- y (number)
- width (number)
- height (number)
owner (Object) - App that owns the window
- name (string) - Name of the app
- processId (number) - Process identifier
- bundleId (string) - Bundle identifier (macOS only)
- path (string) - Path to the app
url (string?) - URL of the active browser tab if the active window is Safari (includes Technology Preview), Chrome (includes Beta, Dev, and Canary), Edge (includes Beta, Dev, and Canary), Brave (includes Beta and Nightly), Mighty, Ghost Browser, Wavebox, Sidekick, Opera (includes Beta and Developer), or Vivaldi (macOS only)
memoryUsage (number) - Memory usage by the window owner process

OS support

It works on macOS, Linux, and Windows 7+.

Note: On Windows, there isn't a clear notion of a "Window ID". Instead it returns the memory address of the window "handle" in the id property. That "handle" is unique per window, so it can be used to identify them. Read more….

Users

active-win-log - Window-usage logging CLI.
active-app-qmk-layer-updater - Sends the active app info to a QMK device to change keymap layers automatically.

active-win-cli - CLI for this module

Maintainers

Keywords

FAQs

What is @todesktop/active-win-prebuild?

Is @todesktop/active-win-prebuild well maintained?

Package last updated on 10 Dec 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install