# Resonator (共鸣者)

> A browser controller for Wuthering Waves concert lightsticks, made by CloudyMoonShape. It supports colors, brightness, native effects, extended effects and music sync. The interface supports Chinese, English and Japanese.

Use a Web Bluetooth browser for hardware control. iPhone Safari and Chrome do not connect directly; the illustrated guide uses Bluefy. Replace depleted batteries before retrying a failed connection. Device commands and audio processing run locally; the optional visitor counter uses a server endpoint. Native effects execute on the lightstick. Extended effects send browser-generated commands.

Research findings apply to the documented sample, not every lightstick or firmware. Venue radio findings are static analysis, not a verified venue-control product. The source-available license permits free development and sharing but restricts sales, paid hosting and commercial bundles. Public source does not mean an unrestricted open-source license. Third-party artwork retains separate rights.

## Start here

- [English controller](https://wuwa.south-wall.com/en/index.md): Text version of the controller and connection instructions.
- [中文控制页](https://wuwa.south-wall.com/zh/index.md): 中文说明。
- [日本語コントローラー](https://wuwa.south-wall.com/ja/index.md): 日本語の説明。
- [How it works](https://wuwa.south-wall.com/en/principles.md): Hardware, Bluetooth and research boundaries.
- [iPhone / Bluefy guide](https://wuwa.south-wall.com/reference/ios.md): Connection steps and battery troubleshooting.

## Development and evidence

- [JavaScript SDK](https://wuwa.south-wall.com/reference/sdk.md): Client API and browser support.
- [Protocol](https://wuwa.south-wall.com/reference/protocol.md): Observed commands and evidence limits.
- [Native effects](https://wuwa.south-wall.com/reference/native-effects.md): Firmware effects and distinctions from browser effects.
- [Function reference](https://wuwa.south-wall.com/reference/functions.md): Findings for developers.
- [Full text](https://wuwa.south-wall.com/llms-full.txt): Combined text from these public references.
- [Source repository](https://github.com/CloudyMoonShape/wuwa-lightstick): Maintained source and complete documentation.
- [License](https://wuwa.south-wall.com/LICENSE.txt): Authoritative use restrictions.