diff options
Diffstat (limited to 'keyboards/gmmk/pro/ansi/keymaps/macos/readme.md')
| -rw-r--r-- | keyboards/gmmk/pro/ansi/keymaps/macos/readme.md | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/keyboards/gmmk/pro/ansi/keymaps/macos/readme.md b/keyboards/gmmk/pro/ansi/keymaps/macos/readme.md new file mode 100644 index 0000000000..8024e77cc1 --- /dev/null +++ b/keyboards/gmmk/pro/ansi/keymaps/macos/readme.md @@ -0,0 +1,85 @@ +# GMMK Pro Standard Layout for macOS by zvuc + +As you may know, Glorious does not (yet) provide their Glorious Core software for macOS; so with stock firmware, there aren't any ways to customize layouts on the hardware level unless you turn to software-based override solutions such as [Karabiner Elements](https://karabiner-elements.pqrs.org/). This is my attempt to try to create the most macOS-like experience on the GMMK Pro, taking close notes from Apple's Magic Keyboard, also referencing code from other community keymaps. + +## Keymap +Layer 0 +<img width="1092" alt="Layer0" src="https://user-images.githubusercontent.com/2870726/132235505-64ac1c89-ecf9-49b5-a030-1d94389fc66d.png"> + +Layer 1 (Hold <kbd>Fn</kbd>) +<img width="1088" alt="Layer1" src="https://user-images.githubusercontent.com/2870726/133090831-5e84fb69-a8bf-463e-a8f6-f1f38a5901d6.png"> + +Layer 2 (Togglable alternative function row layout by pressing <kbd>Fn</kbd>+<kbd>F</kbd>) +<img width="1094" alt="Layer2" src="https://user-images.githubusercontent.com/2870726/133090841-0c6a8b16-bf46-4e6c-b8fa-79f213f95765.png"> + + +## Notable differences from stock key layout for Windows: +- <kbd>Delete</kbd> key placed right next to backspace (under rotary encoder) +- <kbd>F13</kbd> key for the bottommost row (Assign it to a shortcut you like in macOS preferences! [For example: "Emoji & Symbols" to bring up the emoji input popup instantly](https://user-images.githubusercontent.com/2870726/132237211-7e13c156-96a8-4a91-b215-28d310228feb.png)) +- <kbd>Eject</kbd> key for the last key in function row: Needed for macOS native global "Sleep" hotkey (<kbd>⌘</kbd><kbd>⌥</kbd><kbd>Eject</kbd>) + +## Notable Features +- VIA support +- Rotary Encoder support (Defaults to stock behavior Volume Up/Down) +- Standard order for macOS modifier keys: + * Left: <kbd>⌃ Control</kbd><kbd>⌥ Option</kbd><kbd>⌘ Command</kbd> + * Right: <kbd>⌘ Command</kbd><kbd>⌥ Option</kbd><kbd>Fn</kbd> +- Apple Magic Keyboard-like Function Row Mode (Toggle with <kbd>Fn</kbd>+<kbd>F</kbd>) + * <kbd>F1</kbd>: Decrease display brightness + * <kbd>F2</kbd>: Increase display brightness + * <kbd>F3</kbd>: Mission Control + * <kbd>F4</kbd>: Launchpad + * <kbd>F5</kbd>: Decrease keyboard backlight brightness + * <kbd>F6</kbd>: Increase keyboard backlight brightness + * <kbd>F7</kbd>: (none) + * <kbd>F8</kbd>: (none) + * <kbd>F9</kbd>: Media Rewind + * <kbd>F10</kbd>: Media Play/Pause + * <kbd>F11</kbd>: Media Fast Forward + * <kbd>F12</kbd>: (none) + +> #### NOTE +> - Media key mappings follow Apple Magic Keyboard except <kbd>F8</kbd> thru <kbd>F12</kbd>, where keys have been shifted by one to the right. It's because I wanted to get over the awkward gap between <kbd>F8</kbd> and <kbd>F9</kbd> that the GMMK Pro has—and also because we don't need dedicated keys for volume control when we have the more convenient rotary knob. +> - To access standard <kbd>F1</kbd> - <kbd>F12</kbd> keys, press the Function keys while holding <kbd>Fn</kbd>. +> - If you're planning to use Karabiner Elements, use the standard Function row mode (<kbd>F1</kbd> - <kbd>F12</kbd>) because Karabiner Elements always overrides function keys even if you want to just use simple or complex modifications, and it doesn't catch custom keys like Mission Control, Launchpad or <kbd>Eject</kbd>. (<kbd>Eject</kbd> is mapped as <kbd>F24</kbd> so you can replace it with 'Eject' within Karabiner.) + +## RGB Lighting +- Retains Glorious stock firmware key mappings for control + * <kbd>Fn</kbd><kbd>Up</kbd> / <kbd>Fn</kbd><kbd>Down</kbd>: Cycle presets + * <kbd>Fn</kbd><kbd>Left</kbd> / <kbd>Fn</kbd><kbd>Right</kbd>: Adjust speed + * <kbd>Fn</kbd><kbd>W</kbd> / <kbd>Fn</kbd><kbd>S</kbd>: Adjust brightness +- Quickly switch to popular presets: + * <kbd>Fn</kbd><kbd>`</kbd> : Solid color (no animation) + * <kbd>Fn</kbd><kbd>1</kbd> : Solid duotone (no animation) - <kbd>Shift</kbd><kbd>Knob</kbd> to change secondary color. + * <kbd>Fn</kbd><kbd>2</kbd> : Vertical gradient - <kbd>Shift</kbd><kbd>Knob</kbd> to change secondary color. + * <kbd>Fn</kbd><kbd>3</kbd> : "Jellybean Raindrops" + * <kbd>Fn</kbd><kbd>4</kbd> : Horizontal wipe with white backlight + * <kbd>Fn</kbd><kbd>5</kbd> : Horizontal wipe + * <kbd>Fn</kbd><kbd>6</kbd> : Single color pinwheel + * <kbd>Fn</kbd><kbd>7</kbd> : Horizontal rainbow + * <kbd>Fn</kbd><kbd>8</kbd> : Rainbow pinwheel + * <kbd>Fn</kbd><kbd>9</kbd> : Breathing + * <kbd>Fn</kbd><kbd>0</kbd> : Reactive (light up on keypress) + * <kbd>Fn</kbd><kbd>-</kbd> : "Digital Rain" + * <kbd>Fn</kbd><kbd>=</kbd> : "Heatmap" +- RGB turns off after 20 minutes of inactivity +- RGB turns off when USB is suspended / enters sleep +- <kbd>Caps Lock</kbd> toggle indicator (<kbd>Caps Lock</kbd> key and side lights will turn red) +- Easy RGB control using Rotary Encoder + - <kbd>Control</kbd>+<kbd>Rotate Knob</kbd>: Adjust hue + - <kbd>Option</kbd>+<kbd>Rotate Knob</kbd>: Adjust saturation + - <kbd>Command</kbd>+<kbd>Rotate Knob</kbd>: Adjust brightness + +> All latest QMK effects [(41 as of now)](https://beta.docs.qmk.fm/using-qmk/hardware-features/lighting/feature_rgb_matrix#rgb-matrix-effects-id-rgb-matrix-effects) are enabled by default and will apply in order when cycling through using <kbd>Fn</kbd><kbd>Up</kbd> / <kbd>Fn</kbd><kbd>Down</kbd>. You can disable specific effects by uncommenting (remove the `//` at the beginning of line) respective lines (ex: `#define DISABLE_RGB_MATRIX_BREATHING`) in `qmk_firmware/keyboards/gmmk/pro/ansi/keymaps/zvuc/config.h` then recompiling the firmware. + +## Other Features +- 1000hz polling rate +- Short DEBOUNCE time (5 ms) +- Per-key debounce algorithm (`sym_defer_pk`) +- NKRO toggle (<kbd>Fn</kbd>+<kbd>N</kbd>) + +## Warning regarding VIA support +When observing this keyboard firmware in VIA, some custom-implemented keys such as Mission Control/Launchpad and RGB preset shortcuts appear as keycodes such as `0x5d62`. **These must not be modified!** There is no way to get their default functionality back unless you re-flash the firmware through QMK Toolbox. + +## Download pre-compiled firmware binary file +[Download BIN file from here](https://github.com/zvuc/qmk_firmware/releases/tag/zvuc-1.0.1) |