You join a Discord call, start sharing your screen to show a game or document, and your friends see only a black rectangle. Your preview may even look fine, which makes it more confusing. On Linux, this black share is a classic combination of Wayland, NVIDIA drivers, and the way Discord captures your display.
Quick Answer
Discord shows black on Wayland with NVIDIA because its built-in capture does not fully support Wayland’s secure sharing system. The reliable fixes are to complete the system screen-share picker, use Discord in a browser, switch to an X11 session at login for calls, or stream through OBS Virtual Camera instead. Also update your NVIDIA driver and try turning off Discord hardware acceleration.
Why Wayland Changes Screen Sharing
For years Linux desktops used X11, where almost any app could freely record the whole screen. That was convenient but unsafe, because a malicious app could watch everything. Wayland fixes that. Under Wayland, apps cannot grab the screen directly. They must ask the system through a service called a portal, and you pick exactly which window or monitor to share.
Discord was built first for Windows and X11 habits. Its Electron-based app has been slow to adopt the Wayland portal, and the official Linux client still has limited Wayland capture support. The result is predictable: Discord asks for the screen the old way, Wayland refuses for security, and your friends get a black frame, sometimes with only your mouse pointer visible.
NVIDIA adds another layer. Its drivers gained proper Wayland support later than Intel and AMD, and features screen capture depends on matured only in recent driver series. An older NVIDIA driver on Wayland is a common recipe for a black share. Our guide to choosing between Wayland and X11 on Ubuntu explains the trade-offs in plain language.
Quick Checks Before Changing Settings
- Confirm you are on Wayland with
echo $XDG_SESSION_TYPE. If it prints wayland, this article applies directly. - Check your driver with
nvidia-smi. Driver series 535 and newer handle Wayland capture far better, and 550 and newer are better still. - Update Discord fully and restart it. An old build running for weeks will not pick up capture fixes.
- Test sharing a single window instead of the full screen. Window sharing often works while full-screen sharing stays black.
- Ask a friend what they actually see. Sometimes your preview is black but the stream is fine, or the opposite.
Fix 1: Use the System Screen Share Picker Correctly
When Discord does use the portal, a system dialog should appear asking what to share. Many users cancel it by habit or miss it behind other windows and end up with a black feed.
- Join a voice channel and click Screen to start a share.
- Wait for the system picker. It may appear behind Discord, so check the top bar or Activities view if nothing seems to happen.
- Choose the exact monitor or window you want, then confirm with Share or Allow.
- Wait a few seconds before judging. First frames over the portal can be slow, especially at high resolution on NVIDIA.
- If you get black, stop the share completely, wait ten seconds, and try again with a single window instead of a whole display.
If no picker ever appears, Discord is not using the portal in your install. That points to the browser version, an X11 session, or the OBS workaround below. Also check the portal is installed with apt list --installed | grep portal and install xdg-desktop-portal plus the package for your desktop, such as xdg-desktop-portal-gnome, if missing.
Fix 2: Try Discord in the Browser
The browser version is often the fastest fix for Wayland users. Modern Chrome and Firefox handle Wayland capture through the portal correctly, because browsers invested heavily in this for video calls.
- Open Discord in Chrome, Chromium, or Firefox and sign in.
- Join the same voice channel and start a screen share.
- Use the browser dialog to pick a window, tab, or full screen.
- Compare with the desktop app. If the browser works, you have proven the problem is the Discord client, not your computer.
The browser version lacks some desktop extras like certain keybinds and overlay features, but for showing a game, document, or desktop it is perfectly capable. Many Wayland users keep a browser tab for calls and use the desktop app for everything else. The official Discord screen sharing help page lists the general steps and limits across versions.
Fix 3: Log In With an X11 Session for Calls
If you need the desktop app’s full features, switching your session from Wayland to X11 is the most dependable workaround. Discord’s capture was built for X11 and generally works there without drama, even on NVIDIA.
- Save your work and log out.
- On the login screen, click your username, then look for a gear or session menu, usually in a corner.
- Select the session with Xorg or X11 in its name, such as Ubuntu on Xorg.
- Log in, run
echo $XDG_SESSION_TYPEagain, and confirm it prints x11. - Open Discord and test a share with a friend.
You are not stuck on X11 forever. Use it on days when you stream to Discord and Wayland the rest of the time. The trade-off is that X11 lacks some of Wayland’s smoothness for touchpads, mixed-refresh monitors, and fractional scaling, so this is a workaround rather than a perfect answer.
Fix 4: Share Through OBS Virtual Camera
OBS handles Wayland capture well because it uses the portal properly. You can capture your screen in OBS and send that picture to Discord as a camera feed, which works in almost every situation.
- Install OBS Studio and add a Screen Capture source. On Wayland it will ask you to pick a display through the system picker.
- Arrange the scene so the captured screen fills the canvas. Add your webcam as a small corner picture if you like.
- Make sure the virtual camera driver, v4l2loopback, is installed and loaded.
- Click Start Virtual Camera in OBS.
- In Discord Settings, under Voice and Video, select the OBS virtual camera as your camera and turn on video in the call.
Quality through a camera feed is a little lower than a true screen share, because Discord applies camera limits to resolution and frame rate. Still, for gameplay, code, slides, or showing a problem, it is clear enough and extremely reliable. The official OBS Linux installation guide covers setting up OBS and its capture sources correctly.
Fix 5: Update the Driver and Adjust Discord Settings
- Install the newest recommended NVIDIA driver through your distro’s driver tool, then reboot.
- In Discord Settings, under Advanced, turn off Hardware Acceleration and restart Discord when asked.
- In Voice and Video settings, turn off H.264 hardware acceleration options if you see them, then test again.
- Turn off Discord’s option to use its latest technology for screen capture if present, restart, and retest. This toggle helps some users and breaks sharing for others.
- If you use Flatpak Discord, run
flatpak updateso its runtime matches your system.
Change one setting at a time and test with a friend after each change. If you flip five toggles at once and sharing works, you will not know which one mattered, and the problem will be harder to solve when it returns.
Common Mistakes to Avoid
- Assuming hardware is broken: A black share on Wayland is almost always a software permission and capture issue, not a dying GPU.
- Testing with a fullscreen game first: Test with a simple window like your file manager. Fullscreen games add their own capture problems.
- Skipping the reboot after a driver update: The old NVIDIA module keeps running until you restart, so capture fixes cannot take effect.
- Running Discord with sudo: This breaks portal permissions and makes sharing less likely to work, not more.
- Ignoring the system picker: If the portal dialog waits behind other windows, Discord appears to share nothing. Always check for it.
- Using unofficial clients blindly: Third-party clients may capture better but can put your account at risk. Prefer the browser or OBS route.
Conclusion
A black Discord share on Wayland with NVIDIA comes from three things meeting at once: Wayland’s secure capture rules, Discord’s slow Wayland support, and a driver that must be new enough to share frames the modern way. Use the system picker carefully, try Discord in the browser, switch to X11 when you need the desktop app, share through OBS Virtual Camera for reliability, and keep your driver current. One of these routes will get your friends seeing your screen again.
Frequently Asked Questions
Why can friends hear my game but see only black?
Audio and video travel separately. Discord captures audio through the sound system without trouble, but video needs Wayland portal permission and working GPU frame sharing. Black picture with good audio is the classic sign video capture is blocked.
Does switching to X11 reduce security or performance?
X11 lets apps see more of your screen, which is why Discord works better on it. For a normal home gaming session it is a reasonable trade-off. You can log back into Wayland afterward for its scaling and touchpad behavior.
Window sharing works but full screen is black. Why?
Full display capture stresses the NVIDIA Wayland driver path most, especially with multiple monitors or high refresh rates. Window capture uses a simpler path that often works, so sharing the specific window is a practical daily solution.
Will Discord ever fix Wayland sharing properly?
Discord has been improving Linux capture, and newer Electron versions support portals better than old ones. Keep Discord updated and retest after major updates. Until support is complete, the browser version is the most consistently working official option.
Which monitor should I share for testing with multiple displays?
Test with your main monitor at normal resolution and close demanding games for the first test. Multi-monitor setups with different refresh rates are the hardest case for NVIDIA capture. Once a simple share works, add complexity one step at a time.


Leave a Reply