Updated November 13, 2026
If Wuthering Waves 3.8 is not working on Linux, the new Kuro Games launcher may be responsible. You might encounter an invisible or transparent launcher, a "Failed to retrieve space info" error despite having plenty of free storage, a white Kuro account login screen, or blank in-game notices.
These problems can affect Linux players using Steam and Proton, including systems running KDE Plasma, Bazzite, CachyOS, and Steam Deck.
Several issues have practical workarounds. The best starting points are using a compatible DW-Proton build, selecting the correct game installation directory, and testing the login window separately from the launcher.
This guide covers each problem, the available fixes, and what to do when a workaround does not resolve the issue.
.webp "Wuthering Waves 3.8 Linux Launcher Invisible? Proton, Login & Disk Space Fixes")
Quick Answer: How to Fix Wuthering Waves 3.8 on Linux
If the Wuthering Waves launcher is invisible or transparent, try DW-Proton 11.0-14 or a newer compatible release. That version introduced a specific fix for transparent Wuthering Waves launcher rendering.
If the launcher reports "Failed to retrieve space info" or incorrectly says there is not enough storage, manually select your actual Steam installation directory instead of accepting an unsuitable default location.
If the Kuro account login window is white, test another compatible Proton build. You can also temporarily try this Steam launch option:
PROTON_USE_WINED3D=1 %command%
This has helped some players reach the login screen, but it can cause severe performance loss. Remove the option after testing.
For blank notices, Convene history, and other embedded web pages, an unofficial bitmap-rendering workaround may help.
Important: Wuthering Waves does not have an established official Linux compatibility guarantee. A workaround that succeeds on one Linux configuration may not work on another.
Which Wuthering Waves Linux Problem Do You Have?
| Problem | Start here |
|---|---|
| Launcher is invisible or transparent | Fix the launcher with DW-Proton |
| Failed to retrieve space info | Correct the installation directory |
| White screen at Kuro account login | Fix the white login screen |
| Notices or Convene history are blank | Troubleshoot embedded web pages |
| Steam Deck shows a black screen | Steam Deck troubleshooting |
| Want to launch without Kuro's launcher | Direct-launch workaround |
| Illegal software error or game crash | Crash troubleshooting |
📋 Table of Contents
- Why Wuthering Waves 3.8 Has Linux Launcher Problems
- Fix 1: Invisible or Transparent Launcher
- Fix 2: Failed to Retrieve Space Info
- Fix 3: White Screen After Kuro Login
- Fix 4: Blank Notices and Convene History
- Fix 5: Steam Deck Black Screen
- Fix 6: Skip the Kuro Launcher on Linux
- Fix 7: Illegal Software Error or Crash
- Advanced Community Linux Workarounds
- Official Developer Response and Support
- Frequently Asked Questions
Why Wuthering Waves 3.8 Has Linux Launcher Problems
Version 3.8 changed how the Steam edition of Wuthering Waves downloads and updates its game files.
Steam now installs Kuro Games' official launcher, which manages game resource downloads and future updates.
That means Proton must handle the launcher as well as the game itself.
Even if Wuthering Waves worked on your Linux system before the update, the new launcher may behave differently.
Problems can appear at several stages:
- Launcher startup: The window is invisible, transparent, or black.
- Resource download: The launcher cannot determine available disk space.
- Account login: The login interface opens but displays a white screen.
- In-game web pages: Notices, Convene history, or other embedded pages fail to render.
- Game startup: The launcher works, but the game crashes or displays an error.
These symptoms do not necessarily share the same cause.
For example, a Proton build that fixes the transparent launcher may still leave the login window or in-game web pages broken.
Kuro's official Steam launcher replacement announcement explains why the new installation process is required.
The migration can also involve downloading the complete game resource package again. If you are dealing with a large download, missing files, or unexpected storage usage, see our Wuthering Waves 3.8 redownloading whole game and storage fixes.
Fix 1: Wuthering Waves 3.8 Launcher Invisible on Linux
An invisible launcher can make Steam appear to run Wuthering Waves even though no usable game window is displayed.
You might see:
- A completely transparent window.
- A black or empty launcher.
- Buttons that respond to clicks but are not visible.
- A cursor that disappears over the launcher.
- A window that becomes black after being moved.
Step 1: Try DW-Proton 11.0-14 or Newer
DW-Proton 11.0-14 introduced a fix for transparent Wuthering Waves launcher rendering.
This makes it a useful first option for players whose launcher window does not display correctly.
You can find compatible releases on the DW-Proton GitHub releases page.
To change your Proton version:
- Close Wuthering Waves completely.
- Open Steam.
- Go to Library.
- Right-click Wuthering Waves.
- Select Properties.
- Open Compatibility.
- Enable Force the use of a specific Steam Play compatibility tool.
- Select your installed DW-Proton build.
- Close Properties and launch Wuthering Waves again.
If DW-Proton is not listed, install it through a compatible Proton management utility such as ProtonPlus, then restart Steam.
The installation procedure may differ depending on your Linux distribution and whether you use a native or Flatpak Steam installation.
Step 2: Check Whether the Launcher Is Visible
After changing Proton, confirm that:
- The Kuro launcher window displays normally.
- Its download or Start button is visible.
- The installation directory can be selected.
- Mouse clicks work correctly.
- Moving the window does not make its contents disappear.
If these functions work, continue installing or launching the game.
Remember: DW-Proton's documented transparency fix does not guarantee that every login, storage, or gameplay problem will also be resolved.
Step 3: Remove Conflicting Steam Launch Options
If the launcher remains invisible, open:
Steam → Wuthering Waves → Properties → General → Launch Options
Temporarily remove experimental launch options you previously added.
For example, if you are testing an X11-dependent workaround while using:
PROTON_ENABLE_WAYLAND=1 %command%
remove that option and test again.
Some community launcher fixes depend on X11 window behavior and may not work correctly with native Proton Wayland enabled.
Test one change at a time instead of combining several launch variables.
What If DW-Proton Still Does Not Work?
Try another compatible Proton build and restart Steam before launching again.
If the launcher is still transparent, the advanced community Linux workaround may help.
Avoid modifying launcher DLL files as your first troubleshooting step.
Fix 2: Wuthering Waves Failed to Retrieve Space Info on Linux
The new launcher may display:
"Failed to retrieve space info"
You might also receive an insufficient-storage warning even though your Linux drive has hundreds of gigabytes available.
One possible cause is the launcher checking an unsuitable installation directory through Proton's Windows-style filesystem.
Step 1: Find the Actual Steam Game Folder
Open Steam and navigate to:
Library → Wuthering Waves → Manage → Browse local files
Steam will open the directory associated with the game.
A common native Steam library location is:
/home/<username>/.local/share/Steam/steamapps/common/Wuthering Waves
However, your game may be installed in a custom Steam library, on another drive, or inside a Flatpak-managed directory.
Use the folder Steam actually opens rather than assuming the example path applies to your system.
Step 2: Select the Directory Manually
- Open the Kuro Games launcher.
- Find the game installation location selector.
- Choose the option to browse for a directory.
- Navigate to your actual Steam library or intended installation folder.
- Confirm the location.
- Check whether the launcher now recognizes available storage.
- Retry the game resource download.
If the launcher initially points to a Wine Z: path, selecting the correct directory manually may resolve the warning.
Do not select a random folder simply because it displays more free space.
Step 3: Verify Available Storage
If the warning persists, confirm the available space on the filesystem where you intend to install the game.
You can use your Linux file manager or run:
df -h
Check the filesystem containing your chosen game directory.
Remember that the launcher may need additional temporary storage while downloading, unpacking, and verifying resources.
The small Steam launcher package is not the complete game installation.
Step 4: Restart and Retry
Close the launcher, reopen it, and confirm the installation directory again.
If the download starts, allow it to finish before changing Proton versions or moving game files.
If the error returns, try a compatible DW-Proton build.
Avoid deleting Proton prefixes or moving partially downloaded files unless you have a clear reason and a backup.
Fix 3: Wuthering Waves White Screen After Kuro Login on Linux
Sometimes Wuthering Waves downloads and launches successfully, but the Kuro account login window is completely white.
The loading animation may disappear without displaying the login form.
This is different from an invisible launcher because the game has already reached the account login stage.
Fix A: Change the Proton Version
Start by testing another compatible Proton build.
- Exit Wuthering Waves.
- Open Steam.
- Right-click Wuthering Waves and select Properties.
- Open Compatibility.
- Select another installed Proton build.
- Launch the game and open the login window.
If the login form appears, try signing in normally.
Do not change several compatibility settings simultaneously.
Fix B: Temporarily Use WineD3D
If the login window remains white, you can test a temporary WineD3D workaround.
Open:
Steam → Wuthering Waves → Properties → General → Launch Options
Enter:
PROTON_USE_WINED3D=1 %command%
Launch Wuthering Waves and try signing in again.
This option changes the graphics translation path used by Proton and may allow the login interface to render on some systems.
Warning: WineD3D can cause severe performance loss. Treat it as a temporary login or diagnostic workaround rather than a recommended setting for normal gameplay.
Fix C: Remove WineD3D After Testing
Once you have completed the login test:
- Exit the game.
- Return to Steam Launch Options.
- Remove
PROTON_USE_WINED3D=1. - Restore your normal launch options.
- Launch Wuthering Waves again.
Check whether your login session remains active and the game runs normally.
If the login screen becomes white again, the compatibility issue is not fully resolved on your system.
You may need to continue testing Proton versions or wait for a compatibility update.
What If the Login Screen Is Still White?
Avoid repeatedly reinstalling the entire game without evidence of corrupted files.
Record your Linux distribution, desktop environment, GPU, and Proton version before contacting support.
Fix 4: Blank Notices, Convene History, or Black Web Pages
Wuthering Waves may launch and run normally while certain in-game pages fail to display.
Examples include:
- A white screen when opening notices.
- Convene history failing to load.
- A black background over web-based menus.
- Popups that open but do not show their contents.
These symptoms may involve the game's embedded web-view rendering rather than missing game resources.
Fix A: Test Another Compatible Proton Build
If you have not already done so, try the DW-Proton build described earlier.
Restart Wuthering Waves and check the affected pages.
Test notices and Convene history separately because one interface may work while another remains broken.
Fix B: Test the Unofficial usebitmap.flag Workaround
A community workaround for blank web pages involves creating an empty file named:
usebitmap.flag
The file belongs in the game's web-view directory, alongside KRWebClient.exe.
The reported relative directory is:
Wuthering Waves Game/Client/Binaries/Win64/ThirdParty/KrPcSdk_Global/KRSDKRes/KRSDKWebViewOSR/
This is an unofficial workaround. It may not work on every Proton configuration and could stop working after a game update.
To test it:
- Exit Wuthering Waves completely.
- Open your actual game installation folder.
- Navigate to the KRSDKWebViewOSR directory.
- Confirm that the directory exists.
- Create an empty file named
usebitmap.flaginside it. - Launch the game and test notices or Convene history.
If you have opened a terminal inside that directory, you can create the empty file using:
touch usebitmap.flag
Do not create missing game directories just to add this file.
If the workaround does not help, remove only the usebitmap.flag file you created.
Do not delete the web-view directory or replace unrelated game DLL files.
Fix C: Consider an Advanced Community Wrapper
An unofficial Linux wrapper also attempts to address web-view rendering, launcher transparency, cursor behavior, and storage detection.
It is covered in the advanced community fixes section.
Try simpler, reversible compatibility changes before using it.
Fix 5: Wuthering Waves 3.8 Steam Deck Black Screen
Steam Deck players may encounter launcher or login problems that behave differently in Desktop Mode and Gaming Mode.
For example, the launcher may work in Desktop Mode while Gaming Mode displays a black screen or fails to show a login popup.
Step 1: Test Wuthering Waves in Desktop Mode
Switch to Desktop Mode and launch Wuthering Waves through Steam.
Check whether:
- The Kuro launcher is visible.
- You can select an installation directory.
- The game resources download successfully.
- The login screen appears.
- The game starts.
If the launcher is transparent, try the DW-Proton compatibility steps in Fix 1.
Step 2: Finish Installing the Game
Before troubleshooting Gaming Mode, confirm that the Kuro launcher has finished downloading the selected game resources.
Do not assume the complete game is installed simply because Steam shows a small launcher package.
If Wuthering Waves requests another large download, follow our Wuthering Waves 3.8 missing-files and storage troubleshooting guide.
Step 3: Return to Gaming Mode
After successfully launching the game in Desktop Mode:
- Exit Wuthering Waves.
- Return to Gaming Mode.
- Open the game through your Steam library.
- Check whether the launcher and game display correctly.
If Gaming Mode remains black, return to Desktop Mode and verify that the game still works there.
This helps determine whether the problem is specific to Gaming Mode.
Step 4: Review Custom Launch Options
Remove experimental launch options that are no longer needed.
If you are using a community workaround that depends on X11 behavior, native Proton Wayland settings may interfere with it.
Avoid deleting the game's Proton prefix merely to troubleshoot a black screen, as this can remove local settings and require additional setup.
Steam Deck compatibility remains configuration-dependent. A workaround that succeeds in Desktop Mode does not guarantee that every login popup or game window will function in Gaming Mode.
Fix 6: How to Skip the Kuro Launcher on Linux
After Wuthering Waves is fully installed, some Linux players prefer starting the game executable directly instead of opening Kuro's launcher every time.
This may help when the launcher is unreliable but the installed game itself works.
However, you must complete the initial installation first.
Linux Steam Direct-Launch Command
Open:
Steam → Wuthering Waves → Properties → General → Launch Options
For an installed UHD resource package, a community-used command is:
bash -c 'exec "${@/%launcher.exe/Wuthering Waves Game/Client/Binaries/Win64/Client-Win64-Shipping.exe}"' -- %command% -krqlv=uhd
This Bash command replaces the launcher executable path inside Steam's existing launch command with the installed game's executable path.
It is designed to preserve Steam's Proton launch environment without requiring you to hard-code the Steam library location.
Important: This is a community workaround, not an official Steam or Kuro Games launch method. It depends on the expected executable paths and may stop working after a launcher update.
Match the Installed Resource Tier
Use the argument corresponding to the resource package you installed:
| Resource package | Launch argument |
|---|---|
| SD | -krqlv=sd |
| HD | -krqlv=hd |
| UHD | -krqlv=uhd |
For example, if you installed HD resources, replace the final argument with:
-krqlv=hd
Changing the argument does not download or convert the resource package.
When Should You Remove the Command?
Remove the direct-launch command when you need to:
- Download a game update.
- Use Kuro's launcher to manage game resources.
- Change settings that require the official launcher.
- Troubleshoot a game startup problem that may be caused by custom launch options.
After the launcher has completed its update or resource-management task, you can test the direct-launch command again.
If the game fails to start, remove the command and return to normal Steam launching.
For additional information about executable paths and launch options, see our Wuthering Waves 3.8 guide to skipping the Steam launcher and fixing launch errors.
That guide primarily covers Windows, so use the Linux-specific command above rather than copying a Windows path directly.
Fix 7: Wuthering Waves Illegal Software Error or Crash on Linux
A different issue occurs when the Kuro launcher opens successfully, but the game crashes after startup or displays an "illegal software" error.
This is not necessarily related to the invisible-launcher problem.
The exact cause can vary, and there is no established universal Proton fix.
Step 1: Remove Experimental Launch Options
Open Steam Properties and inspect the Launch Options field.
Temporarily remove custom wrappers, direct-launch commands, and experimental compatibility variables.
Then try starting the game through Kuro's official launcher.
Step 2: Test a Clean Proton Configuration
Choose a compatible Proton build and test the game without combining several experimental workarounds.
Record which Proton version produces the error.
Changing Proton may help identify a compatibility difference, but it is not guaranteed to resolve the message.
Step 3: Check the Game Installation
If Kuro's launcher offers a supported repair or verification function, use it.
Allow pending updates and resource downloads to finish.
Do not modify anti-cheat components, replace security-related files, or attempt to bypass game protection mechanisms.
Step 4: Contact Official Support
If the error persists, collect the following information:
- Linux distribution and version.
- Desktop environment.
- GPU and graphics driver.
- Proton version.
- Steam installation type.
- Exact error message.
- Whether the crash happens before or after login.
Submit those details through the official support options available to you.
Avoid repeatedly reinstalling the entire game unless there is evidence of missing or corrupted resources.
Advanced Community Linux Workarounds
If the basic fixes do not resolve your problem, an unofficial Linux wrapper is available for several Wuthering Waves launcher and rendering issues.
Community project: Wuthering Waves Linux fixes on GitHub
The project targets:
- Invisible launcher windows.
- Failed storage-space detection.
- Black borders and missing cursors.
- Window redraw problems.
- Blank notices and web overlays.
- Incorrectly rendered in-game pages.
The workaround has been tested on an Arch Linux configuration using KDE Plasma, Proton-CachyOS, and NVIDIA graphics.
Compatibility with other Linux distributions, graphics hardware, and Steam Deck may differ.
Before Using the Wrapper
Read the repository's instructions and inspect the changes it makes.
Only use it if you understand how to reverse the modifications.
Community scripts are not official game patches, and their behavior may change after a launcher or Proton update.
Some wrapper features depend on X11-related window behavior, so native Proton Wayland may interfere with them.
Recommended order: Try DW-Proton, correct the installation path, and test the login or web-view fixes before applying a multi-component community workaround.
Official Developer Response and Hotfix Status
Kuro Games has confirmed that the Steam version of Wuthering Waves uses its official launcher for game resource downloads and future updates.
The official installation guidance recommends uninstalling the previous Steam game package and installing the new launcher through Steam to avoid file conflicts.
You can read the instructions in the official Wuthering Waves Steam launcher replacement announcement.
Kuro also directs players to the in-game Feedback feature for problems and suggestions.
However, there is no verified official Kuro Games Linux-specific hotfix for the invisible launcher, Proton login issues, or Steam Deck black screens.
The transparent-launcher fix included in DW-Proton is provided by the compatibility-tool developers, not by an official Kuro Games Linux patch.
You can check the relevant technical information in the DW-Proton release notes.
If the game launches successfully, use its Feedback feature to report persistent problems.
If you cannot enter the game, use the official support options available through the Wuthering Waves website or launcher.
Frequently Asked Questions
Why is the Wuthering Waves 3.8 launcher invisible on Linux?
The new Kuro launcher can encounter window-rendering problems under certain Proton configurations. DW-Proton 11.0-14 includes a transparency-rendering fix, making it a useful starting point.
Which Proton version works best for Wuthering Waves 3.8?
DW-Proton 11.0-14 or a newer compatible release is a reasonable first choice for the invisible-launcher problem. However, no single Proton version is confirmed to fix every launcher, login, and gameplay issue on all Linux systems.
How do I install DW-Proton for Wuthering Waves?
Install a compatible DW-Proton build using ProtonPlus or another trusted compatibility-tool manager. Restart Steam, open Wuthering Waves Properties, enable the compatibility-tool override, and select the installed DW-Proton version.
Why does Wuthering Waves say not enough disk space on Linux?
The launcher may be checking an unsuitable installation directory through Proton's Windows-style filesystem. Manually select the correct Steam game directory and verify available space on the target filesystem.
How do I fix the white Kuro login screen on Linux?
Try another compatible Proton build first. If the login window remains white, temporarily test PROTON_USE_WINED3D=1 %command%. This can help some configurations but may significantly reduce performance.
Why are Wuthering Waves notices or Convene history blank?
Some Proton configurations have trouble displaying the game's embedded web pages. Changing Proton, testing the unofficial usebitmap.flag workaround, or using a compatible community wrapper may help.
Does Wuthering Waves 3.8 work on Steam Deck?
Some players can run Wuthering Waves using compatible Proton builds, but launcher visibility, login windows, and Gaming Mode behavior vary. Test the installation in Desktop Mode before troubleshooting Gaming Mode separately.
Can I skip the Kuro launcher on Linux?
Some players use a custom Steam launch command to start the installed game executable directly. The game must already be installed, and Kuro's launcher is still needed for updates and resource management.
How do I fix the illegal software error with Proton?
There is no confirmed universal fix. Remove experimental launch options, test a compatible Proton configuration, complete pending updates, and contact official support if the error persists. Do not modify anti-cheat or security files.
Has Kuro Games fixed the Wuthering Waves 3.8 Linux launcher problems?
No verified official Linux-specific hotfix has been established. DW-Proton includes a transparency-rendering fix, and community workarounds address additional symptoms, but these are separate from official Kuro Games patches.
Final Thoughts
If Wuthering Waves 3.8 is not working on Linux, begin by identifying where the problem occurs.
For an invisible launcher, try a compatible DW-Proton build. For a false disk-space warning, check the Steam installation directory. For a white login screen, test another Proton configuration before using temporary rendering workarounds.
If the game launches but notices or Convene history remain blank, troubleshoot the embedded web-view issue separately rather than reinstalling the entire game.
Steam Deck players should also distinguish Desktop Mode problems from Gaming Mode failures.
Most importantly, test one change at a time. Avoid combining several Proton options or modifying multiple game files simultaneously.
If the game still fails, collect your Linux distribution, GPU, Proton version, and exact error message before contacting support. Those details will help identify the affected component and make further troubleshooting more effective.
Comments
Post a Comment