commit b824cdab400dea6285036af9f8ec64daf7dd11b5
Author: sunglocto <sunglocto@protonmail.com>
Date:   Wed Aug 27 11:09:47 2025 +0000

    Add Pi with Wayland

diff --git a/Pi-with-Wayland.md b/Pi-with-Wayland.md
new file mode 100644
index 0000000..16db135
--- /dev/null
+++ b/Pi-with-Wayland.md
@@ -0,0 +1,17 @@
+Because Pi uses the [Fyne](https://fyne.io) UI toolkit, it has native support for Wayland GNU/Linux systems.
+
+All Pi builds provided on this repo are built with X11, because the majority of Wayland setups can run X11 apps (through XWayland) but virtually no X11 setups can run Wayland apps.
+
+This is why if you're running a setup without XWayland, the default Pi binaries will crash when you launch them. In order to avoid this, build the Pi executable with the Wayland tag. Like so:
+
+```
+git clone https://forge.sunglocto.net/sunglocto/pi-im
+cd pi-im
+go mod tidy
+go build -tags wayland .
+./pi-im
+```
+
+There are also other reasons for using the Wayland native executable, for example the ability of dragging and dropping files, and less lag.
+
+Pi support for Wayland FreeBSD setups has been untested. Those on a FreeBSD setup, please report any issues you experience whilst using Pi. 
\ No newline at end of file