nightlight-cli

Night Light CLI 🌓

Control Windows 10/11's Night Light feature programmatically.

The binary format of the registry value was reverse engineered from NightLight.cs in the tiny-screen project by Maclay74, and converted to Typescript with help from ChatGPT.

For changing the scheduled Night Light settings via a slightly different registry key, see this post: https://superuser.com/a/1209192.

Compatibility

Windows Version	Status
Windows 11 22H2	✅ Tested
Windows 10 21H2	❔ Untested but should work

Please open an issue if you find that this package does not work on your version of Windows.

Contribution

Since this works by modifying registry keys, it can be done in any language. A few examples are implemented already.

To Do

• Implement scheduled Night Light functionality

Language	Status
TypeScript	✅
CLI (NodeJS)	✅
Powershell	✅
C#	⬆️ upstream
Python	✏️ Open a PR
Rust	✏️ Open a PR

Other | ✏️ Open a PR

Getting started (TypeScript)

const nightLight = new NightLight()

console.log('Supported:', nightLight.supported())

console.log('Enabled:', await nightLight.enabled())

// Toggle Night Light
console.log('Toggling')
await nightLight.toggle()

console.log('Enabled:', await nightLight.enabled())

// Control strength (0-100%)
console.log('Current strength:', await nightLight.getStrength(), '%')

// Set to 75% warmth
await nightlight.setStrength(75)

Getting started (CLI)

npm i -g nightlight-cli

# Toggle Night Light on/off
nightlight toggle

# Get current strength
nightlight strength

# Set strength (0-100%)
nightlight strength 75

...or...

# Toggle Night Light
npx nightlight-cli toggle

# Get/set strength
npx nightlight-cli strength
npx nightlight-cli strength 75

Getting started (Powershell)

Import-Module <path_to_psm1_file>

# Check if Night Light is supported
Test-NightLightSupported

# Enable Night Light
Enable-NightLight

# Toggle/Switch Night Light
# If enabled, disables Night Light, and vice versa.
Switch-NightLight

# Disable NightLight
Disable-NightLight

# Get current strength (returns 0-100%)
Get-NightLightStrength

# Set strength (accepts 0-100%)
Set-NightLightStrength -Percentage 75

Strength Control

The Night Light strength can be controlled on a scale from 0% (coolest) to 100% (warmest). This corresponds to color temperatures from 6500K to 1200K. The strength can be controlled using any of the provided implementations:

• CLI: nightlight strength [percentage]
• TypeScript: nightLight.getStrength() and nightLight.setStrength(percentage)
• PowerShell: Get-NightLightStrength and Set-NightLightStrength -Percentage value