texstudio-org/texstudio

Macros silently do nothing when running on Wayland (Qt6)

Closed

#4,520 opened on Jun 21, 2026

View on GitHub
 (3 comments) (0 reactions) (0 assignees)C++ (397 forks)auto 404
help wanted

Repository metrics

Stars
 (3,516 stars)
PR merge metrics
 (Avg merge 5h 26m) (19 merged PRs in 30d)

Description

I have set up macros but since the latest update they dont trigger anymore. When I enter the macro shortcut nothing happens. All macro I have set up are of type normal. I tried to reset my texstudio config, restart texstudio but nothing worked. After some time with claude I found that running texstudio with QT_QPA_PLATFORM=xcb texstudio fixes the issue.

Environment

  • TeXstudio: 4.9.5
  • Qt: 6.11.1
  • OS: Fedora Linux 44 (KDE Plasma Desktop Edition) (Wayland) (Linux 7.0.12-201.fc44.x86_64)
  • TeX distribution: TeX Live 2026

Expected behavior

Macro triggers upon typing its trigger.

Actual behavior

Nothing happens

How to reproduce

create a new macro and try to trigger it.

Workaround

Start texstudio with QT_QPA_PLATFORM=xcb texstudio

Contributor guide

Research direction
Investigate why macros do not trigger on Wayland when using Qt6. The workaround suggests the issue is in the Wayland platform plugin's handling of key events. Compare the event processing between xcb and Wayland backends.
Tech stack
cpp
Domain
desktop
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
C++Qt
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50