How h-m-h/weylus works
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: mod.rs Capture Selection · websocket.rs WebSocket Session · main.rs Application Entry · device.rs Input Device Interface
Components 21
Control and UI
- Application Entry
src/main.rs - Runtime Config
src/config.rs - Desktop GUI
src/gui.rs - Service Coordinator
src/weylus.rs
Browser Transport
- HTTP Web Server
src/web.rs - WebSocket Session
src/websocket.rs - Browser Client
ts/lib.ts - Message Protocol
src/protocol.rs
Screen Capture
- Capture Selection
src/capturable/mod.rs - Linux Capture
src/capturable/pipewire.rs - X11 Capture
src/capturable/x11.rs - CoreGraphics Capture
src/capturable/core_graphics.rs - Windows Capture
src/capturable/captrs_capture.rs
Host Input
- Input Device Interface
src/input/device.rs - Linux uinput
src/input/uinput_device.rs - Desktop Input
src/input/autopilot_device.rs - Windows Input
src/input/autopilot_device_win.rs
Video Encoding
- Video Encoder
src/video.rs - Native Encoder
lib/encode_video.c
Other components
- Computer Operator
- Tablet Browser
Connections 22
- Computer Operator → Application Entry: starts
Readme.md - Application Entry → Runtime Config: loads
src/main.rs - Application Entry → Desktop GUI: launches
src/main.rs - Desktop GUI → Service Coordinator: starts service
src/gui.rs - Application Entry → Service Coordinator: starts headless
src/main.rs - Service Coordinator → HTTP Web Server: serves
src/weylus.rs - Tablet Browser → HTTP Web Server: opens interface
Readme.md - HTTP Web Server → WebSocket Session: upgrades session
src/web.rs - Browser Client → WebSocket Session: exchanges events
- WebSocket Session → Message Protocol: parses messages
src/websocket.rs - WebSocket Session → Capture Selection: lists capturables
src/websocket.rs - Capture Selection → Linux Capture: selects backend
src/capturable/mod.rs - Capture Selection → X11 Capture: selects backend
src/capturable/mod.rs - Capture Selection → CoreGraphics Capture: selects backend
src/capturable/mod.rs - Capture Selection → Windows Capture: selects backend
src/capturable/mod.rs - WebSocket Session → Input Device Interface: dispatches events
src/websocket.rs - Input Device Interface → Linux uinput: implements
src/input/uinput_device.rs - Input Device Interface → Desktop Input: implements
src/input/autopilot_device.rs - Input Device Interface → Windows Input: implements
src/input/autopilot_device_win.rs - WebSocket Session → Video Encoder: encodes capture
src/websocket.rs - Video Encoder → Native Encoder: calls native encoder
src/video.rs - Capture Selection → Video Encoder: provides frames
src/capturable/mod.rs