Improve socket handling for -x spawned fenrir instances.
This commit is contained in:
+16
-3
@@ -132,6 +132,18 @@ enable_command_remote=True # allow command execution
|
||||
|
||||
### Basic Usage with socat
|
||||
|
||||
#### Instance Discovery
|
||||
```bash
|
||||
# List registered Fenrir instances and their socket paths
|
||||
echo "ls" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-deamon.sock
|
||||
```
|
||||
|
||||
In X terminal mode (`fenrir -x`), multiple Fenrir instances can run at the same
|
||||
time. Each instance has a private socket at `/tmp/fenrirscreenreader-<pid>.sock`,
|
||||
and one instance may also own the standard control socket. Use `ls` or
|
||||
`command ls` on the standard socket to find the private socket for a specific
|
||||
instance.
|
||||
|
||||
#### Speech Control
|
||||
```bash
|
||||
# Interrupt current speech
|
||||
@@ -193,6 +205,7 @@ echo "command quitapplication" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-dea
|
||||
- `command say <text>` - Speak text
|
||||
- `command interrupt` - Stop speech
|
||||
- `command tempdisablespeech` - Disable until next key
|
||||
- `ls` / `list` / `command ls` / `command list` - List registered Fenrir instances
|
||||
|
||||
**Settings Commands:**
|
||||
- `setting set <section>#<key>=<value>` - Change setting
|
||||
@@ -318,7 +331,7 @@ Fenrir automatically detects and provides audio feedback for progress indicators
|
||||
|
||||
### Input Drivers
|
||||
- **evdevDriver** - Linux evdev (recommended for Linux)
|
||||
- **ptyDriver** - Terminal emulation (cross-platform)
|
||||
- **x11Driver** - X11 terminal-scoped input for `fenrir -x`
|
||||
|
||||
### Screen Drivers
|
||||
- **vcsaDriver** - Linux VCSA devices (TTY)
|
||||
@@ -341,8 +354,6 @@ fenrir [OPTIONS]
|
||||
- `-o, --options SECTION#SETTING=VALUE;..` - Override settings
|
||||
- `-d, --debug` - Enable debug mode
|
||||
- `-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
|
||||
@@ -368,6 +379,8 @@ X11 terminal mode uses the same keyboard layout files as TTY Fenrir. Supported F
|
||||
|
||||
This mode requires `python-xlib`.
|
||||
|
||||
For a dedicated PTY/terminal screen reader, see TDSR: https://github.com/tspivey/tdsr
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### No Speech
|
||||
|
||||
Reference in New Issue
Block a user