FAQ

KyberStation is a visual editor for designing lightsaber blade styles. You arrange colors, ignition animations, and combat effects in the browser, preview them on a real-time simulator, and export ProffieOS-compatible C++ code that drops into your Proffieboard config.

Think of it like a DAW for sabers — but for v1.0 we ship the design half. The flash half (web-based programming) is experimental; the canonical workflow is arduino-cli + dfu-util.

To design: no. KyberStation runs in any modern desktop browser. You can install it as a PWA from your browser's menu for offline editing.

To flash a real saber: yes — you'll need arduino-cli, the Proffieboard board manager, and dfu-util. Full setup is documented in the Flash Guide.

The Proffieboard is a hobbyist-favorite STM32-based saber controller designed by Fredrik Hübinette. It runs ProffieOS, the open-source firmware that interprets the C++ blade-style templates KyberStation generates.

You don't need one to use the editor — the visualizer and codegen all work without hardware. But the generated config only flashes onto Proffieboards (V2 or V3.9). KyberStation is unaffiliated with the Proffieboard project; we just emit valid templates for it.

The browser-based flasher (WebUSB + DFU) works fine on stock boards, but vendor-customized Proffieboards (89sabers, KR Sabers, Saberbay, Vader's Vault, etc.) sometimes ship with non-standard Option Bytes or custom bootloaders that break the WebUSB manifest phase.

For v1.0 we kept the WebUSB path behind a 3-checkbox disclaimer (responsibility / firmware backup / recovery procedure) and recommend dfu-util as the reliable path. The Flash Guide walks through the safe workflow start to finish.

Safari on macOS works for design and codegen. Some bloom effects render slightly differently than on Chromium-based browsers; that's tracked as a known issue.

On iOS — partially. The editor renders, but Apple's policy disallows USB I/O on iOS browsers, so flashing won't work. Mobile Safari is best used as a read-only preview surface or for the Kyber Code share-link receiving end.

No. KyberStation is a fan-made hobby project, unaffiliated with Lucasfilm Ltd., The Walt Disney Company, the ProffieOS project, the Proffieboard project, or any saber vendor.

ProffieOS template reference material is GPL-3.0 and ships as an aggregate work under those terms. KyberStation source is MIT-licensed. “Lightsaber” is a registered trademark of Lucasfilm Ltd.

In your browser. KyberStation has no backend, no login, and no analytics. Saved presets, profiles, and card queues persist in IndexedDB. Layout and theme preferences live in localStorage. Sound fonts you import stay on your machine.

The only network calls the app makes are static asset loads (fonts, scripts, images). Your saber designs are never transmitted anywhere unless you explicitly export them or share a Kyber Code URL.

Yes — every design encodes as a Kyber Code: a short base58 fragment that round-trips your full BladeConfig. Click the share button in the editor header and the URL pattern ?s=<glyph> gets copied to your clipboard. Recipients open it and load your exact design.

Typical glyphs are ~18–130 characters. The same payload can render as a 3D Kyber Crystal in the My Crystal panel.

KyberStation auto-detects the standard Proffie and CFX font folder layouts. Use the file picker in the AUDIO section to point the app at your local font library; events get recognized across 12 modern Proffie sound categories.

The SmoothSwing engine simulates V1 + V2 hum/swing crossfades in the browser so you can preview pairs before flashing. Brave users may need to enable the file-system-access-api flag at brave://flags/ the first time.

If you took the firmware backup step recommended in the Flash Guide, recovery is a 30-second dfu-util --download backup.bin away. Hold BOOT → tap RESET → release BOOT to enter DFU mode, then re-flash.

If you didn't back up first: the recovery path depends on your specific board. For most stock boards, re-flashing a standard ProffieOS image will recover them. Vendor-customized boards may need an ST-Link adapter and STM32CubeProgrammer. The Flash Guide's recovery section covers both paths.

Yes — KyberStation is a PWA. Install it via your browser's menu (“Install app” / “Add to dock”) and it works offline. The service worker caches the editor shell + all engine code; presets and assets are pre-bundled.

The codegen + simulator run entirely client-side, so designing on a flight with no network is fully supported.

Open an issue on GitHub. Bug reports, feature requests, and preset requests all use dedicated templates.

For v1.0 we don't accept outside pull requests yet — that policy gets revisited 30 days post-launch. Issues and feedback are very welcome in the meantime.

Yes. MIT-licensed source, no ads, no paywalls, no telemetry, no “pro tier.” Use it, fork it, mod it; the only ask is that you respect the GPL-3.0 boundary on the bundled ProffieOS reference material.