Even when the lid is closed or the screen is off, a Mac may briefly wake in the background for Find My, network connectivity, or system maintenance. macOS calls this behavior DarkWake, and it is a normal system feature.

During this brief wake, the QK Alice Duo may resume its USB connection, turn on its LEDs, or send a keyboard signal even though no key was pressed. This can cause the Mac to leave sleep and enter a full wake state.

Because of this issue, certain background services, including Logi Options+, may crash or malfunction, sometimes requiring the Mac to be restarted or the affected service to be relaunched.

As both a developer and a QK Alice Duo user, I reproduced this issue, analyzed the macOS sleep logs, and examined the USB and keyboard-report behavior of the QK Alice Duo v1.0.6 master firmware. Based on that analysis, I developed two firmware options to address the problem.

Both firmware builds were validated for UF2 integrity, controlled patch scope, USB device information preservation, keyboard-report handling, and Cortex-M4 emulation. Each build was then flashed to a physical QK Alice Duo and tested under macOS DarkWake and normal usage conditions. Both versions were confirmed to work as intended.

DarkWake itself is a normal macOS feature and is not disabled. These firmware builds are designed to control only the unwanted keyboard signals and LED activity produced by the QK Alice Duo during DarkWake.

1. DarkWake Guard — Original LED Behavior, Hardware-Tested

File:

qk_alice_master_v1.0.6_darkwake_guard.uf2

SHA-256:

73e4f2a34a45820f9a38ea7cd4a0ff0cf43e4ce6d955abd1918e43380cea739f

This build temporarily blocks unintended keyboard signals from the QK Alice Duo when the Mac briefly wakes in the background through DarkWake. The keyboard’s original LED behavior remains unchanged.

It was installed on a physical QK Alice Duo and tested through two Find My DarkWake cycles. No unintended keyboard input, user activity, or full wake caused by the QK keyboard was observed.

Pros

  • Blocks unintended keyboard signals while preserving the original firmware behavior
  • Retains the keyboard’s original LED behavior and normal usage
  • Tested on physical QK Alice Duo hardware
  • Recommended for users who prefer minimal behavioral changes
  • No additional macOS application or background agent is required

Limitations

  • Keyboard LEDs may still turn on during DarkWake
  • A key pressed immediately after opening the MacBook lid may occasionally be missed

2. DarkWake Press & LED Guard — Physical-Key Activation, Hardware-Tested

File:

qk_alice_master_v1.0.6_press_led_guard.uf2

SHA-256:

248df749c37a3e95a3300d89396bc4699f42138cf30c674724828cca7b80f69b

This build keeps the QK Alice Duo LEDs off and continuously blocks unintended keyboard signals while the Mac is briefly awake through DarkWake.

Opening the MacBook lid alone does not turn the keyboard LEDs back on. Pressing a real QK key passes that key normally and restores the LEDs only if they were enabled before sleep. If the LEDs were disabled before sleep, they remain off.

After static verification and Cortex-M4 firmware emulation, this build was flashed to a physical QK Alice Duo. Hardware testing confirmed that the LEDs remain off and unintended keyboard signals are blocked during DarkWake. Normal LED and keyboard operation returned when a real key was pressed.

Pros

  • Blocks both unintended keyboard signals and LED activity during DarkWake
  • Continues blocking repeated unintended keyboard signals
  • Passes the first real key press normally
  • Restores the LEDs only if they were enabled before sleep
  • Confirmed to work on physical QK Alice Duo hardware
  • No additional macOS application or background agent is required

Limitations

  • The keyboard LEDs remain off until a physical QK key is pressed after opening the MacBook lid
  • This build may not be suitable for users who prefer the LEDs to return automatically when the lid is opened

Compatibility and installation notes

Both files were developed and tested specifically for the QK Alice Duo v1.0.6 master.

The following items are not modified:

  • VIA keymaps and user configuration
  • VIA Raw HID communication
  • Mouse input
  • Media and system-control keys
  • RGB brightness, color, and effect settings
  • USB device information and firmware version information

Backing up the official firmware and VIA keymap before installation is recommended.

Install the selected UF2 file through the master Local Upgrade function in QK Modified VIA. Do not flash these files to the host, left, or right devices.

Do not use a mass erase procedure.