Website: lumasync.app
LumaSync is a native desktop app that mirrors your screen to WS2812B LED strips and Philips Hue entertainment areas in real time. A single calibrated room map drives per-edge LED layouts and Hue channel placement; all processing stays on your machine — no cloud, no telemetry.
It combines a React + TypeScript frontend with a Rust/Tauri runtime to keep the UI responsive while handling native desktop behavior.
Compact tray-sized mode (320×480) and full workspace mode (900×620) — amber Rev 07 design language, same state shared across both layouts.
- Ambilight: real-time screen capture drives LED strips and/or Hue lights simultaneously, with per-LED edge sampling anchored to the room map
- Philips Hue: DTLS 1.2 PSK entertainment streaming, channel position editor, zone auto-derivation from room map
- Room map editor: drag-and-drop canvas with furniture, TV anchor, and USB strip objects; Hue channels overlaid on normalized coordinates
- Multi-monitor capture: pick which display feeds the lights; hot-plug and resolution changes are handled without restart
- Color correction: per-channel R/G/B gamma, Kelvin white-balance, and saturation trim — tuned once per strip, persisted per layout
- Solid color: RGB + brightness push to USB and Hue with debounced 50 ms update
- LED calibration: edge counts, gap, corner ownership, start anchor, direction — persisted per layout
- Firmware profiles: LumaSync-native framing out of the box; Adalight profile for off-the-shelf microcontrollers
- Target-aware pipeline: choose USB, Hue, or both per mode; hot-plug detection with suggestion banner
- Compact, stays out of your way: lives in the tray; opens as a 320×480 panel for quick scene changes or a 900×620 full view for calibration, on demand
- Runtime HUD: StatusBar pill surfaces live FPS and end-to-end latency with green/amber/red thresholds
- Native notifications: OS-level toast for connection, stream, and update events; permission banner asks once and never re-prompts
- Resilient shell: global error boundary catches render faults and offers a localized restart/logs card instead of a white-screened tray window
- Auto-updater: GitHub Releases with minisign signature verification
- Frontend: Vite, React 19, TypeScript (strict), Tailwind CSS
- Desktop runtime: Tauri v2, Rust
- Testing: Vitest + Testing Library, Cargo test
- Package manager: pnpm
Microcontrollers using the following USB-to-serial chips are supported:
| Chip | USB ID |
|---|---|
| CH340 | 1A86:7523 |
| FTDI FT232 | 0403:6001 |
| CP2102 (Silicon Labs) | 10C4:EA60 |
| Arduino Uno R3 | 2341:0043 |
| Arduino Uno (original) | 2341:0001 |
Baud rate: 115200. LumaSync ships with two firmware profiles:
- LumaSync-native (default):
0xAA 0x55header, LE LED count, gamma-corrected RGB triplets, XOR checksum. A matching firmware sketch ships with the companion hardware repo. - Adalight: the widely-used
"Ada"header format, compatible with off-the-shelf WS2812B controllers and existing Adalight firmware builds.
Profile is selected per device in the Devices section.
- Hue Bridge (gen 2+) on the local network
- At least one configured Entertainment Area in the Hue app
- macOS only:
macos-private-apiis required for fullscreen calibration overlays — the app requests this automatically
| Platform | Status | Notes |
|---|---|---|
| macOS | Full support | Primary development target. macos-private-api enabled for fullscreen overlays. |
| Windows | Full support | USB and Hue features work. Windows Graphics Capture powers the capture pipeline. |
| Linux | Planned (v1.5) | Not shipped in v1.4. Targeted for the next release; requires GTK 3, WebKitGTK 4.1, and libudev. |
- Node.js 20+
- pnpm 10+
- Rust toolchain (stable)
- Tauri platform prerequisites for your OS
pnpm installpnpm tauri devpnpm tauri buildpnpm dev: run web-only Vite dev serverpnpm tauri dev: run desktop app in development modepnpm typecheck: run TypeScript type checks (no emit)pnpm lint: alias for typecheckpnpm vitest run: run frontend unit tests oncepnpm vitest: run frontend tests in watch modepnpm verify:shell-contracts: validate Rust command handlers match frontend contract definitionspnpm check:rust: run Rustcargo checkpnpm check:all: run JS + Rust + shell contract checks together
src/: React application and feature modulessrc/shared/contracts/: cross-layer contract definitionssrc-tauri/src/commands/: Rust Tauri command handlersdocs/: debugging and manual operational docs
- Debugging guide:
docs/debugging.md - Contributing guide:
CONTRIBUTING.md - Code of Conduct:
CODE_OF_CONDUCT.md - Security policy:
SECURITY.md - Support guide:
SUPPORT.md - Changelog:
CHANGELOG.md
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
If you discover a security issue, please follow the process in SECURITY.md.
MIT © 2026 voyvodka