# Installation & Paketmanager-Guide für Sanctum 🛡️

Sanctum kann auf verschiedene Arten unter Windows 10/11 installiert und verwaltet werden. Es sind **keine Administratorrechte** erforderlich.

---

## 🚀 1. Installation via Scoop (Empfohlen für Entwickler)

Wenn du den Windows-Paketmanager [Scoop](https://scoop.sh/) nutzt, kannst du Sanctum direkt über das bereitgestellte Manifest installieren:

```powershell
# Direkt über die URL des Manifests installieren:
scoop install https://gitea.pansi.eu/harald/sanctum/raw/branch/main/packages/scoop/sanctum.json
```

Oder falls du ein lokales Repository geklont hast:

```powershell
scoop install .\packages\scoop\sanctum.json
```

Nach der Installation ist der Befehl `sanctum` sofort global in deiner PowerShell verfügbar.

---

## 🪟 2. Installation via Windows Package Manager (Winget)

Sanctum verfügt über ein standardkonformes Winget-Manifest (Schema 1.6.0).

### Lokale Installation via Manifest:
```powershell
winget install --manifest .\packages\winget\HaraldPansi.Sanctum.yaml
```

Winget entpackt das portable Binary automatisch in das Benutzer-Anwendungsverzeichnis und verknüpft das Alias `sanctum`.

---

## 📦 3. Manuelle Installation (Standalone Portable)

1. Lade das aktuelle Release-Paket herunter:
   * **URL:** [https://gitea.pansi.eu/harald/sanctum/releases/tag/v0.4.0](https://gitea.pansi.eu/harald/sanctum/releases/tag/v0.4.0)
   * **Datei:** `sanctum-v0.4.0-windows-x86_64.zip`
2. Entpacke das Archiv in ein Verzeichnis deiner Wahl (z. B. `C:\Tools\Sanctum\`).
3. *(Optional)* Registriere das Windows Explorer Rechtsklick-Kontextmenü:
   ```powershell
   .\sanctum.exe register
   ```
   *(Erlaubt das Einhängen per Rechtsklick "In Sanctum öffnen" ohne Adminrechte).*

---

## 🐧 4. Installation unter Linux (x86_64)

Sanctum wird für Linux als **100 % statisches Single-Binary** (`x86_64-unknown-linux-musl`) ohne jegliche GLIBC- oder Bibliotheksabhängigkeiten bereitgestellt. Es läuft direkt auf Ubuntu, Debian, Alpine, Arch, Fedora und weiteren Distributionen:

1. Lade das Linux-Release herunter und installiere es:
   ```bash
   curl -LO https://gitea.pansi.eu/harald/sanctum/releases/download/v0.4.0/sanctum-v0.4.0-linux-x86_64.tar.gz
   tar -xzf sanctum-v0.4.0-linux-x86_64.tar.gz
   chmod +x sanctum
   sudo install -m 755 sanctum /usr/local/bin/sanctum
   ```
2. *(Optional)* Freedesktop-Integration einrichten (Doppelklick in GNOME / KDE / Thunar):
   ```bash
   sanctum register
   ```
   *Richtet die `.desktop`-Datei und den MIME-Typ `application/x-sanctum` im Userland (`~/.local/share`) ein.*

---

## 🔄 Updates

* **Scoop:**
  ```powershell
  scoop update sanctum
  ```
* **Winget:**
  ```powershell
  winget upgrade --manifest .\packages\winget\HaraldPansi.Sanctum.yaml
  ```

---

## 🗑️ Deinstallation

* **Scoop:**
  ```powershell
  scoop uninstall sanctum
  ```
* **Explorer-Kontextmenü rückstandslos bereinigen:**
  ```powershell
  sanctum.exe unregister
  ```