Updater & Installer

Installer behavior

The installer adds the app, optional shortcuts, optional startup entry, and Windows uninstall registration.

Updater behavior

The updater checks the official GitHub repository, shows release notes, opens the release page, and requires the detached AmazonMusicRPC_Setup.exe.sha256 asset before automatic installation. Redirect hosts, asset names, sizes, and the downloaded hash are validated.

Official builds

Official artifacts are built only by a manually triggered GitHub Actions workflow from the current release branch. Tests, dependency auditing, a clean frozen build, installer smoke tests, Defender scanning when available, an SBOM, and provenance attestations run before an unpublished draft is created for maintainer review.

Build from source

Windows app source, dependencies, icons, and packaging files are stored in the repository's Windows/ folder. From the repository root, install dependencies and run from source with:

pip install -r Windows/requirements.txt

python Windows/main.py

Build the executable with:

pyinstaller Windows/AmazonMusicRPC.spec --noconfirm --workpath Windows/build --distpath Windows/dist

Build the installer with Inno Setup:

"%LOCALAPPDATA%\Programs\Inno Setup 6\ISCC.exe" Windows\installer.iss

The installer output is written to Windows/installer_output/AmazonMusicRPC_Setup.exe. The helper script Windows\build.bat runs both steps.

Verify an installer

Run this in PowerShell and compare the result with the matching AmazonMusicRPC_Setup.exe.sha256 release asset:

Get-FileHash .\AmazonMusicRPC_Setup.exe -Algorithm SHA256

Uninstall

The installer removes installed files, startup entries, logs, config data, and Amazon Music metadata launcher shortcuts during uninstall.

SmartScreen notes

Windows can warn because the installer is unsigned. Download only from the GitHub release page and verify hashes when possible.