Skip to content

adamdry/active-win

 
 

Repository files navigation

active-win Build Status

Get the title / window id / app name / process ID of the active window (macOS, Linux, Windows)

Install

$ npm install --save active-win

Usage

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

activeWin().then(result => {
	console.log(result);
	/*
	{
		title: 'npm install',
		id: 54,
		app: 'Terminal',
		pid: 368
	}
	*/
});

API

activeWin()

Returns a Promise for the result Object.

activeWin.sync()

Returns the result Object.

Result

  • title - Window title
  • id - Window ID
  • app - App owning the window
  • pid - Process ID of the app owning the window

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….

Related

Maintainers

License

MIT © Sindre Sorhus

About

Get the title / window id / app name / process ID of the active window

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 87.0%
  • Objective-C 13.0%