Installing.es

🌐 English · Deutsch · Français · 简体中文

Instalación (gramps-connect-desktop)

gramps-connect-desktop es la versión independiente de Gramps Connect: una aplicación descargable que empaqueta el frontend de app/ y el backend de gramps-web-api junto con SQLite, y se ejecuta por completo en su propio equipo. Es la forma más fácil de probar Gramps Connect hoy, y una alternativa real a Gramps Desktop para el trabajo diario en su propio árbol, no una vista previa limitada de otra cosa.

Es de un solo usuario por diseño: solo escucha en 127.0.0.1, así que no es accesible en absoluto a través de una red, y siempre tiene exactamente un inicio de sesión fijo, admin / admin. Si quiere que toda una familia trabaje en un árbol compartido, o ver en acción las funciones de colaboración en vivo, consulte en cambio Despliegue: en la versión independiente no hay ediciones de nadie más que ver aparecer.

Todas las descargas actuales están en la última versión publicada. Todas empiezan con un árbol vacío: importe su propio archivo Gramps XML (.gramps) o GEDCOM (.ged) desde la pantalla Árboles genealógicos → Importar... de la propia aplicación una vez que esté en marcha.

La primera ejecución crea un pequeño directorio de datos en su carpeta personal (.gramps-connect-desktop) que contiene ese árbol; las ejecuciones posteriores lo reutilizan. Borre esa carpeta para volver a empezar desde cero. Son compilaciones sin firmar y solo para x86_64, de ahí las advertencias del sistema operativo que se describen más abajo; no son señal de que algo vaya mal.

Windows

1. Descargue gramps-connect-desktop-windows.zip de la última versión publicada y descomprímalo (clic derecho → Extraer todo).
2. Abra la carpeta extraída y haga doble clic en gramps-connect-desktop.exe.
3. Probablemente Windows mostrará una advertencia de SmartScreen («Windows protegió su PC») porque no es un ejecutable firmado. Haga clic en Más información y luego en Ejecutar de todas formas.
4. Se abre automáticamente una ventana con la aplicación. Inicie sesión como admin / admin.

macOS (Apple Silicon)

Para Mac con M1/M2/M3/M4.

1. Descargue gramps-connect-desktop-macos-arm64.zip de la última versión publicada y descomprímalo (doble clic, o clic derecho → Abrir, según la configuración de su Mac) para obtener gramps-connect-desktop.app.
2. Haga doble clic en gramps-connect-desktop.app. Esta compilación está firmada con un Developer ID y notarizada por Apple, así que debería abrirse con normalidad sin ninguna advertencia de Gatekeeper. Si aun así ve una, consulte Solución de problemas más abajo.
3. Se abre automáticamente una ventana con la aplicación. Inicie sesión como admin / admin.

macOS (Intel)

Para Mac más antiguos con procesador Intel (anteriores a Apple Silicon). Los mismos pasos que para Apple Silicon, pero descargue gramps-connect-desktop-macos-intel.zip.

Linux (.deb: Debian, Ubuntu y derivadas)

1. Descargue el archivo .deb (gramps-connect-desktop_*_amd64.deb) de la última versión publicada.
2. Instálelo: sudo apt install ./gramps-connect-desktop_*_amd64.deb (como se instala desde un archivo local y no desde un repositorio, es probable que apt avise de que el paquete no está firmado; es lo esperado, véase Solución de problemas).
3. Ejecute gramps-connect-desktop desde una terminal, o busque «Gramps Connect Desktop» en el menú de aplicaciones.
4. Se abre en su propia ventana nativa, usando GTK3 + WebKit2 ya presentes en su sistema (habituales en los escritorios Linux: muchas aplicaciones ya dependen de ellos; este paquete no incluye ninguno de los dos). Si su sistema no los tiene, se abre en cambio en una pestaña del navegador (véase Solución de problemas). Inicie sesión como admin / admin.
5. Para desinstalar: sudo apt remove gramps-connect-desktop.

Linux (.rpm: Fedora, RHEL, AlmaLinux y derivadas)

1. Descargue el archivo .rpm (gramps-connect-desktop-*.x86_64.rpm) de la última versión publicada.
2. Instálelo: sudo dnf install ./gramps-connect-desktop-*.x86_64.rpm (en un sistema sin dnf, también funciona sudo rpm -i gramps-connect-desktop-*.x86_64.rpm, solo que sin resolución automática de dependencias). Igual que con el .deb anterior, instalar desde un archivo local hace que dnf/rpm probablemente avise de que el paquete no está firmado; es lo esperado.
3. Ejecute gramps-connect-desktop desde una terminal, o busque «Gramps Connect Desktop» en el menú de aplicaciones.
4. Se abre en su propia ventana nativa (o recurre a una pestaña del navegador), igual que el .deb anterior. Inicie sesión como admin / admin.
5. Para desinstalar: sudo dnf remove gramps-connect-desktop.

Configuración

gramps-connect-desktop funciona sin ninguna configuración. El único ajuste opcional es el correo electrónico saliente: por defecto, todo lo que enviaría correo (restablecimiento de contraseña, confirmación de correo, notificación de nuevo usuario, aunque en una versión de un solo usuario no hay a quién notificar) simplemente falla con «Connection was refused», ya que no hay ningún servidor de correo en su equipo con el que hablar. Para enviar realmente esos correos, defina estas variables de entorno antes de iniciar la aplicación:

Variable	Función
GRAMPSWEB_EMAIL_HOST	Nombre del servidor SMTP
GRAMPSWEB_EMAIL_PORT	Puerto del servidor SMTP (por defecto 465)
GRAMPSWEB_EMAIL_HOST_USER	Usuario de inicio de sesión SMTP
GRAMPSWEB_EMAIL_HOST_PASSWORD	Contraseña de inicio de sesión SMTP
GRAMPSWEB_DEFAULT_FROM_EMAIL	Dirección «De» de los correos enviados
GRAMPSWEB_EMAIL_USE_SSL	true/false: conexión TLS/SSL implícita
GRAMPSWEB_EMAIL_USE_STARTTLS	true/false: conexión simple mejorada mediante STARTTLS
GRAMPSWEB_EMAIL_USE_TLS	true/false: alias antiguo; mejor use los dos anteriores (por defecto true, es decir, TLS implícito)

Solo tienen efecto las variables que defina; cualquiera que quede sin definir recurre al valor por defecto de gramps-web-api para esa opción. Por ejemplo, para enviar a través de Gmail con una contraseña de aplicación:

GRAMPSWEB_EMAIL_HOST=smtp.gmail.com \
GRAMPSWEB_EMAIL_PORT=587 \
GRAMPSWEB_EMAIL_HOST_USER=you@gmail.com \
GRAMPSWEB_EMAIL_HOST_PASSWORD=your-app-password \
GRAMPSWEB_EMAIL_USE_STARTTLS=true \
GRAMPSWEB_DEFAULT_FROM_EMAIL=you@gmail.com \
./gramps-connect-desktop

Al ejecutarlo desde una terminal, --browser omite la ventana nativa en macOS/Windows y abre siempre la aplicación en su navegador predeterminado: la misma alternativa que Linux usa siempre (véase Arquitectura), solo que elegida en lugar de automática. Es útil si prefiere usar las herramientas de desarrollo o las extensiones de su propio navegador, o si quiere descartar la vista web nativa cuando algo parece ir mal:

./gramps-connect-desktop --browser

Solución de problemas

• SmartScreen de Windows («Windows protegió su PC»): es lo esperado, ya que esta compilación no está firmada. Haga clic en Más información → Ejecutar de todas formas.
• Gatekeeper de macOS («no se puede abrir porque Apple no puede comprobar si contiene software malicioso»): esta compilación está firmada con un Developer ID y notarizada por Apple, así que no debería ocurrir. Si ocurre, pruebe primero a quitar el indicador de cuarentena de todo el .app de una vez: xattr -cr gramps-connect-desktop.app (ejecútelo desde Terminal, en la carpeta donde lo descomprimió). Por favor, infórmenos también: probablemente significa que el ticket de notarización no sobrevivió a la descarga/descompresión como se esperaba, o que la compilación no se notarizó correctamente.
• apt/dnf avisa de que el .deb/.rpm no está firmado, u omite una comprobación OpenPGP: es lo esperado. Estos paquetes los compila la propia CI de este repositorio y no se publican en un repositorio firmado de una distribución, así que instalarlos desde un archivo local siempre se ve así; no significa que algo vaya mal.
• dnf: command not found / rpm: command not found: su distribución está basada en Debian/Ubuntu (o por algún otro motivo no incluye rpm), así que el paquete .rpm no es la descarga adecuada. Descargue en su lugar el archivo .deb e instálelo con sudo apt install ./gramps-connect-desktop_*_amd64.deb (véase la sección .deb anterior).
• No aparece ninguna ventana ni pestaña del navegador en ninguna plataforma: la aplicación siempre intenta abrir una automáticamente cuando su servidor está en marcha; si por algún motivo falla, abra usted mismo http://127.0.0.1:5050. Si allí tampoco escucha nada, algo falló antes de llegar a ese punto: revise la salida de la terminal (en Windows, ejecute gramps-connect-desktop.exe desde una ventana de cmd/PowerShell en lugar de hacer doble clic, para poder verla) en busca de un error, y considere abrir una incidencia con esa salida.
• La aplicación no arranca / el puerto ya está en uso: solo puede haber una instancia en ejecución a la vez (está fijada a 127.0.0.1:5050). Cierre cualquier otra copia en ejecución, o cualquier otra cosa que use el puerto 5050, y vuelva a intentarlo.
• Se abre una pestaña del navegador en lugar de una ventana nativa: la aplicación siempre intenta primero una ventana nativa y, si no puede, recurre automáticamente al navegador: no se pudo acceder a WebView2 en Windows (presente por defecto en Windows 10/11) o a WKWebView en macOS (siempre presente), o, en Linux, GTK3 + WebKit2 no están instalados en el sistema (instale python3-gi, gir1.2-gtk-3.0 y gir1.2-webkit2-4.1, o los equivalentes de su distribución, y vuelva a iniciarla para obtener una ventana nativa). La aplicación funciona igualmente por completo en la pestaña del navegador: esto solo afecta a cómo se presenta, no a lo que puede hacer.
• Empezar de nuevo con un árbol vacío: borre la carpeta .gramps-connect-desktop de su directorio personal y vuelva a iniciar la aplicación.
• ¿Busca un despliegue multiusuario real en lugar de esta versión local de un solo usuario? Consulte Despliegue.

Consulte también las Preguntas frecuentes para dudas sobre la seguridad de los datos y cómo se compara gramps-connect-desktop con Gramps Desktop y con el despliegue en servidor.