in Informatica |

Obsidian + Git: Sincronizzazione automatica e gratuita

Se consideri Obsidian il tuo “secondo cervello”, sai che la perdita dei tuoi dati non è un’opzione accettabile. Obsidian offre un servizio di sincronizzazione nativo eccellente (Obsidian Sync), ma ha un costo ricorrente. Se sei uno sviluppatore, un sistemista o semplicemente un appassionato che ama avere il controllo totale del proprio flusso di lavoro, c’è una soluzione nativa per il tuo DNA: Git.

Sincronizzare la tua cassaforte (Vault) di Obsidian con un repository privato su GitHub (o GitLab) ti garantisce tre vantaggi enormi:

  1. Controllo totale della cronologia: Ogni singola modifica è tracciata. Puoi fare un “viaggio nel tempo” e recuperare un paragrafo cancellato mesi fa.
  2. Costi azzerati: Sfrutta l’infrastruttura cloud di GitHub in modo completamente gratuito.
  3. Nessun lock-in: Le tue note rimangono semplici file Markdown (.md) sul tuo hard disk e sul tuo server Git.

In questa guida dettagliata vedremo come configurare l’integrazione passo dopo passo, come gestire i file di configurazione per evitare conflitti e come automatizzare il tutto.

Passo 1: Preparare il terreno (Il Repository Remoto)

Prima di toccare Obsidian, serve uno spazio sicuro sul cloud dove salvare i dati.

  1. Accedi al tuo account GitHub (o creane uno se non lo possiedi).
  2. Crea un nuovo repository.
  3. Fondamentale: Imposta la visibilità su Private. Non vuoi che i tuoi appunti personali, i tuoi diari o le tue password (che non dovresti comunque mettere lì!) siano pubblici.
  4. Lascia deselezionate le opzioni per creare automaticamente il file README, .gitignore o la licenza. Il repository deve nascere completamente vuoto.

Passo 2: Inizializzare Git localmente e gestire il .gitignore

Ora dobbiamo trasformare la cartella locale di Obsidian in un repository Git.

Apri il terminale all’interno della cartella principale del tuo Vault (la cartella radice che contiene tutte le tue note) ed esegui i seguenti comandi:

# Inizializza il repository locale
git init

# Rinomina il branch principale in 'main' (standard attuale)
git checkout -b main

# Collega il repository locale a quello remoto su GitHub
git remote add origin git@github.com:TUO_UTENTE/TUO_REPO.git

Consiglio sulla sicurezza: Assicurati di aver configurato correttamente le tue chiavi SSH sul computer e su GitHub. Usare l’autenticazione SSH (senza passphrase o memorizzata nel keychain) eviterà che Obsidian ti chieda continuamente le credenziali in background, bloccando l’automazione.

La gestione dei file di configurazione di Obsidian

Obsidian salva le impostazioni, i plugin e lo stato dell’interfaccia all’interno della cartella nascosta .obsidian. Se sincronizzi più PC con monitor o sistemi operativi diversi, tracciare tutto può generare fastidiosi conflitti di Git.

Crea un file chiamato .gitignore nella root del tuo Vault e inserisci questo testo:

# Escludi lo stato dell'interfaccia (layout dei pannelli, file aperti di recente)
.obsidian/workspace.json
.obsidian/graph.json

# Escludi eventuali file di log o temporanei del sistema operativo
.DS_Store
Thumbs.db

# Opzionale: se hai plugin che salvano dati locali pesanti o sensibili
# .obsidian/plugins/nome-plugin/data.json

Mantenere la sincronizzazione di .obsidian/plugins.json e .obsidian/appearance.json è invece consigliato, così avrai gli stessi plugin e lo stesso tema su tutti i dispositivi.

Passo 3: Installazione e automazione con il plugin “Obsidian Git”

Non dovrai aprire il terminale ogni volta che finisci di scrivere una nota. Il plugin della community Obsidian Git farà tutto in background.

[Impostazioni] ➔ [Plugin della community] ➔ Cerca: "Obsidian Git" ➔ Installa e Attiva

Una volta attivato, entra nelle opzioni del plugin per configurare la frequenza di sincronizzazione. Ecco i parametri consigliati per un flusso di lavoro fluido:

Configurazione dei Timer

  • Vault backup interval (minutes): Impostalo a 15 o 30. Ogni tot minuti, se ci sono modifiche, il plugin eseguirà un git commit e un git push in automatico.
  • Auto pull interval (minutes): Impostalo a 5 o 10. Controlla se ci sono modifiche sul server (ad esempio se hai scritto dal laptop) e le scarica sul PC fisso.
  • Pull updates on startup: Attivalo. È fondamentale: appena apri Obsidian, il plugin scarica gli ultimi aggiornamenti prima che tu possa generare conflitti modificando una nota obsoleta.

Personalizzazione del Commit

  • Commit message: Il valore di default è VAULT BACKUP %date%. Puoi lasciarlo così o personalizzarlo per rendere la cronologia più pulita.

Passo 4: Cosa succede se c’è un conflitto?

Lavorando su più computer, può capitare di modificare la stessa nota prima che il plugin abbia il tempo di sincronizzarsi. Git bloccherà il push per evitare sovrascritture.

Niente panico. Se Obsidian Git ti avvisa di un fallimento nel push:

  1. Apri la Command Palette di Obsidian (Ctrl+P su Windows/Linux, Cmd+P su Mac).
  2. Cerca Obsidian Git: Open Source Control View.
  3. Vedrai visivamente quali file sono in conflitto. Il plugin inserisce i classici marker di Git (<<<<<<< HEAD) direttamente nel testo della nota.
  4. Ti basterà aprire la nota, scegliere quale versione mantenere, cancellare i marker e fare clic su “Commit & Push” dall’interfaccia del plugin.

E per il mobile (Android / iOS)?

È l’unico vero “compromesso” di questa architettura. Obsidian Git funziona nativamente su desktop, ma sui dispositivi mobili le limitazioni del sistema operativo rendono l’esecuzione di Git in background più complessa.

  • Su Android: È possibile utilizzare app come Termux combinata con l’app Tasker per sincronizzare la cartella tramite script Git locali.
  • Su iOS: L’approccio più comune prevede l’uso di Working Copy (un client Git per iOS eccellente, ma a pagamento) sfruttando le automazioni dell’app Comandi (Shortcuts) di Apple.

Se il supporto mobile nativo e immediato è un requisito fondamentale e non vuoi combaciare con script di automazione esterni, Obsidian Sync o soluzioni basate su iCloud/Remotely Save (S3/OneDrive) potrebbero essere più adatte. Se invece il tuo flusso di lavoro è principalmente desktop-based, la combinazione Obsidian + Git è imbattibile.

Conclusione

Configurare Git richiede 10 minuti di pazienza iniziali, ma ripaga ampiamente nel lungo termine. Ottieni un sistema di backup centralizzato, privato, indistruttibile e soprattutto basato su standard aperti. La tua conoscenza rimane tua, per sempre.

Tu quale strategia usi per proteggere le tue note? Hai già provato l’approccio Git o preferisci soluzioni cloud tradizionali? Lascia un commento qui sotto!