Add desktop adapters and extras

README.md

@@ -4,21 +4,75 @@ Python X11 STT daemon that records audio, runs Whisper, logs the transcript, and
 
 ## Requirements
 
-- X11 (not Wayland)
+- X11 (Wayland support scaffolded but not available yet)
 - `sounddevice` (PortAudio)
 - `faster-whisper`
 - `llama-cpp-python`
 - Tray icon deps: `gtk3`, `libayatana-appindicator3`
-- Python deps: `pillow`, `python-xlib`, `faster-whisper`, `llama-cpp-python`, `PyGObject`, `sounddevice`
+- Python deps (core): `pillow`, `faster-whisper`, `llama-cpp-python`, `sounddevice`
+- X11 extras: `PyGObject`, `python-xlib`
 
 System packages (example names): `portaudio`/`libportaudio2`.
 
+<details>
+<summary>Ubuntu (X11)</summary>
+
+```bash
+sudo apt install -y portaudio19-dev libportaudio2 python3-gi gir1.2-gtk-3.0 libayatana-appindicator3-1
+```
+
+</details>
+
+<details>
+<summary>Debian (X11)</summary>
+
+```bash
+sudo apt install -y portaudio19-dev libportaudio2 python3-gi gir1.2-gtk-3.0 libayatana-appindicator3-1
+```
+
+</details>
+
+<details>
+<summary>Arch Linux (X11)</summary>
+
+```bash
+sudo pacman -S --needed portaudio gtk3 libayatana-appindicator
+```
+
+</details>
+
+<details>
+<summary>Fedora (X11)</summary>
+
+```bash
+sudo dnf install -y portaudio portaudio-devel gtk3 libayatana-appindicator-gtk3
+```
+
+</details>
+
+<details>
+<summary>openSUSE (X11)</summary>
+
+```bash
+sudo zypper install -y portaudio portaudio-devel gtk3 libayatana-appindicator3-1
+```
+
+</details>
+
 ## Python Daemon
 
 Install Python deps:
 
+X11 (supported):
+
 ```bash
-uv sync
+uv sync --extra x11
+```
+
+Wayland (scaffold only):
+
+```bash
+uv sync --extra wayland
 ```
 
 Run:
@@ -64,6 +118,10 @@ systemctl --user enable --now lel
 - Press it again to stop and run STT.
 - The transcript is logged to stderr.
 
+Wayland note:
+
+- Running under Wayland currently exits with a message explaining that it is not supported yet.
+
 Injection backends:
 
 - `clipboard`: copy to clipboard and inject via Ctrl+Shift+V (GTK clipboard + XTest)