Installing Nimble Viewer on Windows
====================================

1. Double-click "Nimble Viewer Setup <version>.exe".

2. The first time you run an unsigned installer, Windows SmartScreen
   will show a blue dialog:

       "Windows protected your PC
        Microsoft Defender SmartScreen prevented an unrecognized
        app from starting..."

   This appears because Nimble Viewer is a free app and is not
   distributed with a paid Windows code-signing certificate.
   The installer is safe.

   To proceed:

     a. Click the "More info" link in the dialog.
     b. A new "Run anyway" button appears at the bottom.
     c. Click "Run anyway".

3. Follow the installer wizard. The default install location is
   %LOCALAPPDATA%\Nimble Viewer\ and no administrator rights are
   required.

4. After installation, launch Nimble Viewer from the Start Menu
   or pin it to your taskbar.

Uninstalling
------------

Open Settings -> Apps -> Installed apps, find "Nimble Viewer",
click the "..." menu and choose Uninstall. Or use the
"Uninstall Nimble Viewer" shortcut in the Start Menu.

Why the SmartScreen warning appears
-----------------------------------

Windows attaches a "Mark of the Web" tag to executables downloaded
from the internet. SmartScreen blocks any unrecognized executable
unless it has either an Extended Validation code-signing certificate
(several hundred dollars per year) or has built up enough download
reputation across many users. Nimble Viewer is free and open, so it
ships unsigned. Clicking "Run anyway" once tells Windows to trust it.

System requirements
-------------------

  - Windows 10 (64-bit) or Windows 11
  - x64 (Intel/AMD) processor; Windows-on-ARM is not currently supported

Troubleshooting
---------------

Windows Defender or your antivirus removes / quarantines the installer
or "Nimble Viewer.exe".

  Compiled Python apps (built with Nuitka) can occasionally be flagged
  as suspicious because they look like packed binaries — the same
  shape commonly used by malware. Nimble Viewer is safe. To restore
  the file:

    1. Open Windows Security -> Virus & threat protection.
    2. Click "Protection history".
    3. Find the Nimble Viewer entry, click it, and choose
       "Actions -> Allow on device".
    4. Re-run the installer.

  If a third-party antivirus removed the file, look in its
  quarantine/history and choose "Restore" or "Add exception" for
  Nimble Viewer.

"VCRUNTIME140.dll was not found" or similar missing-DLL error.

  Install the Microsoft Visual C++ Redistributable (x64) from:

      https://aka.ms/vs/17/release/vc_redist.x64.exe

  Then launch Nimble Viewer again.

Installer says "This app can't run on your PC".

  You're likely on an ARM-based Windows device or a 32-bit version of
  Windows. Nimble Viewer requires 64-bit x64 Windows 10 or newer.