Skip to content

Add KC_DICTATION keycode for macOS Dictation#26305

Open
ankitsxchdeva wants to merge 1 commit into
qmk:developfrom
ankitsxchdeva:dictation
Open

Add KC_DICTATION keycode for macOS Dictation#26305
ankitsxchdeva wants to merge 1 commit into
qmk:developfrom
ankitsxchdeva:dictation

Conversation

@ankitsxchdeva

@ankitsxchdeva ankitsxchdeva commented Jul 1, 2026

Copy link
Copy Markdown

Description

Adds KC_DICTATION mapping to the standard usage 0x0CF. Requires EXTRAKEY_ENABLE

Types of Changes

  • Core
  • Bugfix
  • New feature
  • Enhancement/optimization
  • Keyboard (addition or update)
  • Keymap/layout (addition or update)
  • Documentation

Issues Fixed or Closed by This PR

Checklist

  • My code follows the code style of this project: C, Python
  • I have read the PR Checklist document and have made the appropriate changes.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • I have tested the changes and verified that they work and don't break anything (as well as I can manage).

Maps to the standard HID Consumer page 'Voice Command' usage (0x0CF),
which macOS (Sonoma and later) and iPadOS interpret as Dictation. Added
as a media/consumer keycode at 0x00C3, appending to the end of the
existing consumer range with no keycode shifting required.
@github-actions github-actions Bot added core documentation dd Data Driven Changes labels Jul 1, 2026
@drashna

drashna commented Jul 6, 2026

Copy link
Copy Markdown
Member

This could be handled just as well as a community module.

Eg:
https://github.com/drashna/qmk_modules/blob/main/extra_extra_key/extra_extra_key.c

@ankitsxchdeva

Copy link
Copy Markdown
Author

I looked at the module route but selfishly wanted this change in core so that downstream forks like via/vial could add it.

It's a standard HID code, not custom behavior. It's also appended at the end of the consumer range so there are no shifts required.

Also it's consistent with the other core keycodes:

KC_ASSISTANT       = 0x00C0
KC_MISSION_CONTROL = 0x00C1
KC_LAUNCHPAD       = 0x00C2

I can close it out if you disagree!

@R1DEN

R1DEN commented Jul 17, 2026

Copy link
Copy Markdown

@ankitsxchdeva agree on this one, this is a standard mac button. so it does make sense to have it as a core part, if it IS is in fact a stock button on a major patform (MacOS) and not just an edge case on some custom device.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core dd Data Driven Changes documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants