Instalación en escritorio

Instrucciones detalladas de instalación para todas las plataformas de escritorio.

Para las compilaciones candidatas a lanzamiento y beta, consulta Únete a los canales beta.

---

Linux

Arch Linux (AUR, precompilado)

La forma más sencilla de instalar en distribuciones basadas en Arch es el paquete AUR precompilado:

# Using yay
yay -S mindwtr-bin

# Using paru
paru -S mindwtr-bin

# Using pamac (Manjaro)
pamac install mindwtr-bin

Paquete AUR: mindwtr-bin

Arch Linux (AUR, compilación desde el código fuente)

En AUR también existe un paquete compilado desde el código fuente, mindwtr. Lo mantiene la comunidad, no el proyecto Mindwtr, y no forma parte del proceso de publicación de Mindwtr. Usa mindwtr-bin salvo que necesites compilar localmente.

Verifica los paquetes AUR oficiales

Mindwtr publica dos identidades AUR actuales: mindwtr-bin (binario estable) y mindwtr-beta-bin (versión preliminar). Un tercer nombre, mindwtr-bin-beta, es la identidad beta anterior; se sigue actualizando desde los mismos artefactos de publicación firmados mientras dura el cambio de nombre. La fuente del paquete debe apuntar a github.com/dongdongbh/Mindwtr, y el mantenedor debe ser dongdongbh. Revisa cada cambio en PKGBUILD y .SRCINFO antes de compilar. Los nuevos manifiestos de sumas de verificación están firmados con la clave 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D.

Debian / Ubuntu

Añade el repositorio APT (recomendado):

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

Instalación manual: descarga el .deb desde GitHub Releases y ejecuta sudo dpkg -i mindwtr_*.deb.

Fedora / RHEL / openSUSE

Añade el repositorio DNF/YUM (recomendado):

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

Instalación manual: descarga el .rpm desde GitHub Releases y ejecuta sudo rpm -i mindwtr-*.rpm.

Flatpak (Flathub)

Instala desde Flathub:

flatpak install flathub tech.dongdongbh.mindwtr

Ejecútalo con:

flatpak run tech.dongdongbh.mindwtr

Página de Flathub

Snap Store

Instala desde Snap Store:

sudo snap install mindwtr

Página de Snap Store

AppImage (universal)

Ficha en el catálogo de AppImage

Funciona en la mayoría de las distribuciones de Linux:

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

# Make executable
chmod +x Mindwtr-*.AppImage

# Run
./Mindwtr-*.AppImage

Consejo: Usa AppImageLauncher para mejorar la integración con el escritorio.

Otras distribuciones

Para otras distribuciones, usa AppImage o compila desde el código fuente (consulta la Guía para desarrolladores).

Los paquetes mantenidos por la comunidad (por ejemplo, nixpkgs para NixOS) son bienvenidos. La compilación de escritorio incluye su dependencia de TLS, por lo que el empaquetado no necesita coincidir con una versión de OpenSSL del sistema. Si mantienes uno, abre una conversación para que podamos enlazarlo aquí.

---

Windows

Microsoft Store (recomendado)

Instala desde Microsoft Store.

Beta de Microsoft Store

Puedes probar versiones candidatas con la misma instalación de la tienda. Envía el correo de tu cuenta Microsoft de la tienda a [email protected], o compártelo en la discusión de la beta, y te añadiré a Mindwtr Beta. Tras la inscripción y publicación del piloto, busca actualizaciones en Microsoft Store → Biblioteca. Conserva tu instalación para mantener las tareas y los adjuntos. Consulta Únete a los canales beta para saber cómo entrar y salir.

Winget

Winget está integrado en Windows 10 y 11. Instala Mindwtr con:

winget install dongdongbh.Mindwtr

Chocolatey

Si usas Chocolatey:

choco install mindwtr

Paquete de Chocolatey

Scoop

Si usas Scoop:

scoop bucket add extras
scoop install extras/mindwtr

Instalador (.exe)

1. Descarga el instalador desde GitHub Releases
2. Ejecuta el instalador
3. Sigue el asistente de instalación
4. Inicia Mindwtr desde el menú Inicio

Portátil

1. Descarga mindwtr_<version>_windows_x64_portable.zip desde GitHub Releases.
2. Extráelo en cualquier carpeta con permisos de escritura.
3. Mantén portable.txt junto a mindwtr.exe.

El modo portátil almacena el estado local junto al ejecutable:

• profile/data/ para la base de datos SQLite, el JSON de sincronización, los archivos adjuntos, los registros, las instantáneas, las capturas de audio y los modelos de voz
• profile/config/ para config.toml y secrets.toml
• profile/webview/ para el perfil del navegador WebView2 (caché, almacenamiento local)

Pasar de la versión portátil a la instalada en Windows, y al revés. Desde v1.3.2 la app instalada usa la misma estructura config\ y data\ bajo %APPDATA%\mindwtr, así que las dos subcarpetas portátiles se copian tal cual; el perfil de WebView2 está en %LOCALAPPDATA%\tech.dongdongbh.mindwtr. Cierra Mindwtr en ambos lados antes de copiar.

Portátil	Instalada
profile\data\ (mindwtr.db, data.json, attachments\, registros, instantáneas)	%APPDATA%\mindwtr\data\
profile\config\config.toml	%APPDATA%\mindwtr\config\config.toml
profile\config\secrets.toml	no es un archivo: la app instalada guarda los secretos en el Administrador de credenciales de Windows; vuelve a introducir la contraseña de sincronización, el inicio de sesión de Dropbox o las claves de API tras el traslado
profile\webview\	%LOCALAPPDATA%\tech.dongdongbh.mindwtr\ (solo caché; se puede omitir)

Windows WebView2 sigue siendo necesario. Los archivos adjuntos que una compilación portátil anterior a v1.1.0 almacenó en AppData\Roaming\mindwtr se trasladan al perfil portátil la primera vez que se inicia; si un Mindwtr instalado comparte el equipo, se copian en su lugar, de modo que ambas instalaciones sigan funcionando.

---

macOS

Mac App Store (recomendado)

Instala desde Mac App Store:

Mindwtr en Mac App Store

Usa esta opción si quieres actualizaciones administradas por la tienda y la compilación firmada de App Store.

Beta de TestFlight

Únete a la beta de macOS mediante TestFlight:

Beta de Mindwtr en TestFlight

Los demás canales beta y las instrucciones para abandonar la beta se explican en Únete a los canales beta.

Homebrew

Instala mediante Homebrew:

brew install --cask mindwtr

Imagen de disco (.dmg)

1. Descarga el .dmg desde GitHub Releases
2. Abre la imagen de disco
3. Arrastra Mindwtr a tu carpeta Aplicaciones
4. Inícialo desde Aplicaciones o Spotlight

---

Verificación de las descargas

Cada versión publicada en GitHub incluye un manifiesto de sumas de comprobación SHA256SUMS y una firma PGP separada SHA256SUMS.asc que lo cubre. Se firman con la misma clave que firma los repositorios APT y RPM, publicada en https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key:

• Clave: Mindwtr Bot (RSA 4096)
• Huella digital: 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D

La misma clave también está publicada en el servidor de claves keys.openpgp.org, independiente de la infraestructura de GitHub: obténla de ambas fuentes y confirma que muestran la huella digital indicada arriba.

# 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 debe informar una firma válida con la huella digital anterior. En macOS, use shasum -a 256 --check --ignore-missing SHA256SUMS para el paso de la suma de comprobación.

---

Ubicación de los datos

Después de la instalación, tus datos se almacenan en:

Plataforma	Base de datos SQLite	JSON de sincronización
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

Las instalaciones de Flatpak usan rutas XDG aisladas bajo ~/.var/app/tech.dongdongbh.mindwtr/. La base de datos está en ~/.var/app/tech.dongdongbh.mindwtr/data/mindwtr/mindwtr.db.

La configuración se almacena por separado:

Plataforma	Ubicación
Linux	~/.config/mindwtr/config.toml
Windows	%APPDATA%/mindwtr/config/config.toml
macOS	~/Library/Application Support/mindwtr/config/config.toml

Antes de v1.3.2, Windows y macOS guardaban todos estos archivos directamente en la carpeta mindwtr. El primer arranque de v1.3.2 los mueve a config/ y data/ y no toca nada más de la carpeta. Volver después a una versión anterior no está soportado: solo mira en el sitio antiguo.

---

Actualización

Las comprobaciones de actualizaciones tienen en cuenta el canal: Mindwtr detecta cómo se instaló, compara con la versión publicada para ese canal y te dirige a la vía de actualización correspondiente.

• Microsoft Store, Winget, Chocolatey, Homebrew, AUR: el recordatorio de actualización solo aparece cuando tu canal tiene la nueva versión; actualiza con tu gestor de paquetes como de costumbre (por ejemplo, winget upgrade dongdongbh.Mindwtr, choco upgrade mindwtr, brew upgrade --cask mindwtr).
• Scoop: Mindwtr no realiza ninguna comprobación automática de actualizaciones, ya que cualquier bucket puede contener el manifiesto y Scoop gestiona las actualizaciones (scoop update mindwtr). La comprobación manual en Ajustes → Acerca de sigue funcionando.
• Flatpak, Snap y la actualización automática de las tiendas de aplicaciones: las actualizaciones llegan automáticamente, por lo que Mindwtr no muestra avisos.
• Descarga directa, portátil, AppImage, .deb/.rpm: comprueba en Ajustes → Acerca de → Buscar actualizaciones; luego descarga la nueva versión desde Releases e instálala sobre la instalación existente.

Tus datos se conservan entre actualizaciones.

---

Desinstalación

Linux (gestor de paquetes)

# AUR
yay -R mindwtr-bin

# Debian/Ubuntu
sudo dpkg -r mindwtr

# Flatpak
flatpak uninstall tech.dongdongbh.mindwtr

Windows

Usa «Agregar o quitar programas» en la configuración de Windows.

macOS

Arrastra Mindwtr desde Aplicaciones a la Papelera.

Limpieza de datos

Para eliminar todos los datos, borra tanto el directorio de configuración como el de datos:

# 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"

---

Solución de problemas

La aplicación no se inicia (Linux)

Asegúrate de que WebKitGTK esté instalado:

# Arch
sudo pacman -S webkit2gtk-4.1

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

Faltan iconos

Instala un tema de iconos completo:

sudo pacman -S papirus-icon-theme

Ventana en blanco

Prueba a ejecutarlo con la GPU desactivada:

WEBKIT_DISABLE_DMABUF_RENDERER=1 mindwtr

---

Consulta también

• Primeros pasos
• Guía del usuario para escritorio
• Datos y sincronización