Desktop-Installation

Ausführliche Installationsanweisungen für alle Desktop-Plattformen.

Informationen zu Release-Candidate- und Beta-Builds finden Sie unter An den Beta-Kanälen teilnehmen.

---

Linux

Arch Linux (AUR, vorgefertigt)

Am einfachsten installieren Sie Mindwtr auf Arch-basierten Distributionen über das vorgefertigte AUR-Paket:

# Using yay
yay -S mindwtr-bin

# Using paru
paru -S mindwtr-bin

# Using pamac (Manjaro)
pamac install mindwtr-bin

AUR-Paket: mindwtr-bin

Arch Linux (AUR, aus dem Quellcode bauen)

Im AUR gibt es außerdem ein aus dem Quellcode gebautes Paket namens mindwtr. Es wird von der Community gepflegt, nicht vom Mindwtr-Projekt, und ist nicht Teil des Mindwtr-Release-Prozesses. Verwenden Sie mindwtr-bin, sofern Sie nicht lokal bauen müssen.

Offizielle AUR-Pakete prüfen

Mindwtr veröffentlicht zwei aktuelle AUR-Paketnamen: mindwtr-bin (vorgefertigte stabile Version) und mindwtr-beta-bin (Vorabversion). Ein dritter Name, mindwtr-bin-beta, ist die frühere Beta-Kennung; er wird während der laufenden Umbenennung weiterhin aus denselben signierten Release-Artefakten aktualisiert. Die Paketquelle muss auf github.com/dongdongbh/Mindwtr verweisen, und der Maintainer muss dongdongbh sein. Prüfen Sie jede Änderung an PKGBUILD und .SRCINFO vor dem Build. Neue Prüfsummen-Manifeste werden mit dem Schlüssel 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D signiert.

Debian / Ubuntu

APT-Repository hinzufügen (empfohlen):

curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/mindwtr-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mindwtr-archive-keyring.gpg] https://dongdongbh.github.io/Mindwtr/deb ./" | sudo tee /etc/apt/sources.list.d/mindwtr.list
sudo apt update
sudo apt install mindwtr

Manuelle Installation: Laden Sie die .deb-Datei von GitHub Releases herunter und führen Sie sudo dpkg -i mindwtr_*.deb aus.

Fedora / RHEL / openSUSE

DNF-/YUM-Repository hinzufügen (empfohlen):

cat <<'EOF' | sudo tee /etc/yum.repos.d/mindwtr.repo
[mindwtr]
name=Mindwtr Repository
baseurl=https://dongdongbh.github.io/Mindwtr/rpm
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key
EOF

sudo dnf install mindwtr

Manuelle Installation: Laden Sie die .rpm-Datei von GitHub Releases herunter und führen Sie sudo rpm -i mindwtr-*.rpm aus.

Flatpak (Flathub)

Von Flathub installieren:

flatpak install flathub tech.dongdongbh.mindwtr

Starten mit:

flatpak run tech.dongdongbh.mindwtr

Flathub-Eintrag

Snap Store

Aus dem Snap Store installieren:

sudo snap install mindwtr

Snap-Store-Eintrag

AppImage (universell)

Eintrag im AppImage-Katalog

Funktioniert auf den meisten Linux-Distributionen:

# Download the versioned AppImage from:
# https://github.com/dongdongbh/Mindwtr/releases/latest

# Make executable
chmod +x Mindwtr-*.AppImage

# Run
./Mindwtr-*.AppImage

Tipp: Verwenden Sie AppImageLauncher für eine bessere Desktop-Integration.

Andere Distributionen

Verwenden Sie für andere Distributionen das AppImage oder bauen Sie Mindwtr aus dem Quellcode (siehe Entwicklerhandbuch).

Von der Community gepflegte Pakete (zum Beispiel nixpkgs für NixOS) sind willkommen. Der Desktop-Build bringt seine TLS-Abhängigkeit mit, daher muss die Paketierung nicht mit einer systemweiten OpenSSL-Version übereinstimmen. Wenn Sie ein Paket pflegen, eröffnen Sie eine Diskussion, damit es hier verlinkt werden kann.

---

Windows

Microsoft Store (empfohlen)

Installieren Sie Mindwtr aus dem Microsoft Store.

Microsoft-Store-Beta

Sie können Release Candidates mit derselben Store-Installation testen. Senden Sie die E-Mail-Adresse Ihres Store-Microsoft-Kontos an [email protected] oder teilen Sie sie in der Beta-Diskussion, damit ich Sie zu Mindwtr Beta hinzufügen kann. Nach Aufnahme und Veröffentlichung des Flights suchen Sie unter Microsoft Store → Bibliothek nach Updates. Behalten Sie Ihre Installation, damit Aufgaben und Anhänge erhalten bleiben. Hinweise zum Beitritt und Austritt finden Sie unter Beta-Kanälen beitreten.

Winget

Winget ist in Windows 10 und 11 integriert. Installieren Sie Mindwtr mit:

winget install dongdongbh.Mindwtr

Chocolatey

Wenn Sie Chocolatey verwenden:

choco install mindwtr

Chocolatey-Paket

Scoop

Wenn Sie Scoop verwenden:

scoop bucket add extras
scoop install extras/mindwtr

Installationsprogramm (.exe)

1. Laden Sie das Installationsprogramm von GitHub Releases herunter.
2. Führen Sie das Installationsprogramm aus.
3. Folgen Sie dem Installationsassistenten.
4. Starten Sie Mindwtr über das Startmenü.

Portable Version

1. Laden Sie mindwtr_<version>_windows_x64_portable.zip von GitHub Releases herunter.
2. Entpacken Sie die Datei in einen beliebigen beschreibbaren Ordner.
3. Lassen Sie portable.txt neben mindwtr.exe liegen.

Der portable Modus speichert den lokalen Zustand neben der ausführbaren Datei:

• profile/data/ für SQLite-Datenbank, Synchronisierungs-JSON, Anhänge, Protokolle, Momentaufnahmen, Audioaufnahmen und Sprachmodelle
• profile/config/ für config.toml und secrets.toml
• profile/webview/ für das WebView2-Browserprofil (Cache, lokaler Speicher)

Wechsel zwischen portabler und installierter Version unter Windows. Seit v1.3.2 verwendet die installierte App dieselbe Aufteilung in config\ und data\ unter %APPDATA%\mindwtr, daher lassen sich die zwei portablen Unterordner direkt hinüberkopieren; das WebView2-Profil liegt unter %LOCALAPPDATA%\tech.dongdongbh.mindwtr. Schließen Sie Mindwtr auf beiden Seiten, bevor Sie kopieren.

Portabel	Installiert
profile\data\ (mindwtr.db, data.json, attachments\, Protokolle, Snapshots)	%APPDATA%\mindwtr\data\
profile\config\config.toml	%APPDATA%\mindwtr\config\config.toml
profile\config\secrets.toml	keine Datei: die installierte App speichert Geheimnisse in der Windows-Anmeldeinformationsverwaltung; Sync-Passphrase, Dropbox-Anmeldung oder API-Schlüssel nach dem Umzug erneut eingeben
profile\webview\	%LOCALAPPDATA%\tech.dongdongbh.mindwtr\ (nur Cache; kann entfallen)

Windows WebView2 ist weiterhin erforderlich. Anhangsdateien, die ein portabler Build vor v1.1.0 unter AppData\Roaming\mindwtr gespeichert hat, werden beim ersten Start in das portable Profil verschoben. Wenn auf demselben Rechner eine installierte Mindwtr-Version vorhanden ist, werden sie stattdessen kopiert, damit beide Installationen weiter funktionieren.

---

macOS

Mac App Store (empfohlen)

Aus dem Mac App Store installieren:

Mindwtr im Mac App Store

Verwenden Sie diese Option, wenn Sie vom Store verwaltete Aktualisierungen und den signierten App-Store-Build wünschen.

TestFlight-Beta

Nehmen Sie über TestFlight an der macOS-Beta teil:

Mindwtr-TestFlight-Beta

Weitere Beta-Kanäle und Anweisungen zum Verlassen der Beta finden Sie unter An den Beta-Kanälen teilnehmen.

Homebrew

Mit Homebrew installieren:

brew install --cask mindwtr

Disk-Image (.dmg)

1. Laden Sie die .dmg-Datei von GitHub Releases herunter.
2. Öffnen Sie das Disk-Image.
3. Ziehen Sie Mindwtr in Ihren Programme-Ordner.
4. Starten Sie die App aus „Programme“ oder über Spotlight.

---

Downloads überprüfen

Jedes GitHub-Release enthält ein SHA256SUMS-Prüfsummen-Manifest und eine separate PGP-Signatur SHA256SUMS.asc dafür. Signiert wird mit demselben Schlüssel wie die APT- und RPM-Repositories, veröffentlicht unter https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key:

• Schlüssel: Mindwtr Bot (RSA 4096)
• Fingerabdruck: 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D

Derselbe Schlüssel ist zusätzlich auf dem Schlüsselserver keys.openpgp.org veröffentlicht, unabhängig von GitHubs Infrastruktur — beziehen Sie ihn aus beiden Quellen und prüfen Sie, dass beide den oben genannten Fingerabdruck zeigen.

# Import the signing key
curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | gpg --import

# Or fetch it from the keys.openpgp.org keyserver (independent second source)
gpg --keyserver hkps://keys.openpgp.org --recv-keys 0358999BBE704F588B9094979E553245CB17047D

# Verify the manifest signature
gpg --verify SHA256SUMS.asc SHA256SUMS

# Check the file you downloaded against the manifest
sha256sum --check --ignore-missing SHA256SUMS

gpg --verify muss eine gültige Signatur mit dem obigen Fingerabdruck melden. Unter macOS verwenden Sie für den Prüfsummen-Schritt shasum -a 256 --check --ignore-missing SHA256SUMS.

---

Speicherort der Daten

Nach der Installation werden Ihre Daten hier gespeichert:

Plattform	SQLite-Datenbank	Synchronisierungs-JSON
Linux	~/.local/share/mindwtr/mindwtr.db	~/.local/share/mindwtr/data.json
Windows	%APPDATA%/mindwtr/data/mindwtr.db	%APPDATA%/mindwtr/data/data.json
macOS	~/Library/Application Support/mindwtr/data/mindwtr.db	~/Library/Application Support/mindwtr/data/data.json

Flatpak-Installationen verwenden abgeschottete XDG-Pfade unter ~/.var/app/tech.dongdongbh.mindwtr/. Die Datenbank liegt unter ~/.var/app/tech.dongdongbh.mindwtr/data/mindwtr/mindwtr.db.

Die Konfiguration wird separat gespeichert:

Plattform	Speicherort
Linux	~/.config/mindwtr/config.toml
Windows	%APPDATA%/mindwtr/config/config.toml
macOS	~/Library/Application Support/mindwtr/config/config.toml

Vor v1.3.2 lagen unter Windows und macOS alle diese Dateien direkt im Ordner mindwtr. Der erste Start von v1.3.2 verschiebt sie nach config/ und data/ und lässt alles andere im Ordner unangetastet. Ein Wechsel zurück zu einer älteren Version wird danach nicht unterstützt: sie sucht nur am alten Ort.

---

Aktualisieren

Aktualisierungsprüfungen berücksichtigen den Kanal: Mindwtr erkennt die Installationsart, vergleicht sie mit der für diesen Kanal veröffentlichten Version und verweist auf den entsprechenden Aktualisierungsweg.

• Microsoft Store, Winget, Chocolatey, Homebrew, AUR: Die Aktualisierungserinnerung erscheint erst, wenn Ihr Kanal die neue Version anbietet. Aktualisieren Sie wie gewohnt mit Ihrem Paketmanager (zum Beispiel winget upgrade dongdongbh.Mindwtr, choco upgrade mindwtr, brew upgrade --cask mindwtr).
• Scoop: Mindwtr führt überhaupt keine automatische Aktualisierungsprüfung aus, da jeder Bucket das Manifest enthalten kann und Scoop Aktualisierungen verwaltet (scoop update mindwtr). Die manuelle Prüfung unter Einstellungen → Über funktioniert weiterhin.
• Flatpak, Snap und automatische Aktualisierung der App-Stores: Aktualisierungen werden automatisch bereitgestellt, daher zeigt Mindwtr keine Meldung.
• Direkter Download, portable Version, AppImage, .deb/.rpm: Prüfen Sie unter Einstellungen → Über → Nach Aktualisierungen suchen, laden Sie anschließend die neue Version von Releases herunter und installieren Sie sie über die vorhandene Installation.

Ihre Daten bleiben bei Aktualisierungen erhalten.

---

Deinstallieren

Linux (Paketmanager)

# AUR
yay -R mindwtr-bin

# Debian/Ubuntu
sudo dpkg -r mindwtr

# Flatpak
flatpak uninstall tech.dongdongbh.mindwtr

Windows

Verwenden Sie in den Windows-Einstellungen „Apps hinzufügen oder entfernen“.

macOS

Ziehen Sie Mindwtr aus „Programme“ in den Papierkorb.

Datenbereinigung

Löschen Sie sowohl das Konfigurations- als auch das Datenverzeichnis, um alle Daten zu entfernen:

# Linux
rm -rf ~/.config/mindwtr
rm -rf ~/.local/share/mindwtr

# macOS
rm -rf ~/Library/Application\ Support/mindwtr

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:APPDATA\\mindwtr"

---

Fehlerbehebung

App startet unter Linux nicht

Stellen Sie sicher, dass WebKitGTK installiert ist:

# Arch
sudo pacman -S webkit2gtk-4.1

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-0

Fehlende Symbole

Installieren Sie ein vollständiges Symbolthema:

sudo pacman -S papirus-icon-theme

Leeres Fenster

Versuchen Sie den Start mit deaktivierter GPU:

WEBKIT_DISABLE_DMABUF_RENDERER=1 mindwtr

---

Siehe auch

• Erste Schritte
• Desktop-Benutzerhandbuch
• Daten und Synchronisierung