rotator

[accius]

@Delerius, i am not sure how the rotator function is supposed to work. I merged it to main, but i see no way of setting it up or using it (it does not seem to work properly.) can you give this a look?

Originally posted by @accius in #405 (comment)

[accius]

@Delerius this merge caused a crash due to being available to the website while only usable as a locally hosted feature. When looking into this and further updates please keep in mind that thousands of users do not local host this project.

[Delerius]

Thanks for flagging this.
The rotator panel is intended for locally hosted setups and requires a local HTTP bridge (e.g. PstRotatorAz or ERC-M).

I see now that the current implementation doesn’t fully guard against hosted deployments where no local endpoint exists.

I’ll update it so that:
• The rotator panel is disabled by default
• It only initializes when explicitly configured
• It fails gracefully without affecting hosted users

Appreciate you catching this — I’ll push a fix shortly.

[Delerius]

Hi @accius — thanks for flagging this.

You were absolutely right — the original merge did not make the setup path clear, and on hosted deployments there was no indication that Rotator is a local-only feature.

Rotator is intentionally local-only because it interfaces with hardware (e.g., PstRotatorAz via LAN HTTP). The hosted site cannot safely access or proxy arbitrary local network devices, so the feature must run where the rotator hardware exists.

This PR ( #446 ) addresses that:

• Rotator is now explicitly marked as Local-only under Settings → Integrations
• Automatically disabled on the hosted site
• No backend calls are attempted unless explicitly enabled
• Added inline Quick Start instructions
• Prevented runtime errors when backend is unavailable
• Hosted deployments remain stable and error-free

To use Rotator locally:

Run OpenHamClock via the local Node server

Configure the PstRotatorAz HTTP endpoint in .env

Enable Rotator in Settings → Integrations

Add the Rotator panel via the “+” tab button

Hosted installations will not show or activate Rotator functionality by design.

I also aligned the N3FJP integration with the same local-only pattern to prevent similar confusion.

Happy to refine further if needed.