Installing Hoard

Hoard is an app for Windows, macOS and Linux (a Flatpak). It also runs from source on all three.

Windows

1. Download Hoard-Setup-<version>.exe from the latest release and run it. It installs for you only, with no administrator prompt, into %LOCALAPPDATA%\Programs\Hoard, and adds Hoard to the Start menu (a desktop icon is optional). The folder can't be changed: it's one only your account can change, which keeps your store sign-ins safe. (Hoard installed somewhere else by an older setup is installed here when it updates; the old folder can then be deleted.)
2. Windows may say "Windows protected your PC" for a while after a release. Hoard is code-signed: choose More info and the publisher shows as Hoard's maintainer. A new publisher earns Microsoft's trust as people install it, so the warning fades with time. Choose Run anyway. To be sure the file is genuine first, see Checking a download.
3. Open Hoard from the Start menu. It opens in its own window, and a short setup assistant walks you through the rest: see Getting started.

Closing the window quits Hoard. While it's downloading, it asks first: stop and close, keep going in the background, or close at once (a download stopped part way carries on from where it was next time).

Prefer no installer? Hoard-<version>-windows.zip is the same app. Extract it anywhere of your own (a folder in your user folder is best) and run Hoard.exe.

Hoard's window uses Microsoft Edge WebView2, which is part of Windows 11 and kept up to date on Windows 10. Without it, Hoard says so and opens in your web browser instead; quit it from Settings, then Quit Hoard.

Updating

In Settings, under Updates, choose Check now. When there's a newer version, Update to it: Hoard downloads its installer from the release on GitHub, checks it, closes (a download in progress resumes next time), installs it and opens again. It only runs an installer whose SHA-256 matches both the release's SHA256SUMS-windows.txt and the checksum GitHub lists for the file; one that doesn't is deleted. Hoard won't update in the middle of a refresh or download: wait for it, or Stop it.

Check for updates automatically (off unless you turn it on) makes Hoard ask GitHub once a day, when it starts; a newer version then shows as Update to at the bottom of the page. A check sends GitHub nothing but the request itself: see Security and privacy.

Hoard installs updates itself only when it was installed with Hoard-Setup. The portable zip, the Mac app, the Flatpak and Hoard run with Python say there's a newer version, which file to get, and link to it. You can always run the newer setup yourself too. There's no need to uninstall first, and an update replaces the program files completely, so nothing from the old version lingers.

Your settings, library, sign-ins and tags live in Hoard's app-data folder (%LOCALAPPDATA%\Hoard) and your files in your downloads folder, so installing, updating and uninstalling never touch them.

Uninstalling

Use Settings › Apps in Windows, like any other app. That removes the program only. To remove everything Hoard keeps, see Where Hoard keeps things.

Checking a download

Every release is built by GitHub Actions straight from this repository, with a signed record of how it was built. With the GitHub CLI:

gh attestation verify Hoard-Setup-<version>.exe -R Soloflighter1010/Hoard-Asset-Manager

The same works for every file on a release (Hoard-<version>-macos-apple-silicon.pkg, Hoard-<version>-linux-x86_64.flatpak, and so on).

Each release also lists checksums: SHA256SUMS-windows.txt for the installer and the Windows zip, SHA256SUMS-macos-apple-silicon.txt and SHA256SUMS-macos-intel.txt for the Mac packages, SHA256SUMS-linux.txt for the Flatpak, and SHA256SUMS.txt for the source zip. In PowerShell, Get-FileHash .\Hoard-Setup-<version>.exe prints the one to compare; on a Mac, shasum -a 256 <file>; on Linux, sha256sum <file>.

Every file is also scanned by VirusTotal before a release is published: the release notes link each file's report. Hoard's Mac packages aren't signed by Apple, and a newly signed program has little reputation yet, so an engine or two may occasionally flag one by mistake; the report shows which, and each release is checked by hand before it's published anyway.

macOS

Hoard runs on macOS 11 (Big Sur) or newer.

1. Download the package for your Mac from the latest release: Hoard-<version>-macos-apple-silicon.pkg for a Mac with an M-series chip, or Hoard-<version>-macos-intel.pkg for an Intel Mac. (Apple menu › About This Mac says which: "Chip Apple M…" or "Processor … Intel".)
2. Open it. Hoard isn't signed by Apple yet (that costs money every year), so macOS says it can't be opened or can't check it for malicious software. Choose Done (not Move to Trash), then open System Settings › Privacy & Security, scroll down to the message about the Hoard package and choose Open Anyway. To be sure the file is genuine first, see Checking a download.
3. The installer puts Hoard in Applications (it asks for your Mac's password, as any app installed for every account does). Open it from Applications or Launchpad. It opens in its own window, and a short setup assistant walks you through the rest: see Getting started.

The first time Hoard's browser signs in to a store, macOS asks whether it may use the Keychain. Choose Always Allow. Hoard's browser (Chromium, about 150 MB) is downloaded once, into ~/Library/Caches/ms-playwright.

Updating: when Settings › Updates says there's a newer version, download that version's package and open it, as above; it replaces the old Hoard. Uninstalling: drag Hoard from Applications to the Trash. Your settings, library, sign-ins and tags are in ~/Library/Application Support/Hoard, and stay unless you delete them (see Where Hoard keeps things).

Linux (Flatpak)

Hoard for Linux is a Flatpak, for x86_64 (Intel and AMD) computers. Most desktop Linux systems have Flatpak already; if yours doesn't, see flatpak.org/setup.

1. Download Hoard-<version>-linux-x86_64.flatpak from the latest release.

2. Open it with your software centre (GNOME Software, KDE Discover), or install it from a terminal:

   flatpak install --user Hoard-<version>-linux-x86_64.flatpak
   

   Hoard runs on the GNOME runtime, which Flatpak gets from Flathub. If it says it can't find org.gnome.Platform, add Flathub once and try again: flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo

3. Open Hoard from your applications menu (or flatpak run io.github.soloflighter1010.Hoard). It opens in its own window, and a short setup assistant walks you through the rest: see Getting started.

The Flatpak may use the network, show its window, your keyring (for your sign-ins: GNOME Keyring, KeePassXC with its Secret Service turned on, or KWallet) and your home folder and removable drives (for your downloads folder), and nothing else. It keeps its settings, library, sign-ins and tags in ~/.local/share/Hoard, like every Linux Hoard, so a library from Hoard run from source carries over and Hoard for Unity finds it. Hoard's browser (Chromium, about 150 MB) is downloaded once, into ~/.var/app/io.github.soloflighter1010.Hoard/cache.

Updating: when Settings › Updates says there's a newer version, download that version's .flatpak and install it as above; it replaces the old one. Uninstalling: flatpak uninstall io.github.soloflighter1010.Hoard (or your software centre). That leaves your settings and library; see Where Hoard keeps things to remove those too.

From source (Windows, macOS, Linux)

1. Install Python 3.10 or newer.
2. Download Hoard-<version>.zip from the latest release and extract it somewhere of your own.
3. Run Hoard.bat (Windows) or ./run.sh (macOS and Linux).

The first run sets up a private Python environment in that folder, checking every package against a fingerprint recorded in advance, so a tampered package won't install. On Windows, setup also makes the folder changeable only by your account.

From source, Hoard opens in your web browser rather than its own window. Quit it from Settings, then Quit Hoard, or just close its pages: it stops by itself a few minutes after the last one closes.

Store sign-ins use Microsoft Edge on Windows, and Hoard's own browser elsewhere or without Edge: a copy of Chromium at a fixed version, about 150 MB, downloaded once.

• macOS asks once whether Hoard's browser may use the Keychain. Choose Always Allow.
• Linux needs a keyring to protect your sign-ins: GNOME Keyring, KeePassXC with its Secret Service turned on, or KWallet. See Stores for computers without a desktop. If the browser won't start, run .venv/bin/python -m playwright install-deps chromium in Hoard's folder.

Coming from Hoard 1.x

Your sign-ins and tags carry over by themselves. The setup assistant's Used Hoard before? step brings over your library list and downloads folder: choose the folder you ran 1.x from. From the command line, that's hoard-cli migrate <folder>.