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:
- in the web UI: Deploy → Build installers
- or from the command line:
make windows
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.