Mintplex-Labs/anything-llm
1
0
Fork 0
mirror of https://github.com/Mintplex-Labs/anything-llm.git synced 2026-07-19 14:13:35 -04:00
Code Issues 328 Packages Projects Releases 10 Wiki Activity

[GH-ISSUE #5425] [BUG]: Desktop Assistant shortcut not working with app closed (Pop!_OS) #5085

New Issue
Closed
opened 2026-06-05 14:51:55 -04:00 by yindo · 2 comments
yindo commented 2026-06-05 14:51:55 -04:00
Owner
Copy Link
Copy Source

Originally created by @Testnotafk on GitHub (Apr 13, 2026).
Original GitHub issue: https://github.com/Mintplex-Labs/anything-llm/issues/5425

How are you running AnythingLLM?

Docker (local) / Linux Installer

What happened?

On Pop!_OS, The shortcut to activate the Desktop Assistant does not work. My clock and list of running processes becomes darker, but nothing pops up. The actual process is running in the backround. It only works with the AnythingLLM app open.

Are there known steps to reproduce?

Open AnythingLLM
Press the "X" in the top right corner
Do your shortcut
It will not appear

https://github.com/user-attachments/assets/eb425fc9-bc2e-44f9-9bb1-3055f125d416

LLM Provider & Model (if applicable)

No response

Embedder Provider & Model (if applicable)

No response

Originally created by @Testnotafk on GitHub (Apr 13, 2026). Original GitHub issue: https://github.com/Mintplex-Labs/anything-llm/issues/5425 ### How are you running AnythingLLM? Docker (local) / Linux Installer ### What happened? On Pop!_OS, The shortcut to activate the Desktop Assistant does not work. My clock and list of running processes becomes darker, but nothing pops up. The actual process is running in the backround. It only works with the AnythingLLM app open. ### Are there known steps to reproduce? Open AnythingLLM Press the "X" in the top right corner Do your shortcut It will not appear https://github.com/user-attachments/assets/eb425fc9-bc2e-44f9-9bb1-3055f125d416 ### LLM Provider & Model (if applicable) _No response_ ### Embedder Provider & Model (if applicable) _No response_
yindo added the possible bug label 2026-06-05 14:51:55 -04:00
yindo closed this issue 2026-06-05 14:51:55 -04:00
yindo commented 2026-06-05 14:51:56 -04:00
Author
Owner
Copy Link
Copy Source

@timothycarambat commented on GitHub (Apr 13, 2026):

Thanks for the detailed report and video! This is unfortunately a known Linux platform limitation that we cannot fix in the application code :/

Electron's globalShortcut API has known issues on Linux - particularly with X11/Wayland display servers. We've already added workarounds in our code for cases where shortcut registration falsely reports failure, but the underlying behavior remains inconsistent.

Wayland security restrictions - Pop!_OS (and other GNOME-based distros) increasingly default to Wayland, which has stricter security policies around global shortcuts from background/tray applications. When the main window is closed and the app is running only in the system tray, the desktop environment may not forward global shortcuts to the app.

This affects all Electron apps on Linux - it's not specific to AnythingLLM.

Workarounds you can try:

  • Keep the main window minimized instead of closing it (the shortcut should work while the window exists)
  • Switch to an X11 session instead of Wayland (you can select this at the login screen) - X11 has better support for global shortcuts
  • Use the system tray icon to open the assistant when the shortcut doesn't work

Understandably, none of those are exactly convienent.

We'll keep this issue around for visibility, but closing it as a wont-fix unfortunately there's no code-level fix we can implement for this platform limitation. I know there is an issue on the electron repo around this but it is not fixed and whatever does exist requires a ton more code to patch just this distro that still has blindspots.

<!-- gh-comment-id:4238135097 --> @timothycarambat commented on GitHub (Apr 13, 2026): Thanks for the detailed report and video! This is unfortunately a known Linux platform limitation that we cannot fix in the application code :/ Electron's globalShortcut API has known issues on Linux - particularly with X11/Wayland display servers. We've already added workarounds in our code for cases where shortcut registration falsely reports failure, but the underlying behavior remains inconsistent. Wayland security restrictions - Pop!_OS (and other GNOME-based distros) increasingly default to Wayland, which has stricter security policies around global shortcuts from background/tray applications. When the main window is closed and the app is running only in the system tray, the desktop environment may not forward global shortcuts to the app. This affects all Electron apps on Linux - it's not specific to AnythingLLM. Workarounds you can try: - Keep the main window minimized instead of closing it (the shortcut should work while the window exists) - Switch to an X11 session instead of Wayland (you can select this at the login screen) - X11 has better support for global shortcuts - Use the system tray icon to open the assistant when the shortcut doesn't work Understandably, none of those are exactly convienent. We'll keep this issue around for visibility, but closing it as a wont-fix unfortunately there's no code-level fix we can implement for this platform limitation. I know there is an issue on the electron repo around this but it is not fixed and whatever does exist requires a ton more code to patch just this distro that still has blindspots.
yindo commented 2026-06-05 14:51:56 -04:00
Author
Owner
Copy Link
Copy Source

@LFd3v commented on GitHub (May 14, 2026):

@timothycarambat Hi, there. Thank you for the app and maintaining it. I just wanted to link here a comment on another project (also related to AI btw) that also links to a commit that seems to solve this problem on Linux by using org.freedesktop.portal.GlobalShortcuts on Wayland (it should work on most Wayland DEs/WMs) and fallback to regular Electron behavior otherwise (that does not work on Wayland right now, at least not on GNOME/Wayland).

https://github.com/johnzfitch/claude-cowork-linux/issues/28#issuecomment-4104042809

Besides the code above, another possible solution would be adding toggles when launching the app, so one could add them manually to global shortcut settings for the tasks, for instance, launching the app with --assistant would launch the Assistant feature.

Regards

<!-- gh-comment-id:4450860997 --> @LFd3v commented on GitHub (May 14, 2026): @timothycarambat Hi, there. Thank you for the app and maintaining it. I just wanted to link here a comment on another project (also related to AI btw) that also links to a commit that seems to solve this problem on Linux by using `org.freedesktop.portal.GlobalShortcuts` on Wayland (it should work on most Wayland DEs/WMs) and fallback to regular Electron behavior otherwise (that does not work on Wayland right now, at least not on GNOME/Wayland). https://github.com/johnzfitch/claude-cowork-linux/issues/28#issuecomment-4104042809 Besides the code above, another possible solution would be adding toggles when launching the app, so one could add them manually to global shortcut settings for the tasks, for instance, launching the app with `--assistant` would launch the Assistant feature. Regards
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Desktop
Docker
Integration Request
Integration Request
OS: Linux
OS: Mobile
OS: Windows
UI/UX
blocked
bug
bug
core-team-only
documentation
duplicate
embed-widget
enhancement
feature request
github_actions
good first issue
investigating
needs info / can't replicate
possible bug
pull-request
Mirrored from GitHub Pull Request
 question
stage: specifications
wontfix
No Label possible bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Mintplex-Labs/anything-llm#5085
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?