Rewrite README for better discoverability and conversion

Restructure to lead with the problem LinGlide solves instead of
jumping straight into features. Add comparison table vs alternatives,
expand feature list, add release/stars badges, use collapsible
troubleshooting sections, and add contributing section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: anbeckham

README.md

@@ -1,56 +1,85 @@
-# LinGlide
+<p align="center">
+  <img src="LinGlideFlow.png" alt="LinGlide" width="128">
+  <br>
+  <strong>LinGlide</strong>
+</p>
 
-[![CI](https://github.com/BeckhamLabsLLC/LinGlide/actions/workflows/ci.yml/badge.svg)](https://github.com/BeckhamLabsLLC/LinGlide/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+<h3 align="center">Use your phone as a second monitor on Linux</h3>
 
 <p align="center">
-  <img src="LinGlideFlow.png" alt="LinGlide Logo" width="128">
+  <a href="https://github.com/BeckhamLabsLLC/LinGlide/actions/workflows/ci.yml"><img src="https://github.com/BeckhamLabsLLC/LinGlide/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://github.com/BeckhamLabsLLC/LinGlide/releases"><img src="https://img.shields.io/github/v/release/BeckhamLabsLLC/LinGlide" alt="Release"></a>
+  <a href="https://github.com/BeckhamLabsLLC/LinGlide/stargazers"><img src="https://img.shields.io/github/stars/BeckhamLabsLLC/LinGlide?style=social" alt="GitHub stars"></a>
 </p>
 
-A high-performance Linux application that turns your mobile device into an extended display with touch control. Built with Rust for optimal performance.
+<p align="center">
+  <em>Turn any phone or tablet into a wireless extended display with touch control.<br>No app install needed — runs entirely in the browser. Built with Rust.</em>
+</p>
 
-**Developed by [BeckhamLabs](https://beckhamlabs.com)**
+---
 
-## Features
+Windows and macOS have tools like Duet Display, Sidecar, and GlideX. Linux has had nothing — until now.
+
+**LinGlide** is a native Linux application that creates a real virtual display on your system and streams it to any mobile device over WiFi. Your phone becomes a true second monitor: drag windows to it, use touch to interact, and it shows up in your display settings like any other screen.
 
-- **Extended Display**: Use your phone/tablet as a second monitor
-- **Touch Control**: Full touch input support - tap, scroll, drag
-- **Zero App Install**: Works in any modern browser (PWA supported)
-- **Low Latency**: Hardware-accelerated H.264 streaming
-- **Secure**: Device pairing with PIN verification
-- **mDNS Discovery**: Devices auto-discover the server on your network
+<!-- TODO: Replace with an actual demo GIF or screenshot of LinGlide in action -->
+<!-- <p align="center">
+  <img src="demo.gif" alt="LinGlide demo" width="600">
+</p> -->
 
-## Quick Install
+## Why LinGlide?
 
-One command to install everything:
+| | LinGlide | VNC-based scripts | Deskreen |
+|---|---|---|---|
+| **True extended display** | Virtual monitor via EVDI | xrandr hacks | Mirror only |
+| **Touch input** | Native tap, scroll, drag, stylus | No | No |
+| **App install required** | No (browser PWA) | VNC viewer app | No |
+| **Latency** | Low (H.264 + WebCodecs) | High (VNC) | Medium (WebRTC) |
+| **Written in** | Rust | Bash/Python | Electron |
+| **Linux native** | Yes | Yes | Cross-platform |
+| **Secure pairing** | PIN + token auth + TLS | None | None |
+
+## Features
+
+- **Extended display** — real virtual monitor via EVDI kernel module, visible in display settings
+- **Mirror mode** — share your existing screen without a virtual display
+- **Full touch control** — tap, scroll, drag, and stylus input via uinput
+- **Zero install on mobile** — works in Chrome, Edge, Safari (PWA for app-like experience)
+- **Low latency** — hardware-accelerated H.264 encoding with OpenH264
+- **Secure** — 6-digit PIN pairing, token authentication, TLS encryption
+- **Auto-discovery** — devices find LinGlide automatically via mDNS
+- **USB support** — ADB port forwarding for wired Android connections
+- **Desktop GUI** — system tray app with QR code for easy pairing
+- **CLI** — fully scriptable for power users
+
+## Quick Start
 
 ```bash
 git clone https://github.com/BeckhamLabsLLC/LinGlide.git
-cd linglide
+cd LinGlide
 sudo ./scripts/install.sh
 ```
 
-Then **log out and log back in** for permissions to take effect.
+Log out and back in, then:
 
-## Usage
-
-1. Launch **LinGlide** from your application menu (or run `linglide` in terminal)
+1. Launch **LinGlide** from your application menu (or run `linglide`)
 2. Click **Start Server**
-3. On your mobile device, open the URL shown (or scan the QR code)
-4. Enter the PIN to pair your device
-
-That's it! Your mobile device is now an extended display.
+3. On your phone, open the URL shown or scan the QR code
+4. Enter the PIN — done
 
 ## System Requirements
 
 - Linux with X11 (Wayland support planned)
-- EVDI kernel module (installed automatically)
-- Modern browser with WebCodecs (Chrome 94+, Edge 94+, Safari 16.4+)
+- EVDI kernel module (installed automatically by the install script)
+- Mobile browser with WebCodecs support:
+  - Chrome/Chromium 94+
+  - Edge 94+
+  - Safari 16.4+
+  - Firefox is **not** supported (no WebCodecs)
 
 ## Build from Source
 
-If you prefer to build manually:
-
 ```bash
 # Install dependencies (Ubuntu/Debian)
 sudo apt install build-essential pkg-config libssl-dev libx11-dev \
@@ -64,23 +93,17 @@ cargo build --release -p linglide-desktop
 ./target/release/linglide-gui
 ```
 
-## Uninstall
-
-```bash
-sudo ./scripts/uninstall.sh
-```
-
 ## How It Works
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                    LINUX HOST (Rust)                        │
 ├─────────────────────────────────────────────────────────────┤
-│  EVDI         →   Frame      →   H.264 Encoder              │
-│  (Virtual         Capture        (OpenH264)                  │
+│  EVDI         →   Frame      →   H.264 Encoder             │
+│  (Virtual         Capture        (OpenH264)                 │
 │   Display)                                                  │
 │                                                             │
-│  uinput       ←   Event      ←   WebSocket Server           │
+│  uinput       ←   Event      ←   WebSocket Server          │
 │  (Touch)          Handler        (Axum + TLS)               │
 └─────────────────────────────────────────────────────────────┘
                               │
@@ -96,34 +119,44 @@ sudo ./scripts/uninstall.sh
 
 ## Troubleshooting
 
-### EVDI module not loading
+<details>
+<summary><strong>EVDI module not loading</strong></summary>
 
 If you see "Failed to add EVDI device", run:
 ```bash
 sudo modprobe -r evdi && sudo modprobe evdi initial_device_count=1
 ```
-
 The install script configures this automatically for future boots.
+</details>
 
-### Permission denied for uinput
+<details>
+<summary><strong>Permission denied for uinput</strong></summary>
 
 Log out and log back in after installation for group permissions to take effect.
+</details>
 
-### Browser not supported
+<details>
+<summary><strong>Browser not supported</strong></summary>
 
-WebCodecs is required. Supported browsers:
-- Chrome/Chromium 94+
-- Edge 94+
-- Safari 16.4+
+WebCodecs is required. Use Chrome/Chromium 94+, Edge 94+, or Safari 16.4+. Firefox does not support WebCodecs.
+</details>
 
-Firefox does not support WebCodecs.
+## Contributing
+
+Contributions are welcome! Feel free to open issues for bugs or feature requests, or submit pull requests.
+
+## Uninstall
+
+```bash
+sudo ./scripts/uninstall.sh
+```
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License — see [LICENSE](LICENSE) for details.
 
 ---
 
 <p align="center">
-  Made with care for the Linux community by <a href="https://beckhamlabs.com">BeckhamLabs</a>
+  <a href="https://beckhamlabs.com">BeckhamLabs</a>
 </p>