Files
latchd/docs/ui.md

40 lines
1.3 KiB
Markdown

# Latchd user interface
Latchd starts on a virtual terminal. The interface keeps the session list and the login fields visible at the same time.
![Login screen](images/latchd-preview.png)
The screenshot comes from the Docker test image. It uses preview mode. Preview mode does not contact PAM or start a user session.
## Help panel
Press `?` to show the key reference.
![Keyboard help](images/latchd-help.png)
Use the following keys:
- Press `Tab` or `Shift-Tab` to move focus.
- Press the arrow keys to choose a session.
- Press `/` to filter sessions or accounts.
- Press `Ctrl-N` or `Ctrl-P` to change the account.
- Press `Ctrl-R` to refresh account and session discovery.
- Press `Ctrl-B` to toggle the background.
- Press `Ctrl-M` to toggle reduced motion.
- Press `Enter` to authenticate.
- Press `Esc` to clear the password or close the help panel.
- Press `Ctrl-C` to restore the terminal and quit.
These messages show account state before login. PAM accepts or rejects the login.
## Capture method
The capture uses a Docker PTY and the release binary from `latchd-test:local`:
```sh
tmux new-session -d -x 120 -y 36 \
'docker run --rm -it latchd-test:local /workspace/target/release/latchd --preview --no-log'
```
The image in this directory contains the plain terminal capture. It does not show a host VT, a host compositor, or a real PAM login.