diff --git a/README.md b/README.md
index faed32d..e60ce10 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # mirada
 
-> A sovereign Wayland compositor + tiling window manager, in Rust, on [Llimphi](https://gitea.gioser.net/sergio/llimphi).
+> A sovereign Wayland compositor + tiling window manager, in Rust, on [Llimphi](https://github.com/tawasuyu/llimphi).
 
 `mirada` (Spanish *look, gaze*) is the display stack: a tiling Wayland compositor, an XDG desktop portal (generic file pickers / screenshare), a PAM login greeter, and the control CLI. The architecture splits cleanly in two:
 
@@ -9,6 +9,12 @@
 
 All UI (greeter, portal dialogs, menus) renders on Llimphi-HAL, so the same scene tree runs on Wayland and on Wawa bare-metal.
 
+<p align="center">
+  <img src="docs/mirada_showreel.gif" alt="mirada showreel — one desktop layout morphing across Windows XP, macOS, KDE, Hyprland and CDE looks" width="900">
+  <br>
+  <sub>one compositor, every desktop — the same layout across XP · macOS · KDE · Hyprland · CDE &nbsp;<em>(stylized concept render, not a live capture)</em></sub>
+</p>
+
 ## Run
 
 ```sh
diff --git a/docs/mirada_showreel.gif b/docs/mirada_showreel.gif
new file mode 100644
index 0000000..785b5b8
Binary files /dev/null and b/docs/mirada_showreel.gif differ
diff --git a/docs/mirada_showreel.mp4 b/docs/mirada_showreel.mp4
new file mode 100644
index 0000000..d538d3b
Binary files /dev/null and b/docs/mirada_showreel.mp4 differ