Architecture
OpenLogi is several pieces:
- OpenLogi GUI — a GPUI desktop app (macOS + Linux; Windows preview) with the device carousel, mouse diagram, and action picker.
- OpenLogi agent —
openlogi-agent, the background process that owns device I/O and the input hook; the GUI talks to it over local IPC. - OpenLogi CLI —
openlogi, for headless inventory, asset-sync, and diagnostics. hidppcrate — the HID++ protocol implementation that talks to devices.- assets.openlogi.org — a static host
(Cloudflare R2) serving per-device renders and clickable-hotspot metadata,
keyed by each device’s
modelId.
Button presses are remapped through the OS hook — a CGEventTap on macOS,
evdev/uinput on Linux, WH_MOUSE_LL on Windows; DPI and SmartShift changes are
written straight to the device over HID++. Configuration is a plain TOML file —
no cloud, no account.
Expanded architecture notes coming soon.
Last updated on