diff --git a/README.md b/README.md
index dc99b4f..e3631a1 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,15 @@
 # nahual
 
-> `nahual` (Nahuatl: *companion spirit*). Everyday "open-with" viewers, in Rust, on [Llimphi](https://gitea.gioser.net/sergio/llimphi).
+> `nahual` (Nahuatl: *companion spirit*). Everyday "open-with" viewers, in Rust, on [Llimphi](https://github.com/tawasuyu/llimphi).
 
 `nahual` is the set of viewers a desktop user expects — a file shell that dispatches the right viewer by content, plus viewers for text, images, audio, video, SVG, maps, fonts, hex, tables, markdown, archives and more. All render on the same GPU-accelerated Llimphi UI. A **meta-runtime** lets you define a new viewer from a JSON schema, with no Rust.
 
+<p align="center">
+  <img src="docs/nahual_showreel.gif" alt="nahual showreel — a Dopus-style file manager: folder tree, session tabs, icon grid with real thumbnails, and browse-and-preview with a content-dispatched viewer" width="900">
+  <br>
+  <sub>a file manager with real thumbnails + browse-and-preview, the viewer dispatched by content</sub>
+</p>
+
 ## Run
 
 ```sh
@@ -21,8 +27,8 @@ cargo run --release -p nahual-text-viewer-llimphi    # text viewer
 
 This is a clean front-door repo: it contains **only nahual's own crates**. Everything else is pulled as a git dependency —
 
-- the **Llimphi** UI framework → [`llimphi.git`](https://gitea.gioser.net/sergio/llimphi)
-- foundational crates (content discern, media decoders, content-addressed sources, shared leaves) → the [`gioser`](https://gitea.gioser.net/sergio/gioser) monorepo, the suite's source of truth.
+- the **Llimphi** UI framework → [`llimphi.git`](https://github.com/tawasuyu/llimphi)
+- foundational crates (content discern, media decoders, content-addressed sources, shared leaves) → the [`tawasuyu`](https://github.com/tawasuyu/tawasuyu) monorepo, the suite's source of truth.
 
 No vendoring, no duplication. First build clones those repos (cached afterwards).
 
@@ -34,4 +40,4 @@ No vendoring, no duplication. First build clones those repos (cached afterwards)
 
 ## License
 
-MIT. Builds on [Llimphi](https://gitea.gioser.net/sergio/llimphi) and the [gioser](https://gitea.gioser.net/sergio/gioser) suite.
+MIT. Builds on [Llimphi](https://github.com/tawasuyu/llimphi) and the [tawasuyu](https://github.com/tawasuyu/tawasuyu) suite.
diff --git a/docs/nahual_showreel.gif b/docs/nahual_showreel.gif
new file mode 100644
index 0000000..95b2706
Binary files /dev/null and b/docs/nahual_showreel.gif differ
diff --git a/docs/nahual_showreel.mp4 b/docs/nahual_showreel.mp4
new file mode 100644
index 0000000..4c20cbd
Binary files /dev/null and b/docs/nahual_showreel.mp4 differ