Files
peerspeak/packaging/windows/README.md
T
molluskandClaude Opus 4.8 2a6e6401ad
cargo-deny / cargo-deny (push) Has been cancelled
windows-build / windows-build (push) Has been cancelled
Add Windows installer (Inno Setup) + GUI-subsystem release builds
Package PeerSpeak for Windows as a single self-contained binary. The GUI
icon, notification chimes, and avatar presets are already embedded via
include_bytes!, and the cross-compiled .exe is statically linked (no extra
DLLs), so the installer payload is just peerspeak.exe plus an .ico.

- src/main.rs: set windows_subsystem = "windows" for release builds so the
  GUI launches without a stray console window (debug keeps the console for
  stderr/panics).
- packaging/windows/: Inno Setup script (peerspeak.iss), multi-resolution
  app icon (peerspeak.ico), and a build README. The installer drops a
  Start-menu/desktop shortcut, optionally adds a Windows Firewall allow-rule
  (iroh UDP hole-punching), and provides an uninstaller.
- win-cross-build.sh: promote the cross-build helper from a throwaway to the
  documented installer build step; .gitignore the staged exe + compiled
  setup.exe build artifacts.

Built with Inno Setup 6.7.1 under Wine; binary is unsigned (SmartScreen will
warn until code-signed).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-20 16:27:03 -04:00

2.7 KiB

PeerSpeak — Windows installer

This directory builds a Windows setup installer for PeerSpeak using Inno Setup.

PeerSpeak ships as a single self-contained peerspeak.exe — the GUI icon, notification chimes, and avatar presets are all embedded in the binary (include_bytes!), and the executable is statically linked against the GNU runtime, so there are no extra DLLs to bundle. The installer payload is just the .exe plus an .ico for the Start-menu / desktop shortcuts.

Files

File Tracked Purpose
peerspeak.iss yes Inno Setup script
peerspeak.ico yes multi-resolution app icon (from assets/icons/*.png)
README.md yes this file
peerspeak.exe no (gitignored) staged build artifact, copied from target/x86_64-pc-windows-gnu/release/
output/peerspeak-<ver>-setup.exe no (gitignored) the compiled installer

Build steps

  1. Cross-compile the Windows binary (from the repo root, inside the peerspeak-win archlinux distrobox):

    RUSTC_BOOTSTRAP=1 ./win-cross-build.sh -Z build-std=std,panic_abort
    

    This needs the rust-src component and the x86_64-pc-windows-gnu target installed in that toolchain. The result is a statically-linked, GUI-subsystem .exe (no stray console window).

  2. Stage the binary next to the script:

    cp target/x86_64-pc-windows-gnu/release/peerspeak.exe packaging/windows/
    
  3. Regenerate the icon if the source PNGs changed:

    magick assets/icons/peerspeak-16.png assets/icons/peerspeak-24.png \
           assets/icons/peerspeak-32.png assets/icons/peerspeak-48.png \
           assets/icons/peerspeak-64.png assets/icons/peerspeak-128.png \
           assets/icons/peerspeak-256.png packaging/windows/peerspeak.ico
    
  4. Compile the installer with Inno Setup. On Linux this runs under Wine:

    cd packaging/windows
    wine ~/.wine/drive_c/InnoSetup6/ISCC.exe peerspeak.iss
    

    The installer lands at output/peerspeak-<version>-setup.exe.

What the installer does

  • Installs peerspeak.exe to Program Files\PeerSpeak (requires admin / one UAC prompt).
  • Creates a Start-menu shortcut, with an optional desktop shortcut.
  • Optionally adds a Windows Firewall allow-rule for PeerSpeak (recommended — iroh uses UDP hole-punching, so this avoids a mid-call firewall prompt). The rule is removed on uninstall.
  • Provides a standard uninstaller.

Note: the installer and the binary are not code-signed, so Windows SmartScreen will show an "unknown publisher" warning on first run. The user clicks More info → Run anyway. Removing this warning requires a paid code-signing certificate.