Tauri WSL2 gdk-pixbuf Crash Fix

Solution

Quick Fix

Set an empty icon array in tauri.conf.json:

{
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": []
  }
}

Why This Works

The gdk-pixbuf library in GTK has issues loading certain icon formats or dimensions in the WSL2/WSLg environment. By providing an empty icon array, Tauri skips the problematic icon loading during window initialization. The app will use a default system icon instead.

Alternative: Ensure Icons are Proper RGBA

If you need custom icons, ensure they are:

1. True color RGBA (not indexed/palette)
2. Created with proper color depth: convert -size 32x32 xc:'#3b82f6' -type TrueColorAlpha -define png:color-type=6 icon.png
3. Standard dimensions (32x32, 128x128, 256x256)

Even with proper icons, the empty array workaround may still be needed on WSL2.

Verification

After applying the fix:

1. Run npm run tauri:dev or cargo tauri dev
2. App should compile and show Running /path/to/app
3. Window should appear without panic
4. Check with ps aux | grep your-app-name to confirm process is running

Example

Before (crashes):

{
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": [
      "icons/32x32.png",
      "icons/128x128.png",
      "icons/icon.png"
    ]
  }
}

After (works):

{
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": []
  }
}

Notes

• This is a WSL2/Linux-specific issue; the same app typically works fine on Windows and macOS
• The fix only affects the development/bundle icons, not runtime functionality
• For production Linux builds, you may need to test on actual Linux to see if the issue persists
• The empty icon array results in a generic/default window icon
• This issue is related to how GTK's gdk-pixbuf handles icon data in the WSLg compositor environment
• Future Tauri or GTK updates may resolve this; check if the issue persists after updates

Related Issues

• Tauri apps on WSL2 may also require proper DISPLAY/WAYLAND_DISPLAY setup
• If app runs but window doesn't appear, check echo $DISPLAY and /mnt/wslg/ exists
• For "cannot open display" errors, ensure WSLg is installed and running