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)

Verwenden Sie das aus dem Quellcode gebaute AUR-Paket, wenn Sie lokal bauen möchten:

# Using yay
yay -S mindwtr

# Using paru
paru -S mindwtr

AUR-Paket: mindwtr

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
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)

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.

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 mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr

Installationsprogramm (.msi oder .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)

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.

---

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/mindwtr.db	%APPDATA%/mindwtr/data.json
macOS	~/Library/Application Support/mindwtr/mindwtr.db	~/Library/Application Support/mindwtr/data.json

Flatpak-Installationen verwenden abgeschottete XDG-Pfade unter ~/.var/app/tech.dongdongbh.mindwtr/. Die genauen aktiven Pfade können Sie jederzeit unter Einstellungen → Synchronisierung → Lokale Daten prüfen.

Die Konfiguration wird separat gespeichert:

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

---

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