Fix an Electron app that runs but never shows a window
The core fix is correct and well-sourced: omarchy#7642 exists with that exact title, and Omarchy's default/hypr/envs.lua really does export both ELECTRON_OZONE_PLATFORM_HINT=wayland and OZONE_PLATFORM=wayland, so unsetting BOTH is genuinely required. The record gets this right where record 13 does not. The problem is the trailing elephant section. It is quoted accurately from omarchy#6206, but that issue is against Omarchy 3.x (Elephant 2.21 / Walker 2.16), and Omarchy 4.x has removed elephant entirely. There is no config/elephant directory and no elephant.service on the quattro branch. An Omarchy 4 user following that step gets 'Unit elephant.service not found' after writing a config file nothing reads.
Setting hl.env("OZONE_PLATFORM", "") globally pushes every Electron app back to XWayland, where they will be blurry on HiDPI and unable to screen-share Wayland windows. Prefer the per-app override.
Symptom
An Electron app starts (the process is alive in ps) but no window ever appears. hyprctl clients shows no client for it. No error, no crash, it just sits there. Often hit with games shipping a bundled Electron runtime, or older Electron builds launched from Steam.
Cause
Omarchy globally exports ELECTRON_OZONE_PLATFORM_HINT=wayland and OZONE_PLATFORM=wayland in /usr/share/omarchy/default/hypr/envs.lua. An app built against an Electron version whose Wayland/Ozone backend is broken or absent will fail to create a surface and silently produce no window instead of falling back to X11.
Fix
Unset both variables for that one process. Omarchy sets ELECTRON_OZONE_PLATFORM_HINT *and* OZONE_PLATFORM, so unsetting only one leaves the app on Wayland. From a terminal:
env -u ELECTRON_OZONE_PLATFORM_HINT -u OZONE_PLATFORM <app>
From Steam, in the game's Properties -> Launch Options:
env -u ELECTRON_OZONE_PLATFORM_HINT -u OZONE_PLATFORM %command%
For a desktop launcher, copy the entry to your user directory and wrap the Exec line:
cp /usr/share/applications/<app>.desktop ~/.local/share/applications/
Exec=env -u ELECTRON_OZONE_PLATFORM_HINT -u OZONE_PLATFORM /usr/bin/<app> %U
For Arch's shared electron package you can also pin flags per app in ~/.config/<application_name>-flags.conf, e.g. ~/.config/vesktop-flags.conf:
--ozone-platform=x11
**Omarchy 3.x only**. A related but different failure: the Elephant/Walker launcher may run apps under systemd-run --user --scope, which makes some Electron apps segfault and leave stale ~/.config/<App>/SingletonLock files (omarchy#6206). Pin the launcher prefix in ~/.config/elephant/elephant.toml:
auto_detect_launch_prefix = false
launch_prefix = "uwsm-app --"
then systemctl --user restart elephant.service.
This does not apply to Omarchy 4.x, which dropped Elephant and Walker for the Quickshell-based launcher. There is no elephant.service to restart there.
Verify
hyprctl clients | grep -i <app> now returns a client, and the window is visible.