From e3eecc5b960103f5351b76371eeb3f1d3692c2f9 Mon Sep 17 00:00:00 2001 From: John O'Keefe Date: Tue, 15 Sep 2026 22:18:52 -0400 Subject: [PATCH] docs: note webkitgtk-6.0 runtime requirement for running releases The release binary dynamically links libwebkitgtk-6.0 and libgtk-4, neither of which ships in the tarball or gets installed by install_linux.sh, and webkitgtk-6.0 is not preinstalled on most distros. Tell runners up front which runtime package to install (Arch/Debian-Ubuntu names verified) and what the missing-.so launch error looks like. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 8eaa800..6457fd8 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,12 @@ This has been built with the official Wails Svelte-TS template. To run as is, please feel free to download a binary from the releases page. +> **To run:** install the WebKitGTK 6 runtime first — it is not preinstalled +> on most distros, and the app will not start without it +> (`error while loading shared libraries: libwebkitgtk-6.0.so.4`). +> Arch: `sudo pacman -S webkitgtk-6.0` · +> Debian/Ubuntu: `sudo apt install libwebkitgtk-6.0-4`. + If you are getting too many errors due to api usage, please build from source. ## Build from Source