zzjcool/krd

选用指南

AI 根据 README 整理 · 2026/10/30 11:21:36

使用方式

通过命令行使用，例如 `krd --fps 20` 镜像显示，`krd ax tree` 读取无障碍树。

查看 README 依据

Everything is explained in [docs/DEPLOY.md](docs/DEPLOY.md); the script itself is plain `sh` ([install.sh](install.sh)). ## Use ```bash krd --fps 20 # mirror the display the pointer is on krd --list # displays and windows; backdrop entries are marked krd --window Safari # mirror a single window (a backdrop window is refused, not shown black) krd --zoom 2 # show half the screen at twice the density (crop on the capture side) krd --zoom 3 --zoom-at 200,300 # ...centred on a source point, in global screen points

krd ax doctor # is Accessibility granted, does the window server answer krd ax windows # app, pid, window index, title, frame krd ax tree --app Finder -d 3 -i # one window, shallow, actionable nodes only krd ax tree --app Finder --json # same, for a program krd ax screen # every on-screen window, plus the focused element ``` Output is one line per node — `@e3 button "Save" value="hi" [120,80 64x24] press` — with refs stable for the life of that dump. Exit codes: `0` ok, `2` usage, `3` no Accessibility permission,

部署要求

需要 macOS 14 或更高版本，以及支持 kitty 图形协议的终端（如 rex、Ghostty、kitty、WezTerm）。

查看 README 依据

`4` window server unreachable, `5` nothing matched. Text is sanitized: a window title can contain ESC sequences and those are replaced, not printed. See [docs/research-ax-text-channel.md](docs/research-ax-text-channel.md) for the measurements. ## Requirements - macOS 14 or newer. - A terminal that speaks the kitty graphics protocol: **rex**, **Ghostty**, **kitty**, **WezTerm**. Terminal.app does not. - One-time approval of **Screen Recording** (capture) and **Accessibility** (input) — the installer prints the exact prompt. Details and failure modes: [docs/DEPLOY.md](docs/DEPLOY.md).

已知限制

目前不支持在一个画面中同时显示多个显示器，且颜色丰富的全屏动态画面带宽较高。

查看 README 依据

that answers the OSC 52 read — `--clipboard-paste <file>` is the path that always works) | | Solid (IME/CJK) | `--ime` (`auto` / `raw` / `unicode`): physical keys go to the target so *its* input method composes (candidate window renders in the mirrored picture); characters with no key fall back to injected text, with a log line — see TROUBLESHOOTING §19 | | Not yet | spanning several displays in one picture (a session follows one display at a time) | ## Docs | | | |---|---| | [ARCHITECTURE](docs/ARCHITECTURE.md) | capture → tiles → protocol → injection, CLI and env vars |

| Rough | colour-heavy full-screen motion: 13.58 MB/frame worst case, costed in [research-photo-bandwidth](docs/research-photo-bandwidth.md) — the cheap fix is 16-bit tiles plus a smaller capture, not a codec; Herdr's image-delete semantics | | Solid (clipboard) | clipboard bridge, opt-in with `--clipboard=in|out|both`: a copy inside the mirrored desktop becomes an OSC 52 sequence for the local terminal (`in`), and `Ctrl-V` asks the terminal for its clipboard, puts it on the target's pasteboard and posts `Cmd-V` (`out`, needs a terminal