https://github.com/tomasmark79/kbd-informer

A GNOME Shell extension that displays the status of keyboard modifier keys in the top panel and shows notifications when lock keys change state.
https://github.com/tomasmark79/kbd-informer

capslock capslock-indicator gnome-desktop gnome-extension keyboard keyboard-state numlock numlock-indicator

Last synced: 9 months ago
JSON representation

A GNOME Shell extension that displays the status of keyboard modifier keys in the top panel and shows notifications when lock keys change state.

• Host: GitHub
• URL: https://github.com/tomasmark79/kbd-informer
• Owner: tomasmark79
• License: gpl-3.0
• Created: 2025-08-05T17:53:03.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-08-22T11:17:47.000Z (9 months ago)
• Last Synced: 2025-08-31T19:04:51.806Z (9 months ago)
• Topics: capslock, capslock-indicator, gnome-desktop, gnome-extension, keyboard, keyboard-state, numlock, numlock-indicator
• Language: JavaScript
• Homepage: https://extensions.gnome.org/extension/8500/keyboard-informer/
• Size: 144 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# Keyboard Informer

A GNOME Shell extension that displays keyboard modifier keys in the top panel and shows notifications when lock keys change state.

![GNOME Shell](https://img.shields.io/badge/GNOME%20Shell-45%2B-blue)

![License](https://img.shields.io/badge/License-GPL%20v3-green)

## Features

- Shows active modifier keys in the top panel

- OSD notifications for Caps Lock, Num Lock, Scroll Lock changes

- Customizable symbols for all modifier keys

- Multi-monitor support

## Installation

### From GNOME Extensions Website

Install directly from: **https://extensions.gnome.org/extension/8500/keyboard-informer/**

### Manual Installation

```bash

git clone https://github.com/tomasmark79/kbd-informer.git

cd kbd-informer

./build-release.sh

# Install the generated zip file

```

## Screenshots

![Panel Indicator](screenshot-panel.png)

![OSD Notification](screenshot-osd.png)

## Configuration

Open extension preferences to customize modifier symbols.

## License

GPL v3.0 - see [LICENSE](LICENSE) file.

## Author

**Tomáš Mark** - *Initial work*

Partially inspired by sneetsher/keyboard_modifiers_status