Guía

Instalar SpiderGit

Los paquetes se descargan desde la página Descargar.

SpiderGit se distribuye como paquete self-contained: incluye el runtime de .NET, así que no hace falta instalar .NET. Sí hace falta git (versión 2.35 o posterior), porque SpiderGit ejecuta el git instalado en el equipo: así se aplican tu configuración, tus claves SSH y tu credential helper.

SistemaPaquete
Windows 10/11 (x64)SpiderGit-<versión>-win-x64-setup.exe (instalador) o SpiderGit-<versión>-win-x64.zip
Linux (x64)SpiderGit-<versión>-linux-x64.tar.gz
macOS con procesador IntelSpiderGit-<versión>-osx-x64.tar.gz
macOS con procesador Apple (M1 y posteriores)SpiderGit-<versión>-osx-arm64.tar.gz

Windows

Con el instalador (recomendado)

  1. Instala git desde https://git-scm.com/download/win (incluye Git Credential Manager).
  2. Ejecuta SpiderGit-<versión>-win-x64-setup.exe.
    • De forma predeterminada se instala solo para tu usuario, sin permisos de administrador (en %LOCALAPPDATA%\Programs\SpiderGit); en la primera pantalla puedes elegir instalarlo para todos los usuarios.
    • Si no encuentra git, el instalador lo indica y pregunta si quieres continuar.
  3. SpiderGit aparece en el menú Inicio (y, si lo eliges, en el escritorio).

Para actualizar basta con ejecutar el instalador de la nueva versión: sustituye la instalada y cierra SpiderGit si está abierto. Se desinstala desde Configuración de Windows → Aplicaciones → Aplicaciones instaladas → SpiderGit.

Instalación desatendida (p. ej. para distribuirlo en varios equipos):

SpiderGit-<versión>-win-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /CURRENTUSER

Con el zip

  1. Instala git, como arriba.
  2. Extrae el zip.
  3. En la carpeta SpiderGit extraída, haz clic derecho en install-windows.ps1 → Ejecutar con PowerShell, o desde un terminal: La aplicación se copia en %LOCALAPPDATA%\Programs\SpiderGit y aparece en el menú Inicio (con -Desktop también en el escritorio). No hacen falta permisos de administrador.
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 -Desktop

También puedes ejecutar directamente SpiderGit.exe desde la carpeta extraída, sin instalar nada.

Aviso de Windows SmartScreen. El instalador y el ejecutable no están firmados con un certificado de firma de código, así que en el primer inicio Windows puede mostrar “Windows protegió su PC”: elige Más información → Ejecutar de todas formas.

Desinstalación (elimina la aplicación y los accesos directos):

powershell -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\Programs\SpiderGit\install-windows.ps1" -Uninstall

Linux

  1. Instala git y las bibliotecas gráficas que usa Avalonia (normalmente ya presentes en un entorno de escritorio): (Fedora: sudo dnf install git libICE libSM fontconfig.)
sudo apt install git libice6 libsm6 libfontconfig1
  1. Extrae el archivo y lanza la instalación para el usuario actual: La aplicación se instala en ~/.local/share/spidergit, aparece en el menú de aplicaciones y también se inicia con el comando spidergit (si ~/.local/bin está en el PATH).
tar -xzf SpiderGit-<versión>-linux-x64.tar.gz
./SpiderGit/install.sh

También puedes ejecutar directamente ./SpiderGit/SpiderGit desde la carpeta extraída.

Desinstalación (elimina la aplicación, el comando y la entrada del menú):

~/.local/share/spidergit/install.sh --uninstall

macOS

  1. Instala git, si no está ya:
xcode-select --install
  1. Descarga el paquete adecuado para tu Mac (Apple → osx-arm64, Intel → osx-x64), extráelo e instálalo: La aplicación se copia en /Applications (con --user en ~/Applications).
tar -xzf SpiderGit-<versión>-osx-arm64.tar.gz
./SpiderGit/install-macos.sh

Por qué hace falta el script. SpiderGit no está firmado ni notarizado por Apple. El script elimina la “cuarentena” de la descarga y aplica una firma local (ad-hoc), sin la cual macOS se niega a iniciar las aplicaciones en los Mac con procesador Apple. Si prefieres copiar la aplicación a mano, ejecuta después:

xattr -dr com.apple.quarantine /Applications/SpiderGit.app
codesign --force --deep --sign - /Applications/SpiderGit.app

Idioma

La interfaz de SpiderGit está disponible en inglés, italiano y español. En el primer inicio usa el idioma del sistema, si es uno de estos, y si no el inglés; se cambia en Ajustes → Ajustes del sistema → Idioma y se aplica al reiniciar (botón Reiniciar ahora). El instalador de Windows también propone el idioma de Windows. Los mensajes de git, por ejemplo en los detalles de un error, se muestran siempre en inglés.

Dónde están los datos

La instalación y la desinstalación no tocan los datos (workspaces, biblioteca, caché del panel):

SistemaCarpeta
Windows%APPDATA%\SpiderGit
Linux~/.config/SpiderGit
macOS~/Library/Application Support/SpiderGit

Para empezar desde cero basta con eliminar esta carpeta. La ruta también se ve en Ajustes → Aplicación.

Credenciales

Para HTTPS SpiderGit usa el credential helper configurado en git (en Windows y macOS normalmente Git Credential Manager, incluido en la instalación de git). Si no hay ninguno, SpiderGit pide el usuario y la contraseña o el token en una ventana en cada operación, sin guardarlos. Para GitHub, GitLab y Azure DevOps usa un token de acceso personal en lugar de la contraseña. Para SSH la clave debe estar cargada en el agente (ssh-add); la frase de contraseña, si hace falta, la pide SpiderGit.