corsair-lcd-control/README.md

corsair-lcd-control

Electron app to control Corsair LCD displays. Monitors system stats (CPU temp, RAM, GPU temp), detects USB devices, and manages preferences.

Prerequisites

• Node.js >= 18
• npm >= 9
• Linux: libusb-1.0-0-dev, build-essential, python3
• macOS: Xcode Command Line Tools (xcode-select --install)
• Windows: Build Tools for Visual Studio

Setup

git clone <repo-url>
cd corsair-lcd-control
npm install

postinstall automatically rebuilds native modules for Electron using @electron/rebuild.

Development

npm start

Build

npm run build

Produces platform-specific packages:

Platform	Format
Linux	.AppImage, .deb
macOS	.dmg
Windows	.exe (NSIS)

Rebuild Native Modules

If native modules fail to load after a Node.js or Electron upgrade:

npm run rebuild

Capabilities

• USB — usb module enumerates and connects to devices
• System Tray — background process with context menu (Show/Hide/Quit)
• Preferences — persisted via electron-store (JSON)
• File Pickers — native OS dialogs via Electron's dialog API
• CPU Temperature — systeminformation.cpuTemperature()
• RAM Usage — systeminformation.mem()
• GPU Temperature — systeminformation.graphics()