starred/terminal
1
0
Fork 0
mirror of https://github.com/microsoft/terminal.git synced 2026-02-04 05:35:20 +00:00
Code Issues 19.0k Packages Projects Releases 20 Wiki Activity

Multimedia Key Hotkey Support #13753

New Issue
Closed
opened 2026-01-31 03:51:10 +00:00 by claunia · 5 comments
claunia commented 2026-01-31 03:51:10 +00:00
Owner
Copy Link

Originally created by @allquixotic on GitHub (May 9, 2021).

Description of the new feature/enhancement

In the documentation at https://docs.microsoft.com/en-us/windows/terminal/customize-settings/actions#accepted-modifiers-and-keys the listed keys are:

Type | Keys
-- | --
Function and alphanumeric keys | f1-f24, a-z, 0-9
Symbols | `, plus, -, =, [, ], \, ;, ', ,, ., /
Arrow keys | down, left, right, up, pagedown, pageup, pgdn, pgup, end, home
Action keys | tab, enter, esc, escape, space, backspace, delete, insert, app, menu
Numpad keys | numpad_0-numpad_9, numpad0-numpad9, numpad_add, numpad_plus, numpad_decimal, numpad_period, numpad_divide, numpad_minus, numpad_subtract, numpad_multiply

The Back, Forward, and other multimedia keys are not mentioned. I have a TEX Shinobi and would like to bind the "Back" and "Forward" keys to previous/next tab. I had this working 10 years ago in gnome-terminal; would be nice to have this on Windows by now. :)

The nice thing about being able to use Back and Forward specifically for this is because those keys are already useful in web browsers to do what you would expect, so I don't have to write an AutoHotkey macro or rebind the behavior of the keys at the hardware level to get this working in both Terminal and on the web.

Proposed technical implementation details (optional)

Not sure exactly, but I believe the multimedia keys have normal key codes, at least on Windows. PassMark KeyboardTest reports "Windows Key Code" 0xA6 (decimal 166) for Back and 0xA7 / decimal 167 for Forward. Not sure if they are handled the same way as other keys, since no "BIOS Key Code" gets sent. I've always suspected something was a little weird / non-standard about multimedia keys.

Originally created by @allquixotic on GitHub (May 9, 2021). # Description of the new feature/enhancement In the documentation at https://docs.microsoft.com/en-us/windows/terminal/customize-settings/actions#accepted-modifiers-and-keys the listed keys are: ``` Type | Keys -- | -- Function and alphanumeric keys | f1-f24, a-z, 0-9 Symbols | `, plus, -, =, [, ], \, ;, ', ,, ., / Arrow keys | down, left, right, up, pagedown, pageup, pgdn, pgup, end, home Action keys | tab, enter, esc, escape, space, backspace, delete, insert, app, menu Numpad keys | numpad_0-numpad_9, numpad0-numpad9, numpad_add, numpad_plus, numpad_decimal, numpad_period, numpad_divide, numpad_minus, numpad_subtract, numpad_multiply ``` The `Back`, `Forward`, and other multimedia keys are not mentioned. I have a TEX Shinobi and would like to bind the "Back" and "Forward" keys to previous/next tab. I had this working 10 years ago in gnome-terminal; would be nice to have this on Windows by now. :) The nice thing about being able to use Back and Forward specifically for this is because those keys are already useful in web browsers to do what you would expect, so I don't have to write an AutoHotkey macro or rebind the behavior of the keys at the hardware level to get this working in both Terminal and on the web. # Proposed technical implementation details (optional) Not sure exactly, but I believe the multimedia keys have normal key codes, at least on Windows. PassMark KeyboardTest reports "Windows Key Code" 0xA6 (decimal 166) for Back and 0xA7 / decimal 167 for Forward. Not sure if they are handled the same way as other keys, since no "BIOS Key Code" gets sent. I've always suspected something was a little weird / non-standard about multimedia keys.
claunia commented 2026-01-31 03:51:12 +00:00
Author
Owner
Copy Link

@zadjii-msft commented on GitHub (May 11, 2021):

Hmm. I'd bet those keys are

name hex description
VK_BROWSER_BACK 0xA6 Browser Back key
VK_BROWSER_FORWARD 0xA7 Browser Forward key
VK_BROWSER_REFRESH 0xA8 Browser Refresh key
VK_BROWSER_STOP 0xA9 Browser Stop key
VK_BROWSER_SEARCH 0xAA Browser Search key
VK_BROWSER_FAVORITES 0xAB Browser Favorites key
VK_BROWSER_HOME 0xAC Browser Start and Home key

Doesn't seem totally unreasonable to add those. We'd need to come up with sensible names for those keys, but then they could be added pretty easily.

@zadjii-msft commented on GitHub (May 11, 2021): Hmm. I'd bet those keys are name | hex | description -- | -- | -- VK_BROWSER_BACK | 0xA6 | Browser Back key VK_BROWSER_FORWARD | 0xA7 | Browser Forward key VK_BROWSER_REFRESH | 0xA8 | Browser Refresh key VK_BROWSER_STOP | 0xA9 | Browser Stop key VK_BROWSER_SEARCH | 0xAA | Browser Search key VK_BROWSER_FAVORITES | 0xAB | Browser Favorites key VK_BROWSER_HOME | 0xAC | Browser Start and Home key Doesn't seem totally unreasonable to add those. We'd need to come up with sensible names for those keys, but then they could be added pretty easily.
claunia commented 2026-01-31 03:51:12 +00:00
Author
Owner
Copy Link

@allquixotic commented on GitHub (May 11, 2021):

For the docs / name for each key, how about

  • Add a new type of key: Multimedia keys
  • Name them as follows: back, forward, refresh, stop, search, favorites, start

Obviously VK_BROWSER_HOME can't map to "home" since that's already another key.

If that sounds good to you, I can work on a PR. C++ is like my third strongest language, but I should definitely be able to make such an easy change.

@allquixotic commented on GitHub (May 11, 2021): For the docs / name for each key, how about - Add a new type of key: **Multimedia keys** - Name them as follows: back, forward, refresh, stop, search, favorites, start Obviously `VK_BROWSER_HOME` can't map to "home" since that's already another key. If that sounds good to you, I can work on a PR. C++ is like my third strongest language, but I should definitely be able to make such an easy change.
claunia commented 2026-01-31 03:51:12 +00:00
Author
Owner
Copy Link

@zadjii-msft commented on GitHub (May 12, 2021):

I'd probably go with

browser_back
browser_forward
browser_refresh
browser_stop
browser_search
browser_favorites
browser_home

I'd be a little worried with back maybe being confusing, and start might be confusing with the win key as well. At least that's got parity with the actual VKEY constants, so that makes sense to me. I'm pretty sure the only file you'll need to edit is src\cascadia\TerminalSettingsModel\KeyChordSerialization.cpp. @carlos-zamora can correct me if I'm wrong here.

@zadjii-msft commented on GitHub (May 12, 2021): I'd probably go with ``` browser_back browser_forward browser_refresh browser_stop browser_search browser_favorites browser_home ``` I'd be a little worried with `back` maybe being confusing, and `start` might be confusing with the `win` key as well. At least that's got parity with the actual VKEY constants, so that makes sense to me. I'm pretty sure the only file you'll need to edit is `src\cascadia\TerminalSettingsModel\KeyChordSerialization.cpp`. @carlos-zamora can correct me if I'm wrong here.
claunia commented 2026-01-31 03:51:12 +00:00
Author
Owner
Copy Link

@KalleOlaviNiemitalo commented on GitHub (May 15, 2021):

Please edit doc/cascadia/profiles.schema.json as well.

@KalleOlaviNiemitalo commented on GitHub (May 15, 2021): Please edit [doc/cascadia/profiles.schema.json](https://github.com/microsoft/terminal/blob/66fdc645f748bfc4fe4ba8f123469de0ce2a66a3/doc/cascadia/profiles.schema.json#L6-L10) as well.
claunia commented 2026-01-31 03:51:13 +00:00
Author
Owner
Copy Link

@ghost commented on GitHub (Aug 31, 2021):

:tada:This issue was addressed in #10801, which has now been successfully released as Windows Terminal Preview v1.11.2421.0.🎉

Handy links:

@ghost commented on GitHub (Aug 31, 2021): :tada:This issue was addressed in #10801, which has now been successfully released as `Windows Terminal Preview v1.11.2421.0`.:tada: Handy links: * [Release Notes](https://github.com/microsoft/terminal/releases/tag/v1.11.2421.0) * [Store Download](https://www.microsoft.com/store/apps/9n8g5rfz9xk3?cid=storebadge&ocid=badge)
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
⛺ Reserved
A11yCO
A11yMAS
A11ySev1
A11ySev2
A11ySev3
A11yTTValidated
A11yUsable
A11yVoiceAccess
A11yWCAG
Area-Accessibility
Area-AtlasEngine
Area-AzureShell
Area-Build
Area-Build
Area-Chat
Area-CmdPal
Area-CodeHealth
Area-Commandline
Area-CookedRead
Area-DefApp
Area-Extensibility
Area-Fonts
Area-GroupPolicy
Area-i18n
Area-Input
Area-Interaction
Area-Interop
Area-Localization
Area-Output
Area-Performance
Area-Portable
Area-Quality
Area-Remoting
Area-Rendering
Area-Schema
Area-Server
Area-Settings
Area-SettingsUI
Area-ShellExtension
Area-ShellExtension
Area-ShellExtension
Area-Suggestions
Area-Suggestions
Area-TerminalConnection
Area-TerminalControl
Area-Theming
Area-UserInterface
Area-VT
Area-Windowing
Area-WPFControl
AutoMerge
Blocking-Ingestion
Culprit-Centennial
Culprit-WinUI
Disability-All
Disability-Blind
Disability-LowVision
Disability-Mobility
External-Blocked-WinUI3
Fixed
Gathering-Data
good first issue
HCL-E+D
HCL-WindowsTerminal
Help Wanted
Impact-Compatibility
Impact-Compliance
Impact-Correctness
Impact-Visual
In-PR
InclusionBacklog
InclusionBacklog-Windows TerminalWin32
InclusionCommitted-202206
Issue-Bug
Issue-Docs
Issue-Feature
Issue-Feature
Issue-Question
Issue-Samples
Issue-Scenario
Issue-Task
Needs-Attention
Needs-Author-Feedback
Needs-Bisect
Needs-Discussion
Needs-Repro
Needs-Tag-Fix
Needs-Tag-Fix
Needs-Triage
No-Recent-Activity
Priority-0
Priority-1
Priority-2
Priority-3
Product-Cmd.exe
Product-Colortool
Product-Colortool
Product-Colortool
Product-Conhost
Product-Conpty
Product-Meta
Product-Powershell
Product-Terminal
Product-WSL
pull-request
Mirrored from GitHub Pull Request
 Resolution-Answered
Resolution-By-Design
Resolution-Duplicate
Resolution-External
Resolution-Fix-Available
Resolution-Fix-Committed
Resolution-No-Repro
Resolution-Won't-Fix
Severity-Blocking
Severity-Crash
Severity-DataLoss
spam
this-will-be-a-breaking-change
Tracking-External
WindowsTerminal_Win32
Work-Item
zAskModeBug
zInbox-Bug
No Label Area-Settings good first issue Help Wanted Issue-Task Product-Terminal Resolution-Fix-Committed
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claunia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#13753
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?