diff --git a/docs/devices/index.md b/docs/devices/index.md
index be5fbba..19a2801 100644
--- a/docs/devices/index.md
+++ b/docs/devices/index.md
@@ -13,7 +13,7 @@ The ports listed here are independent. Their maintainers own the repositories; t
 | Device | SoC | State | Maintainer |
 | --- | --- | --- | --- |
 | [DroidVM guest (crosvm on Gunyah)](/devices/droidvm) | crosvm-gunyah | iPadOS 17 home screen; CPU presentation; Metal widgets and icons; virtio-net works | Droid-VM |
-| [QEMU virt](/devices/qemu) | QEMU virt | iPadOS 17 home screen and Settings; CPU-rendered | xVanTuring |
+| [QEMU virt](/devices/qemu) | QEMU virt | iPadOS 17 home screen and Settings; Metal on the Mac GPU with `--metal` | xVanTuring |
 | [Lenovo Xiaoxin Pad 2022 (tb128fu)](/devices/tb128fu) | SM6225 | iPadOS 17 home screen with touch; Metal frames presented by the GPU; Adreno 610 runs | xVanTuring |
 | [Xiaomi 13 (fuxi)](/devices/fuxi) | SM8550 | Kernel links and prelinks; stage B archive chain near complete; no hardware run | matejkoo217, hanzi123-bilp |
 | [OnePlus 7 Pro (guacamole)](/devices/guacamole) | SM8150 | iOS 16.7.16 userland reached; GPU pending | wochgn |
diff --git a/docs/devices/qemu.md b/docs/devices/qemu.md
index 69937cb..515938a 100644
--- a/docs/devices/qemu.md
+++ b/docs/devices/qemu.md
@@ -4,7 +4,7 @@ The QEMU target runs UniXNU on the AArch64 `virt` machine. It substitutes for a
 
 | Repository | Maintainer | State |
 | --- | --- | --- |
-| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 home screen and Settings |
+| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 home screen and Settings; Metal on the Mac GPU with `--metal` |
 
 ## State
 
@@ -17,11 +17,12 @@ The QEMU target runs UniXNU on the AArch64 `virt` machine. It substitutes for a
 | AMFI and original launchd | start with the original trust cache |
 | SystemOS union and dyld shared cache | work |
 | Data ramdisk | works |
-| Display | NativeLegacyDisplay on ramfb; CPU-rendered |
+| Display | NativeLegacyDisplay on ramfb; CPU-rendered without `--metal`, and composed on the Mac's GPU with `--metal` |
 | Touch and Home | work; typing not yet |
-| GPU | no Metal device |
+| GPU | QemuMetal device; `--metal` runs the render server's Metal work on the Mac's GPU. Without it there is no Metal device and QuartzCore uses the CPU renderer |
+| Settings | without `--metal` it stays white; with it the app opens and lists everything, with some row icons missing |
 
-The repository README records the commands that stage the ESP and boot QEMU.
+`--metal` needs the plugin, owner trust cache and Data seed built by `scripts/build-qemu-metal.py`. The repository README records the commands that stage the ESP and boot QEMU.
 
 ## Maintenance
 
diff --git a/docs/zh/devices/index.md b/docs/zh/devices/index.md
index 88a40e5..46134e6 100644
--- a/docs/zh/devices/index.md
+++ b/docs/zh/devices/index.md
@@ -13,7 +13,7 @@
 | 设备 | SoC | 状态 | 维护者 |
 | --- | --- | --- | --- |
 | [DroidVM 客户机（Gunyah 上的 crosvm）](/zh/devices/droidvm) | crosvm-gunyah | iPadOS 17 主屏幕，CPU 呈现，Metal widget 和图标，virtio-net 工作 | Droid-VM |
-| [QEMU virt](/zh/devices/qemu) | QEMU virt | iPadOS 17 主屏幕和 Settings，CPU 渲染 | xVanTuring |
+| [QEMU virt](/zh/devices/qemu) | QEMU virt | iPadOS 17 主屏幕和 Settings；使用 `--metal` 时在 Mac GPU 上运行 Metal | xVanTuring |
 | [联想小新 Pad 2022（tb128fu）](/zh/devices/tb128fu) | SM6225 | 已到 iPadOS 17 主屏幕，触控可用；Metal 帧由 GPU 呈现；Adreno 610 已运行 | xVanTuring |
 | [小米 13（fuxi）](/zh/devices/fuxi) | SM8550 | 内核可链接和预链接，阶段 B archive 链接近完成，未在真机运行 | matejkoo217、hanzi123-bilp |
 | [一加 7 Pro（guacamole）](/zh/devices/guacamole) | SM8150 | 已到达 iOS 16.7.16 用户态，GPU 待完成 | wochgn |
diff --git a/docs/zh/devices/qemu.md b/docs/zh/devices/qemu.md
index 887aeb9..eb79ba3 100644
--- a/docs/zh/devices/qemu.md
+++ b/docs/zh/devices/qemu.md
@@ -4,7 +4,7 @@ QEMU 目标在 AArch64 `virt` 机器上运行 UniXNU，用于在没有平板时
 
 | 仓库 | 维护者 | 状态 |
 | --- | --- | --- |
-| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 主屏幕和 Settings |
+| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 主屏幕和 Settings；使用 `--metal` 时在 Mac GPU 上运行 Metal |
 
 ## 状态
 
@@ -17,11 +17,12 @@ QEMU 目标在 AArch64 `virt` 机器上运行 UniXNU，用于在没有平板时
 | AMFI 和原始 launchd | 使用原始 trust cache 启动 |
 | SystemOS union 和 dyld shared cache | 工作 |
 | Data ramdisk | 工作 |
-| 显示 | ramfb 上的 NativeLegacyDisplay，CPU 渲染 |
+| 显示 | ramfb 上的 NativeLegacyDisplay；不带 `--metal` 时 CPU 渲染，带 `--metal` 时由 Mac GPU 合成 |
 | 触控和 Home | 工作，键盘输入尚未工作 |
-| GPU | 没有 Metal 设备 |
+| GPU | QemuMetal 设备；`--metal` 让 render server 的 Metal 工作跑在 Mac GPU 上。不带该选项时没有 Metal 设备，QuartzCore 使用 CPU 渲染 |
+| Settings | 不带 `--metal` 时为白屏；带上后可以打开并列出全部项目，部分行图标缺失 |
 
-仓库 README 记录了构建 ESP 和启动 QEMU 的命令。
+`--metal` 需要 `scripts/build-qemu-metal.py` 生成的插件、owner trust cache 和 Data 种子。仓库 README 记录了构建 ESP 和启动 QEMU 的命令。
 
 ## 维护