Windows-Controls

A comprehensive, lightweight, and zero-dependency toolkit for controlling Windows system features directly from Node.js.

Overview

windows-controls provides a unified API to interface with various Windows-specific functionalities such as audio volume, display brightness, WiFi connections, system power states, and hardware diagnostics. It utilizes optimized PowerShell commands and native C# snippets to ensure high performance and reliability without requiring heavy external binaries.

Features

• Audio: Get/Set volume, mute/unmute.
• WiFi: SSID status, network listing, and connection management.
• Display: Screen brightness control.
• Power: Battery status, shutdown, restart, and sleep.
• Media: Global media keys (Play/Pause, Next, Previous).
• System Info: OS details, CPU model, RAM, and Disk usage.
• Process: List and kill processes by name or ID.
• UI: Lock workstation, empty recycle bin, and monitor control.
• Shell: Built-in wrappers for PowerShell and CMD execution.
• Hardware: CPU temperature and GPU/Motherboard/BIOS diagnostics.

Installation

npm install windows-controls

Quick Start

import { audio, wifi, display, ui } from 'windows-controls';

// Set system volume to 50%
await audio.setVolume(50);

// Get current WiFi SSID
const ssid = await wifi.getCurrentSsid();
console.log(`Connected to: ${ssid}`);

// Set screen brightness
await display.setBrightness(75);

// Lock the workstation
await ui.lock();

API Modules

Audio (audio)

• getVolume(): Returns volume level (0-100).
• setVolume(level): Sets volume level.
• isMuted(): Returns boolean.
• setMute(bool): Toggles mute state.

WiFi (wifi)

• getCurrentSsid(): Returns active SSID.
• getAvailableNetworks(): Returns array of SSIDs.
• connect(ssid): Connects to a known profile.
• disconnect(): Disconnects current session.

Display (display)

• getBrightness(): Returns brightness level.
• setBrightness(level): Sets brightness level (0-100).

Power (power)

• getBattery(): Returns { percentage, status }.
• shutdown(delay) / restart(delay): Power management.
• sleep(): Puts system to sleep.

Media (media)

• playPause(), next(), prev(): Global media control.

Hardware (hw)

• getCpuTemp(): Returns CPU temperature in Celsius.
• getGpuInfo(): Returns GPU specifications.
• getMotherboard(): Returns board manufacturer and product.

Requirements

• OS: Windows 10/11
• Node.js: 14.x or higher
• Permissions: Some features (like CPU temperature or WiFi management) may require administrative privileges.

License

MIT