🖥️ XWebVNC Server

XWebVNC is an efficient, headless Xorg/Xvfb-based display server with built-in WebVNC capability — allowing you to stream and interact with your Linux desktop directly from any modern web browser.

---

🚀 Features

• 🧠 Headless X Server — Works as either Xorg or Xvfb, optimized for headless environments.
• 🌐 Built-in WebSocket & HTTP Server — Serves both the web client and live framebuffer updates.
• ⚡ Real-Time Compression — Supports:
  • LZ4 → Ultra-fast, low-latency compression
  • JPEG → High compression ratio with good visual fidelity
• 🪶 Zero External Dependencies — No x11vnc, no nginx, no proxies.
• 🔒 Lightweight & Secure — Ideal for servers, embedded systems, or containerized setups.
• 🧩 Fully Self-Contained — Includes built-in index.html client page.
• 🖱️local mouse -> use local mouse like few good webvnc app

---

🧪 Example Use Cases

• Remote GUI access for headless Linux servers
• Browser-based desktops in Docker or VMs
• Lightweight remote development environments
• Embedded Linux systems with browser-based control

build and run

example command meson compile -C build && ./build/hw/vfb/Xvfb :1 -screen 0 1280x720x24 -web 80

more details will be added soon

🧩 Architecture

flowchart LR
    subgraph Core["XWebVNC App"]
        A1["Direct Framebuffer Capture"]
        A2["Frame Compressor (LZ4 / JPEG)"]
    end

    subgraph Net["Network Layer"]
        B1["Built-in HTTP Server\n(serves index.html, JS, assets)"]
        B2["WebSocket Server\n(sends frames, receives input)"]
    end

    subgraph Client["Browser Web Client"]
        C1["UI (index.html + JS)"]
        C2["Real-time Renderer\n(receives framebuffer)"]
        C3["Input Handler\n(sends keyboard/mouse events)"]
    end

    A1 --> A2
    A2 --> B2
    A1 --> B1
    B1 --> C1
    B2 --> C2
    C3 --> B2
    C2 -. "Displays live desktop" .-> C1

Loading