From b201561442586316c58271e49242f93c94ef7efc Mon Sep 17 00:00:00 2001
From: katR <katr@oiupoyt.space>
Date: Sun, 11 Oct 2026 10:15:28 +0530
Subject: [PATCH] docs: add pipeline architecture flow diagram

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index ae671a2..d78fb73 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,29 @@ Scythe is a native, ultra-lightweight alternative to NVIDIA ShadowPlay and GPU S
 
 ---
 
+## Pipeline Architecture
+
+```text
+[ Desktop Surface ]
+  │
+  ├── Wayland : ashpd screencast ──> PipeWire DMA-BUF fd (zero-copy)
+  ├── X11     : XCB MIT-SHM      ──> Shared Memory frame pool
+  └── Windows : D3D11 DXGI       ──> Desktop Duplication texture
+  │
+  ▼
+[ Hardware Encoder Surface ]
+  ├── NVENC / AMF / QSV / VAAPI  (direct hardware ingest)
+  └── libx264 / libx265 / libsvtav1 (CPU fallback)
+  │
+  ▼
+[ Memory Ring Buffer ] ──(Ctrl+Shift+R)──> [ MP4 Muxer (AVPacket Rebase) ] ──> ~/Videos/Scythe/
+  │ (rolling circular buffer)
+  ▼
+[ Live Stream / Record Engine ] ─────────> Local MP4 / RTMP Broadcast
+```
+
+---
+
 ## Features
 
 - **Instant Replay Buffer**: Constantly records gameplay into a high-speed in-memory circular ring buffer. Save the last 15s to 5 minutes of action instantly with one hotkey (`Ctrl+Shift+R`) without writing temporary files to disk.