plexyshell — PlexyDesk GPU-Accelerated Compositor
==================================================

The main display server binary. plexyshell is a bare-metal Wayland-compatible
compositor running on DRM/KMS with OpenGL SDF rendering, libinput, and the
plexy IPC protocol for zero-copy DMA-BUF client rendering.

BUILD ORDER
  Module 5 of 7. All library modules must be installed first:
    1. libplexy              (module 1)   — make install PREFIX=/usr/local
    2. libplexy-event-loop   (module 2)   — make install PREFIX=/usr/local
    3. libplexycanvas        (module 3)   — make install PREFIX=/usr/local
    4. libplexyui            (module 4)   — make install PREFIX=/usr/local

DEPENDENCIES
  - All 4 plexy libraries installed at PREFIX
  - gcc/g++ with C++20 support
  - pkg-config
  - libdrm, libgbm, libegl, libseat, libinput, libudev, libsystemd
  - libXcursor, libGL, libGLEW
  - pangocairo, cairo, freetype2

  On Debian/Ubuntu:
    apt install libdrm-dev libgbm-dev libegl-dev libseat-dev libinput-dev \
                libudev-dev libsystemd-dev libxcursor-dev libglew-dev libgl-dev \
                libpango1.0-dev libcairo2-dev libfreetype-dev

BUILD
  make PREFIX=/usr/local
  make install PREFIX=/usr/local

RUNNING
  plexyshell must be started from a TTY on a system with a DRM-capable GPU.
  It does not require an existing Wayland or X11 session.

LICENSE
  GNU Affero General Public License v3.0 only — see COPYING
  Copyright (C) 2024-2026 Siraj Razick