cal/claude-home
1
0
Fork 0
Code Issues 6 Pull Requests 4 Actions Packages Projects Releases Wiki Activity
7c9c96eb52
claude-home/workstation/troubleshooting.md
Cal Corum 7c9c96eb52
All checks were successful
Reindex Knowledge Base / reindex (push) Successful in 3s
Details
docs: sync KB — troubleshooting.md
2026-04-03 12:00:22 -05:00

2.3 KiB
Raw Blame History

title description type domain tags
Workstation Troubleshooting Troubleshooting notes for Nobara/KDE Wayland workstation issues. troubleshooting workstation
troubleshooting
wayland
kde

Workstation Troubleshooting

Discord screen sharing shows no windows on KDE Wayland (2026-04-03)

Severity: Medium — cannot share screen via Discord desktop app

Problem: Clicking "Share Your Screen" in Discord desktop app (v0.0.131, Electron 37) opens the Discord picker but shows zero windows/screens. Same behavior in both the desktop app and the web app when using Discord's own picker. Affects both native Wayland and XWayland modes.

Root Cause: Discord's built-in screen picker uses Electron's desktopCapturer.getSources() which relies on X11 window enumeration. On KDE Wayland:

  • In native Wayland mode: no X11 windows exist, so the picker is empty
  • In forced X11/XWayland mode (ELECTRON_OZONE_PLATFORM_HINT=x11): Discord can only see other XWayland windows (itself, Android emulator), not native Wayland apps
  • Discord ignores --use-fake-ui-for-media-stream and other Chromium flags that should force portal usage
  • The discord-flags.conf file is not read by the Nobara/RPM Discord package — flags must go in the .desktop file Exec= line

Fix: Use Discord web app in Firefox for screen sharing. Firefox natively delegates to the XDG Desktop Portal via PipeWire, which shows the KDE screen picker with all windows. The desktop app's own picker remains broken on Wayland as of v0.0.131.

Configuration applied (for general Discord Wayland support):

  • ~/.local/share/applications/discord.desktop — overrides system .desktop with Wayland flags
  • ~/.config/discord-flags.conf — created but not read by this Discord build

Lesson:

  • Discord desktop on Linux Wayland cannot do screen sharing through its own picker — always use the web app in Firefox for this
  • Electron's desktopCapturer API is fundamentally X11-only; the PipeWire/portal path requires the app to use getDisplayMedia() instead, which Discord's desktop app does not do
  • discord-flags.conf is unreliable across distros — always verify flags landed in /proc/<pid>/cmdline
  • Vesktop (community client) is an alternative that properly implements portal-based screen sharing, if the web app is insufficient