Revert "Add SteamOS GPU fixes and launch script"
This reverts commit 27cb97ac00.
This commit is contained in:
@@ -1,101 +0,0 @@
|
|||||||
# GPU Fix Guide for Nebula Browser
|
|
||||||
|
|
||||||
## Common GPU Issues
|
|
||||||
|
|
||||||
Nebula Browser is an Electron-based application that uses Chromium's rendering engine. Some systems may experience GPU-related issues such as:
|
|
||||||
- Black/blank screens
|
|
||||||
- Webviews not loading content
|
|
||||||
- Flickering or visual artifacts
|
|
||||||
- Application crashes
|
|
||||||
|
|
||||||
## SteamOS / Steam Deck
|
|
||||||
|
|
||||||
### Symptoms
|
|
||||||
On SteamOS (Steam Deck), you may see:
|
|
||||||
- Browser chrome loads (tab bar, URL bar visible)
|
|
||||||
- Web page content area is completely black/empty
|
|
||||||
- No error messages visible
|
|
||||||
|
|
||||||
### Cause
|
|
||||||
This is caused by GPU compositing conflicts between Electron's Chromium renderer and Gamescope (Steam Deck's compositor). The AMD GPU in Steam Deck handles nested compositor contexts differently.
|
|
||||||
|
|
||||||
### Solution
|
|
||||||
|
|
||||||
**Option 1: Automatic Detection (Recommended)**
|
|
||||||
The latest version of Nebula automatically detects SteamOS/Gamescope and applies the necessary fixes. Simply update to the latest version.
|
|
||||||
|
|
||||||
**Option 2: Manual Launch Script**
|
|
||||||
Use the provided `start-steamos.sh` script:
|
|
||||||
```bash
|
|
||||||
chmod +x start-steamos.sh
|
|
||||||
./start-steamos.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
**Option 3: Command-line Flags**
|
|
||||||
If running manually, add these flags:
|
|
||||||
```bash
|
|
||||||
electron . --ozone-platform=x11 --disable-gpu-compositing --disable-gpu-vsync --no-sandbox --disable-dev-shm-usage
|
|
||||||
```
|
|
||||||
|
|
||||||
**Option 4: Environment Variable**
|
|
||||||
Set the `ELECTRON_OZONE_PLATFORM_HINT` environment variable:
|
|
||||||
```bash
|
|
||||||
export ELECTRON_OZONE_PLATFORM_HINT=x11
|
|
||||||
npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
## Linux (General)
|
|
||||||
|
|
||||||
### Wayland
|
|
||||||
If running on a Wayland compositor (GNOME Wayland, KDE Wayland, Sway, etc.):
|
|
||||||
```bash
|
|
||||||
electron . --ozone-platform=wayland --enable-features=UseOzonePlatform,WaylandWindowDecorations
|
|
||||||
```
|
|
||||||
|
|
||||||
### X11
|
|
||||||
For X11 sessions:
|
|
||||||
```bash
|
|
||||||
electron . --ozone-platform=x11
|
|
||||||
```
|
|
||||||
|
|
||||||
### NVIDIA GPUs
|
|
||||||
If using NVIDIA proprietary drivers:
|
|
||||||
```bash
|
|
||||||
electron . --disable-gpu-sandbox --no-sandbox
|
|
||||||
```
|
|
||||||
|
|
||||||
## Windows
|
|
||||||
|
|
||||||
### Intel/AMD Integrated Graphics Issues
|
|
||||||
If experiencing blank screens on Windows with integrated graphics:
|
|
||||||
1. Try running with `start-gpu-safe.bat`
|
|
||||||
2. Update your graphics drivers
|
|
||||||
3. Disable hardware acceleration in settings (if available)
|
|
||||||
|
|
||||||
### Multiple GPU Systems
|
|
||||||
On laptops with both integrated and discrete GPUs:
|
|
||||||
- Right-click the Nebula shortcut
|
|
||||||
- Select "Run with graphics processor"
|
|
||||||
- Choose your dedicated GPU
|
|
||||||
|
|
||||||
## macOS
|
|
||||||
|
|
||||||
macOS typically has fewer GPU issues, but if problems occur:
|
|
||||||
```bash
|
|
||||||
electron . --disable-gpu
|
|
||||||
```
|
|
||||||
|
|
||||||
## Diagnostic Information
|
|
||||||
|
|
||||||
To see GPU information and diagnostics:
|
|
||||||
1. Open Nebula Browser
|
|
||||||
2. Navigate to `nebula://gpu` or `chrome://gpu`
|
|
||||||
3. Check the "Graphics Feature Status" section
|
|
||||||
|
|
||||||
## Reporting Issues
|
|
||||||
|
|
||||||
If none of the above solutions work, please report the issue with:
|
|
||||||
1. Operating system and version
|
|
||||||
2. GPU model and driver version
|
|
||||||
3. Contents of `chrome://gpu` page
|
|
||||||
4. Any error messages from terminal/console
|
|
||||||
|
|||||||
+2
-89
@@ -5,36 +5,6 @@ class GPUConfig {
|
|||||||
constructor() {
|
constructor() {
|
||||||
this.isGPUSupported = false;
|
this.isGPUSupported = false;
|
||||||
this.fallbackApplied = false;
|
this.fallbackApplied = false;
|
||||||
this.isSteamOS = false;
|
|
||||||
this.isLinux = process.platform === 'linux';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Detect if running on SteamOS/Steam Deck
|
|
||||||
detectSteamOS() {
|
|
||||||
if (!this.isLinux) return false;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const fs = require('fs');
|
|
||||||
// Check for SteamOS identifiers
|
|
||||||
if (fs.existsSync('/etc/steamos-release')) return true;
|
|
||||||
if (fs.existsSync('/usr/share/steamos/steamos.conf')) return true;
|
|
||||||
|
|
||||||
// Check os-release for SteamOS
|
|
||||||
if (fs.existsSync('/etc/os-release')) {
|
|
||||||
const osRelease = fs.readFileSync('/etc/os-release', 'utf8');
|
|
||||||
if (osRelease.includes('SteamOS') || osRelease.includes('steamos')) return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check if running under Gamescope (Steam Deck's compositor)
|
|
||||||
if (process.env.GAMESCOPE_WAYLAND_DISPLAY || process.env.SteamDeck) return true;
|
|
||||||
|
|
||||||
// Check for Steam runtime environment
|
|
||||||
if (process.env.STEAM_RUNTIME || process.env.SteamAppId) return true;
|
|
||||||
} catch (err) {
|
|
||||||
console.log('SteamOS detection error:', err.message);
|
|
||||||
}
|
|
||||||
|
|
||||||
return false;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Apply GPU configuration based on system capabilities
|
// Apply GPU configuration based on system capabilities
|
||||||
@@ -45,14 +15,7 @@ class GPUConfig {
|
|||||||
const platform = process.platform;
|
const platform = process.platform;
|
||||||
const arch = process.arch;
|
const arch = process.arch;
|
||||||
|
|
||||||
this.isSteamOS = this.detectSteamOS();
|
console.log(`Platform: ${platform}, Architecture: ${arch}`);
|
||||||
|
|
||||||
console.log(`Platform: ${platform}, Architecture: ${arch}, SteamOS: ${this.isSteamOS}`);
|
|
||||||
|
|
||||||
// Apply Linux/SteamOS specific configuration FIRST (before app ready)
|
|
||||||
if (this.isLinux) {
|
|
||||||
this.applyLinuxSettings();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Start with conservative settings that usually work
|
// Start with conservative settings that usually work
|
||||||
this.applyConservativeSettings();
|
this.applyConservativeSettings();
|
||||||
@@ -61,48 +24,6 @@ class GPUConfig {
|
|||||||
this.tryEnableGPU();
|
this.tryEnableGPU();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Linux-specific settings for proper rendering
|
|
||||||
applyLinuxSettings() {
|
|
||||||
console.log('Applying Linux-specific GPU settings...');
|
|
||||||
|
|
||||||
// Ozone platform selection - critical for rendering on Linux
|
|
||||||
// Check for Wayland vs X11 environment
|
|
||||||
const waylandDisplay = process.env.WAYLAND_DISPLAY;
|
|
||||||
const gamescope = process.env.GAMESCOPE_WAYLAND_DISPLAY;
|
|
||||||
const x11Display = process.env.DISPLAY;
|
|
||||||
|
|
||||||
if (this.isSteamOS || gamescope) {
|
|
||||||
// SteamOS/Gamescope: Force X11 backend for better compatibility
|
|
||||||
// Gamescope provides X11 compatibility layer that works better with Electron
|
|
||||||
console.log('SteamOS/Gamescope detected - using X11 Ozone backend');
|
|
||||||
app.commandLine.appendSwitch('ozone-platform', 'x11');
|
|
||||||
|
|
||||||
// Disable GPU compositing issues on Steam Deck AMD GPU
|
|
||||||
app.commandLine.appendSwitch('disable-gpu-compositing');
|
|
||||||
app.commandLine.appendSwitch('disable-gpu-vsync');
|
|
||||||
|
|
||||||
// Use software rendering for webviews if needed
|
|
||||||
app.commandLine.appendSwitch('disable-accelerated-2d-canvas');
|
|
||||||
|
|
||||||
// Fix for AMD GPU rendering issues
|
|
||||||
app.commandLine.appendSwitch('use-gl', 'desktop');
|
|
||||||
app.commandLine.appendSwitch('enable-features', 'UseOzonePlatform');
|
|
||||||
} else if (waylandDisplay && !x11Display) {
|
|
||||||
// Pure Wayland environment
|
|
||||||
console.log('Wayland detected - using Wayland Ozone backend');
|
|
||||||
app.commandLine.appendSwitch('ozone-platform', 'wayland');
|
|
||||||
app.commandLine.appendSwitch('enable-features', 'UseOzonePlatform,WaylandWindowDecorations');
|
|
||||||
} else if (x11Display) {
|
|
||||||
// X11 environment
|
|
||||||
console.log('X11 detected - using X11 Ozone backend');
|
|
||||||
app.commandLine.appendSwitch('ozone-platform', 'x11');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Common Linux fixes
|
|
||||||
app.commandLine.appendSwitch('disable-features', 'VizDisplayCompositor');
|
|
||||||
app.commandLine.appendSwitch('enable-unsafe-swiftshader');
|
|
||||||
}
|
|
||||||
|
|
||||||
applyConservativeSettings() {
|
applyConservativeSettings() {
|
||||||
// Essential switches that usually don't cause issues
|
// Essential switches that usually don't cause issues
|
||||||
app.commandLine.appendSwitch('no-sandbox');
|
app.commandLine.appendSwitch('no-sandbox');
|
||||||
@@ -119,12 +40,6 @@ class GPUConfig {
|
|||||||
|
|
||||||
tryEnableGPU() {
|
tryEnableGPU() {
|
||||||
try {
|
try {
|
||||||
// Skip aggressive GPU features on SteamOS - they conflict with Gamescope
|
|
||||||
if (this.isSteamOS) {
|
|
||||||
console.log('SteamOS detected - skipping aggressive GPU acceleration');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GPU acceleration switches
|
// GPU acceleration switches
|
||||||
app.commandLine.appendSwitch('ignore-gpu-blacklist');
|
app.commandLine.appendSwitch('ignore-gpu-blacklist');
|
||||||
app.commandLine.appendSwitch('ignore-gpu-blocklist');
|
app.commandLine.appendSwitch('ignore-gpu-blocklist');
|
||||||
@@ -135,10 +50,8 @@ class GPUConfig {
|
|||||||
app.commandLine.appendSwitch('enable-accelerated-video-decode');
|
app.commandLine.appendSwitch('enable-accelerated-video-decode');
|
||||||
app.commandLine.appendSwitch('enable-accelerated-mjpeg-decode');
|
app.commandLine.appendSwitch('enable-accelerated-mjpeg-decode');
|
||||||
|
|
||||||
// Conservative feature enabling - skip on Linux to avoid conflicts
|
// Conservative feature enabling
|
||||||
if (!this.isLinux) {
|
|
||||||
app.commandLine.appendSwitch('enable-features', 'VaapiVideoDecoder');
|
app.commandLine.appendSwitch('enable-features', 'VaapiVideoDecoder');
|
||||||
}
|
|
||||||
|
|
||||||
console.log('GPU acceleration switches applied');
|
console.log('GPU acceleration switches applied');
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
|
|||||||
@@ -5,8 +5,6 @@
|
|||||||
"main": "main.js",
|
"main": "main.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "electron .",
|
"start": "electron .",
|
||||||
"start:steamos": "electron . --ozone-platform=x11 --disable-gpu-compositing --disable-gpu-vsync --no-sandbox --disable-dev-shm-usage --disable-features=VizDisplayCompositor",
|
|
||||||
"start:linux-safe": "electron . --disable-gpu --disable-gpu-compositing --no-sandbox",
|
|
||||||
"dist": "electron-builder",
|
"dist": "electron-builder",
|
||||||
"run": "electron ."
|
"run": "electron ."
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -1,31 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
# SteamOS/Steam Deck launch script for Nebula Browser
|
|
||||||
# This script applies necessary flags for proper rendering on SteamOS/Gamescope
|
|
||||||
|
|
||||||
# Detect if running on SteamOS
|
|
||||||
if [ -f /etc/steamos-release ] || [ -f /usr/share/steamos/steamos.conf ]; then
|
|
||||||
echo "SteamOS detected"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Detect if running under Gamescope (Steam Deck's compositor)
|
|
||||||
if [ -n "$GAMESCOPE_WAYLAND_DISPLAY" ] || [ -n "$SteamDeck" ]; then
|
|
||||||
echo "Gamescope/Steam Deck environment detected"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Get the directory where this script is located
|
|
||||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
||||||
|
|
||||||
# Launch Nebula with SteamOS-compatible flags
|
|
||||||
# These flags help with webview rendering issues on AMD GPUs under Gamescope
|
|
||||||
exec electron "$SCRIPT_DIR" \
|
|
||||||
--ozone-platform=x11 \
|
|
||||||
--disable-gpu-compositing \
|
|
||||||
--disable-gpu-vsync \
|
|
||||||
--disable-accelerated-2d-canvas \
|
|
||||||
--use-gl=desktop \
|
|
||||||
--no-sandbox \
|
|
||||||
--disable-dev-shm-usage \
|
|
||||||
--disable-gpu-sandbox \
|
|
||||||
--disable-features=VizDisplayCompositor \
|
|
||||||
--enable-unsafe-swiftshader \
|
|
||||||
"$@"
|
|
||||||
Reference in New Issue
Block a user