> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screention.gkernel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solutions to common issues

## Hotkey Not Working

If the global hotkey isn't triggering a capture:

1. **Check if the app is running**: Look for the Screention icon in your system tray.
2. **Key conflict**: Another application might be using the same hotkey. Try changing it in **Settings**.
3. **Restart**: Sometimes a simple restart of the app resolves global shortcut registration issues.

## Screen Black/Blank on Capture (macOS)

If your screen goes black or you only see a desktop background without windows when capturing on macOS:

1. Open **System Settings** -> **Privacy & Security** -> **Screen Recording**.
2. Ensure **Screention** is checked.
3. If it is already checked, uncheck it and check it again.
4. **Restart Screention** for the permission to re-initialize.

## App Fails to Launch on Ubuntu 24.04+ / Debian (Linux)

Modern Ubuntu (24.04 LTS+) and Debian 12 restrict unprivileged user namespaces used by Chromium's SUID sandbox. If Screention does not launch after manual installation:

Fix the sandbox binary permissions by running:

```bash theme={null}
sudo chown root:root /opt/Screention/chrome-sandbox && sudo chmod 4755 /opt/Screention/chrome-sandbox
```

## App Doesn't Start Automatically

If "Launch at startup" is enabled but not working:

* **Windows**: Check Task Manager -> Startup apps to ensure it's not disabled there.
* **Linux**: Check your distribution's "Startup Applications" preferences.
* **Generally**: Toggle the setting OFF and then ON again in Screention Settings to re-register the startup entry.

## Contact Support

If you're still having issues, please [open an issue on GitHub](https://github.com/gkernel247/screention/issues).