Guía
Instalar SpiderGit
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.
| Sistema | Paquete |
|---|---|
| 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 Intel | SpiderGit-<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)
- Instala git desde https://git-scm.com/download/win (incluye Git Credential Manager).
- 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.
- De forma predeterminada se instala solo para tu usuario, sin permisos de administrador
(en
- 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
- Instala git, como arriba.
- Extrae el zip.
- En la carpeta
SpiderGitextraída, haz clic derecho eninstall-windows.ps1→ Ejecutar con PowerShell, o desde un terminal: La aplicación se copia en%LOCALAPPDATA%\Programs\SpiderGity aparece en el menú Inicio (con-Desktoptambié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
- 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
- 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 comandospidergit(si~/.local/binestá en elPATH).
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
- Instala git, si no está ya:
xcode-select --install
- 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--useren~/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):
| Sistema | Carpeta |
|---|---|
| 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.