Add X11 terminal input mode

docs/user.md

@@ -343,9 +343,31 @@ fenrir [OPTIONS]
 - `-p, --print` - Print debug to screen
 - `-e, --emulated-pty` - PTY emulation for desktop use
 - `-E, --emulated-evdev` - PTY + evdev emulation
+- `-x, --x11` - PTY + X11 keyboard input scoped to the terminal window
+- `--x11-window-id WINDOWID` - X11 window id to use for `--x11` terminal mode
 - `-F, --force-all-screens` - Ignore ignoreScreen setting
 - `-i, -I, --ignore-screen SCREEN` - Ignore specific screen(s), can be used multiple times
 
+### X11 Terminal Mode
+
+Use `fenrir -x` to run Fenrir in an X11 terminal as a normal user:
+
+```bash
+fenrir -x
+```
+
+This mode uses PTY screen monitoring and X11 keyboard input. It is intended for GUI terminals such as xterm and VTE-based terminals, while keeping Fenrir key handling scoped to that terminal window. Desktop screen readers keep their global bindings outside the focused terminal.
+
+Fenrir normally detects the target terminal from `WINDOWID` or the active X11 window. If needed, pass a window id explicitly:
+
+```bash
+fenrir -x --x11-window-id 0x123456
+```
+
+X11 terminal mode uses the same keyboard layout files as TTY Fenrir. Supported Fenrir keys include numpad Insert/`KEY_KP0`, CapsLock/`KEY_CAPSLOCK`, Insert/`KEY_INSERT`, and Super/Windows/`KEY_META`. Compose script keys are exposed as `KEY_COMPOSE`.
+
+This mode requires `python-xlib`.
+
 ## Troubleshooting
 
 ### No Speech