Skip to content

Commit 937eba4

Browse files
Add docs for powertoys light switch utility coming in next release (#5867)
* Add shell of new Light Switch utility doc * Add Light Switch to TOC and PT index Still needs a screenshot. The image link is currently broken. * Add activation info for Light Switch * Add light switch settings to docs * Update metadata and intro for SEO * Adjust text to read better * Add Light Switch image for pt index * Add Light Switch GIF to settings section
1 parent 8d2a239 commit 937eba4

5 files changed

Lines changed: 53 additions & 0 deletions

File tree

hub/dev-environment/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -820,6 +820,8 @@ items:
820820
href: ../powertoys/command-palette/microsoft-commandpalette-extensions-toolkit/utilities_ispackaged.md
821821
- name: Color Picker
822822
href: ../powertoys/color-picker.md
823+
- name: Light Switch
824+
href: ../powertoys/light-switch.md
823825
- name: PowerToys Run
824826
href: ../powertoys/run.md
825827
- name: Screen Ruler
1.79 MB
Loading

hub/images/pt-light-switch.png

88.6 KB
Loading

hub/powertoys/index.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,17 @@ The currently available utilities include:
184184
:::column-end:::
185185
:::row-end:::
186186

187+
### Light Switch
188+
189+
:::row:::
190+
:::column:::
191+
[![A screenshot of the Light Switch PowerToys utility for Windows.](../images/pt-light-switch.png)](light-switch.md)
192+
:::column-end:::
193+
:::column span="2":::
194+
[Light Switch](light-switch.md) allows you to automatically switch between light and dark themes in Windows based on the time of day.
195+
:::column-end:::
196+
:::row-end:::
197+
187198
### Mouse utilities
188199

189200
:::row:::

hub/powertoys/light-switch.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Manage your Windows theme with Light Switch
3+
description: Learn how to automatically switch between light and dark themes in Windows using PowerToys Light Switch. Reduce eye strain and save battery life.
4+
ms.date: 09/30/2025
5+
ms.topic: concept-article
6+
ms.localizationpriority: medium
7+
no-loc: [PowerToys, Windows, themes, Light Switch]
8+
# Customer intent: As a Windows power user, I want to use PowerToys Light Switch to automatically change my Windows theme based on the time of day, so that I can have a more comfortable viewing experience.
9+
---
10+
11+
# Light Switch utility
12+
13+
Light Switch is a PowerToys utility that automatically switches your Windows theme between light and dark modes based on time of day. You can configure Light Switch to change themes automatically using sunrise and sunset times in your location, or set custom schedules that work best for your daily routine.
14+
15+
Benefits of using Light Switch include:
16+
17+
- **Reduced eye strain** - Dark themes are easier on your eyes in low-light environments
18+
- **Better battery life** - Dark themes can help extend battery life on devices with OLED displays
19+
- **Automatic adaptation** - No need to manually change themes throughout the day
20+
21+
## How to activate and use Light Switch
22+
23+
Light Switch is enabled by default, but you can activate or deactivate it by opening PowerToys Settings and changing the **Enable Light Switch** toggle. You can then configure the settings to specify the times for switching between light and dark themes based on your local sunrise and sunset times or manually set times.
24+
25+
:::image type="content" source="../images/pt-light-switch-settings.gif" alt-text="An animated GIF of the Light Switch settings.":::
26+
27+
The following settings are available for Light Switch:
28+
29+
| Setting | Description |
30+
| :-- | :-- |
31+
| Enable Light Switch | Turn the Light Switch utility on or off. |
32+
| Theme toggle shortcut | Set a keyboard shortcut to manually toggle between light and dark themes. |
33+
| Mode | Choose between using dark mode from **Sunset to Sunrise** (automatic based on your location) or **Manual** (set specific times). Note that you must have location services enabled and synced for automatic mode to work. |
34+
| Location | Sync your location to enable automatic switching based on local sunrise and sunset times. |
35+
| Offset in minutes | Adjust the time for switching themes by a specified number of minutes before or after sunrise and sunset. |
36+
| Turn on dark mode | Set the time to switch to dark mode when using manual mode. |
37+
| Turn on light mode | Set the time to switch to light mode when using manual mode. |
38+
| Apply dark mode to | Choose whether Light Switch applies dark mode to **System** (Taskbar, Start, and other system UI) and/or **Apps** (supported apps). |
39+
40+
[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

0 commit comments

Comments
 (0)