regain documentation

Install & upgrade

Choose the package for your imaging application, then keep your saved equipment profiles when upgrading.

Choose a package

Download regain 0.5.11.0 from the release page, or install the NINA plugin from its registry. The 0.6 Hub preview is separate.

Windows release executables use the StackFoundry LLC signing certificate. PulsarFab is the product name. Ordinary CI artifacts and local builds are unsigned.

Windows requirements

• NINA: Windows x64 and NINA 3.2.0.9001 or later.
• Native ASCOM: Windows 10 or later, x64, .NET Framework 4.8, and ASCOM Platform. Both 32-bit and 64-bit clients are supported.
• Published 0.5.11 packages: install the Microsoft Visual C++ v14 x64 Redistributable if Windows reports a missing VCRUNTIME140.dll. Current main and release/0.5 source builds statically link this runtime; that fix ships in the next release.
• Cameras: install the ZWO Windows camera driver, including for Direct USB mode.
• ETA M54: CH340 serial driver, selected by port; setup and current validation limits.
• CAA, EFW, EAF: Windows’ built-in HID driver. FocusCube3, Falcon V2 and OFP2: built-in USB Serial Device driver. Do not replace these with WinUSB/Zadig.

Upgrade from ZWOgain

The plugin GUID, saved NINA equipment IDs, and ASCOM COM identities remain unchanged. Updating through the shared NINA registry keeps the same plugin entry.

1. Close NINA and other device-control applications. Stop manually launched old Alpaca servers.
2. For a manual NINA upgrade, remove the old ZWOgain plugin folder before extracting the new package to %LOCALAPPDATA%\NINA\Plugins\3.0.0\Regain. Do not load both plugin DLLs.
3. For ASCOM, run the newer installer. It detects busy files and removes obsolete binaries after a successful installation.
4. Existing settings copy from %LOCALAPPDATA%\ZwoGain to %LOCALAPPDATA%\Regain when needed. Existing regain settings are never overwritten; the old files remain.

Selections are independent between native NINA, native ASCOM, and Alpaca. See settings locations before changing or removing profiles. ASCOM uninstall preserves settings and logs.

Build the stable source

The tagged source matches the published packages and still needs the VC runtime described above. A Windows plugin build needs stable Rust, .NET 8 SDK, and the Visual Studio C++ build tools. In the source checkout:

git clone https://github.com/pulsarfab/regain.git
cd regain
git checkout v0.5.11.0
pwsh ./scripts/build.ps1
pwsh ./scripts/build-ascom.ps1

The first script writes the NINA ZIP; the second writes the portable ASCOM ZIP. For a source-built installer, see the Windows build instructions. Linux and macOS users can build the Rust workspace for Alpaca; see portable setup.