nebula-project/NebulaBrowser
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Refactor GPU config: move critical Linux flags to main.js

Browse Source 
Critical Linux and SteamOS GPU flags are now set immediately after loading Electron in main.js, before app.ready, to ensure proper rendering and compatibility. The GPUConfig class now only applies additional, non-critical settings. Improved SteamOS detection logic and added more detailed logging for GPU environment detection.
This commit is contained in:
Andrew Zambazos
2025-12-28 11:47:57 +13:00
parent a92e3e4652
commit 80622e63fb
2 changed files with 94 additions and 91 deletions
Download Patch File Download Diff File Expand all files Collapse all files
gpu-config.js
+19 -49
View File
@@ -39,7 +39,7 @@ class GPUConfig {
// Apply GPU configuration based on system capabilities
configure() {
console.log('Configuring GPU settings...');
console.log('[GPUConfig] Additional GPU configuration...');
// Try to detect if we're on a system that supports GPU acceleration
const platform = process.platform;
@@ -47,67 +47,37 @@ class GPUConfig {
this.isSteamOS = this.detectSteamOS();
console.log(`Platform: ${platform}, Architecture: ${arch}, SteamOS: ${this.isSteamOS}`);
console.log(`[GPUConfig] Platform: ${platform}, Architecture: ${arch}, SteamOS: ${this.isSteamOS}`);
// Apply Linux/SteamOS specific configuration FIRST (before app ready)
if (this.isLinux) {
this.applyLinuxSettings();
}
// NOTE: Primary Linux/SteamOS GPU flags are now applied in main.js
// immediately after loading Electron, before app.ready
// This configure() method now only applies additional non-critical settings
// Start with conservative settings that usually work
this.applyConservativeSettings();
// Try to enable GPU features progressively
this.tryEnableGPU();
// Try to enable GPU features progressively (skip on SteamOS - already handled)
if (!this.isSteamOS) {
this.tryEnableGPU();
}
}
// Linux-specific settings for proper rendering
// NOTE: Critical flags are now in main.js - this is for additional settings only
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');
// Most Linux settings are now applied earlier in main.js
// This method is kept for any additional non-critical settings
console.log('[GPUConfig] Additional Linux settings (if any)...');
}
applyConservativeSettings() {
// Essential switches that usually don't cause issues
app.commandLine.appendSwitch('no-sandbox');
// Note: no-sandbox and disable-gpu-sandbox are already set in main.js for Linux
if (process.platform !== 'linux') {
app.commandLine.appendSwitch('no-sandbox');
app.commandLine.appendSwitch('disable-gpu-sandbox');
}
app.commandLine.appendSwitch('disable-dev-shm-usage');
app.commandLine.appendSwitch('disable-gpu-sandbox');
// Performance improvements that don't rely on GPU
app.commandLine.appendSwitch('disable-background-timer-throttling');
@@ -121,7 +91,7 @@ class GPUConfig {
try {
// Skip aggressive GPU features on SteamOS - they conflict with Gamescope
if (this.isSteamOS) {
console.log('SteamOS detected - skipping aggressive GPU acceleration');
console.log('[GPUConfig] SteamOS detected - skipping aggressive GPU acceleration');
return;
}
main.js
+74 -41
View File
@@ -1,67 +1,100 @@
// ============================================================================
// CRITICAL: GPU flags must be applied BEFORE Electron loads
// These must be at the VERY TOP of main.js for packaged apps
// CRITICAL: Load Electron first, then apply GPU flags IMMEDIATELY
// app.commandLine.appendSwitch() must be called before app.ready
// ============================================================================
const { app, BrowserWindow, ipcMain, session, screen, shell, dialog, Menu, clipboard, webContents } = require('electron');
// Apply Linux/SteamOS GPU flags IMMEDIATELY after loading Electron
// This MUST happen before app.ready and before any other initialization
if (process.platform === 'linux') {
const fs = require('fs');
// Detect SteamOS/Gamescope environment
let isSteamOS = false;
let detectionReason = '';
try {
if (fs.existsSync('/etc/steamos-release')) isSteamOS = true;
else if (fs.existsSync('/usr/share/steamos/steamos.conf')) isSteamOS = true;
else if (process.env.GAMESCOPE_WAYLAND_DISPLAY) isSteamOS = true;
else if (process.env.SteamDeck) isSteamOS = true;
else if (process.env.SteamAppId) isSteamOS = true;
else if (fs.existsSync('/etc/os-release')) {
if (fs.existsSync('/etc/steamos-release')) {
isSteamOS = true;
detectionReason = '/etc/steamos-release exists';
} else if (fs.existsSync('/usr/share/steamos/steamos.conf')) {
isSteamOS = true;
detectionReason = '/usr/share/steamos/steamos.conf exists';
} else if (process.env.GAMESCOPE_WAYLAND_DISPLAY) {
isSteamOS = true;
detectionReason = 'GAMESCOPE_WAYLAND_DISPLAY env var set';
} else if (process.env.SteamDeck === '1' || process.env.SteamDeck === 'true') {
isSteamOS = true;
detectionReason = 'SteamDeck env var set';
} else if (process.env.SteamAppId) {
isSteamOS = true;
detectionReason = 'SteamAppId env var set (running from Steam)';
} else if (process.env.STEAM_COMPAT_DATA_PATH) {
isSteamOS = true;
detectionReason = 'STEAM_COMPAT_DATA_PATH set (Proton/Steam environment)';
} else if (fs.existsSync('/etc/os-release')) {
const osRelease = fs.readFileSync('/etc/os-release', 'utf8');
if (osRelease.includes('SteamOS') || osRelease.includes('steamos')) isSteamOS = true;
if (osRelease.toLowerCase().includes('steamos')) {
isSteamOS = true;
detectionReason = '/etc/os-release contains SteamOS';
}
}
} catch (e) {}
// Apply flags via app.commandLine BEFORE requiring electron
// We need to do this via process.argv for packaged apps
const linuxFlags = [
'--disable-gpu-sandbox',
'--no-sandbox',
'--disable-dev-shm-usage'
];
// Also check for gamescope in display server - common on Steam Deck
if (!isSteamOS && process.env.XDG_CURRENT_DESKTOP) {
const desktop = process.env.XDG_CURRENT_DESKTOP.toLowerCase();
if (desktop.includes('gamescope')) {
isSteamOS = true;
detectionReason = 'XDG_CURRENT_DESKTOP contains gamescope';
}
}
} catch (e) {
console.log('[GPU] SteamOS detection error:', e.message);
}
if (isSteamOS || process.env.GAMESCOPE_WAYLAND_DISPLAY) {
console.log('[GPU] SteamOS/Gamescope detected at startup - applying critical flags');
linuxFlags.push(
'--ozone-platform=x11',
'--disable-gpu-compositing',
'--disable-gpu-vsync',
'--disable-accelerated-2d-canvas',
'--use-gl=desktop',
'--disable-features=VizDisplayCompositor',
'--enable-features=UseOzonePlatform'
);
// Always apply basic Linux sandbox fixes
app.commandLine.appendSwitch('no-sandbox');
app.commandLine.appendSwitch('disable-gpu-sandbox');
app.commandLine.appendSwitch('disable-dev-shm-usage');
if (isSteamOS) {
console.log(`[GPU] SteamOS/Gamescope DETECTED: ${detectionReason}`);
console.log('[GPU] Applying SteamOS-specific GPU flags for webview rendering...');
// Critical flags for SteamOS/Gamescope webview rendering
app.commandLine.appendSwitch('ozone-platform', 'x11');
app.commandLine.appendSwitch('disable-gpu-compositing');
app.commandLine.appendSwitch('disable-gpu-vsync');
app.commandLine.appendSwitch('disable-accelerated-2d-canvas');
app.commandLine.appendSwitch('use-gl', 'desktop');
app.commandLine.appendSwitch('disable-features', 'VizDisplayCompositor');
app.commandLine.appendSwitch('enable-features', 'UseOzonePlatform');
app.commandLine.appendSwitch('enable-unsafe-swiftshader');
// Additional flags that help with AMD GPU under Gamescope
app.commandLine.appendSwitch('disable-background-networking');
app.commandLine.appendSwitch('in-process-gpu');
} else {
console.log('[GPU] Standard Linux environment detected');
// General Linux - detect Wayland vs X11
const waylandDisplay = process.env.WAYLAND_DISPLAY;
const x11Display = process.env.DISPLAY;
if (waylandDisplay && !x11Display) {
linuxFlags.push('--ozone-platform=wayland', '--enable-features=UseOzonePlatform,WaylandWindowDecorations');
console.log('[GPU] Pure Wayland environment - using wayland backend');
app.commandLine.appendSwitch('ozone-platform', 'wayland');
app.commandLine.appendSwitch('enable-features', 'UseOzonePlatform,WaylandWindowDecorations');
} else if (x11Display) {
linuxFlags.push('--ozone-platform=x11');
console.log('[GPU] X11 environment detected');
app.commandLine.appendSwitch('ozone-platform', 'x11');
}
linuxFlags.push('--disable-features=VizDisplayCompositor');
}
// Add flags that aren't already present
linuxFlags.forEach(flag => {
const flagName = flag.split('=')[0];
if (!process.argv.some(arg => arg.startsWith(flagName))) {
process.argv.push(flag);
}
});
app.commandLine.appendSwitch('disable-features', 'VizDisplayCompositor');
}
}
// ============================================================================
const { app, BrowserWindow, ipcMain, session, screen, shell, dialog, Menu, clipboard, webContents } = require('electron');
const { autoUpdater } = require('electron-updater');
const { pathToFileURL } = require('url');
const fs = require('fs');
@@ -90,7 +123,7 @@ try {
// Non-fatal: some environments may not allow commandLine changes at this time.
}
// Configure GPU settings before app is ready
// Configure GPU settings before app is ready (additional platform-specific settings)
gpuConfig.configure();
// Set a custom application name