hluk/CopyQ

CopyQ does not distinguish FR and FRPC keyboard layouts for shortcuts on Mac

Open

#3436 opened on Feb 17, 2026

View on GitHub
 (5 comments) (0 reactions) (0 assignees)C++ (7,372 stars) (419 forks)batch import
Qt bugbughelp wantedmacOS

Description

Describe the bug

To Reproduce

  1. Prerequisites :
    • Have an Apple laptop with an internal Apple French keyboard ;
    • Have an external non-Apple French AZERTY keyboard ;
    • Have FRPC set as your current keyboard layout, for use with the external keyboard ;
  2. Open CopyQ ;
  3. Go to File -> Preferences -> Shortcuts -> Global ;
  4. Click on + next to Show/hide main window ;
  5. Press the top-left key of the external keyboard (²) ;
  6. Submit, close settings and focus another app ;
  7. Press ² again and expect CopyQ to appear ;
  8. See CopyQ appear ;
  9. Set FR as your keyboard layout, for use with the internal keyboard ;
  10. Press the top-left key of the internal keyboard (#) and expect CopyQ not to appear ;
  11. See CopyQ appear.

The same issue occurs when doing the opposite : setting # as shortcut using the internal keyboard then pressing ² using the external keyboard (CopyQ appears when it should not).

Expected behavior CopyQ shouldn't appear in this situation.

Screenshots

Version, OS and Environment CopyQ Clipboard Manager 13.0.0-gfa209998-v13.0.0 Qt: 6.9.3 KNotifications: 6.7.0 Compiler: GCC Arch: x86_64-little_endian-lp64 OS: macOS Tahoe (26.1)

  • Installation method (for example Windows installer, portable zip, Flatpak, Homebrew, manual build) : CopyQ-macos-13.dmg.zip

Additional context I'm so sorry for bringing you an Apple issue. I hate them and I wish I wasn't forced to use it because of work. On the bright side, apps like CopyQ, and the ton of others I need to do stuff that is basic on Linux, make it more bearable.

Thank you.

Contributor guide

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.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
C++ knowledgeQt framework basicsmacOS keyboard layout handling
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
45
Research direction
Investigate how CopyQ handles global shortcuts on macOS, particularly the mapping of key codes to keyboard layouts. Look at Qt's QKeySequence parsing and the platform specific code in the repository (likely in src/platform/mac or similar). Check if there is a known issue with identifying the keyboard layout when setting shortcuts. Review comments in the issue for any additional clarifications from maintainers.