PanVK Mali driver: how to install it on Android handhelds
Install the PanVK driver (kbase and device builds) on a Mali Android handheld: supported GPUs, which apps load it, and how it compares with Turnip.
Winlator, GameHub, GameNative
If you searched for a PanVK driver or a PanVK Mali driver, you have an Android phone or handheld with an Arm Mali GPU, and you want a Vulkan driver other than the one the device shipped with. PanVK is Mesa's open-source Vulkan driver for Mali. On a stock Android handheld it only helps when an app can load an alternate driver, and the package has to be one built for Android's mali_kbase kernel driver. This page is how to get those packages, which GPUs the projects actually name, which apps they document, and what not to expect if you are used to Turnip on Adreno.
Nobody on the Overclocked team has run these builds on a handheld yet. Every number and menu name below comes from the projects' own notes, checked on 10 November 2026. These are experimental drivers. Keep the system driver installed so you can switch back.
Short answer
- Start with panvk-kbase v26.3.1 (31 October 2026) if you want one driver for many Mali GPUs. It is a universal build for architecture v6 to v14 and it ships a different zip per app. Do not unzip it.
- If you own a Retroid Pocket 4 Pro or an Anbernic RG556, also look at panvk_faux123 v1.1.4 (7 November 2026). The same
panvk_faux123_v1.1.4.adpkg.zipis in his Retroid Pocket 4 Pro, RG556, Pixel 7 and GameForce Ace repositories, and his notes say he tested that release on all four. - Turnip will not load. Turnip and the Qualcomm packages are for Adreno. See the Turnip guide only if your chip is a Snapdragon.
- Eden is not a verified loader for these packages. Details are below.
The driver list, with official release links only, is on the GPU driver hub (Mali filter).
What the PanVK driver is
PanVK is the Vulkan half of Mesa's Panfrost driver stack. Mesa's Panfrost page describes it as a Vulkan implementation for Bifrost and later Mali GPUs. On Linux it talks to the open Panfrost or Panthor kernel drivers. A retail Android handheld ships Arm's proprietary mali_kbase driver instead, and the bootloader is usually locked, so you cannot swap that kernel. The Android projects on this page patch PanVK so it speaks mali_kbase directly. That is why they do not need root.
Upstream's hardware table and the Android zips are not the same list. On the Mesa page checked for this guide, Vulkan 1.3 is listed for Bifrost (G71, G72, G31, G51, G52, G76) and Vulkan 1.4 for Valhall v10 and newer (G310, G610, G615, G715, G720, G725, and the G1-Pro, G1-Premium and G1-Ultra). The Vulkan cell for Valhall v9 (G57, G68) is empty. G77 and G78 are not in that table. Where PanVK support is experimental, Mesa says the driver refuses to load unless PAN_I_WANT_A_BROKEN_VULKAN_DRIVER=1 is set. That switch is for the upstream Linux driver. The Android release notes we used do not tell you to set it, so this guide does not either.
Which PanVK build to get
panvk-kbase v26.3.1
zenithblue-oss/panvk-kbase-android is a patch layer on a pinned Mesa commit. The README calls v26.3.1 one universal libvulkan_panfrost.so for Mali GPUs on mali_kbase, covering Bifrost v6 and v7, Valhall v9, and CSF v10 to v14. Mali v15 (G2) is not fully supported. It needs Android 10 or newer (API 29) on arm64. driverInfo on this tag reads Mesa 26.3.0-devel (git-795ca7ff3e, p0175, 2026-10-31).
The README's supported-GPU table, and the release's tested-device table, name these parts: Mali-G72 (v6), Mali-G52 (v7), Mali-G57 and Mali-G78 (v9), Mali-G710 (v10), Mali-G715 and Mali-G615 (v11), Immortalis-G720 (v12), Immortalis-G925 (v13) and Mali-G1-Ultra (v14). The README also says some models that share an architecture were not run, including the Mali-G610. A shared architecture is not a test on your handheld.
panvk_faux123 v1.1.4
faux123 publishes one PanVK .adpkg.zip from his own patches on top of the panvk-kbase v0.1.0-rc4 series. From v1.0.0 the Retroid Pocket 4 Pro, RG556, Pixel 7 and GameForce Ace repositories ship the same bytes. v1.1.4 is that package. His RP4 Pro README says the driver reports Vulkan 1.3 on that device, where the stock driver offers Vulkan 1.1, and that it is an early, non-conformant driver. He tells other devices they are on their own: he does not debug hardware he does not own.
MineGraph panvk.6
Mesa 26.3.0 panvk.6 (2 November 2026) is a separate experimental build, Mesa.26.3.0-panvk.6.zip, minimum API 30. The release notes say it was verified on a Mali-G715 Immortalis MC12 and built with the g615-v11-csf profile, which those notes say covers v11 CSF hardware. Other CSF v10 to v14 parts, and the Valhall v9 / Bifrost code in the tree, ship untested. The same notes say the zip does not work with Eden.
Mali GPUs on handhelds we list
Chip and GPU names are from the Overclocked device catalog. "Tested" below means the driver's own notes name that device or that exact test phone. Sharing a GPU with a tested device is listed separately, because the projects do not treat that as a pass.
| Handheld | GPU | What the driver notes say |
|---|---|---|
| Retroid Pocket 4 Pro | Mali-G77 MC9 (Dimensity 1100) | faux123's v1.1.4 notes say he tested this handheld. panvk-kbase's v9 test devices are a G57 and a G78, not a G77. |
| Anbernic RG556 | Mali-G57 MC4 (Unisoc T820) | faux123's v1.1.4 notes say he tested this handheld. panvk-kbase tested a Mali-G57 MC2 tablet (Lenovo TB336FU), not the RG556. |
| RG406H, RG406V, RG Cube | Mali-G57 MC4 (Unisoc T820) | Same chip as the RG556. Not named in the v1.1.4 or v26.3.1 test write-ups. |
| RG557, RG477M | Mali-G615 MC6 (Dimensity 8300) | panvk-kbase's reference tests use a Poco X6 Pro with a Mali-G615 MC6. These handhelds are not named. MineGraph's panvk.6 profile is the v11 CSF profile, verified on a G715, not on these devices. |
| Retroid Pocket Flip 2 | Mali-G77 MC9 (Dimensity 1100) | Same SoC and GPU as the Pocket 4 Pro. The Flip 2 is not named in the notes we checked. |
| Retroid Pocket 4 (standard) | Mali-G68 MC4 (Dimensity 900) | faux123's RP4 Pro README says the standard Pocket 4 was not tested. It is not in panvk-kbase's tested-device table. v9 is inside the universal driver's range. |
| AYANEO Pocket Air | Mali-G77 MC9 (Dimensity 1200) | Same GPU model as the Pocket 4 Pro, different SoC. Not named in the test notes. |
| AYANEO Pocket Micro | Mali-G57 MC2 (Helio G99) | panvk-kbase tested a Mali-G57 MC2, on a Lenovo tablet. This handheld is not named. |
| Pocket Air Mini, KONKR Pocket Advance | Mali-G76 MC4 (Helio G90T) | Bifrost v7, which v26.3.1 says it builds for. The tested v7 device in that release is a Mali-G52 (Galaxy A31), not a G76. Upstream Mesa lists the G76 for Vulkan 1.3 on the Linux driver. We found no Android test of the G76. |
Our 19 October PanVK kbase article describes the older 0.1.0 RC3 range (v9 to v13, Bifrost left out). v26.3.1 is newer than that article. Use this page for the current range.
Which apps can load it
Android will not replace the system Vulkan driver for every app unless the device is rooted. faux123's README says most driver pickers were written for Adreno and will refuse or ignore a Mali package. Only install a zip the app's own project, or the driver's release notes, tell you to import.
| App | What is documented |
|---|---|
| PanPlay and PanProbe | panvk-kbase bundles the driver in PanPlay 1.3.1 and PanProbe 1.3.2. PanPlay is their Windows-game launcher (Wine, DXVK, vkd3d-proton). PanProbe is their 41-test Vulkan check. |
| GameNative | panvk-kbase says GameNative and other adpkg launchers should use the .adpkg.zip. faux123 says GameNative-Mali can import his package from version 1.2.1-mali.11, under Driver Manager, then Graphics for the game. |
| Winlator, Winlator cmod, Bannerlator, Ludashi | v26.3.1 ships a separate zip for each (-winlator, -cmod, -bannerlator, -ludashi). The release says to import the zip and select it. It does not publish a game list for those apps. MineGraph panvk.6 says its own zip was validated only on Winlator Mali. |
| GameHub | v26.3.1 ships -gamehub.zip. The release notes say the library inside is named libvulkan_freedreno.so. Import that zip. We do not have a GameHub game list from the project. |
| adrenotools launchers | v26.3.1 ships -adrenotools.zip for launchers that use that package layout. |
| Eden | Not verified. MineGraph's panvk.6 notes say that zip does not work with Eden, and that an Eden build has not been released. panvk-kbase's install table does not name Eden. faux123's install steps name GameNative-Mali, not Eden. |
| glibc "EMULATOR" zip | v26.3.1 includes Mesa-PanVK-v26.3.1-795ca7ff-EMULATOR.zip and says the glibc build is not tested on a device. Do not treat it as a working emulator install. |
faux123's v1.1.4 notes mention one emulator result on his test devices: in ARMSX3, the opening movie and song-loading screen of Diva F 2nd no longer go black, after the driver reports a 64 KiB uniform buffer limit. That is a bugfix note, not an install guide, so this page does not invent ARMSX3 menu steps.
How to install it
- Confirm the GPU on your device page. If the page says Adreno, stop and use Turnip instead.
- Download one zip from the official release linked above. For panvk-kbase, pick the suffix that matches the app. For faux123, download
panvk_faux123_v1.1.4.adpkg.zip. - Do not unzip it. The app wants the zip.
- Import it in that app's driver screen and select it. In GameNative-Mali, faux123's README says: Driver Manager, import the zip, then select it for the game under Graphics. panvk-kbase's notes say the same idea for every launcher zip: import, then select. To move off an older kbase build, import the new zip and select it. The old one can stay installed so you can compare.
- Boot one game. If it fails, select the system driver before you change anything else.
PanPlay and PanProbe do not need a separate driver download. Install the app from its own release page. The driver is already in it.
What to expect, compared with Turnip
Turnip is the open Mesa Vulkan driver Adreno handhelds load per app. It has years of builds, and our Turnip guide is the page for that. It does not run on Mali. PanVK is the Mali counterpart in the sense that it is also an open Mesa Vulkan driver you load per app, but the Android packages are younger and the projects still call them experimental.
- Not a conformance claim. faux123 says his driver is not conformant. MineGraph says panvk.6 does not declare Vulkan conformance. Mesa's docs mention a Mali-G610 Vulkan 1.4 conformance submission for upstream PanVK. That footnote is not a claim about these Android zips.
- Against the stock driver, the comparison we can cite is faux123's v1.1.4 Trails from Zero test (the same dialogue scene, frames per second): Pixel 7 (G710) 7.0 on v1.1.3, 59.9 on v1.1.4, 59.9 on Arm's driver; GameForce Ace (G610) 9.4, 59.3, 60.0; RG556 (G57) 3.8, 13.1, 17.3. On the G77 he says Arm's driver cannot run that game there, and a tessellation cost check went from about 330 microseconds a draw on v1.1.3 to about 42 on v1.1.4. He also says Giana Sisters: Twisted Dreams on the Pocket 4 Pro is about 5 percent slower than on v1.1.3 (about 34.5 fps against about 36.5).
- panvk-kbase's speed notes compare its own builds. On a Poco X6 Pro (Mali-G615), the v26.3.1 notes say a DXVK D3D11 cube went from 285 fps on RC4 to 683 fps on this release. That is not a comparison with Arm's driver. The same notes say D3D12 feature level 12_x is unsupported and falls back to 11_1, and that Fallout 4 on the DXVK path draws a black face.
- MineGraph warns about stability. panvk.6 says some D3D11 games hit a GPU page fault that can panic the kernel and reboot the device, and that heavy D3D11 titles can still freeze with
DEVICE_LOST. Leave its KRAID compiler off (it is off by default). Do not also turn on a wrapper's BCn texture conversion: the driver already converts BC1 to BC7 itself, and stacking the two is what the notes say corrupts the image.
Troubleshooting
- The app ignores the zip or falls straight back to the system driver. You probably imported an Adreno package, or a PanVK zip built for a different loader. Use the suffix table above. faux123 says a lot of Adreno pickers simply will not take a Mali package.
- The game will not boot, or the picture is badly wrong. Select the system driver. Nothing was flashed, so that is a full undo.
- Textures look soft on panvk-kbase. The v26.3.1 notes say low-memory BC1 to BC5 shadows are on by default, and that
PANVK_BC_AFRC=0restores an exact decode. Only set that if the app gives you a place to put driver variables. - A D3D11 game reboots the handheld on the MineGraph zip. That matches a known issue in the panvk.6 notes. Go back to the system driver, or to the panvk-kbase zip for that app, and do not keep testing that title on panvk.6.
- You wanted Eden. We cannot document a working import. Use the system driver in Eden. Crash steps that do apply to Eden are in the Eden crash guide, and the driver-swap section there is for Adreno.
- You are on a Mali-G76 handheld (Pocket Air Mini, KONKR Pocket Advance). The universal driver claims the v7 architecture, and a G76 was not in the tested-device table. Treat a failure to load as expected, and stay on the system driver.
Mali drivers on the hub → Turnip guide (Adreno only) →
FAQ
What is the PanVK driver?
PanVK is Mesa's open-source Vulkan driver for Arm Mali GPUs. The Android packages on the Overclocked driver hub talk to the stock mali_kbase kernel driver, so they do not need root or a custom kernel. Upstream Mesa's Linux PanVK driver is a different install path and is not the zip you sideload onto a handheld.
Can I use a Turnip driver on a Mali handheld?
No. Turnip and the Qualcomm driver packages are for Qualcomm Adreno GPUs. They will not load on Mali. Use a PanVK package built for Android, or stay on the system driver. The Turnip guide is only for Adreno handhelds.
Do I need root to install the PanVK driver?
No. panvk-kbase and faux123's builds run on the mali_kbase kernel driver that Android already ships. They load inside an app that accepts a custom Vulkan driver. They do not replace the system driver, so an ordinary Play Store game cannot use them.
Which PanVK file should I download?
For panvk-kbase v26.3.1, pick the zip whose suffix matches the app: .adpkg.zip for GameNative and other adpkg launchers, -winlator.zip for Winlator, -gamehub.zip for GameHub, and the matching suffix for Winlator cmod, Bannerlator, Ludashi or an adrenotools launcher. PanPlay and PanProbe already include the driver. For a Retroid Pocket 4 Pro or RG556, faux123's panvk_faux123_v1.1.4.adpkg.zip is the package he tested on those handhelds. Do not unzip the file. The glibc EMULATOR zip is not tested on a device.
Which Mali handhelds have a published test?
faux123's v1.1.4 notes say he tested that shared package on his Retroid Pocket 4 Pro (Mali-G77) and Anbernic RG556 (Mali-G57), plus a Pixel 7 and a GameForce Ace. panvk-kbase v26.3.1's tested-device table names phones and tablets, including a Mali-G615 MC6 and a Mali-G57 MC2, not those handhelds by name. Other devices in the Overclocked catalog share a GPU or an architecture with a tested part. That is not the same as a test on that handheld. The Mali-G76 models are in the v7 range and are not in the tested-device table.
Does Eden, Winlator or GameHub load a PanVK driver?
panvk-kbase v26.3.1 ships a Winlator zip and a GameHub zip and says to import the one that matches the app. MineGraph panvk.6 says its zip was validated on Winlator Mali only, and that it does not work with Eden. We could not find an Eden install path in the panvk-kbase release notes or in faux123's install steps. Do not expect Eden's GPU driver manager to accept these packages.
Is the PanVK driver as fast or as compatible as Turnip?
No comparison like that holds. Turnip does not run on Mali, and these PanVK builds are experimental and not claimed as conformant by their authors. The stock-driver numbers we cite are faux123's Trails from Zero results on v1.1.4. panvk-kbase's published frame rates compare its own builds, not Arm's driver.
How do I go back to the stock Mali driver?
Select the system driver in the app that loaded PanVK. Nothing was flashed. You can leave the PanVK package installed and switch back to it later.
Latest related news
- panvk_faux123 v1.1.4 batches Mali tessellation like Arm's driver: Trails from Zero jumps from 7 to 60 fps on the Pixel 7
- CapyPS5 v0.0.5 opens the Android PS5 emulator to Mali GPUs on their stock driver and shows real vs generated frames
- Pocket Foundry runs Factorio's official Linux ARM64 build natively on Android, with no emulation
- PanVK kbase brings an open Vulkan driver to Mali handhelds like the RG556 and RG557