DEFAULT_GRAPHICS_DRIVER = "turnip"), which is the best choice for Qualcomm Adreno devices.
Available drivers
- Turnip (default)
- VirGL
- Zink
Turnip is the open-source Vulkan driver for Qualcomm Adreno GPUs, developed as part of Mesa. It runs natively on the GPU, bypassing Android’s proprietary graphics stack entirely, and delivers the highest performance of the three options.Best for: Snapdragon devices (Adreno 6xx and later)Winlator automatically detects Adreno 6xx hardware using the
GPUInformation.isAdreno6xx() method and defaults to Turnip for those devices. On unrecognised hardware, fall back to VirGL.Key characteristics:- Native Vulkan 1.3 support
- Lowest driver overhead
- Required for DXVK and VKD3D at full performance
- Installable versions:
turnip-24.1.0,turnip-25.0.0(available via the in-app component manager)
| Variable | Default | Effect |
|---|---|---|
TU_DEBUG | noconform | Disables conformance tests, improves performance |
MESA_VK_WSI_PRESENT_MODE | mailbox | Sets the Vulkan swap chain present mode |
MESA_SHADER_CACHE_DISABLE | false | Enables the Mesa shader cache |
MESA_SHADER_CACHE_MAX_SIZE | 512MB | Maximum size of the shader disk cache |
Choosing a driver
Qualcomm Snapdragon
Use Turnip. It provides native Vulkan and delivers the best gaming performance on Adreno GPUs.
ARM Mali / Immortalis
Use VirGL first. If performance is poor and your GPU supports Vulkan, try Zink.
Other / unknown GPU
Start with VirGL for the broadest compatibility. Switch to Zink only if your GPU has Vulkan support.
Legacy / old games
Any driver works. Pair with WineD3D or CNC DDraw and add
MESA_EXTENSION_MAX_YEAR=2003 to restrict Mesa extensions to those available before 2003.Default environment variables
Every new container is created with these environment variables pre-configured (Container.DEFAULT_ENV_VARS):
FPS counter
Enable the Show FPS toggle in the container settings to display a real-time frames-per-second overlay while a Windows application is running. This uses theshowFPS field on the container object.
Changing the driver
Adjust environment variables
Review the Environment variables field. Remove driver-specific variables that no longer apply (for example, remove
TU_DEBUG when switching away from Turnip).