diff --git a/README.md b/README.md
index 86fe114..0841651 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,15 @@ MCP endpoint so AI agents can operate the machine too.
[Features](#features) · [Interface](#interface-overview) · [Architecture](#architecture) · [Quick start](#quick-start) · [Build](#building-from-source) · [API](#api-overview) · [Contributing](CONTRIBUTING.md) · [中文](README.zh-CN.md)
+
+
+
+
+
+
+
+Live 4K60 target in the browser. More screenshots under Interface overview; full-resolution clip: WebM.
+
---
@@ -110,7 +119,15 @@ The web UI is a single-page app served by the device itself.
First launch opens a **setup wizard** where you choose password or no-password mode.
-
+| | Light | Dark |
+| --- | --- | --- |
+| **Remote desktop** | | |
+| **Sidebar pinned** | | |
+| **Settings** | | |
+| **Focus mode** | | |
+| **Connect** | | |
+
+Click any image for full size. How these were captured and their sources: [docs/assets/demo/README.md](docs/assets/demo/README.md).
## Architecture
diff --git a/docs/assets/demo/README.md b/docs/assets/demo/README.md
new file mode 100644
index 0000000..648c51a
--- /dev/null
+++ b/docs/assets/demo/README.md
@@ -0,0 +1,36 @@
+# Demo media
+
+Screenshots and a short clip of the RustKVM web UI (English, light and dark
+themes), used by the top-level README.
+
+| File | What it shows |
+| --- | --- |
+| `light-01-connect.webp` | Connect card on a fresh page load |
+| `{light,dark}-02-remote-desktop.webp` | Remote desktop: live target screen, titlebar with LEDs and actions |
+| `{light,dark}-03-sidebar-pinned.webp` | Sidebar pinned open (navigation and connection status) |
+| `{light,dark}-04-settings-general.webp` | Settings dialog, General page (appearance and language) |
+| `{light,dark}-09-focus-mode.webp` | Focus mode: sidebar and titlebar hidden |
+| `rustkvm-demo.gif` | 11 s loop: pin sidebar, open Settings, switch to dark, close, unpin (1280 px wide) |
+| `rustkvm-demo.webm` | The same clip at 1920×1080 (VP9) |
+
+## How they were made
+
+- Device: RK3588 running RustKVM, capturing a Windows 11 target at
+ 3840×2160, 60 fps.
+- Browser: headless Chromium driven by Playwright at 1920×1080, device scale
+ factor 1. Theme and language were set in the browser's localStorage only.
+- The scripts clicked only UI elements (sidebar, titlebar, settings dialog)
+ and sent no keyboard or mouse input to the target.
+- Stills were saved as WebP (quality 85). The clip was recorded with the
+ Chrome DevTools screencast and encoded with ffmpeg; the GIF drops frames
+ identical to the previous one, because the UI changes in single steps.
+
+## Sources and licenses
+
+- **RustKVM UI**: this repository, GPL-2.0-only.
+- **Target screen**: Google Chrome on Windows 11 showing this repository's
+ GitHub page (). The page content is this
+ project's README and social preview image (GPL-2.0-only). Windows, Chrome and
+ GitHub interface elements belong to Microsoft, Google and GitHub, and appear
+ here as ordinary product screenshots.
+- No third-party photos, videos or wallpapers are visible.
diff --git a/docs/assets/demo/dark-02-remote-desktop.webp b/docs/assets/demo/dark-02-remote-desktop.webp
new file mode 100644
index 0000000..95a9e6f
Binary files /dev/null and b/docs/assets/demo/dark-02-remote-desktop.webp differ
diff --git a/docs/assets/demo/dark-03-sidebar-pinned.webp b/docs/assets/demo/dark-03-sidebar-pinned.webp
new file mode 100644
index 0000000..8eb4039
Binary files /dev/null and b/docs/assets/demo/dark-03-sidebar-pinned.webp differ
diff --git a/docs/assets/demo/dark-04-settings-general.webp b/docs/assets/demo/dark-04-settings-general.webp
new file mode 100644
index 0000000..dbaa98e
Binary files /dev/null and b/docs/assets/demo/dark-04-settings-general.webp differ
diff --git a/docs/assets/demo/dark-09-focus-mode.webp b/docs/assets/demo/dark-09-focus-mode.webp
new file mode 100644
index 0000000..6c67f7d
Binary files /dev/null and b/docs/assets/demo/dark-09-focus-mode.webp differ
diff --git a/docs/assets/demo/light-01-connect.webp b/docs/assets/demo/light-01-connect.webp
new file mode 100644
index 0000000..45fc9cd
Binary files /dev/null and b/docs/assets/demo/light-01-connect.webp differ
diff --git a/docs/assets/demo/light-02-remote-desktop.webp b/docs/assets/demo/light-02-remote-desktop.webp
new file mode 100644
index 0000000..04123f2
Binary files /dev/null and b/docs/assets/demo/light-02-remote-desktop.webp differ
diff --git a/docs/assets/demo/light-03-sidebar-pinned.webp b/docs/assets/demo/light-03-sidebar-pinned.webp
new file mode 100644
index 0000000..b29b8e1
Binary files /dev/null and b/docs/assets/demo/light-03-sidebar-pinned.webp differ
diff --git a/docs/assets/demo/light-04-settings-general.webp b/docs/assets/demo/light-04-settings-general.webp
new file mode 100644
index 0000000..0fe27f2
Binary files /dev/null and b/docs/assets/demo/light-04-settings-general.webp differ
diff --git a/docs/assets/demo/light-09-focus-mode.webp b/docs/assets/demo/light-09-focus-mode.webp
new file mode 100644
index 0000000..5e45ebc
Binary files /dev/null and b/docs/assets/demo/light-09-focus-mode.webp differ
diff --git a/docs/assets/demo/rustkvm-demo.gif b/docs/assets/demo/rustkvm-demo.gif
new file mode 100644
index 0000000..83e33e6
Binary files /dev/null and b/docs/assets/demo/rustkvm-demo.gif differ
diff --git a/docs/assets/demo/rustkvm-demo.webm b/docs/assets/demo/rustkvm-demo.webm
new file mode 100644
index 0000000..bcbd88f
Binary files /dev/null and b/docs/assets/demo/rustkvm-demo.webm differ