forked from mirrors/qmk_userspace
		
	Remove obsolete note about media keys in MacOS (#6631)
* Remove obsolete note about media keys in MacOS KC_MNXT and KC_MPRV work fine on MacOS, so this note is obsolete. * Document behaviour of MEDIA_FAST_FORWARD/MEDIA_REWIND codes on MacOS * Small typo fix, and make OS-dependent keycode claim less absolute * Update docs/keycodes_basic.md Co-Authored-By: fauxpark <fauxpark@gmail.com>
This commit is contained in:
		
					parent
					
						
							
								64b7cfe735
							
						
					
				
			
			
				commit
				
					
						606813b72d
					
				
			
		
					 3 changed files with 5 additions and 12 deletions
				
			
		| 
						 | 
				
			
			@ -95,13 +95,6 @@ Even worse, it is not recognized unless the keyboard's VID and PID match that of
 | 
			
		|||
 | 
			
		||||
See [this issue](https://github.com/qmk/qmk_firmware/issues/2179) for detailed information.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## Media Control Keys in Mac OSX
 | 
			
		||||
#### KC_MNXT and KC_MPRV Does Not Work on Mac
 | 
			
		||||
Use `KC_MFFD`(`KC_MEDIA_FAST_FORWARD`) and `KC_MRWD`(`KC_MEDIA_REWIND`) instead of `KC_MNXT` and `KC_MPRV`.
 | 
			
		||||
See https://github.com/tmk/tmk_keyboard/issues/195
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## Keys Supported in Mac OSX?
 | 
			
		||||
You can know which keycodes are supported in OSX from this source code.
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -185,8 +185,8 @@ This is a reference only. Each group of keys links to the page documenting their
 | 
			
		|||
|`KC_AUDIO_MUTE`        |`KC_MUTE`                     |Mute                                           |
 | 
			
		||||
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`                     |Volume Up                                      |
 | 
			
		||||
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`                     |Volume Down                                    |
 | 
			
		||||
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`                     |Next Track (Windows)                           |
 | 
			
		||||
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`                     |Previous Track (Windows)                       |
 | 
			
		||||
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`                     |Next Track                                     |
 | 
			
		||||
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`                     |Previous Track                                 |
 | 
			
		||||
|`KC_MEDIA_STOP`        |`KC_MSTP`                     |Stop Track (Windows)                           |
 | 
			
		||||
|`KC_MEDIA_PLAY_PAUSE`  |`KC_MPLY`                     |Play/Pause Track                               |
 | 
			
		||||
|`KC_MEDIA_SELECT`      |`KC_MSEL`                     |Launch Media Player (Windows)                  |
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -191,7 +191,7 @@ The basic set of keycodes are based on the [HID Keyboard/Keypad Usage Page (0x07
 | 
			
		|||
 | 
			
		||||
These keycodes are not part of the Keyboard/Keypad usage page. The `SYSTEM_` keycodes are found in the Generic Desktop page, and the rest are located in the Consumer page.
 | 
			
		||||
 | 
			
		||||
Windows and macOS use different keycodes for "next track" and "previous track". Make sure you choose the keycode that corresponds to your OS.
 | 
			
		||||
?> Some of these keycodes may behave differently depending on the OS. For example, on macOS, the keycodes `KC_MEDIA_FAST_FORWARD`, `KC_MEDIA_REWIND`, `KC_MEDIA_NEXT_TRACK` and `KC_MEDIA_PREV_TRACK` skip within the current track when held, but skip the entire track when tapped.
 | 
			
		||||
 | 
			
		||||
|Key                    |Aliases  |Description                  |
 | 
			
		||||
|-----------------------|---------|-----------------------------|
 | 
			
		||||
| 
						 | 
				
			
			@ -201,8 +201,8 @@ Windows and macOS use different keycodes for "next track" and "previous track".
 | 
			
		|||
|`KC_AUDIO_MUTE`        |`KC_MUTE`|Mute                         |
 | 
			
		||||
|`KC_AUDIO_VOL_UP`      |`KC_VOLU`|Volume Up                    |
 | 
			
		||||
|`KC_AUDIO_VOL_DOWN`    |`KC_VOLD`|Volume Down                  |
 | 
			
		||||
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`|Next Track (Windows)         |
 | 
			
		||||
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`|Previous Track (Windows)     |
 | 
			
		||||
|`KC_MEDIA_NEXT_TRACK`  |`KC_MNXT`|Next Track                   |
 | 
			
		||||
|`KC_MEDIA_PREV_TRACK`  |`KC_MPRV`|Previous Track               |
 | 
			
		||||
|`KC_MEDIA_STOP`        |`KC_MSTP`|Stop Track (Windows)         |
 | 
			
		||||
|`KC_MEDIA_PLAY_PAUSE`  |`KC_MPLY`|Play/Pause Track             |
 | 
			
		||||
|`KC_MEDIA_SELECT`      |`KC_MSEL`|Launch Media Player (Windows)|
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue