Installare SpiderGit

SpiderGit è distribuito come pacchetto self-contained: include il runtime .NET, quindi non serve installare .NET. Serve invece git (versione 2.35 o successiva), perché SpiderGit esegue il git installato sul computer: così valgono la tua configurazione, le chiavi SSH e il credential helper.

Windows

Con l’installer (consigliato)

1. Installa git da https://git-scm.com/download/win (include Git Credential Manager).
2. Avvia SpiderGit-<versione>-win-x64-setup.exe.
   • Per impostazione predefinita installa solo per il tuo utente, senza permessi di amministratore (in %LOCALAPPDATA%\Programs\SpiderGit); nella prima schermata puoi scegliere l’installazione per tutti gli utenti.
   • Se git non viene trovato, l’installer lo segnala e chiede se continuare.
3. SpiderGit compare nel menu Start (e, se lo scegli, sul desktop).

Per aggiornare basta eseguire l’installer della nuova versione: sostituisce quella installata, chiudendo SpiderGit se è aperto. Si disinstalla da Impostazioni di Windows → App → App installate → SpiderGit.

Installazione senza interfaccia (es. per distribuirla a più postazioni):

SpiderGit-<versione>-win-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /CURRENTUSER

Con lo zip

1. Installa git, come sopra.
2. Estrai lo zip.
3. Nella cartella SpiderGit estratta, fai clic destro su install-windows.ps1 → Esegui con PowerShell, oppure da un terminale: L’app viene copiata in %LOCALAPPDATA%\Programs\SpiderGit e compare nel menu Start (con -Desktop anche sul desktop). Non servono permessi di amministratore.

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 -Desktop

In alternativa puoi avviare direttamente SpiderGit.exe dalla cartella estratta, senza installare nulla.

Avviso di Windows SmartScreen. L’installer e l’eseguibile non sono firmati con un certificato di firma del codice, quindi al primo avvio Windows può mostrare “Windows ha protetto il PC”: scegli Ulteriori informazioni → Esegui comunque.

Disinstallazione (rimuove l’app e i collegamenti):

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

Linux

1. Installa git e le librerie grafiche usate da Avalonia (di solito già presenti in un ambiente desktop): (Fedora: sudo dnf install git libICE libSM fontconfig.)

sudo apt install git libice6 libsm6 libfontconfig1

2. Estrai l’archivio e lancia l’installazione per l’utente corrente: L’app viene installata in ~/.local/share/spidergit, compare nel menu delle applicazioni e si avvia anche con il comando spidergit (se ~/.local/bin è nel PATH).

tar -xzf SpiderGit-<versione>-linux-x64.tar.gz
./SpiderGit/install.sh

In alternativa puoi avviare direttamente ./SpiderGit/SpiderGit dalla cartella estratta.

Disinstallazione (rimuove app, comando e voce di menu):

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

macOS

1. Installa git, se non c’è già:

xcode-select --install

2. Scarica il pacchetto adatto al tuo Mac (Apple → osx-arm64, Intel → osx-x64), estrailo e installa: L’app viene copiata in /Applications (con --user in ~/Applications).

tar -xzf SpiderGit-<versione>-osx-arm64.tar.gz
./SpiderGit/install-macos.sh

Perché serve lo script. SpiderGit non è firmato né autenticato da Apple. Lo script rimuove la “quarantena” del download e applica una firma locale (ad-hoc), senza la quale macOS si rifiuta di avviare le app sui Mac con processore Apple. Se preferisci copiare l’app a mano, esegui poi:

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

Lingua

L’interfaccia di SpiderGit è disponibile in inglese, italiano e spagnolo. Al primo avvio usa la lingua del sistema, se è una di queste, altrimenti l’inglese; si cambia da Impostazioni → Impostazioni di sistema → Lingua e si applica al riavvio (pulsante Riavvia ora). Anche l’installer per Windows propone la lingua di Windows. I messaggi di git, ad esempio nei dettagli di un errore, restano sempre in inglese.

Dove sono i dati

L’installazione e la disinstallazione non toccano i dati (workspace, libreria, cache della dashboard):

Per ricominciare da zero basta eliminare questa cartella. Il percorso è visibile anche in Impostazioni → Applicazione.

Credenziali

Per HTTPS SpiderGit usa il credential helper configurato in git (su Windows e macOS di solito Git Credential Manager, incluso nell’installazione di git). Se non ce n’è uno, SpiderGit chiede utente e password o token in una finestra ad ogni operazione, senza salvarli. Per GitHub, GitLab e Azure DevOps usa un token di accesso personale al posto della password. Per SSH la chiave deve essere caricata nell’agent (ssh-add); la passphrase, se richiesta, viene chiesta da SpiderGit.