Snug by CrafterD - version 1.0.0
====================================

From photos of your tools on an A4 sheet to 3D-printable pockets that fill a drawer.


WHAT IS IN THIS ZIP
-------------------
  Snug\Snug.exe          the app (keep it inside its Snug folder: the other files there are what it runs on)
  Snug-guide.pdf         the user guide, with screenshots
  README.txt             this file
  CHANGELOG.txt          what is new in each version
  LICENSE.txt            the licence of Snug
  THIRD-PARTY-NOTICES.txt  the components Snug ships and their licences


START
-----
1. Extract the whole zip into a folder of your choice (right-click > Extract All). Do not run it from inside the
   zip: Windows would only extract Snug.exe and the app would not start.
2. Open the Snug folder and double-click Snug.exe.
   Nothing is installed: to remove Snug, delete the folder (and the settings folder below if you wish).
   If Snug says Windows blocked its files: right-click the zip > Properties > tick Unblock > OK, then extract
   it again into a new folder.


WHAT YOU NEED
-------------
  - Windows 10 or 11, 64-bit.
  - Microsoft Edge WebView2 Runtime. It comes with Windows 11 and with up-to-date Windows 10;
    if the window stays empty, install the "Evergreen" runtime from Microsoft's WebView2 page.
  - About 4 GB of memory and 600 MB of free disk space.
  - A phone or camera, an A4 sheet of paper and your tools. A 3D printer for the result.
  Python is not needed: everything Snug runs on is inside the Snug folder.


"WINDOWS PROTECTED YOUR PC"
---------------------------
Snug.exe is not signed with a code-signing certificate, so the first time you run it, Windows SmartScreen shows
"Windows protected your PC" and names the publisher as "Unknown publisher".
If you got the zip from the CrafterD site and its fingerprint matches (below): click "More info", then "Run anyway".
Windows remembers the choice for this copy of Snug.

Some antivirus programs flag apps built with PyInstaller (the tool that packs Snug) by mistake. The fingerprint
tells you whether your copy is the one that was published.


CHECK THE FINGERPRINT (SHA-256)
-------------------------------
The download page gives the SHA-256 of the zip, and the file Snug-1.0.0-windows-x64.zip.sha256 holds it too.
In PowerShell, in the folder where the zip is:

    Get-FileHash .\Snug-1.0.0-windows-x64.zip -Algorithm SHA256

The 64 characters it shows must be the same as the published ones (upper or lower case does not matter).
If they differ, do not run the app: download it again from the CrafterD site.


PRIVACY
-------
Snug works offline. It sends nothing anywhere: no account, no statistics, no update check.
Your photos, projects and exports stay where you save them.
The window talks only to Snug itself, through a private connection inside this computer.
The one exception is the "Support my work" button at the top right: when you click it, your web browser opens
ko-fi.com/crafterd. Snug itself sends nothing, and never opens it on its own.

If Snug helps you, you can support it on Ko-fi: ko-fi.com/crafterd


WHERE SNUG KEEPS ITS SETTINGS
-----------------------------
  %APPDATA%\Snug\settings.json        printer, filament, drawer and display settings
  %APPDATA%\Snug\logs\snug.log       a log, only when Snug is started with --debug
  %LOCALAPPDATA%\Snug\startup-error.log  written only if Snug cannot start
Type %APPDATA%\Snug in the address bar of File Explorer to open the folder. Delete it to start again from the
default settings.


HELP
----
Every control in the app has a tooltip, "Help & shortcuts" in the menu (or the ? key) opens the built-in help,
and Snug-guide.pdf walks through a whole project: photos, outlines, drawer, export.
