Fix Black Screenshot Issues on Linux

If WebWork screenshots appear completely black on your Linux system, this happens because your Linux distribution is using Wayland display server instead of Xorg.

Why this occurs:

WebWork Linux Desktop App is designed to work with Xorg display server by default
Wayland has different security and permission systems that prevent regular screenshot capture
When WebWork tries to take screenshots on Wayland, it captures only black screens
This is a compatibility issue, not a WebWork malfunction

How to fix this

You have two options to resolve this issue:

Option 1: Switch to Xorg display server (Recommended)

For Ubuntu users:

Temporary switch (per session):
- On the login screen, click your username
- Click the Gear icon ⚙️ next to "Sign In" button
- Select "Ubuntu on Xorg" from the dropdown menu
- Enter your password and log in normally
Permanent switch (always use Xorg):
- Open Terminal (Ctrl + Alt + T)
- Type this command and press Enter:
```
sudo nano /etc/gdm3/custom.conf
```
- Add this line under the [daemon] section:
```
WaylandEnable=false
```
- Save the file (Ctrl + X, then Y, then Enter)
- Restart your computer

For other Linux distributions:

The process varies depending on your distribution and desktop environment
Look for display server or session options on your login screen
Consult your distribution's documentation for Xorg switching instructions

Option 2: Install Flameshot for Wayland compatibility

If you prefer to continue using Wayland:

Install Flameshot screenshot utility:
- Open Terminal (Ctrl + Alt + T)
- For Ubuntu/Debian, run:
```
sudo apt install flameshot
```
- For other distributions, Flameshot is available on:
  - Flathub (Flatpak)
  - Snap Store
  - AUR (Arch Linux)
  - Your distribution's package manager
Restart your system:
- Completely restart your computer after installation
- This ensures Flameshot integrates properly with WebWork

How to check if it's working

After applying either solution:

Launch WebWork and start time tracking (Make sure you're using the latest version of WebWork for best compatibility)
Allow WebWork to take a few screenshots
Check the screenshots in WebWork dashboard or reports
Screenshots should now show your actual screen content instead of black screens
Verify that all your applications and desktop are visible in the screenshots

Still having issues?

Screenshots still black after switching to Xorg:

Verify you're actually using Xorg by running: echo $XDG_SESSION_TYPE in terminal
Should return "x11" for Xorg, "wayland" for Wayland
Try logging out and logging back in

Flameshot installation failed:

Update your package manager: sudo apt update (Ubuntu/Debian)
Try installing via Flatpak: flatpak install flathub org.flameshot.Flameshot
Check your distribution's specific installation method

Still getting permission errors:

Ensure WebWork has necessary permissions to access screenshot tools
Try running WebWork from terminal to see any error messages
If you see errors, learn how to send an error log to support
Check if your desktop environment has additional security restrictions

Important information

About display servers:

Xorg (X11) is the traditional Linux display server with broader application compatibility
Wayland is newer and more secure but has stricter permission controls
Many applications still work better with Xorg, including most time tracking software

About Flameshot:

Flameshot is an open-source screenshot utility trusted by the Linux community
It provides better Wayland compatibility for screenshot functionality
Installing it doesn't affect your other applications or system performance

Performance considerations:

Both solutions work equally well for WebWork functionality
Xorg switching is usually simpler and more reliable
Flameshot installation lets you keep your preferred Wayland environment

Need more help? Contact support with your Linux distribution name, desktop environment, and current display server type (echo $XDG_SESSION_TYPE output).