-
Notifications
You must be signed in to change notification settings - Fork 111
Description
This is a tracker bug for general GPU issues, like:
- Apps that crash after startup
- Rendering glitches
- GPU fault/timeout errors
When making a comment on this bug, please run the asahi-diagnose command and attach the file it saves to your comment. Please tell us what you were doing when the problem happened, what desktop environment and window system you use, and any other details about the issue.
The purpose of this bug is to collect reports of app issues in one place, so we have somewhere to look when figuring out what to work on. Since the driver is still a work-in-progress and lots of things are not expected to work, please don't expect a timely response to reports. We're working on it!
Before reporting something, please check that the issue has not been reported already. Duplicate reports just clutter up the bug and will be marked as duplicate. --marcan
-
If you are having shader errors with Chromium/Electron-based apps after an update, delete your shader cache:
rm -rf ~/.config/chromium/Default/GPUCache(or similar paths for other apps). Upstream bug. This is not a driver bug. -
If you run into a GPU lockup or crash (all GPU apps stop working, but you can still SSH into the machine), please open a new bug in this repo, tell us what you were doing when the GPU locked up, and attach the
asahi-diagnoselog. -
If you get GPU fault or GPU timeout messages in dmesg (probably together with rendering issues), but the GPU keeps working in general, this tracker bug is the right place to report that.
-
If you have
linux-asahi-edgeissues unrelated to the GPU, please report them here. This includes display output/controller related issues, like screen resolution switching and backlight control, which are unrelated to the GPU driver. -
If you are seeing single-pixel-wide glitches, please set your screen scale to 100%, log out and back in, and try to reproduce it again. These kinds of glitches are likely to be compositor/desktop environment bugs related to fractional scaling, rather than driver issues.
If you see magenta
Magenta is the error color on Apple GPUs. It is what you get when you sample an uninitialized compressed texture. This often happens with driver bugs that break rendering, but there are also many apps that have bugs that transiently display uninitialized buffer contents. These will often show up as black or transparent on other GPUs or with software rendering, which stands out less but it indicates the same bug.
If you see magenta glitches, please try running the app with ASAHI_MESA_DEBUG=nocompress. If you see the same problems but they are now black, try LIBGL_ALWAYS_SOFTWARE=true to force software rendering. If you get the same results (still black regions where previously there was magenta), then it is likely an app bug or an upstream Mesa bug, not a driver issue.
Another common issue is apps that have rendering feedback loops, which are undefined behavior in OpenGL. These often result in 4x2 pixel shaped corruption regions. You can work around this with ASAHI_MESA_DEBUG=nocompress, which should fix the issue (at least if it wouldn't normally break on all GPUs). This could also be caused by a driver bug, though, so please do report anything that is fixed with nocompress so we can take a look and determine whether it's an app bug or a driver bug!
Known issues
- When GPU timeouts/faults occur, rarely the firmware can lock up (see [GPU Lockup] Rare firmware robustness issues while recovering from faults #79)
- Google Maps on Firefox is slow/jerky
Resolved issues
- System Monitor glitches in the History tab
- Plasmashell sometimes shows magenta areas or missing rendering
- Portraits render incorrectly or cause faults in Darwinia
- Geometry edges render poorly/jagged in Darwinia
- WebGL Aquarium faults above 10000 fish
- Xorg sometimes flashes black while switching windows in KWin
- gl_FragDepth is not implemented
- three.js scenes (and other complex renders) with MSAA glitch on Pro/Max/Ultra machines
- Discard regressed with the OpenGL 3.1 update (breaking Darwinia)
- MSRTT wrongly advertised when not properly supported (making Darwinia MSAA not work)
- Texture barriers wrongly advertised when not properly supported (X11/Emacs glitching)
- Water glitches near screen edges in Darwinia if you get up really close.
- (6.2/explicit sync regression) KWin flashes magenta rectangles when starting up, or right before going to sleep.
- Nautilus is pink with Adwaita
- Google Maps & PDF viewer on Firefox use too much memory
- Corrupted X11 apps on GNOME/XWayland
- Rendering with some render targets disabled regressed (Inochi2D, KiCad 3D glitching)
- Figma rendering is glitchy
- CSS transforms in Firefox render incorrectly
- Complex GTK apps (GIMP, etc.) under XWayland sometimes glitch magenta
- Register spilling is excessively slow (example)
Issues that aren't driver bugs
- gnome-terminal has a glitchy background (upstream bug from 2 years ago, they don't seem interested in fixing it...)
- Moving the mouse above blurred backgrounds in KWin/Wayland causes artifacts (upstream bug)
- KWin has single-pixel glitches when fractional scaling is enabled (Fixed in plasma 5.27.7)
- OBS screen sharing does not work (PipeWire regression, fixed in 0.3.62, plus KWin bug (merged for 5.26.5, ETA Jan 3), plus core Mesa bug)
- Some WebGL apps on Firefox (like Plex and QuakeJS) can hang/fail to render (upstream bug, fixed for Firefox 110)
- Firefox sometimes flashes magenta on startup (upstream bug)
- SuperTuxKart sometimes has rectangular black glitches (upstream bug) (worked around in driver for now)
- QuakeJS has jittery geometry (emscripten bug, fixed years ago but they need to update). Probably applies to any WebGL apps with similar issues too.
- Window corruption / magenta regions with Java OpenGL rendering enabled (Java does not double buffer its OpenGL visual so it will always tear/break on any modern system from this decade, just worse on Apple with compression.)
- Google Sheets gets blurry on scroll (
Google Sheets bugFirefox bug) (workaround:ASAHI_MESA_DEBUG=no16) - blender's gl version check is sketchy https://bugzilla.redhat.com/show_bug.cgi?id=2237821
- xeyes has a magenta/nontransparent background in kwin and wlroots compositors (they do not implement X11 SHAPE, see wlroots issue; GNOME/mutter works).
- GTK4 apps have visual corruption with non-integer scales (GTK4 bug, patched in Fedora)
- Faults and mipmap-related artifacts in GTK4 apps (GTK4 bug, worked around in Fedora Asahi Remix with
GSK_RENDERER=ngl)