Browse the docs

Light or dark mode

Switches macOS to dark mode or light mode, or toggles between them.

Switch to mode mode

Keyboard Maestro: DarkMode

Details #

Sets the system appearance. mode is dark, light or toggle. Toggle is the default, and flips whichever mode is on now.

The output is dark or light, whichever is on afterwards, and the note says "Dark mode is on" or "Light mode is on".

Parameters #

ParameterTypeRequiredValuesWhat it does
modeone ofdark light toggledark, light or toggle. The default is toggle. Any other value fails.

Every step also accepts label, onFailure, timeout and dryRunSafe.

Examples #

Switch to dark mode. This really changes the system appearance:

Switch to dark mode (really changes the appearance)
Do
  1. Switch to Dark mode
  2. Show “Dark mode on”
Open in Switchboard to try it

Gotchas #

  • It changes the appearance through System Events, so Switchboard Engine needs Automation permission for it. Without it the step fails and points to System Settings > Privacy & Security > Automation.

  • In a dry run the step is simulated.

See also #

Set desktop picture, Change screen brightness