SPEEDBIRD

Building the Windows installer#

The Windows installer SPEEDBIRD-Setup-<version>.exe is normally built on a SPEEDBIRD Linux node itself, using pynsist and NSIS with the Python 3.12 embeddable runtime:

The Windows build kit (a source .zip) is the fallback for building it elsewhere.

Option A: Linux or macOS with NSIS#

You need NSIS and Python 3.11 or newer.

sudo apt install nsis            # macOS: brew install makensis
python3 -m venv .venv
.venv/bin/pip install pynsist
.venv/bin/python packaging/windows/build_nsis.py --out dist

Output: dist/SPEEDBIRD-Setup-<version>.exe

Option B: a Windows 10/11 x64 PC#

This builds a frozen PyInstaller app with the legacy Inno Setup script (packaging\windows\speedbird.iss).

winget install Python.Python.3.12
winget install JRSoftware.InnoSetup
powershell -ExecutionPolicy Bypass -File packaging\windows\build_windows.ps1

Add -SkipTests to skip the test run.

Output: packaging\windows\Output\SPEEDBIRD-Setup-<version>.exe

The Windows guide describes each build step.

Code signing (optional)#

Without a signature, Windows SmartScreen warns about an unknown publisher.

On Windows:

signtool sign /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 /a SPEEDBIRD-Setup-*.exe

On Linux:

osslsigncode sign -pkcs12 cert.pfx -t http://timestamp.digicert.com -in in.exe -out out.exe

Publish it#

Upload the .exe on the SPEEDBIRD Deploy page (Upload a Windows installer) to offer it for download from your node. To publish it on speedbird.io, place it in the site's downloads folder and rebuild.