Files
hytale-f2p-mirror/backend/utils/platformUtils.js
Fazri Gading 1cb08f029a Release Stable Build v2.2.1 (#258)
* fix: resolve cross-platform EPERM permissions errors

modManager.js:
- Switch from hardcoded 'junction' to dynamic symlink type based on OS (fixing Linux EPERM).
- Add retry logic for directory removal to handle file locking race conditions.
- Improve broken symlink detection during profile sync.

gameManager.js:
- Implement retry loop (3 attempts) for game directory removal in updateGameFiles to prevent EBUSY/EPERM errors on Windows.

paths.js:
- Prevent fs.mkdirSync failure in getModsPath by pre-checking for broken symbolic links.

* fix: missing pacman builds

* prepare release for 2.1.1

minor fix for EPERM error permission

* prepare release 2.1.1

minor fix EPERM permission error

* prepare release 2.1.1

* Update README.md Windows Prequisites for ARM64 builds

* fix: remove broken symlink after detected

* fix: add pathexists for paths.js to check symlink

* fix: isbrokenlink should be true to remove the symlink

* add arch package .pkg.tar.zst for release

* fix: release workflow for build-arch and build-linux

* build-arch job now only build arch .pkg.tar.zst package instead of the whole generic linux.
* build-linux job now exclude .pacman package since its deprecated and should not be used.

* fix: removes pacman build as it replaced by tar.zst and adds build:arch shortcut for pkgbuild

* aur: add proper VCS (-git) PKGBUILD

created clean VCS-based PKGBUILD following arch packaging conventions.

this explicitly marked as a rolling (-git) build and derives its version dynamically from git tags and commit history via pkgver(). previous hybrid approach has been changed.

key changes:
- use -git suffix to clearly indicate rolling source builds
- set pkgver=0 and compute the actual version via pkgver()
- build only a directory layout using electron-builder (--dir)
- avoid generating AppImage, deb, rpm, or pacman installers
- align build and package steps with Arch packaging guidelines

note: this PKGBUILD is intended for development and AUR use only and is not suitable for binary redistribution or release artifacts.

* ci: add fixed-version PKGBUILD for Arch Linux releases

this PKGBUILD intended for CI and GitHub release artifacts. targets tagged releases only and uses a fixed pkgver that matches the corresponding git tag. all of the VCS logic has been removed to PKGBUILD-git to ensure reproducible builds and stable versioning suitable for binary distribution.

the build process relies on electron-builder directory output (--dir) and packages only the unpacked application into a standard Arch Linux package (.pkg.tar.zst). other distro format are excluded from this path and handled separately.

this change establishes a clear separation between:
- rolling AUR development builds (-git)
- CI-generated, versioned Arch Linux release packages

the result is predictable artifact naming, correct version alignment, and Arch-compliant packaging for downstream users.

* Update README.md

adds information for Arch build

* Update README.md

BUILD.md location was changed and now this link is poiting to nothing

* Update PKGBUILD

* Update PKGBUILD-git

* chore: fix ubuntu/debian part in README.md

* Polish language support (#195)

* Update support_request.yml

Added hardware specification

* Update bug_report.yml

Add logs textfield to bug report

* chore: add changelog in README.md

* fix screenshot input in feature_request.yml

* add hardware spec input in bug_report.yml

* fix: PKGBUILD pkgname variable fix

* userdata migration [need review from other OS]

* french translate

* Add German and Swedish translations

Added de.json and sv.json locale files for German and Swedish language support. Updated i18n.js to register 'de' and 'sv' as available languages in the launcher.

* Update README.md

* chore: add offline-mode warning to the README.md

* chore: add downloads counter in README.md

* fix: Steam Deck/Ubuntu crash - use system libzstd.so

The bundled libzstd.so is incompatible with glibc 2.41's stricter heap
validation, causing "free(): invalid pointer" crashes.

Solution: Automatically replace bundled libzstd.so with system version
on Linux. The launcher detects and symlinks to /usr/lib/libzstd.so.1.

- Auto-detect system libzstd at common paths (Arch, Debian, Fedora)
- Backup bundled version as libzstd.so.bundled
- Create symlink to system version
- Add HYTALE_NO_LIBZSTD_FIX=1 to disable if needed

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: remove Windows and Linux ARM64 information on the README.md

* Update support_request.yml

* fix: improve update system UX and macOS compatibility

Update System Improvements:
- Fix duplicate update popups by disabling legacy updater.js
- Add skip button to update popup (shows after 30s, on error, or after download)
- Add macOS-specific handling with manual download as primary option
- Add missing open-download-page IPC handler
- Add missing unblockInterface() method to properly clean up after popup close
- Add quitAndInstallUpdate alias in preload for compatibility
- Remove pulse animation when download completes
- Fix manual download button to show correct status and close popup
- Sync player name to settings input after first install

Client Patcher Cleanup:
- Remove server patching code (server uses pre-patched JAR from CDN)
- Simplify to client-only patching
- Remove unused imports (crypto, AdmZip, execSync, spawn, javaManager)
- Remove unused methods (stringToUtf8, findAndReplaceDomainUtf8)
- Move localhost dev code to backup file for reference

Code Quality Fixes:
- Fix duplicate DOMContentLoaded handlers in install.js
- Fix duplicate checkForUpdates definition in preload.js
- Fix redundant if/else in onProgressUpdate callback
- Fix typo "Harwadre" -> "Hardware" in preload.js

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add Russian language support

Added Russian (ru) to the list of available languages.

* chore: drafting documentation on SERVER.md

* Some updates in Russian language localization file

* fix

* Update ru.json

* Fixed Java runtime name and fixed typo

* fixed untranslated place

* Update ru.json

* Update ru.json

* Update ru.json

* Update ru.json

* Update ru.json

* fix: timeout getLatestClient 

fixes #138

* fix: change default version to 7.pwr in main.js

* fix: change default release version to 7.pwr

* fix: change version release to 7.pwr

* docs: Add comprehensive troubleshooting guide (#209)

Add TROUBLESHOOTING.md with solutions for common issues including:

- Windows: Firewall configuration, duplicate mods, SmartScreen
- Linux: GPU detection (NVIDIA/AMD), SDL3_image/libpng dependencies,
  Wayland/X11 issues, Steam Deck support
- macOS: Rosetta 2 for Apple Silicon, code signing, quarantine
- Connection: Server boot failures, regional restrictions
- Authentication: Token errors, config reset procedures
- Avatar/Cosmetics: F2P limitations documentation
- Backup locations for all platforms
- Log locations for bug reports

Solutions compiled from closed GitHub issues (#205, #155, #90, #60,
#144, #192) and community feedback.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* Standardize language codes, improve formatting, and update all locale files. (#224)

* Update German (Germany) localization

* Update Español (España) localization

* Update French (France) localization

* Update Polish (Poland) localization

* Update Portuguese (Brazil) localization

* Update Russian (Russia) localization

* Update Swedish (Sweden) localization

* Update Turkish (Turkey) localization

* Update language codes, names and alphabetical in i18n system

* Changed Spanish language name to the Formal name "Spanish (Spain)"

* Fix PKGBUILD-git

* Fix PKGBUILD

* delete cache after installation

* Enforce 16-char player name limit and update mod sync

Added a maxlength attribute to the player name input and enforced a 16-character limit in both install and settings scripts, providing user feedback if exceeded. Refactored modManager.js to replace symlink-based mod management with a copy-based system, copying enabled mods to HytaleSaves\Mods and removing legacy symlink logic to improve compatibility and avoid permission issues.

* Update installation subtitle

* chore: update quickstart link in README.md

* chore: delete warning of Ubuntu-Debian at Linux Prequisites section

* added featured server list from api

* Add Featured Servers page to GUI

* Update Discord invite URL in client patcher

* Add differential update system

* Remove launcher chat and add Discord popup

* fix: removed 'check disk space' alert on permission file error

* fix: upgrade tar to ^7.5.6 version

* fix: re-add universal arch for mac

* fix: upgrade electron/rebuild to 4.0.3

* fix: removed override tar version

* fix: pkgbuild version to 2.1.2

* fix: src.tar.zst and srcinfo missing files

* feat: add Indonesian language translation

* fix: GPU preference hint to Laptop-only

* feat: create two columns for settings page

* Add Discord invite link to rpc

* docs: add recordings form, fix OS list

* Release v2.2.0

* Release v2.2.0

* Release v2.2.0

* chore: delete icon.ico, moved to build folder

* chore: delete icon.png, moved to build folder

* fix: build and release for tag push-only in release.yml

* fix: gamescope steam deck issue fixes #186 hopefully

* Support branch selection for server patching

* chose: add auto-patch system for pre-release JAR

* fix: preserves arch x64 on linux target for #242

* fix: removed arm64 flags

* fix: redo package.json arch

* update package-lock.json

* Update release.yml

* chore: sync package-lock with package.json

* fix: reorder fedora libzstd paths to first iteration

* feat: enhance gpu detection, drafting

* fix: comprehensive UUID/username persistence bug fixes (#252)

* fix: comprehensive UUID/username persistence bug fixes

Major fixes for UUID/skin reset issues that caused players to lose cosmetics:

Core fixes:
- Username rename now preserves UUID (atomic rename, not new identity)
- Atomic config writes with backup/recovery system
- Case-insensitive UUID lookup with case-preserving storage
- Pre-launch validation blocks play if no username configured
- Removed saveUsername calls from launch/install flows

UUID Modal fixes:
- Fixed isCurrent badge showing on wrong user
- Added switch identity button to change between saved usernames
- Fixed custom UUID input using unsaved DOM username
- UUID list now refreshes when player name changes
- Enabled copy/paste in custom UUID input field

UI/UX improvements:
- Added translation keys for switch username functionality
- CSS user-select fix for UUID input fields
- Allowed Ctrl+V/C/X/A shortcuts in Electron

Files: config.js, gameLauncher.js, gameManager.js, playerManager.js,
launcher.js, settings.js, main.js, preload.js, style.css, en.json

See UUID_BUGS_FIX_PLAN.md for detailed bug list (18 bugs, 16 fixed)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(i18n): add switch username translations to all locales

Added translation keys for username switching functionality:
- notifications.noUsername
- notifications.switchUsernameSuccess
- notifications.switchUsernameFailed
- notifications.playerNameTooLong
- confirm.switchUsernameTitle
- confirm.switchUsernameMessage
- confirm.switchUsernameButton

Languages updated: de-DE, es-ES, fr-FR, id-ID, pl-PL, pt-BR, ru-RU, sv-SE, tr-TR

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: move UUID_BUGS_FIX_PLAN.md to docs folder

* docs: update UUID_BUGS_FIX_PLAN with complete fix details

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* chore: rearrange, fix, and improve README.md

* chore: link downloads, platform, and version to release page in README.md

* chore: update discord link

* chore: insert contact link in CODE_OF_CONDUCT.md

* fix: missing version text on launcher

* chore: update quickstart button link to header

* chore: update discord link and give warning quickstart

* chore revise online play hosting instructions in README

Updated instructions for hosting an online game and clarified troubleshooting steps.

* Fix Turkish translations in tr-TR.json

* fix: EPERM error in Repair Game Button [windows testing needed]

* fix: invalid generated token that caused hangs on exit [windows testing needed]

* fix: major bug - hytale won't launch with laptop machine and ghost processes

* fix: discord RPC destroy error if not connected

* fix: major bug - detach game process to avoid launcher-held handles causing zombie process

* docs: add analysis on ghost process and launcher cleanup

* revert generateLocalTokens, wrong analysis on game launching issue

* revert add deps for generateLocalTokens

* Add proxy client and route downloads through it

* fix: Prevent JAR file corruption during proxy downloads

Fixed binary file corruption when downloading through proxy by using PassThrough stream to preserve data integrity while tracking download progress.

* Improve featured servers layout with Discord integration

- Add Discord button to server cards when discord link is present in API data
- Remove HF2P Servers section to use full width for featured servers
- Increase server card size (300x180px banner, larger fonts and spacing)
- Simplify layout from 2-column grid to single full-width container
- Discord button opens external browser with server invite link

* package version to 2.2.1

Update package.json version from 2.2.0 to 2.2.1 to publish a patch release.

* fix: add game_running_marker to prevent duplicate launches

* Add smart proxy with direct-fallback and logging

* fix: remove duplicate check

* fix: cache invalidation from .env prevents multiple launch attempts

for all env related, it is necessary to clear cache first, otherwise on few launch attempts the game wouldn't run

* fix: redact proxy_url and remove timed out emoji

* Prepare Release v2.2.1

* docs: enhance bug report template with placeholders and options

Updated the bug report template to include placeholders and additional Linux distributions.

* chore revise windows prerequisites and changelog

Updated prerequisites and changelog for version 2.2.1.

* chore: improvise badges, relocate star history, fix discord links

* chore: fix release notes for v2.2.1

---------

Co-authored-by: TalesAmaral <57869141+TalesAmaral@users.noreply.github.com>
Co-authored-by: walti0 <95646872+walti0@users.noreply.github.com>
Co-authored-by: AMIAY <letudiantenrap.collab@gmail.com>
Co-authored-by: sanasol <mail@sanasol.ws>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Terromur <79866197+Terromur@users.noreply.github.com>
Co-authored-by: Zakhar Smokotov <zaharb840@gmail.com>
Co-authored-by: xSamiVS <samtaiebc@gmail.com>
Co-authored-by: MetricsLite <66024355+MetricsLite@users.noreply.github.com>
2026-02-02 05:58:56 +01:00

712 lines
24 KiB
JavaScript

const { execSync, spawnSync } = require('child_process');
const fs = require('fs');
function getOS() {
if (process.platform === 'win32') return 'windows';
if (process.platform === 'darwin') return 'darwin';
if (process.platform === 'linux') return 'linux';
return 'unknown';
}
function getArch() {
return process.arch === 'x64' ? 'amd64' : process.arch;
}
function isWaylandSession() {
if (process.platform !== 'linux') {
return false;
}
const sessionType = process.env.XDG_SESSION_TYPE;
const waylandDisplay = process.env.WAYLAND_DISPLAY;
// Debug logging
console.log(`[PlatformUtils] Checking Wayland: XDG_SESSION_TYPE=${sessionType}, WAYLAND_DISPLAY=${waylandDisplay}`);
if (sessionType && sessionType.toLowerCase() === 'wayland') {
return true;
}
if (waylandDisplay) {
return true;
}
try {
const sessionId = process.env.XDG_SESSION_ID;
if (sessionId) {
const output = execSync(`loginctl show-session ${sessionId} -p Type`, { encoding: 'utf8' });
if (output && output.toLowerCase().includes('wayland')) {
return true;
}
}
} catch (err) {
}
return false;
}
function setupWaylandEnvironment() {
if (process.platform !== 'linux') {
return {};
}
// If the user has manually set SDL_VIDEODRIVER (e.g. to 'x11'), strictly respect it.
if (process.env.SDL_VIDEODRIVER) {
console.log(`User manually set SDL_VIDEODRIVER=${process.env.SDL_VIDEODRIVER}, ignoring internal Wayland configuration.`);
return {};
}
if (!isWaylandSession()) {
console.log('Detected X11 session, using default environment');
return {};
}
console.log('Detected Wayland session, checking for Gamescope/Steam Deck...');
const envVars = {};
// Only set Ozone hint if not already set by user
if (!process.env.ELECTRON_OZONE_PLATFORM_HINT) {
envVars.ELECTRON_OZONE_PLATFORM_HINT = 'wayland';
}
// 2. DETECT GAMESCOPE / STEAM DECK
// Native Wayland often fails for SDL games in Gaming Mode (gamescope), so we force X11 (XWayland).
// Checks:
// - XDG_CURRENT_DESKTOP == 'gamescope'
// - SteamDeck=1 (often set in SteamOS)
const currentDesktop = process.env.XDG_CURRENT_DESKTOP || '';
const isGamescope = currentDesktop.toLowerCase() === 'gamescope' || process.env.SteamDeck === '1';
if (isGamescope) {
console.log('Gamescope / Steam Deck detected, forcing SDL_VIDEODRIVER=x11 for compatibility');
envVars.SDL_VIDEODRIVER = 'x11';
} else {
// For standard desktop Wayland (GNOME, KDE), we leave SDL_VIDEODRIVER unset.
// This allows SDL3/SDL2 to use its internal preference (Wayland > X11).
// EXCEPT if it was somehow force-set to 'wayland' by the parent process (rare but possible),
// we strictly want to allow fallback, so we might unset it if it was 'wayland'.
// But since we checked process.env.SDL_VIDEODRIVER at the start, we know it's NOT set manually.
// So we effectively do nothing for standard Wayland, letting SDL decide.
console.log('Standard Wayland session detected, letting SDL decide backend (auto-fallback enabled).');
}
console.log('Wayland environment variables:', envVars);
return envVars;
}
function detectGpu() {
const platform = getOS();
try {
if (platform === 'linux') {
return detectGpuLinux();
} else if (platform === 'windows') {
return detectGpuWindows();
} else if (platform === 'darwin') {
return detectGpuMac();
} else {
return { mode: 'integrated', vendor: 'intel', integratedName: 'Unknown', dedicatedName: null };
}
} catch (error) {
console.warn('GPU detection failed, falling back to integrated:', error.message);
return { mode: 'integrated', vendor: 'intel', integratedName: 'Unknown', dedicatedName: null };
}
}
function detectGpuLinux() {
let output = '';
try {
output = execSync('lspci -nn | grep -E "VGA|3D"', { encoding: 'utf8' });
} catch (e) {
return { mode: 'integrated', vendor: 'intel', integratedName: 'Unknown', dedicatedName: null };
}
const lines = output.split('\n').filter(line => line.trim());
let gpus = {
integrated: [],
dedicated: []
};
for (const line of lines) {
// Example: 01:00.0 VGA compatible controller [0300]: NVIDIA Corporation TU116 [GeForce GTX 1660 Ti] [10de:2182] (rev a1)
// Matches all content inside [...]
const brackets = line.match(/\[([^\]]+)\]/g);
let name = line; // fallback
let vendorId = '';
if (brackets && brackets.length >= 2) {
const idBracket = brackets.find(b => b.includes(':')); // [10de:2182]
if (idBracket) {
vendorId = idBracket.replace(/[\[\]]/g, '').split(':')[0].toLowerCase();
// The bracket before the ID bracket is usually the model name.
const idIndex = brackets.indexOf(idBracket);
if (idIndex > 0) {
name = brackets[idIndex - 1].replace(/[\[\]]/g, '');
}
}
} else if (brackets && brackets.length === 1) {
name = brackets[0].replace(/[\[\]]/g, '');
}
// Clean name
name = name.trim();
const lowerName = name.toLowerCase();
const lowerLine = line.toLowerCase();
// Vendor detection
const isNvidia = lowerLine.includes('nvidia') || vendorId === '10de';
const isAmd = lowerLine.includes('amd') || lowerLine.includes('radeon') || vendorId === '1002';
const isIntel = lowerLine.includes('intel') || vendorId === '8086';
// Intel Arc detection
const isIntelArc = isIntel && (lowerName.includes('arc') || lowerName.includes('a770') || lowerName.includes('a750') || lowerName.includes('a380'));
let vendor = 'unknown';
if (isNvidia) vendor = 'nvidia';
else if (isAmd) vendor = 'amd';
else if (isIntel) vendor = 'intel';
let vramMb = 0;
// VRAM Detection Logic
if (isNvidia) {
try {
// Try nvidia-smi
const smiOutput = execSync('nvidia-smi --query-gpu=memory.total --format=csv,noheader,nounits', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
const vramVal = parseInt(smiOutput.split('\n')[0]); // Take first if multiple
if (!isNaN(vramVal)) {
vramMb = vramVal;
}
} catch (err) {
// failed
}
} else if (isAmd) {
// Try /sys/class/drm/card*/device/mem_info_vram_total
// This is a bit heuristical, we need to match the card.
// But usually checking any card with AMD vendor in /sys is a good guess if we just want "the AMD GPU vram".
try {
const cards = fs.readdirSync('/sys/class/drm').filter(c => c.startsWith('card') && !c.includes('-'));
for (const card of cards) {
try {
const vendorFile = fs.readFileSync(`/sys/class/drm/${card}/device/vendor`, 'utf8').trim();
if (vendorFile === '0x1002') { // AMD vendor ID
const vramBytes = fs.readFileSync(`/sys/class/drm/${card}/device/mem_info_vram_total`, 'utf8').trim();
vramMb = Math.round(parseInt(vramBytes) / (1024 * 1024));
if (vramMb > 0) break;
}
} catch (e2) {}
}
} catch (err) {}
} else if (isIntel) {
// Try lspci -v to get prefetchable memory (stolen/dedicated aperture)
try {
// Extract slot from line, e.g. "00:02.0"
const slot = line.split(' ')[0];
if (slot && /^[0-9a-f:.]+$/.test(slot)) {
const verbose = execSync(`lspci -v -s ${slot}`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
const vLines = verbose.split('\n');
for (const vLine of vLines) {
// Match "Memory at ... (..., prefetchable) [size=256M]"
// Must ensure it is prefetchable and NOT non-prefetchable
if (vLine.includes('prefetchable') && !vLine.includes('non-prefetchable')) {
const match = vLine.match(/size=([0-9]+)([KMGT])/);
if (match) {
let size = parseInt(match[1]);
const unit = match[2];
if (unit === 'G') size *= 1024;
else if (unit === 'K') size /= 1024;
// M is default
if (size > 0) {
vramMb = size;
break;
}
}
}
}
}
} catch (e) {
// ignore
}
}
const gpuInfo = {
name: name,
vendor: vendor,
vram: vramMb
};
if (isNvidia || isAmd || isIntelArc) {
gpus.dedicated.push(gpuInfo);
} else if (isIntel) {
gpus.integrated.push(gpuInfo);
} else {
// Unknown vendor or other, fallback to integrated list to be safe
gpus.integrated.push(gpuInfo);
}
}
// Fallback: Attempt to get Integrated VRAM via glxinfo if it's STILL 0 (common for Intel iGPUs if lspci failed)
// glxinfo -B usually reports the active renderer's "Video memory" which includes shared memory for iGPUs.
if (gpus.integrated.length > 0 && gpus.integrated[0].vram === 0) {
try {
const glxOut = execSync('glxinfo -B', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
const lines = glxOut.split('\n');
let glxVendor = '';
let glxMem = 0;
for (const line of lines) {
const trim = line.trim();
if (trim.startsWith('Device:')) {
const lower = trim.toLowerCase();
if (lower.includes('intel')) glxVendor = 'intel';
else if (lower.includes('nvidia')) glxVendor = 'nvidia';
else if (lower.includes('amd') || lower.includes('ati')) glxVendor = 'amd';
} else if (trim.startsWith('Video memory:')) {
// Example: "Video memory: 15861MB"
const memStr = trim.split(':')[1].replace('MB', '').trim();
glxMem = parseInt(memStr, 10);
}
}
// If glxinfo reports Intel and we have an Intel integrated GPU, update it
// We check vendor match to ensure we don't accidentally assign Nvidia VRAM to Intel if user is running on dGPU
if (glxVendor === 'intel' && gpus.integrated[0].vendor === 'intel' && glxMem > 0) {
gpus.integrated[0].vram = glxMem;
}
} catch (err) {
// glxinfo missing or failed, ignore
}
}
const primaryDedicated = gpus.dedicated[0] || null;
const primaryIntegrated = gpus.integrated[0] || { name: 'Intel GPU', vram: 0 };
return {
mode: primaryDedicated ? 'dedicated' : 'integrated',
vendor: primaryDedicated ? primaryDedicated.vendor : (gpus.integrated[0] ? gpus.integrated[0].vendor : 'intel'),
integratedName: primaryIntegrated.name,
dedicatedName: primaryDedicated ? primaryDedicated.name : null,
dedicatedVram: primaryDedicated ? primaryDedicated.vram : 0,
integratedVram: primaryIntegrated.vram
};
}
function detectGpuWindows() {
let output = '';
let commandUsed = 'cim'; // Track which command succeeded
const POWERSHELL_TIMEOUT = 5000; // 5 second timeout to prevent hanging
try {
// Use spawnSync with explicit timeout instead of execSync to avoid ghost processes
// Fetch Name and AdapterRAM (VRAM in bytes)
const result = spawnSync('powershell.exe', [
'-NoProfile',
'-ExecutionPolicy', 'Bypass',
'-Command',
'Get-CimInstance Win32_VideoController | Select-Object Name, AdapterRAM | ConvertTo-Csv -NoTypeInformation'
], {
encoding: 'utf8',
timeout: POWERSHELL_TIMEOUT,
stdio: ['ignore', 'pipe', 'ignore'],
windowsHide: true
});
if (result.error) {
throw result.error;
}
if (result.status === 0 && result.stdout) {
output = result.stdout;
} else {
throw new Error(`PowerShell returned status ${result.status || result.signal}`);
}
} catch (e) {
try {
// Fallback to Get-WmiObject (Older PowerShell)
commandUsed = 'wmi';
const result = spawnSync('powershell.exe', [
'-NoProfile',
'-ExecutionPolicy', 'Bypass',
'-Command',
'Get-WmiObject Win32_VideoController | Select-Object Name, AdapterRAM | ConvertTo-Csv -NoTypeInformation'
], {
encoding: 'utf8',
timeout: POWERSHELL_TIMEOUT,
stdio: ['ignore', 'pipe', 'ignore'],
windowsHide: true
});
if (result.error) {
throw result.error;
}
if (result.status === 0 && result.stdout) {
output = result.stdout;
} else {
throw new Error(`PowerShell WMI returned status ${result.status || result.signal}`);
}
} catch (e2) {
// Fallback to wmic (Deprecated, often missing on newer Windows)
// Note: This fallback likely won't provide VRAM in the same reliable CSV format easily,
// so we stick to just getting the Name to at least allow the app to launch.
try {
commandUsed = 'wmic';
const result = spawnSync('wmic.exe', ['path', 'win32_VideoController', 'get', 'name'], {
encoding: 'utf8',
timeout: POWERSHELL_TIMEOUT,
stdio: ['ignore', 'pipe', 'ignore'],
windowsHide: true
});
if (result.error) {
throw result.error;
}
if (result.status === 0 && result.stdout) {
output = result.stdout;
} else {
throw new Error(`wmic returned status ${result.status || result.signal}`);
}
} catch (err) {
console.warn('All Windows GPU detection methods failed:', err.message);
return { mode: 'unknown', vendor: 'none', integratedName: null, dedicatedName: null };
}
}
}
// Parse lines.
// PowerShell CSV output (Get-CimInstance/Get-WmiObject) usually looks like:
// "Name","AdapterRAM"
// "NVIDIA GeForce RTX 3060","12884901888"
//
// WMIC output is just plain text lines with the name (if we used the wmic command above).
const lines = output.split(/\r?\n/).filter(l => l.trim().length > 0);
let gpus = {
integrated: [],
dedicated: []
};
for (const line of lines) {
// Skip header lines
if (line.toLowerCase().includes('name') && (line.includes('AdapterRAM') || commandUsed === 'wmic')) {
continue;
}
let name = '';
let vramBytes = 0;
if (commandUsed === 'wmic') {
name = line.trim();
} else {
// Parse CSV: "Name","AdapterRAM"
// Simple regex to handle potential quotes.
// This assumes simple CSV structure from ConvertTo-Csv.
const parts = line.split(',');
// Remove surrounding quotes if present
const rawName = parts[0] ? parts[0].replace(/^"|"$/g, '') : '';
const rawRam = parts[1] ? parts[1].replace(/^"|"$/g, '') : '0';
name = rawName.trim();
vramBytes = parseInt(rawRam, 10) || 0;
}
if (!name) continue;
const lowerName = name.toLowerCase();
const vramMb = Math.round(vramBytes / (1024 * 1024));
// Logic for dGPU detection; added isIntelArc check
const isNvidia = lowerName.includes('nvidia');
const isAmd = lowerName.includes('amd') || lowerName.includes('radeon');
const isIntelArc = lowerName.includes('arc') && lowerName.includes('intel');
const gpuInfo = {
name: name,
vendor: isNvidia ? 'nvidia' : (isAmd ? 'amd' : (isIntelArc ? 'intel' : 'unknown')),
vram: vramMb
};
if (isNvidia || isAmd || isIntelArc) {
gpus.dedicated.push(gpuInfo);
} else if (lowerName.includes('intel') || lowerName.includes('iris') || lowerName.includes('uhd')) {
gpus.integrated.push(gpuInfo);
} else {
// Fallback: If unknown vendor but high VRAM (> 512MB), treat as dedicated?
// Or just assume integrated if generic "Microsoft Basic Display Adapter" etc.
// For now, if we can't identify it as dedicated vendor, put in integrated/other.
gpus.integrated.push(gpuInfo);
}
}
const primaryDedicated = gpus.dedicated[0] || null;
const primaryIntegrated = gpus.integrated[0] || { name: 'Intel GPU', vram: 0 };
return {
mode: primaryDedicated ? 'dedicated' : 'integrated',
vendor: primaryDedicated ? primaryDedicated.vendor : 'intel', // Default to intel if only integrated found
integratedName: primaryIntegrated.name,
dedicatedName: primaryDedicated ? primaryDedicated.name : null,
// Add VRAM info if available (mostly for debug or UI)
dedicatedVram: primaryDedicated ? primaryDedicated.vram : 0,
integratedVram: primaryIntegrated.vram
};
}
function detectGpuMac() {
let output = '';
try {
output = execSync('system_profiler SPDisplaysDataType', { encoding: 'utf8' });
} catch (e) {
return { mode: 'integrated', vendor: 'intel', integratedName: 'Unknown', dedicatedName: null };
}
const lines = output.split('\n');
let gpus = {
integrated: [],
dedicated: []
};
let currentGpu = null;
for (const line of lines) {
const trimmed = line.trim();
// New block starts with "Chipset Model:"
if (trimmed.startsWith('Chipset Model:')) {
if (currentGpu) {
// Push previous
categorizeMacGpu(currentGpu, gpus);
}
currentGpu = {
name: trimmed.split(':')[1].trim(),
vendor: 'unknown',
vram: 0
};
} else if (currentGpu) {
if (trimmed.startsWith('VRAM (Total):') || trimmed.startsWith('VRAM (Dynamic, Max):')) {
// Parse VRAM: "1.5 GB" or "1536 MB"
const valParts = trimmed.split(':')[1].trim().split(' ');
let val = parseFloat(valParts[0]);
if (valParts[1] && valParts[1].toUpperCase() === 'GB') {
val = val * 1024;
}
currentGpu.vram = Math.round(val);
} else if (trimmed.startsWith('Vendor:') || trimmed.startsWith('Vendor Name:')) {
// "Vendor: NVIDIA (0x10de)"
const v = trimmed.split(':')[1].toLowerCase();
if (v.includes('nvidia')) currentGpu.vendor = 'nvidia';
else if (v.includes('amd') || v.includes('ati')) currentGpu.vendor = 'amd';
else if (v.includes('intel')) currentGpu.vendor = 'intel';
else if (v.includes('apple')) currentGpu.vendor = 'apple';
}
}
}
// Push last one
if (currentGpu) {
categorizeMacGpu(currentGpu, gpus);
}
// If we have an Apple Silicon GPU (vendor=apple) but VRAM is 0, fetch system memory as it is unified.
gpus.dedicated.forEach(gpu => {
if (gpu.vendor === 'apple' && gpu.vram === 0) {
try {
const memSize = execSync('sysctl -n hw.memsize', { encoding: 'utf8' }).trim();
// memSize is in bytes
const memMb = Math.round(parseInt(memSize, 10) / (1024 * 1024));
if (memMb > 0) gpu.vram = memMb;
} catch (err) {
// ignore
}
}
});
const primaryDedicated = gpus.dedicated[0] || null;
const primaryIntegrated = gpus.integrated[0] || { name: 'Integrated GPU', vram: 0 };
return {
mode: primaryDedicated ? 'dedicated' : 'integrated',
vendor: primaryDedicated ? primaryDedicated.vendor : (gpus.integrated[0] ? gpus.integrated[0].vendor : 'intel'),
integratedName: primaryIntegrated.name,
dedicatedName: primaryDedicated ? primaryDedicated.name : null,
dedicatedVram: primaryDedicated ? primaryDedicated.vram : 0,
integratedVram: primaryIntegrated.vram
};
}
function categorizeMacGpu(gpu, gpus) {
const lowerName = gpu.name.toLowerCase();
// Refine vendor if still unknown
if (gpu.vendor === 'unknown') {
if (lowerName.includes('nvidia')) gpu.vendor = 'nvidia';
else if (lowerName.includes('amd') || lowerName.includes('radeon')) gpu.vendor = 'amd';
else if (lowerName.includes('intel')) gpu.vendor = 'intel';
else if (lowerName.includes('apple') || lowerName.includes('m1') || lowerName.includes('m2') || lowerName.includes('m3')) gpu.vendor = 'apple';
}
const isNvidia = gpu.vendor === 'nvidia';
const isAmd = gpu.vendor === 'amd';
const isApple = gpu.vendor === 'apple';
// Per user request, "project is not meant for Intel Mac (x86)",
// so we treat Apple Silicon as the primary "dedicated-like" GPU for this app's context.
if (isNvidia || isAmd || isApple) {
gpus.dedicated.push(gpu);
} else {
// Intel or unknown
gpus.integrated.push(gpu);
}
}
function setupGpuEnvironment(gpuPreference) {
if (process.platform !== 'linux') {
return {};
}
let finalPreference = gpuPreference;
let detected = detectGpu();
if (gpuPreference === 'auto') {
finalPreference = detected.mode;
console.log(`Auto-detected GPU: ${detected.vendor} (${detected.mode})`);
}
console.log('Preferred GPU set to:', finalPreference);
const envVars = {};
if (finalPreference === 'dedicated') {
if (detected.vendor === 'nvidia') {
envVars.__NV_PRIME_RENDER_OFFLOAD = '1';
envVars.__GLX_VENDOR_LIBRARY_NAME = 'nvidia';
const nvidiaEglFile = '/usr/share/glvnd/egl_vendor.d/10_nvidia.json';
if (fs.existsSync(nvidiaEglFile)) {
envVars.__EGL_VENDOR_LIBRARY_FILENAMES = nvidiaEglFile;
} else {
console.warn('NVIDIA EGL vendor library file not found, not setting __EGL_VENDOR_LIBRARY_FILENAMES');
}
} else {
envVars.DRI_PRIME = '1';
}
console.log('GPU environment variables:', envVars);
} else {
console.log('Using integrated GPU, no environment variables set');
}
return envVars;
}
function getSystemType() {
const platform = getOS();
try {
if (platform === 'linux') return getSystemTypeLinux();
if (platform === 'windows') return getSystemTypeWindows();
if (platform === 'darwin') return getSystemTypeMac();
return 'desktop'; // Default to desktop if unknown
} catch (err) {
console.warn('Failed to detect system type, defaulting to desktop:', err.message);
return 'desktop';
}
}
function getSystemTypeLinux() {
try {
// Try reliable DMI check first
if (fs.existsSync('/sys/class/dmi/id/chassis_type')) {
const type = parseInt(fs.readFileSync('/sys/class/dmi/id/chassis_type', 'utf8').trim());
// 8=Portable, 9=Laptop, 10=Notebook, 11=Hand Held, 12=Docking Station, 14=Sub Notebook
if ([8, 9, 10, 11, 12, 14, 31, 32].includes(type)) {
return 'laptop';
}
}
// Fallback to chassis_id for some systems? Usually chassis_type is enough.
return 'desktop';
} catch (e) {
return 'desktop';
}
}
function getSystemTypeWindows() {
const POWERSHELL_TIMEOUT = 5000; // 5 second timeout
try {
// Use spawnSync instead of execSync to avoid ghost processes
const result = spawnSync('powershell.exe', [
'-NoProfile',
'-ExecutionPolicy', 'Bypass',
'-Command',
'Get-CimInstance Win32_SystemEnclosure | Select-Object -ExpandProperty ChassisTypes'
], {
encoding: 'utf8',
timeout: POWERSHELL_TIMEOUT,
stdio: ['ignore', 'pipe', 'ignore'],
windowsHide: true
});
if (result.error || result.status !== 0) {
throw new Error(`PowerShell failed: ${result.error?.message || result.signal}`);
}
const output = (result.stdout || '').trim();
// Output might be a single number or array.
// Clean it up
const types = output.split(/\s+/).map(t => parseInt(t)).filter(n => !isNaN(n));
// Laptop codes: 8, 9, 10, 11, 12, 14, 31, 32
const laptopCodes = [8, 9, 10, 11, 12, 14, 31, 32];
for (const t of types) {
if (laptopCodes.includes(t)) return 'laptop';
}
return 'desktop';
} catch (e) {
// Fallback wmic
try {
const result = spawnSync('wmic.exe', ['path', 'win32_systemenclosure', 'get', 'chassistypes'], {
encoding: 'utf8',
timeout: POWERSHELL_TIMEOUT,
stdio: ['ignore', 'pipe', 'ignore'],
windowsHide: true
});
if (result.status === 0 && result.stdout) {
const output = result.stdout.trim();
if (output.includes('8') || output.includes('9') || output.includes('10') || output.includes('14')) {
return 'laptop';
}
}
} catch (err) {
console.warn('System type detection failed:', err.message);
}
return 'desktop';
}
}
function getSystemTypeMac() {
try {
const model = execSync('sysctl -n hw.model', { encoding: 'utf8' }).trim().toLowerCase();
if (model.includes('book')) return 'laptop';
return 'desktop';
} catch (e) {
return 'desktop';
}
}
module.exports = {
getOS,
getArch,
isWaylandSession,
setupWaylandEnvironment,
detectGpu,
setupGpuEnvironment,
getSystemType
};