# h-m-h/weylus architecture

> Architecture diagram of the GitHub repository h-m-h/weylus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/h-m-h/weylus
- Repository: https://github.com/h-m-h/weylus

## Overview

Weylus is a computer-hosted tablet and phone interface for mirroring screens and forwarding touch, stylus, mouse, and keyboard input. The main workflow is browser connection, capturable selection/configuration, video delivery, and event dispatch to the host. The graph includes platform capture and input backends, encoding, and the GUI/control layer. Some internal wiring is based on the source index or README rather than shown call sites; uncertain relationships are left out or marked dashed.

Main entry points: [`src/capturable/mod.rs`](https://github.com/h-m-h/weylus/blob/master/src/capturable/mod.rs) (Capture Selection), [`src/websocket.rs`](https://github.com/h-m-h/weylus/blob/master/src/websocket.rs) (WebSocket Session), [`src/main.rs`](https://github.com/h-m-h/weylus/blob/master/src/main.rs) (Application Entry), [`src/input/device.rs`](https://github.com/h-m-h/weylus/blob/master/src/input/device.rs) (Input Device Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control and UI"]
  node_main["Application Entry<br/>[main.rs]"]
  node_config["Runtime Config<br/>[config.rs]"]
  node_gui["Desktop GUI<br/>[gui.rs]"]
  node_weylus["Service Coordinator<br/>[weylus.rs]"]
end

subgraph group_transport["Browser Transport"]
  node_web["HTTP Web Server<br/>[web.rs]"]
  node_websocket["WebSocket Session<br/>[websocket.rs]"]
  node_browser_client["Browser Client<br/>[lib.ts]"]
  node_protocol["Message Protocol<br/>[protocol.rs]"]
end

subgraph group_capture["Screen Capture"]
  node_capture_api["Capture Selection<br/>[mod.rs]"]
  node_linux_capture["Linux Capture<br/>[pipewire.rs]"]
  node_x11_capture["X11 Capture<br/>[x11.rs]"]
  node_mac_capture["CoreGraphics Capture<br/>[core_graphics.rs]"]
  node_windows_capture["Windows Capture<br/>[captrs_capture.rs]"]
end

subgraph group_input["Host Input"]
  node_input_dispatch["Input Device Interface<br/>[device.rs]"]
  node_uinput["Linux uinput<br/>[uinput_device.rs]"]
  node_autopilot["Desktop Input"]
  node_windows_input["Windows Input"]
end

subgraph group_media["Video Encoding"]
  node_video["Video Encoder<br/>[video.rs]"]
  node_native_encoder["Native Encoder<br/>[encode_video.c]"]
end

node_operator(("Computer Operator"))
node_browser(("Tablet Browser"))

node_operator -->|"starts"| node_main
node_main -->|"loads"| node_config
node_main -->|"launches"| node_gui
node_gui -->|"starts service"| node_weylus
node_main -->|"starts headless"| node_weylus
node_weylus -->|"serves"| node_web
node_browser -->|"opens interface"| node_web
node_web -.->|"upgrades session"| node_websocket
node_browser_client -.->|"exchanges events"| node_websocket
node_websocket -->|"parses messages"| node_protocol
node_websocket -->|"lists capturables"| node_capture_api
node_capture_api -->|"selects backend"| node_linux_capture
node_capture_api -->|"selects backend"| node_x11_capture
node_capture_api -->|"selects backend"| node_mac_capture
node_capture_api -->|"selects backend"| node_windows_capture
node_websocket -->|"dispatches events"| node_input_dispatch
node_input_dispatch -.->|"implements"| node_uinput
node_input_dispatch -.->|"implements"| node_autopilot
node_input_dispatch -.->|"implements"| node_windows_input
node_websocket -->|"encodes capture"| node_video
node_video -->|"calls native encoder"| node_native_encoder
node_capture_api -.->|"provides frames"| node_video

click node_main "https://github.com/h-m-h/weylus/blob/master/src/main.rs"
click node_config "https://github.com/h-m-h/weylus/blob/master/src/config.rs"
click node_gui "https://github.com/h-m-h/weylus/blob/master/src/gui.rs"
click node_weylus "https://github.com/h-m-h/weylus/blob/master/src/weylus.rs"
click node_web "https://github.com/h-m-h/weylus/blob/master/src/web.rs"
click node_websocket "https://github.com/h-m-h/weylus/blob/master/src/websocket.rs"
click node_browser_client "https://github.com/h-m-h/weylus/blob/master/ts/lib.ts"
click node_protocol "https://github.com/h-m-h/weylus/blob/master/src/protocol.rs"
click node_capture_api "https://github.com/h-m-h/weylus/blob/master/src/capturable/mod.rs"
click node_linux_capture "https://github.com/h-m-h/weylus/blob/master/src/capturable/pipewire.rs"
click node_x11_capture "https://github.com/h-m-h/weylus/blob/master/src/capturable/x11.rs"
click node_mac_capture "https://github.com/h-m-h/weylus/blob/master/src/capturable/core_graphics.rs"
click node_windows_capture "https://github.com/h-m-h/weylus/blob/master/src/capturable/captrs_capture.rs"
click node_input_dispatch "https://github.com/h-m-h/weylus/blob/master/src/input/device.rs"
click node_uinput "https://github.com/h-m-h/weylus/blob/master/src/input/uinput_device.rs"
click node_autopilot "https://github.com/h-m-h/weylus/blob/master/src/input/autopilot_device.rs"
click node_windows_input "https://github.com/h-m-h/weylus/blob/master/src/input/autopilot_device_win.rs"
click node_video "https://github.com/h-m-h/weylus/blob/master/src/video.rs"
click node_native_encoder "https://github.com/h-m-h/weylus/blob/master/lib/encode_video.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_config,node_gui,node_weylus,node_browser toneBlue
class node_web,node_websocket,node_browser_client,node_protocol toneAmber
class node_capture_api,node_linux_capture,node_x11_capture,node_mac_capture,node_windows_capture toneMint
class node_input_dispatch,node_uinput,node_autopilot,node_windows_input toneRose
class node_video,node_native_encoder,node_operator toneIndigo
```

## Components

### Control and UI

- [Application Entry](https://github.com/h-m-h/weylus/blob/master/src/main.rs): `src/main.rs`
- [Runtime Config](https://github.com/h-m-h/weylus/blob/master/src/config.rs): `src/config.rs`
- [Desktop GUI](https://github.com/h-m-h/weylus/blob/master/src/gui.rs): `src/gui.rs`
- [Service Coordinator](https://github.com/h-m-h/weylus/blob/master/src/weylus.rs): `src/weylus.rs`

### Browser Transport

- [HTTP Web Server](https://github.com/h-m-h/weylus/blob/master/src/web.rs): `src/web.rs`
- [WebSocket Session](https://github.com/h-m-h/weylus/blob/master/src/websocket.rs): `src/websocket.rs`
- [Browser Client](https://github.com/h-m-h/weylus/blob/master/ts/lib.ts): `ts/lib.ts`
- [Message Protocol](https://github.com/h-m-h/weylus/blob/master/src/protocol.rs): `src/protocol.rs`

### Screen Capture

- [Capture Selection](https://github.com/h-m-h/weylus/blob/master/src/capturable/mod.rs): `src/capturable/mod.rs`
- [Linux Capture](https://github.com/h-m-h/weylus/blob/master/src/capturable/pipewire.rs): `src/capturable/pipewire.rs`
- [X11 Capture](https://github.com/h-m-h/weylus/blob/master/src/capturable/x11.rs): `src/capturable/x11.rs`
- [CoreGraphics Capture](https://github.com/h-m-h/weylus/blob/master/src/capturable/core_graphics.rs): `src/capturable/core_graphics.rs`
- [Windows Capture](https://github.com/h-m-h/weylus/blob/master/src/capturable/captrs_capture.rs): `src/capturable/captrs_capture.rs`

### Host Input

- [Input Device Interface](https://github.com/h-m-h/weylus/blob/master/src/input/device.rs): `src/input/device.rs`
- [Linux uinput](https://github.com/h-m-h/weylus/blob/master/src/input/uinput_device.rs): `src/input/uinput_device.rs`
- [Desktop Input](https://github.com/h-m-h/weylus/blob/master/src/input/autopilot_device.rs): `src/input/autopilot_device.rs`
- [Windows Input](https://github.com/h-m-h/weylus/blob/master/src/input/autopilot_device_win.rs): `src/input/autopilot_device_win.rs`

### Video Encoding

- [Video Encoder](https://github.com/h-m-h/weylus/blob/master/src/video.rs): `src/video.rs`
- [Native Encoder](https://github.com/h-m-h/weylus/blob/master/lib/encode_video.c): `lib/encode_video.c`

### Other components

- **Computer Operator**
- **Tablet Browser**

## Connections

- Computer Operator → Application Entry: starts (evidence: `Readme.md`)
- Application Entry → Runtime Config: loads (evidence: `src/main.rs`)
- Application Entry → Desktop GUI: launches (evidence: `src/main.rs`)
- Desktop GUI → Service Coordinator: starts service (evidence: `src/gui.rs`)
- Application Entry → Service Coordinator: starts headless (evidence: `src/main.rs`)
- Service Coordinator → HTTP Web Server: serves (evidence: `src/weylus.rs`)
- Tablet Browser → HTTP Web Server: opens interface (evidence: `Readme.md`)
- HTTP Web Server → WebSocket Session: upgrades session (evidence: `src/web.rs`)
- Browser Client → WebSocket Session: exchanges events
- WebSocket Session → Message Protocol: parses messages (evidence: `src/websocket.rs`)
- WebSocket Session → Capture Selection: lists capturables (evidence: `src/websocket.rs`)
- Capture Selection → Linux Capture: selects backend (evidence: `src/capturable/mod.rs`)
- Capture Selection → X11 Capture: selects backend (evidence: `src/capturable/mod.rs`)
- Capture Selection → CoreGraphics Capture: selects backend (evidence: `src/capturable/mod.rs`)
- Capture Selection → Windows Capture: selects backend (evidence: `src/capturable/mod.rs`)
- WebSocket Session → Input Device Interface: dispatches events (evidence: `src/websocket.rs`)
- Input Device Interface → Linux uinput: implements (evidence: `src/input/uinput_device.rs`)
- Input Device Interface → Desktop Input: implements (evidence: `src/input/autopilot_device.rs`)
- Input Device Interface → Windows Input: implements (evidence: `src/input/autopilot_device_win.rs`)
- WebSocket Session → Video Encoder: encodes capture (evidence: `src/websocket.rs`)
- Video Encoder → Native Encoder: calls native encoder (evidence: `src/video.rs`)
- Capture Selection → Video Encoder: provides frames (evidence: `src/capturable/mod.rs`)
