Skip to content

issue #7421 : keyboard unresponsive during startup/shutdown of Hop GUI#7422

Closed
mattcasters wants to merge 1 commit into
apache:mainfrom
mattcasters:issue-7421
Closed

issue #7421 : keyboard unresponsive during startup/shutdown of Hop GUI#7422
mattcasters wants to merge 1 commit into
apache:mainfrom
mattcasters:issue-7421

Conversation

@mattcasters

@mattcasters mattcasters commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

issue #7421

A fix for a super annoying issue on Linux desktops when starting/stopping the Hop GUI.
Adds option system variable HOP_KEEP_A11Y and the documentation for it.

Fix keyboard input stall on Linux Hop GUI startup/shutdown (#7421)

Problem

On Linux (especially Ubuntu/GNOME on X11 with many SWT plugins), Hop GUI can temporarily stop accepting keyboard input while starting up or shutting down. The AT-SPI accessibility bridge and IBus can block the X11 event loop during that window.

Solution

On Linux, hop-gui.sh and the main hop launcher now set these environment variables by default:

Variable Effect
NO_AT_BRIDGE=1 Bypasses the AT-SPI accessibility bridge
GTK_IM_MODULE=xim Switches GTK input method away from IBus
IBUS_DISABLE=1 Disables IBus

This runs in the existing Linux case block, before the Wayland workaround for #4252.

Accessibility / IME opt-out

Users who need full accessibility or IBus-based input methods (e.g. screen readers, CJK IME) can opt out:

export HOP_KEEP_A11Y=1
./hop-gui.sh

When HOP_KEEP_A11Y is set to any non-empty value, none of the three variables above are exported.

Files changed

Launcher scripts (code fix)

  • assemblies/static/src/main/resources/hop-gui.sh
  • assemblies/static/src/main/resources/hop

User manual (documentation)

File Change
docs/hop-user-manual/modules/ROOT/pages/hop-gui/linux-desktop.adoc New — full explanation of the workaround, opt-out, and Wayland note
docs/hop-user-manual/modules/ROOT/pages/snippets/variables/hop-keep-a11y.adoc New — reusable env-var snippet
docs/hop-user-manual/modules/ROOT/pages/hop-gui/index.adoc Link to Linux Desktop page
docs/hop-user-manual/modules/ROOT/nav.adoc Nav entry under Hop Gui
docs/hop-user-manual/modules/ROOT/pages/installation-configuration.adoc Include HOP_KEEP_A11Y snippet
docs/hop-user-manual/modules/ROOT/pages/variables.adoc Include HOP_KEEP_A11Y snippet

Testing suggestions for reviewers

  1. Default (no env var) — On Ubuntu/GNOME/X11, start and quit Hop GUI; keyboard should remain responsive during startup/shutdown.
  2. With HOP_KEEP_A11Y=1 — Confirm screen reader / IBus IME still works as before the change.
  3. Wayland — Unchanged; GDK_BACKEND=x11 still applies independently of HOP_KEEP_A11Y.

Related issues

@mattcasters mattcasters marked this pull request as draft July 3, 2026 09:41
@mattcasters

Copy link
Copy Markdown
Contributor Author

Getting some flashing when rendering, investigating further.

@mattcasters

Copy link
Copy Markdown
Contributor Author

It was a good idea but it causes too much flickering because of the xim back-end usage, which is really old.
I'll give this one up and will try 28.04 LTS later on.

@mattcasters mattcasters closed this Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: keyboard unresponsive during startup/shutdown of Hop GUI

1 participant