From 3eed1b64af72dcb4bcb8ae28d45856767d4acff1 Mon Sep 17 00:00:00 2001
From: Trung Lê <8@tle.id.au>
Date: Sat, 21 Feb 2026 23:40:05 +1100
Subject: Initial commit

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe2e05c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+![](./gsr-logo.png)
+
+# GPU Screen Recorder (libadwaita port)
+GNOME frontend for [GPU Screen Recorder](https://git.dec05eba.com/gpu-screen-recorder/about/).
+
+## Notes
+The program has to be launched from your application launcher or hotkeys may not work properly in your Wayland compositor (this is the case with GNOME).
+
+# Installation
+```sh
+meson setup build
+ninja -C build
+sudo ninja -C build install
+```
+
+## Build options
+Both X11 and Wayland backends are enabled by default. Distributions can disable either at compile time:
+
+```sh
+# Wayland-only build (no X11 dependency)
+meson setup build -Dx11=false
+
+# X11-only build (no Wayland portal shortcuts)
+meson setup build -Dwayland=false
+```
+
+| Option    | Default | Description                                  |
+|-----------|---------|----------------------------------------------|
+| `x11`     | `true`  | Enable X11 hotkeys and window picker         |
+| `wayland` | `true`  | Enable Wayland global shortcuts via portal   |
+
+# Dependencies
+The app uses the meson build system so you need to install `meson` and `ninja`.
+
+## Build dependencies
+These are the dependencies needed to build GPU Screen Recorder Adwaita:
+
+* libadwaita (>= 1.8)
+* libx11 (optional, required when `-Dx11=true`)
+* desktop-file-utils
+
+## Runtime dependencies
+There are also additional dependencies needed at runtime:
+
+* [GPU Screen Recorder](https://git.dec05eba.com/gpu-screen-recorder/)
+
+## Screenshots
+
+![](./screenshot1.png)
+
+# Reporting bugs, contributing patches, questions or donation
+See [gpu-screen-recorder-adwaita](https://github.com/runlevel5/gpu-screen-recorder-adwaita/issues)
-- 
cgit v1.2.3