monitor-sleeper

This program puts a second monitor into the standby state when you do not use it. The program starts the monitor again when you use it.

The program has support for GlazeWM. If a workspace on the second monitor contains a window, the monitor stays on. Thus you can keep a monitor on for your chat window or your log window, and the monitor goes to standby when that workspace is empty.

The program is one PowerShell script. It has no dependencies. It sends the standby command directly to the monitor with the Windows DDC/CI interface.

GlazeWM is not necessary. If you do not use GlazeWM, refer to "Use without GlazeWM".

Before you start

You must have these items:

• Windows 10 or Windows 11
• Windows PowerShell 5.1
• A monitor with DDC/CI support
• GlazeWM (optional)

Many monitors have DDC/CI in the off state when they are new. If your monitor does not obey this program, open the monitor menu. Then set DDC/CI to on.

Installation

1. Download the four files into one folder.

2. Open PowerShell in that folder.

3. Run this command to find the display index:

   .\monitor-sleeper.ps1 -List

   The command shows each monitor with its display index, its name, and its size. Example:

   [0] Primary Display  1920x1080 at (0,0)
   [1] Secondary Display  1920x1080 at (1920,0)
   

4. Run this command to find the GlazeWM index of the same monitor:

   $i=0; (glazewm query monitors|ConvertFrom-Json).data.monitors|%{ "[$i] $($_.hardwareId)"; $i++ }

   The two lists can have a different sequence.

5. Open settings.json in a text editor.

6. Set displayIndex to the index from step 3.

7. Set glazeMonitorIndex to the index from step 4.

8. Set idleSeconds to the time in seconds before the monitor goes into standby.

9. Set keepAwakeWorkspaces to the workspaces that must keep the monitor on (when an app is present within the focused workspace). To make this easier, each workspace should be assigned a monitor in the GlazeWM Config file (Ex: I have my even workspaces set to my secondary monitor):

   "keepAwakeWorkspaces": [2, 4, 6, 8, 10]

   names are also permitted:

   "keepAwakeWorkspaces": ["chat", "mail"]

10. Save the file.

11. Run this command to examine the settings:

    .\monitor-sleeper.ps1 -Test

    The program prints its decisions. It does not change the monitor in this mode. Push Ctrl+C to stop the program.

12. Run this command to start the program:

    .\monitor-sleeper.ps1

13. Add to the Windows startup folder if you want to.

Use without GlazeWM

The program operates without GlazeWM. The mouse rule and the focus rule do not need GlazeWM.

Warning: you must make the workspace list empty. If the list is not empty and GlazeWM is absent, the program cannot get the workspace data. In that condition the program keeps the monitor on for safety, and the monitor never goes into standby.

Do these steps:

1. Do the installation steps, but do step 4 and step 7 no more. These two steps are for GlazeWM only. Keep the default value of glazeMonitorIndex.

2. Set the workspace list to an empty list:

   "keepAwakeWorkspaces": []

3. Save the file.

The program then ignores GlazeWM fully. It does not start the glazewm command.

More than one monitor

The program can control two monitors or more. Each monitor has its own idle time and its own workspace list. One monitor can go into standby while the other monitor stays on.

To control more than one monitor, use a displays list. Each item in the list has the three monitor settings. Remove displayIndex, glazeMonitorIndex, and keepAwakeWorkspaces from the top level of the file.

{
  "idleSeconds": 180,
  "pollSeconds": 0.5,
  "glazePollSeconds": 3,
  "offValue": 4,
  "wakeOnFocus": true,
  "wakeOnMouseEnter": true,
  "displays": [
    { "displayIndex": 1, "glazeMonitorIndex": 1, "keepAwakeWorkspaces": [2, 4] },
    { "displayIndex": 2, "glazeMonitorIndex": 2, "keepAwakeWorkspaces": ["chat"] }
  ]
}

Do step 3 and step 4 of the installation again for each monitor. Then put the two indexes in the item for that monitor.

The other settings stay at the top level. They apply to all the monitors.

You can give one monitor a different time. Put idleSeconds in the item for that monitor. This value replaces the value at the top level for that monitor only.

"displays": [
  { "displayIndex": 1, "glazeMonitorIndex": 1, "keepAwakeWorkspaces": [2, 4] },
  { "displayIndex": 2, "glazeMonitorIndex": 2, "keepAwakeWorkspaces": [], "idleSeconds": 30 }
]

Settings

All settings are in settings.json.

Setting	Function
displays	A list of monitors. Refer to "More than one monitor".
displayIndex	The monitor that goes into standby. Use the index from -List.
glazeMonitorIndex	The position of the same monitor in glazewm query monitors.
idleSeconds	The time in seconds that a monitor stays unused before standby. You can also put this setting in one item of the displays list.
pollSeconds	The interval between the checks. Decimal values are permitted. The minimum is 0.05.
glazePollSeconds	The minimum interval between two glazewm commands.
offValue	The standby command value. Use 4 first. If the monitor does not obey, use 5.
keepAwakeWorkspaces	The workspaces that keep the monitor on. An empty list stops the GlazeWM rule.
wakeOnFocus	If true, a window in focus on that monitor keeps the monitor on.
wakeOnMouseEnter	If true, mouse movement on that monitor keeps the monitor on.

Known Issues

• Some monitors do not obey a DDC/CI standby command that comes from software. If your monitor stays on, set offValue to 5.
• Some monitors do not accept DDC/CI commands while they are in standby. If your monitor does not come on again, move the mouse pointer, or use the monitor power button.
• When entering a screen saver, the secondary monitor will turn back on (and display the screensaver). - I honestly don't hate this.

---

Engineered with Anthropic's Opus 5 Model