manu-st / node-process-windows Goto Github PK

View Code? Open in Web Editor NEW

Manage application windows via a Node API - set focus, cycle active windows, and get active windows

License: MIT License

JavaScript 39.67% C# 60.33%

node-process-windows's Introduction

node-node-process-windows

Manage application windows via a Node API - set focus, cycle active windows, and get active windows

Installation
- Supported Platforms
Usage
Contributing
License
Contact

Installation

Requires Node 4+

    npm install node-process-windows

This module is not supported in browsers.

Supported Platforms

Currently, this module is only supported on Windows, and uses a .NET console app to manage windows.

Pull requests are welcome - it would be great to have this API work cross-platform.

Usage

Get active processes

    var processWindows = require("node-process-windows");

    var activeProcesses = processWindows.getProcesses(function(err, processes) {
        processes.forEach(function (p) {
            console.log("PID: " + p.pid.toString());
            console.log("MainWindowTitle: " + p.mainWindowTitle);
            console.log("ProcessName: " + p.processName);
        });
    });

Focus a window

    var processWindows = require("node-process-windows");

    // Focus window by process...
    var activeProcesses = processWindows.getProcesses(function(err, processes) {
        var chromeProcesses = processes.filter(p => p.processName.indexOf("chrome") >= 0);

        // If there is a chrome process active, focus the first window
        if(chromeProcesses.length > 0) {
            processWindows.focusWindow(chromeProcesses[0]);
        }
    });

    // Or focus by name
    processWindows.focusWindow("chrome");

Get active window

    var processWindows = require("node-process-windows");

    var currentActiveWindow = processWindows.getActiveWindow((err, processInfo) => {
        console.log("Active window title: " + processInfo.mainWindowTitle);
    });