https://github.com/sneetsher/keyboard_modifiers_status

Gnome-Shell extension that shows keyboard modifiers status. It's useful when sticky keys are active.
https://github.com/sneetsher/keyboard_modifiers_status

accessibility gnome-shell-extension sticky-keys wayland x11

Last synced: 20 days ago
JSON representation

Gnome-Shell extension that shows keyboard modifiers status. It's useful when sticky keys are active.

• Host: GitHub
• URL: https://github.com/sneetsher/keyboard_modifiers_status
• Owner: sneetsher
• License: gpl-3.0
• Created: 2015-08-17T19:22:16.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-12-03T11:30:00.000Z (about 2 months ago)
• Last Synced: 2024-12-24T00:48:39.686Z (about 1 month ago)
• Topics: accessibility, gnome-shell-extension, sticky-keys, wayland, x11
• Language: JavaScript
• Homepage:
• Size: 46.9 KB
• Stars: 22
• Watchers: 6
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Keyboard Modifiers Status - Gnome-Shell Extension

 A Gnome-Shell extension that shows keyboard modifiers status. It is more useful when accessibility feature - sticky keys is active. 

 Current supported features:

 - Indicates status of these modifiers: Shift, Caps, Control, Alt, AltGr, Meta/Cmd, Num, (Scroll?)

 - Shows these states: (Off, Latched, Locked) in Wayland, (Off, Active) in Xorg

## Install

Choose a method

- Simply, from Gnome extensions portal site

    https://extensions.gnome.org/extension/975/keyboard-modifiers-status/

- Manually

    1. Extract it into a subfolder `keyboard_modifiers_status@sneetsher` in `~/.local/share/gnome-shell/extensions/`

    

            unzip [email protected] -d ~/.local/share/gnome-shell/extensions/keyboard_modifiers_status@sneetsher

        or

            

            make install

    

    2. Restart gnome-shell, using Alt+F2 then `r`+Enter with Xorg or logout/login with Wayland.

    

    3. Enable it

    

            gnome-extensions enable keyboard_modifiers_status@sneetsher

## Extras

- Enable an extension for all users (machine-wide)

    See https://help.gnome.org/admin/system-admin-guide/stable/extensions-enable.html.en

## Alternatives

- https://github.com/kazysmaster/gnome-shell-extension-lockkeys

- https://github.com/caasiu/gnome-shell-extension-KeysIndicator

- https://github.com/marf41/stickind

## Modifier indication (Push to a fix upstream in Gnome-shell)

- Feature Request/Bug Report: https://gitlab.gnome.org/GNOME/gnome-shell/-/issues/4706

## Developer hints

For anyone looking to modify it or creating anternative solution. Check [HACKING.md](HACKING.md) file.