Difference between revisions of "Media keys and default keybindings"

From GalliumOS Wiki
Jump to: navigation, search
(keyboard map updates)
(Tag: visualeditor)
m (grammatical correction)
(20 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''Media keys'''
+
GalliumOS includes five keyboard layouts customized for Chromebooks. They can be configured from the GalliumOS/Whisker Menu, in Settings >> Keyboard >> Layout >> Keyboard Model.
  
Media keys are accessible with the search+function key combination
+
Media keys and Function keys can be accessed either with or without pressing the "Overlay" key first, depending on your choice of keyboard layout.
  
'''Function keys'''
+
== Keyboard Layouts ==
  
The function keys by themselves will map to F1-F10. Function keys are also mapped to Super + Number Row key, where Super + 1 is F1 and Super + = is F12.
+
{| class="wikitable"
 
+
!Layout Name
'''CAPS LOCK'''
+
!Overlay Key
 
+
!Top row keys (alone)
Super + Alt. You must press Super before you press Alt. ;) (Super is the key with the magnifying glass on it).
+
!Top row keys (with Overlay)
 
+
|-
'''How was this done'''
+
| Chromebook / No overlay / F keys mapped to media keys
 +
| None
 +
| Media keys
 +
| Media keys
 +
|-
 +
| Chromebook / Right alt overlay
 +
| <code>Right-Alt</code>
 +
| Function keys
 +
| Media keys
 +
|-
 +
| style="background-color:#e0e8ff" | '''Chromebook / Right alt overlay / F keys mapped to media keys'''<br>'''** default for GalliumOS 1.0 and later **'''
 +
| style="background-color:#e0e8ff" | <code>Right-Alt</code>
 +
| style="background-color:#e0e8ff" | Media keys
 +
| style="background-color:#e0e8ff" | Function keys
 +
|-
 +
| Chromebook / Search overlay<br>previous default (1.0beta1), and Crouton default
 +
| <code>Super (Search)</code>
 +
| Function keys
 +
| Media keys
 +
|-
 +
| Chromebook / Search overlay / F keys mapped to media key
 +
| <code>Super (Search)</code>
 +
| Media keys
 +
| Function keys
 +
|}
  
We included Crouton's keyboard model for Chromebooks: [https://github.com/dnschneid/crouton/wiki/Keyboard]. See: [https://github.com/GalliumOS/galliumos-distro/issues/50] for more info.
+
These layouts are stored in /usr/share/X11/xkb/symbols/chromebook* . To modify the functionality of a key, one can make changes to the appropriate file (as root).<br>
 +
For instance, to remap the power key to Delete, add the following line in the appropriate file: <code>key <POWR> {[ Delete ]      };</code>, and set the power button to "Do nothing" in the Power Manager menu.
  
'''Switching Function and Shortcut Key'''
+
== Key Mappings ==
  
At the moment, switching the Function Keys and Shortcut Keys (as it is on ChromeOS) is not an easy task.
 
 
However, ColtonDRG states that there are plans to make it easier in a future release.
 
 
== Common key combinations ==
 
 
{| class="wikitable"
 
{| class="wikitable"
 
!Key
 
!Key
 
!Combination
 
!Combination
 
|-
 
|-
|F1-F9
+
|F1-F10
|[Overlay + 1] - [Overlay + 9]
+
|Accessed directly or with <code>Overlay</code>, depending on Keyboard layout
 
|-
 
|-
|KBD Brightness Toggle
+
|F11
|[Overlay + 0]
+
|
 
|-
 
|-
|KBD Brightness Down
+
|F12
|[Overlay + - ]
+
|
|-
 
|KBD Brightness Up
 
|[Overlay + = ]
 
 
|-
 
|-
 
|Home
 
|Home
|[Overlay + Left]
+
|<code>Overlay</code> + <code>Left Arrow</code>
 
|-
 
|-
 
|End
 
|End
|[Overlay + Right]
+
|<code>Overlay</code> + <code>Right Arrow</code>
 
|-
 
|-
 
|Page Up
 
|Page Up
|[Overlay + Up]
+
|<code>Overlay</code> + <code>Up Arrow</code>
 
|-
 
|-
 
|Page Down
 
|Page Down
|[Overlay + Down]
+
|<code>Overlay</code> + <code>Down Arrow</code>
 
|-
 
|-
 
|Insert
 
|Insert
|[Overlay + . ]
+
|<code>Overlay</code> + <code>.</code>
 
|-
 
|-
 
|Delete
 
|Delete
|[Overlay + Backspace]
+
|<code>Overlay</code> + <code>Backspace</code>
 
|-
 
|-
 
|Caps Lock
 
|Caps Lock
|[Overlay + Alt] (for keyboard maps that use Super as the overlay)
+
|Right-Alt as Overlay: <code>Overlay</code> + <code>Left Alt</code> + <code>Right Shift</code><br>Super as Overlay: <code>Overlay</code> + <code>Left Alt</code>
 
|}
 
|}
''Note: The overlay key will be different depending on the keyboard map chosen. ''
 
  
''The default overlay key for Beta 1 was the Super key (Search). For Beta 2, the overlay key is ''
+
Crouton keyboard layout: https://github.com/dnschneid/crouton/wiki/Keyboard
  
''the right alt key.''
+
Other discussion: https://github.com/GalliumOS/galliumos-distro/issues/50
  
== 1.0beta2 ==
+
== Keyboard Shortcuts ==
  
There are five keyboard maps in current nightlies (actually there are a ton, but five that are customized for Chromeb*s):
+
{| class="wikitable"
 
+
!Key
# Chromebook | No overlay | F keys mapped to media keys
+
!Combination
# Chromebook | Right alt overlay
+
|-
# Chromebook | Right alt overlay | F keys mapped to media keys
+
|Screenshot (fullscreen)
# Chromebook | Search overlay
+
|<code>Ctrl</code> + <code>F5(display)</code>
# Chromebook | Search overlay | F keys mapped to media keys
+
|-
 
+
|Screenshot (window)
 
+
|<code>Ctrl</code> + <code>Shift</code> + <code>F5(display)</code>
* Options 1,2,3 open the Whisker Menu when the Super key is pressed
+
|-
* Options 1,3,5 send media key events when the media/Fkey keys are pressed (and Fkey events when not)
+
|Whisker Menu/Search
* Options 2,4 send Fkey events when the media/Fkey keys are pressed (and media key events when not)
+
|Right-Alt as Overlay: <code>Super</code> + <code>M</code><br>Super as Overlay: <code>Left-Alt</code> + <code>M</code>
 
+
|-
Noteworthy quirk: the settings dialog doesn't always save your selection...it works better if you switch to another tab of the dialog and then back to "Layout" before selecting "Close".
+
|Keyboard Backlight Toggle
 +
|<code>Overlay</code> + <code>0</code> '''(not working!)'''
 +
|-
 +
|Keyboard Backlight Brightness Down
 +
|<code>Overlay</code> + <code>-</code>
 +
|-
 +
|Keyboard Backlight Brightness Up
 +
|<code>Overlay</code> + <code>=</code>
 +
|}

Revision as of 08:20, 23 April 2018

GalliumOS includes five keyboard layouts customized for Chromebooks. They can be configured from the GalliumOS/Whisker Menu, in Settings >> Keyboard >> Layout >> Keyboard Model.

Media keys and Function keys can be accessed either with or without pressing the "Overlay" key first, depending on your choice of keyboard layout.

Keyboard Layouts

Layout Name Overlay Key Top row keys (alone) Top row keys (with Overlay)
Chromebook / No overlay / F keys mapped to media keys None Media keys Media keys
Chromebook / Right alt overlay Right-Alt Function keys Media keys
Chromebook / Right alt overlay / F keys mapped to media keys
** default for GalliumOS 1.0 and later **
Right-Alt Media keys Function keys
Chromebook / Search overlay
previous default (1.0beta1), and Crouton default
Super (Search) Function keys Media keys
Chromebook / Search overlay / F keys mapped to media key Super (Search) Media keys Function keys

These layouts are stored in /usr/share/X11/xkb/symbols/chromebook* . To modify the functionality of a key, one can make changes to the appropriate file (as root).
For instance, to remap the power key to Delete, add the following line in the appropriate file: key <POWR> {[ Delete ] };, and set the power button to "Do nothing" in the Power Manager menu.

Key Mappings

Key Combination
F1-F10 Accessed directly or with Overlay, depending on Keyboard layout
F11
F12
Home Overlay + Left Arrow
End Overlay + Right Arrow
Page Up Overlay + Up Arrow
Page Down Overlay + Down Arrow
Insert Overlay + .
Delete Overlay + Backspace
Caps Lock Right-Alt as Overlay: Overlay + Left Alt + Right Shift
Super as Overlay: Overlay + Left Alt

Crouton keyboard layout: https://github.com/dnschneid/crouton/wiki/Keyboard

Other discussion: https://github.com/GalliumOS/galliumos-distro/issues/50

Keyboard Shortcuts

Key Combination
Screenshot (fullscreen) Ctrl + F5(display)
Screenshot (window) Ctrl + Shift + F5(display)
Whisker Menu/Search Right-Alt as Overlay: Super + M
Super as Overlay: Left-Alt + M
Keyboard Backlight Toggle Overlay + 0 (not working!)
Keyboard Backlight Brightness Down Overlay + -
Keyboard Backlight Brightness Up Overlay + =