On-screen notices

OpenLogi draws short-lived notices in its own overlay. The notices do not use the operating system notification service.

Controls and configuration

Open Settings → General to control the two configurable notices:

• Low battery notifications controls the low-battery card. It is on by default.
• Lock key notifications controls the lock-key indicator. It is on by default.

The keyboard-backlight indicator has no Settings switch or app configuration key. It appears when a compatible keyboard reports a backlight-level change.

Use low_battery_notifications and lock_key_notifications under [app_settings] to set the two switches in the configuration file.

Low battery

OpenLogi shows a low-battery card when a connected device meets either condition:

• Its battery reports 20% or less and is not charging.
• Its battery has no percentage and reports a low or critical level.

The card identifies the device and includes the percentage when the device reports one. It stays visible for 8 seconds, and clicking it hides it. The overlay shows at most three cards at once; newer cards take precedence.

OpenLogi announces each discharge once. It re-arms the device after it begins charging, reports 30% or more, or reports a good or full level. When you turn the switch off, OpenLogi still records a recharge, so a later discharge can be announced after you enable it again.

This is an OpenLogi overlay window, not an OS notification. It does not need notification permission from the operating system.

Lock keys

A keyboard with 0x4220 LockKeyState can report lock-key changes. OpenLogi shows these changes only when Lock key notifications is on:

• Caps Lock shows on macOS, Linux, and Windows.
• Num Lock and Scroll Lock show on Linux and Windows.
• Fn Lock never shows.

OpenLogi does not announce the state that the keyboard reports at connection. A later change opens a centred indicator for 1.5 seconds. A new change replaces the indicator already on screen.

The indicator is a dark card with the lock-key state as text. Its key glyph is blue while the key is on and gray while the key is off.

Keyboard backlight level

On a keyboard that exposes 0x1982 backlight, OpenLogi follows hardware backlight-change events. After a hardware adjustment, it shows a centred indicator for 1.5 seconds when the reported backlight is lit.

The indicator shows Backlight, the current level, and the reported maximum. A blue progress bar represents the current level. A newer backlight event replaces the current indicator and starts a new 1.5-second interval.

No setting controls this indicator. A software-disabled, critically-low-battery, or ambient-light-saturated backlight closes the indicator. A keyboard without the backlight feature does not send the event, so OpenLogi shows no backlight-level indicator for it.

Screen placement

Outside Wayland, low-battery cards use the display under the pointer when its location is available. Otherwise, OpenLogi uses the primary display. On macOS, the card stays above the Dock. On Windows, it stays above the taskbar.

On Wayland, OpenLogi first requests a bottom-edge layer-shell surface. If the compositor does not provide layer-shell support, OpenLogi opens a normal window and the compositor chooses its placement.

The lock-key and backlight indicators are centred popup windows. Their code does not select a display explicitly, so OpenLogi does not guarantee their multi-monitor placement.

In the config

schema_version = 9

[app_settings]
low_battery_notifications = true
lock_key_notifications = true

For the complete configuration reference, see Configuration.

Status: macOS + Linux + Windows. Lock-key notices require 0x4220 LockKeyState. Backlight-level notices require 0x1982 backlight.