Skip to content

theunschut/ProffieOS-Workbench

 
 

Repository files navigation

ProffieOS Workbench

A web-based remote control for ProffieOS lightsabers, connecting over Web Bluetooth or WebUSB directly from your browser.

Forked from profezzorn/lightsaber-web-bluetooth. The original single-file app is preserved in old/.

Features

  • Connect via BLE (multiple UART profiles supported) or WebUSB
  • Reconnect to previously authorized known devices (BLE/USB)
  • Browse and activate presets
  • Play tracks from the SD card
  • Send control commands (on/off, clash, blast, force, lockup, drag, melt, stab, lightning)
  • Edit presets: name, font, track, blade styles (with color/int argument editors), variation
  • Settings: brightness, clash threshold, blade length, gesture ignition options
  • Auto-reconnect on disconnect (BLE and USB)
  • Toast notifications for errors
  • PWA — installable, works offline after first load

Requirements

  • A Chromium-based browser (Chrome, Edge) — required for Web Bluetooth / WebUSB
  • A ProffieOS-based saber with BLE or USB connectivity

Tech Stack

  • Blazor WebAssembly (.NET 10)
  • MudBlazor component library (dark theme)
  • Lightweight JavaScript interop over browser BLE/USB APIs, with connection resilience and diagnostics

Running locally

dotnet run --project ProffieOS.Workbench

Then open the URL printed by dotnet run (default launch profile uses https://localhost:7054 and http://localhost:5135).

Deployment

GitHub Pages

Merging to master automatically builds and deploys via GitHub Actions.

Docker

docker compose up --build

Runs on port 8080. Set BASE_PATH in docker-compose.yml if serving from a sub-path.

About

Web-bluetooth experimentation.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 47.2%
  • C# 30.0%
  • JavaScript 11.7%
  • CSS 10.5%
  • Dockerfile 0.6%