Manuale d'uso

🚀 Per iniziare

1. Avvia Version Tracker. Al primo avvio, un assistente di configurazione ti guida nella concessione dell'accesso completo al disco (necessario per analizzare le tue applicazioni), poi, se vuoi, nell'installazione dei gestori di pacchetti che vuoi monitorare. Tutto si può cambiare in seguito nelle Impostazioni.
2. Approfitta della prova gratuita. A di 7 giorni della versione completa parte automaticamente. Nessuna carta di credito. Al termine, l'app torna alla versione gratuita (l'analisi resta sempre disponibile).
3. Aspetta la prima analisi. A seconda del numero di app installate e delle fonti attive, la prima analisi richiede da 10 a 60 secondi.
4. Guarda la scheda « Tutti ». È lì che si riuniscono tutti gli aggiornamenti disponibili di tutte le fonti.
5. Fai clic su « Aggiorna tutto » per lanciare tutti gli aggiornamenti in una volta, oppure usa i pulsanti individuali per gestire ogni app.

Installare con Homebrew

Version Tracker è disponibile dal suo tap Homebrew.

brew tap version-tracker/tap
brew install --cask version-tracker/tap/version-tracker

Hai già installato Version Tracker a mano? Aggiungi --force perché Homebrew prenda in carico la copia che hai già:

brew install --cask --force version-tracker/tap/version-tracker

Version Tracker si aggiorna da solo, quindi brew upgrade non entrerà in conflitto con l'aggiornatore dell'app.

🗃️ Fonti supportate

Version Tracker rileva gli aggiornamenti di:

Impostazioni → Fonti elenca le 51 fonti, ciascuna con due interruttori:

• Attiva: la fonte viene analizzata. Disattivarla nasconde i suoi elementi e accorcia l'analisi.
• Raggruppata: la fonte partecipa a Aggiorna tutto, Elabora tutto e Scarica tutto. Disattivala per tenere una fonte visibile e analizzata, ma fuori dai pulsanti grandi. Le sue righe restano aggiornabili una per una.

Raggruppata è in grigio finché Attiva è disattivata, perché una fonte che non viene analizzata non ha nulla da dare a un lotto.

Nota: Adobe Camera Raw è un plug-in e non un'app, ma viene elencato e aggiornato con gli altri prodotti Creative Cloud.

🖥️ L'interfaccia

La schermata principale è divisa in tre colonne, sormontate da una barra degli strumenti:

Barra laterale sinistra

La navigazione è organizzata in sezioni richiudibili che puoi riordinare trascinandole. Il contatore accanto a ogni categoria indica quanti elementi elenca, con un colore che dice di cosa si tratta (vedi cosa significano i colori dei badge).

• PANORAMICA: Dashboard (panoramica, attività recente, ultima istantanea) e Istantanee
• AGGIORNAMENTI: Tutti (tutti gli aggiornamenti in un unico elenco), Applicazioni, Pacchetti, Homebrew, Aggiornamenti di sistema, Apple Developer Tools, Posticipato (vedi posticipare un aggiornamento)…
• Poi sezioni per ambito (APPLICAZIONI, SISTEMA, IA, JavaScript, Python, Rust, editor…): compaiono solo quelle che corrispondono a ciò che è davvero installato sul tuo Mac.

Barra degli strumenti

• Analizza: lancia un'analisi completa (il pulsante permette anche di annullare un'analisi in corso)
• Impostazioni e Feedback: accesso diretto alle preferenze e al modulo di feedback
• Due pulsanti per mostrare o nascondere la barra laterale e il pannello Dettagli

Area centrale

L'elenco degli elementi della categoria selezionata, con un campo di ricerca. Ogni riga mostra:

• L'icona e il nome dell'applicazione o del pacchetto
• La versione attuale e la versione disponibile
• Un pulsante d'azione contestuale (Aggiorna, Scarica, Apri, Rivela nel Finder…)

La ricerca copre sia le applicazioni sia i pacchetti, gems, crates, pacchetti yarn e strumenti uv compresi. La digitazione filtra subito, per quanto grande sia il tuo inventario. Scegliere un risultato apre la categoria giusta, seleziona la riga e la porta in vista; un'app la cui unica riga è il suo cask Homebrew atterra su quella riga.

Le colonne ricordano ogni larghezza che imposti, compresa quella del nome, e ogni tabella adatta le sue colonne allo spazio disponibile quando ridimensioni la finestra.

Ogni elenco indica quando è stato fatto, comprese le liste di pacchetti, Adottabili e Ignorate. Un elenco vuoto spiega perché è vuoto invece di non mostrare nulla.

Barra laterale destra (Dettagli)

Dettagli dell'elemento selezionato, distribuiti su quattro schede: descrizione, versioni, note di versione, fonte, percorso su disco e controlli di sicurezza.

• I pulsanti Aggiorna e Scarica sono anche qui, non solo sulla riga. Un download mostra la sua barra di avanzamento, poi diventa Rivela nel Finder.
• Copia rapporto mette negli appunti, con un clic, tutto ciò che le quattro schede sanno dell'elemento.
• Più azioni → Segnala un rilevamento errato apre un modulo già compilato con quello che Version Tracker ha visto: devi solo dire cosa non va.
• Il pannello si riapre sulla scheda che usavi e, durante un lotto, passa direttamente da un'app alla successiva invece di svuotarsi in mezzo.
• I suoi pulsanti sono in grigio durante un'analisi, un lotto o un download, come lo erano già le righe.

Nota: la larghezza della finestra viene memorizzata tra una sessione e l'altra. La dimensione minima è pensata per mostrare comodamente le tre colonne.

🔄 Aggiornare le applicazioni

Aggiornamento individuale

Fai clic sul pulsante verde « Aggiorna » di una riga (richiede una licenza attiva o la prova, vedi Licenza e prova). A seconda della fonte:

• Mac App Store: usa CommerceKit (aggiornamento silenzioso in background)
• Cask o formula Homebrew: esegue brew upgrade (con autenticazione amministratore se necessario, vedi sotto). Se brew rifiuta l'aggiornamento sul posto, Version Tracker applica automaticamente la reinstallazione forzata che brew consiglia.
• Sparkle: scarica il DMG/ZIP, smonta la vecchia versione e installa quella nuova
• GitHub: scarica e installa il binario più recente
• Download diretto: vedi la sezione seguente

Backup automatico: quando l'helper privilegiato è attivo, la versione precedente dell'app viene salvata prima di ogni aggiornamento. Se qualcosa va storto, ripristinala da Impostazioni → Backup (periodo di conservazione e numero di copie sono regolabili).

Aggiornamento in lotto

Il pulsante « Aggiorna tutto » nella vista Tutti lancia in sequenza tutti gli aggiornamenti automatizzabili, dopo una conferma che riepiloga il numero di aggiornamenti. Puoi lasciare la vista: l'operazione continua in background e alla fine appare un riepilogo (compresi gli aggiornamenti posticipati).

Puoi anche selezionare più righe e aggiornare solo quella selezione, dal menu.

Un lotto prende solo le fonti il cui interruttore Raggruppata è attivo (vedi Fonti supportate). Quattro regole decidono cos'altro resta fuori:

• Le app in esecuzione e gli aggiornamenti maggiori sono esclusi dal filtro di sicurezza (Impostazioni → Aggiornamenti). Puoi comunque aggiornarli uno alla volta.
• Gli aggiornamenti che richiedono un macOS più recente del tuo sono esclusi, e la riga indica la versione necessaria.
• Un aggiornamento senza alcuna firma viene annunciato con un avviso prima di installare qualsiasi cosa. Un aggiornamento la cui firma non supera la verifica resta bloccato, senza eccezioni.
• Su un Mac Intel, le formule Homebrew che potrebbero dover essere compilate dai sorgenti restano fuori da un lotto globale, e il rapporto dice quali e perché. Aggiornale singolarmente se vuoi procedere: Version Tracker concede allora fino a otto ore per formula e puoi annullare in qualsiasi momento.

Se una riga fallisce quando il suo file era già scaricato, il download ti viene consegnato invece di essere buttato: la riga propone Rivela nel Finder.

Posticipare un aggiornamento

Un aggiornamento che non vuoi adesso può essere posticipato invece che ignorato. Fai clic destro sulla riga, scegli Differire, poi la durata: 1 giorno, 3 giorni, 1 settimana, 2 settimane, 1 mese oppure Indefinitamente.

La riga passa alla categoria Posticipato nella barra laterale, che riunisce tutte le app, i pacchetti e le estensioni il cui aggiornamento è saltato o posticipato. Lascia gli elenchi di aggiornamenti e i contatori, quindi smette di insistere, ma non è mai persa: Smettere di rinviare la riporta subito.

Posticipato non è Ignorate. Ignorate raccoglie gli elementi con cui Version Tracker non può fare nulla. Posticipato è una tua decisione, con una data attaccata, e la riga torna da sola quando il termine scade.

Download manuale (« Scarica »)

Alcune app non hanno un meccanismo automatico ma espongono un URL di download diretto (PKG, DMG, ZIP). Per queste:

• Il pulsante arancione « Scarica » compare
• Il file viene scaricato nella tua cartella dei download (per impostazione predefinita ~/Downloads, personalizzabile nelle Impostazioni)
• Una volta scaricato, il pulsante diventa « Rivela nel Finder » per completare l'installazione a mano

Il pulsante « Scarica tutto » avvia i download in lotto per tutte le app idonee.

In caso di errore (HTTP 403, file non trovato, ecc.), il pulsante diventa « Apri »: Version Tracker avvia l'app installata perché gestisca il proprio aggiornamento.

📸 Istantanee

La vista Istantanee (sezione PANORAMICA) cattura lo stato software completo del tuo Mac: applicazioni, pacchetti, strumenti, versioni installate e aggiornamenti noti.

• Crea istantanea (⇧+⌘+N): cattura l'inventario attuale. Puoi poi rinominarla o fissarla.
• Confronta: seleziona due istantanee per vedere tutto ciò che è cambiato tra loro (elementi installati, rimossi o aggiornati), con filtri per tipo di cambiamento.
• Esporta…: esporta un'istantanea o un confronto in JSON, CSV o Markdown. Due profili di riservatezza: Completo (conserva percorsi e nome della macchina, tienilo in locale) oppure Condivisibile (percorsi assoluti, nome utente e nome della macchina sono mascherati).

Casi d'uso tipici: documentare una macchina prima di una migrazione o di una reinstallazione, seguire cosa ha davvero cambiato una sessione di aggiornamenti, o condividere un inventario pulito.

Istantanee automatiche

Due opzioni in Impostazioni → Aggiornamenti:

• Istantanee automatiche attorno a « Aggiorna tutto »: crea un'istantanea dell'inventario prima e dopo ogni aggiornamento in lotto, per confrontare e documentare i cambiamenti.
• Istantanea dopo ogni analisi programmata: al termine di ogni analisi automatica crea un'istantanea, solo se qualcosa è cambiato dall'ultima.

📋 La barra dei menu

Version Tracker offre un'icona nella barra dei menu che mostra il numero di aggiornamenti in attesa. L'icona si anima mentre un'analisi o un aggiornamento è in corso.

Il pannello

Facendo clic sull'icona si apre un pannello che elenca gli aggiornamenti disponibili (la tua versione → nuova versione), con:

• Azioni per riga: Aggiorna, Scarica oppure Apri a seconda della fonte
• I pulsanti Analizza, Aggiorna tutto e Scarica tutto
• Un piè di pagina con la data dell'ultima analisi e il numero di elementi monitorati
• Un chevron nell'intestazione per richiudere o espandere l'elenco (« Nascondi l'elenco » / « Mostra l'elenco »): richiuso, il pannello si riduce alla sua intestazione e al piè di pagina

Autonomo, anche ad app chiusa

• Apri all'accesso (Impostazioni → Generale): all'avvio della sessione lancia solo l'icona della barra dei menu, senza aprire la finestra principale.
• Gli aggiornamenti lanciati dal pannello girano in un processo in background, senza aprire la finestra principale né l'icona del Dock.
• Con la Analisi in background (Impostazioni → Automazione), le analisi programmate, a intervalli o a un'ora fissa giornaliera, continuano anche ad app chiusa: badge e notifiche restano aggiornati.

⚙️ Impostazioni

Le impostazioni sono organizzate in pannelli:

Cartelle scansionate

Per impostazione predefinita Version Tracker cerca dove macOS mette le applicazioni. Impostazioni → Fonti → Cartelle scansionate permette di cambiarlo:

• Anche le cartelle da scansionare: aggiungi una cartella, per esempio un secondo disco, perché anche le tue app che si trovano lì vengano trovate.
• Cartelle da lasciare stare: Version Tracker non guarderà dentro.

Se la stessa cartella è in entrambe le liste, lasciarla stare vince. Togliere una cartella da una lista la toglie dalla lista e non tocca nulla di ciò che contiene.

Suggerimenti

Punta su un pulsante o un'impostazione e una frase spiega cosa fa, sia nella finestra sia nel pannello della barra dei menu.

I suggerimenti sono disattivati per impostazione predefinita nella versione 1.3. Attivali in Impostazioni → Aspetto → Suggerimenti. L'interruttore governa tutta l'app, non una schermata su due.

Nascondere l'icona della barra dei menu

Impostazioni → Generale → Nascondi l'icona della barra dei menu toglie completamente l'icona, che la finestra sia aperta o chiusa. Chiudere la finestra la nasconde allora semplicemente, e la riapri dal Dock o con ⌘+Tab.

Chiusura della finestra

• Chiudere la finestra principale (⌘+W o il pulsante rosso) nasconde la finestra: l'app resta attiva in background.
• L'opzione « Chiudere la finestra lascia solo la barra dei menu » (Impostazioni → Generale) chiude l'app principale alla chiusura e lascia solo l'icona della barra dei menu.
• ⌘+Q chiude davvero l'applicazione (un avviso ti previene se un aggiornamento è in corso).

🔐 Autenticazione amministratore

Alcuni aggiornamenti richiedono i privilegi di amministratore. Version Tracker offre due meccanismi:

1. Helper privilegiato (consigliato): un piccolo demone firmato, attivato una volta per tutte da Impostazioni → Generale → Helper privilegiato → Attiva.
2. Autenticazione puntuale: se l'helper non è installato, una finestra di sistema chiede la password di amministratore a ogni operazione.

Cosa porta l'helper:

• Nessuna richiesta di password a ogni aggiornamento
• Installazione atomica (l'app non resta mai sostituita a metà)
• Verifica della firma e del Team ID lato root
• Backup automatico della versione precedente prima di ogni aggiornamento

L'helper non risponde? Dopo un aggiornamento dell'app, usa il pulsante « Ripara » nel pannello Helper privilegiato: registra di nuovo il demone senza chiederti di nuovo la password.

🔑 Licenza e prova

Version Tracker segue un modello freemium:

• Versione gratuita: l'analisi e l'inventario completi restano sempre disponibili. Vedi tutto ciò che è obsoleto, su tutte le fonti.
• Licenza (Mono, Solo o Family): sblocca l'installazione degli aggiornamenti con un clic, gli aggiornamenti in lotto e gli aggiornamenti dalla barra dei menu. Vedi piani e prezzi.
• Prova gratuita di 7 giorni: parte automaticamente al primo avvio, senza carta di credito. Al termine della prova, l'app torna automaticamente alla versione gratuita.

Attivare una licenza: apri Impostazioni → Licenza e incolla la chiave ricevuta per e-mail dopo l'acquisto. Puoi disattivare la licenza su un Mac per liberare un posto e attivarla su un altro.

Un posto appartiene a un account utente, non a un Mac. La tua chiave resta nel portachiavi di accesso, che macOS tiene separato per ogni account. Un secondo account sullo stesso Mac parte quindi senza licenza e occupa un posto suo quando la attivi lì. Conta un posto per ogni account utente che userà Version Tracker.

Hai perso la chiave di licenza o ti serve una fattura? Apri I miei ordini e accedi con l'e-mail dell'acquisto. Nessuna password, solo un link magico. Elenca tutti gli ordini, la tua chiave di licenza e i file da scaricare. Per gestire l'abbonamento (metodo di pagamento, dati IVA, cambio di piano), usa invece il portale di fatturazione.

🖱️ Scorciatoie da tastiera

Per rilanciare un'analisi completa, usa il pulsante Analizza nella barra degli strumenti o il pulsante Analizza nel pannello della barra dei menu.

🌍 Lingue

Version Tracker è disponibile in:

• 🇬🇧 Inglese
• 🇫🇷 Francese
• 🇩🇪 Tedesco
• 🇪🇸 Spagnolo
• 🇵🇹 Portoghese (Portogallo)
• 🇮🇹 Italiano
• 🇳🇱 Olandese

La lingua segue automaticamente le impostazioni di sistema di macOS e può essere forzata in Impostazioni → Generale → Lingua.

🗑️ Disinstallare Version Tracker

Trascinare l'app nel Cestino basta nella grande maggioranza dei casi. Ecco la procedura completa se non vuoi lasciare alcuna traccia.

Metodo semplice (consigliato)

• Apri le Impostazioni e disattiva Generale → Apri all'accesso e Automazione → Analisi in background.
• Chiudi Version Tracker e la sua icona nella barra dei menu (clic sull'icona → Esci).
• Trascina Version Tracker.app da /Applications nel Cestino, poi svuota il Cestino.

Nessuna fretta: anche senza questo passaggio, le tracce rimaste sono inerti. Niente gira, niente è root, niente consuma risorse.

Per una rimozione completa (facoltativo)

Version Tracker installa tre piccoli componenti, tutti approvati da te al momento dell'installazione: un helper privilegiato e un'icona nella barra dei menu (entrambi dentro l'app, spariscono con lei) e un'attività di analisi programmata (un file separato). Se hai saltato il passaggio precedente, rimuovila a mano:

launchctl unload ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist

Per rimuovere anche i backup delle app e le istantanee dell'inventario (irreversibile):

rm -rf ~/Library/Application\ Support/Version\ Tracker
defaults delete com.jpflorencio.VersionTracker

Infine, se Version Tracker compare ancora in Impostazioni di Sistema → Generali → Elementi login ed estensioni, rimuovi la voce (sparisce da sola poco dopo).

Hai intenzione di reinstallare o cambiare Mac?

• Reinstallazione sullo stesso Mac: non toccare nulla. La tua chiave di licenza resta nel portachiavi e si attiva da sola.
• Passaggio a un altro Mac: libera prima il tuo posto di attivazione da Impostazioni → Licenza → Disattiva, prima di rimuovere l'app.

L'helper privilegiato non si reinstalla? In Impostazioni di Sistema → Generali → Elementi login ed estensioni, disattiva Version Tracker, poi riattivalo (il ciclo completo risincronizza lo stato: riattivarlo soltanto non basta). Se il problema persiste, svuota il Cestino e riavvia.

🗑️ Disinstallare i gestori di pacchetti

Prima di cominciare

• Apri l'app Terminale (Applicazioni → Utility). Il file di configurazione della shell citato qui sotto è ~/.zshrc (quello predefinito di macOS).
• Rimuovi solo gli strumenti che hai installato tu per Version Tracker. Se altri software o progetti dipendono da essi, tienili.
• Disinstalla prima i singoli strumenti e Homebrew per ultimo: disinstallarlo rimuove tutti i pacchetti installati con lui.
• Dopo la disinstallazione, Version Tracker smetterà semplicemente di monitorare quella fonte. Puoi reinstallare qualsiasi strumento in qualsiasi momento dall'avvio guidato o dalle Impostazioni.

1. Strumenti installati direttamente da Version Tracker (tramite Homebrew)

Homebrew rifiuterà la disinstallazione se altre formule dipendono da lui. È una protezione, non un errore.

⚠️ Homebrew (per ultimo) rimuove Homebrew e ogni pacchetto installato con lui:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

Alla fine lo script elenca le cartelle residue (di solito /opt/homebrew su Apple Silicon, /usr/local/Homebrew su Intel).

2. Strumenti esterni (installati tramite le loro guide ufficiali)

Se hai installato uno di questi con Homebrew invece che con il programma di installazione ufficiale, usa semplicemente brew uninstall <formula> al suo posto.

Verifica

Per ogni strumento disinstallato: command -v <tool> non deve stampare nulla (apri prima una nuova finestra del Terminale).

❓ Domande frequenti

📩 Contatto

Il posto migliore per segnalare un problema o chiedere una funzione è il tracker pubblico su GitHub. Ogni segnalazione è visibile a tutti, quindi puoi verificare se il tuo problema è già stato segnalato, aggiungere i tuoi dettagli e seguirne l'avanzamento fino alla correzione.

• Problemi e richieste di funzioni: apri una issue su github.com/Version-Tracker/feedback
• Licenza, fatturazione o domande private: contact@version-tracker.app
• Feedback rapido: il pulsante Feedback dentro l'app

Segnali un problema? Indica la tua versione di macOS, la tua versione di Version Tracker e quale app o fonte è interessata. Poiché il tracker è pubblico, non incollare mai la tua chiave di licenza o dati personali in una issue: mandali invece per e-mail.