Handleiding

🚀 Snel starten

1. Start Version Tracker. Bij de eerste start leidt een configuratieassistent je door het verlenen van volledige schijftoegang (nodig om je apps te scannen), en daarna eventueel door het installeren van de pakketbeheerders die je wilt volgen. Alles is later in de Instellingen te wijzigen.
2. Maak gebruik van de gratis proefperiode. A proefperiode van 7 dagen van de volledige versie begint automatisch. Geen creditcard nodig. Als die afloopt, gaat de app terug naar de gratis versie (scannen blijft altijd beschikbaar).
3. Wacht op de eerste scan. Afhankelijk van het aantal geïnstalleerde apps en actieve bronnen duurt de eerste scan 10 tot 60 seconden.
4. Bekijk het tabblad « Alle ». Daar komen alle beschikbare updates uit alle bronnen samen.
5. Klik op « Alles bijwerken » om alle updates in één keer te starten, of gebruik de losse knoppen om elke app apart te doen.

Installeren met Homebrew

Version Tracker is beschikbaar via zijn eigen Homebrew-tap.

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

Version Tracker al met de hand geïnstalleerd? Voeg --force toe zodat Homebrew de kopie overneemt die je al hebt:

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

Version Tracker houdt zichzelf bij, dus brew upgrade botst niet met de eigen updater van de app.

🗃️ Ondersteunde bronnen

Version Tracker vindt updates voor:

Instellingen → Bronnen toont de 51 bronnen, elk met twee schakelaars:

• Actief: de bron wordt gescand. Uitzetten verbergt de items en verkort de scan.
• Gegroepeerd: de bron doet mee aan Alles bijwerken, Verwerk alles en Alles downloaden. Zet dit uit om een bron zichtbaar en gescand te houden, maar buiten de grote knoppen. De losse rijen blijven één voor één bij te werken.

Gegroepeerd is grijs zolang Actief uit staat: een bron die niet gescand wordt, heeft niets bij te dragen aan een batch.

Let op: Adobe Camera Raw is een plug-in en geen app, maar staat in de lijst en wordt bijgewerkt met de andere Creative Cloud-producten.

🖥️ De interface

Het hoofdscherm bestaat uit drie kolommen, met daarboven een werkbalk:

Linker navigatiekolom

De navigatie is ingedeeld in inklapbare secties die je met slepen kunt herschikken. De teller naast elke categorie laat zien hoeveel items erin staan, met een kleur die zegt wat het zijn (zie wat de kleuren van de badges betekenen).

• OVERZICHT: Dashboard (overzicht, recente activiteit, laatste momentopname) en Momentopnamen
• UPDATES: Alle (alle updates in één lijst), Apps, Pakketten, Homebrew, Systeemupdates, Apple Developer Tools, Gesnoozed (zie een update uitstellen)…
• Daarna secties per gebied (APPS, SYSTEEM, AI, JavaScript, Python, Rust, editors…): alleen die verschijnen die overeenkomen met wat er echt op je Mac staat.

Werkbalk

• Scan: start een volledige scan (met dezelfde knop annuleer je een lopende scan)
• Instellingen en Feedback: rechtstreeks naar de voorkeuren en het feedbackformulier
• Twee knoppen om de navigatiekolom en het paneel Details te tonen of te verbergen

Middengebied

De lijst met items van de gekozen categorie, met een zoekveld. Elke rij toont:

• Het pictogram en de naam van de app of het pakket
• De huidige versie en de beschikbare versie
• Een knop die past bij de situatie (Bijwerken, Downloaden, Openen, Onthullen in Finder…)

Zoeken dekt zowel apps als pakketten, inclusief gems, crates, yarn-pakketten en uv-tools. Typen filtert meteen, hoe groot je inventaris ook is. Een resultaat kiezen opent de juiste categorie, selecteert de rij en scrolt hem in beeld; een app waarvan de enige rij zijn Homebrew-cask is, landt op die rij.

De kolommen onthouden elke breedte die je instelt, ook die van de naam, en elke tabel past zijn kolommen aan de beschikbare ruimte aan als je het venster van formaat verandert.

Elke lijst vermeldt wanneer hij is gemaakt, ook de pakketlijsten, Adopteerbaar en Genegeerd. Een lege lijst legt uit waarom hij leeg is in plaats van niets te tonen.

Rechter navigatiekolom (Details)

Details van het gekozen item, verdeeld over vier tabbladen: beschrijving, versies, release-opmerkingen, bron, pad op schijf en de beveiligingscontroles.

• De knoppen Bijwerken en Downloaden staan hier ook, niet alleen op de rij. Een download toont zijn voortgangsbalk en wordt daarna Onthul in Finder.
• Kopieer rapport zet met één klik alles op het klembord wat de vier tabbladen over het item weten.
• Meer acties → Meld een verkeerde detectie opent een formulier dat al is ingevuld met wat Version Tracker zag: je hoeft alleen te zeggen wat er mis is.
• Het paneel opent weer op het tabblad dat je het laatst gebruikte, en tijdens een batch gaat het direct van de ene app naar de volgende in plaats van er tussenin leeg te blijven.
• De knoppen zijn grijs terwijl een scan, een batch of een download loopt, net als de rijen al waren.

Let op: de vensterbreedte wordt tussen sessies onthouden. De minimale grootte is zo gekozen dat alle drie kolommen comfortabel passen.

🔄 Apps bijwerken

Losse update

Klik op de groene knop « Bijwerken » op een rij (vereist een actieve licentie of de proefperiode, zie Licentie en proef). Afhankelijk van de bron:

• Mac App Store: gebruikt CommerceKit (stille update op de achtergrond)
• Homebrew-cask of -formula: voert brew upgrade uit (met beheerderrechten indien nodig, zie hieronder). Weigert brew de upgrade ter plekke, dan past Version Tracker automatisch de geforceerde herinstallatie toe die brew aanraadt.
• Sparkle: downloadt de DMG/ZIP, ontkoppelt de oude versie en installeert de nieuwe
• GitHub: downloadt en installeert het nieuwste binaire bestand
• Directe download: zie de volgende sectie

Automatische back-up: als de bevoorrechte helper aanstaat, wordt de vorige versie van de app vóór elke update bewaard. Gaat er iets mis, herstel hem dan via Instellingen → Back-ups (bewaartermijn en aantal kopieën zijn instelbaar).

Batch-update

De knop « Alles bijwerken » in de weergave Alle start alle automatiseerbare updates op volgorde, na een bevestiging die het aantal updates samenvat. Je kunt de weergave verlaten: de bewerking loopt op de achtergrond door, en aan het eind verschijnt een samenvatting (inclusief uitgestelde updates).

Je kunt ook meerdere rijen selecteren en alleen die selectie bijwerken, via het menu.

Een batch neemt alleen de bronnen mee waarvan de schakelaar Gegroepeerd aanstaat (zie Ondersteunde bronnen). Vier regels bepalen wat er verder buiten blijft:

• Draaiende apps en grote versiesprongen worden uitgesloten door het veiligheidsfilter (Instellingen → Updates). Je kunt ze nog steeds één voor één bijwerken.
• Updates die een nieuwere macOS vereisen dan die je draait worden uitgesloten, en de rij noemt de vereiste versie.
• Een update zonder enige handtekening wordt met een waarschuwing aangekondigd voordat er iets wordt geïnstalleerd. Een update waarvan de handtekening de controle niet doorstaat, blijft geblokkeerd, punt uit.
• Op een Intel-Mac blijven Homebrew-formulae die mogelijk uit de broncode gecompileerd moeten worden buiten een globale batch, en het rapport zegt welke en waarom. Werk ze los bij als je toch door wilt: Version Tracker staat dan tot acht uur per formula toe en je kunt op elk moment annuleren.

Mislukt een rij terwijl het bestand al gedownload was, dan wordt de download aan jou overgedragen in plaats van weggegooid: de rij biedt Onthul in Finder.

Een update uitstellen

Een update die je nu niet wilt, kun je uitstellen in plaats van negeren. Klik met rechts op de rij, kies Uitstellen en dan de duur: 1 dag, 3 dagen, 1 week, 2 weken, 1 maand of Voor onbepaalde tijd.

De rij gaat naar de categorie Gesnoozed in de navigatiekolom, die alle apps, pakketten en extensies verzamelt waarvan de update is overgeslagen of uitgesteld. Hij verlaat de updatelijsten en de tellers, dus hij zeurt niet meer, maar hij is nooit kwijt: Stop met uitstellen haalt hem meteen terug.

Gesnoozed is niet Genegeerd. Genegeerd is voor items waar Version Tracker niets mee kan. Gesnoozed is je eigen beslissing, met een datum eraan, en de rij komt vanzelf terug als de termijn afloopt.

Handmatige download (« Downloaden »)

Sommige apps hebben geen automatisch mechanisme maar bieden wel een directe download-URL (PKG, DMG, ZIP). Voor die apps:

• De oranje knop « Downloaden » verschijnt
• Het bestand komt in je downloadmap (standaard ~/Downloads, aan te passen in de Instellingen)
• Zodra het binnen is, wordt de knop « Onthul in Finder » om de installatie met de hand af te ronden

De knop « Alles downloaden » start de downloads in batch voor alle apps die daarvoor in aanmerking komen.

Bij een fout (HTTP 403, bestand niet gevonden, enzovoort) wordt de knop « Openen »: Version Tracker start de geïnstalleerde app zodat die zijn eigen update kan afhandelen.

📸 Momentopnamen

De weergave Momentopnamen (sectie OVERZICHT) legt de volledige softwarestaat van je Mac vast: apps, pakketten, tools, geïnstalleerde versies en bekende updates.

• Maak momentopname (⇧+⌘+N): legt de huidige inventaris vast. Je kunt hem daarna hernoemen of vastzetten.
• Vergelijk: kies twee momentopnamen om alles te zien wat ertussen veranderd is (toegevoegde, verwijderde of bijgewerkte items), met filters per soort verandering.
• Exporteer…: exporteert een momentopname of een vergelijking als JSON, CSV of Markdown. Twee privacyprofielen: Volledig (bewaart paden en machinenaam, houd hem lokaal) of Deelbaar (absolute paden, gebruikersnaam en machinenaam worden gemaskeerd).

Typische toepassingen: een machine vastleggen vóór een migratie of herinstallatie, bijhouden wat een updatesessie echt veranderd heeft, of een schone inventaris delen.

Automatische momentopnamen

Twee opties in Instellingen → Updates:

• Automatische momentopnamen rond « Alles bijwerken »: maakt een momentopname van de inventaris voor en na elke batch-update, om de veranderingen te vergelijken en vast te leggen.
• Momentopname na elke geplande scan: maakt aan het eind van elke automatische scan een momentopname, alleen als er iets veranderd is sinds de vorige.

📋 De menubalk

Version Tracker biedt een menubalkpictogram dat het aantal openstaande updates toont. Het pictogram beweegt terwijl een scan of een update loopt.

Het paneel

Op het pictogram klikken opent een paneel met de beschikbare updates (jouw versie → nieuwe versie), met:

• Acties per rij: Bijwerken, Downloaden of Openen, afhankelijk van de bron
• De knoppen Scan, Alles bijwerken en Alles downloaden
• Een voettekst met de datum van de laatste scan en het aantal gevolgde items
• Een chevron in de kop om de lijst in of uit te klappen (« Verberg de lijst » / « Toon de lijst »): ingeklapt krimpt het paneel tot zijn kop en voettekst

Zelfstandig, ook met de app dicht

• Openen bij inloggen (Instellingen → Algemeen): start bij het inloggen alleen het menubalkpictogram, zonder het hoofdvenster te openen.
• Updates die je vanuit het paneel start, lopen in een achtergrondproces, zonder het hoofdvenster of het Dock-pictogram te openen.
• Met Achtergrondscan (Instellingen → Automatisering) blijven geplande scans doorlopen, per interval of op een vast tijdstip per dag, ook als de app is afgesloten: badge en meldingen blijven bij.

⚙️ Instellingen

De instellingen zijn verdeeld over panelen:

Gescande mappen

Standaard kijkt Version Tracker daar waar macOS apps neerzet. Instellingen → Bronnen → Gescande mappen verandert dat:

• Mappen om ook te scannen: voeg een map toe, bijvoorbeeld een tweede schijf, zodat je apps daar ook gevonden worden.
• Mappen om met rust te laten: Version Tracker kijkt er niet in.

Staat dezelfde map in beide lijsten, dan wint met rust laten. Een map uit een lijst halen haalt hem van de lijst en raakt niets aan van wat erin staat.

Tooltips

Wijs een knop of een instelling aan en een zin legt uit wat die doet, zowel in het venster als in het menubalkpaneel.

Tooltips staan in versie 1.3 standaard uit. Zet ze aan in Instellingen → Uiterlijk → Tooltips. De schakelaar geldt voor de hele app, niet voor één scherm van de twee.

Het menubalkpictogram verbergen

Instellingen → Algemeen → Verberg het menubalkpictogram haalt het pictogram helemaal weg, of het venster nu open of dicht is. Het venster sluiten verbergt het dan gewoon, en je opent het weer vanuit het Dock of met ⌘+Tab.

Het venster sluiten

• Het hoofdvenster sluiten (⌘+W of de rode knop) verbergt het venster: de app blijft actief op de achtergrond.
• De optie « Het venster sluiten laat alleen de menubalk over » (Instellingen → Algemeen) sluit de hoofd-app bij het sluiten en laat alleen het menubalkpictogram staan.
• ⌘+Q sluit de app echt af (een melding waarschuwt je als er een update bezig is).

🔐 Beheerderrechten

Sommige updates vragen beheerderrechten. Version Tracker biedt twee manieren:

1. Bevoorrechte helper (aanbevolen): een kleine ondertekende daemon, eens en voor altijd aangezet via Instellingen → Algemeen → Bevoorrechte helper → Inschakelen.
2. Eenmalige verificatie: staat de helper niet geïnstalleerd, dan vraagt een systeemvenster bij elke bewerking om je beheerderswachtwoord.

Wat de helper oplevert:

• Geen wachtwoordvraag meer bij elke update
• Atomaire installatie (de app blijft nooit half vervangen achter)
• Controle van handtekening en Team ID aan de root-kant
• Automatische back-up van de vorige versie vóór elke update

Reageert de helper niet? Gebruik na een update van de app de knop « Repareren » in het paneel Bevoorrechte helper: die registreert de daemon opnieuw zonder je wachtwoord opnieuw te vragen.

🔑 Licentie en proef

Version Tracker volgt een freemium-model:

• Gratis versie: volledig scannen en de volledige inventaris blijven altijd beschikbaar. Je ziet alles wat verouderd is, in alle bronnen.
• Licentie (Mono, Solo of Family): ontgrendelt het installeren van updates met één klik, batch-updates en updates vanuit de menubalk. Zie abonnementen en prijzen.
• Gratis proefperiode van 7 dagen: begint automatisch bij de eerste start, zonder creditcard. Als de proefperiode afloopt, gaat de app automatisch terug naar de gratis versie.

Een licentie activeren: open Instellingen → Licentie en plak de sleutel die je na aankoop per e-mail hebt gekregen. Je kunt de licentie op de ene Mac deactiveren om een plek vrij te maken en hem op een andere activeren.

Een plek hoort bij een gebruikersaccount, niet bij een Mac. Je sleutel staat in je inlogsleutelhanger, die macOS voor elk account apart houdt. Een tweede account op dezelfde Mac begint dus zonder licentie en gebruikt een eigen plek zodra je hem daar activeert. Reken op één plek per gebruikersaccount dat Version Tracker gaat draaien.

Licentiesleutel kwijt, of een factuur nodig? Open Mijn bestellingen en log in met het e-mailadres van je aankoop. Geen wachtwoord, alleen een magic link. Je ziet er elke bestelling, je licentiesleutel en de downloadbestanden. Wil je je abonnement beheren (betaalmethode, btw-gegevens, ander abonnement), gebruik dan het factuurportaal.

🖱️ Sneltoetsen

Wil je opnieuw een volledige scan draaien, gebruik dan de knop Scan in de werkbalk of de knop Scan in het menubalkpaneel.

🌍 Talen

Version Tracker is beschikbaar in:

• 🇬🇧 Engels
• 🇫🇷 Frans
• 🇩🇪 Duits
• 🇪🇸 Spaans
• 🇵🇹 Portugees (Portugal)
• 🇮🇹 Italiaans
• 🇳🇱 Nederlands

De taal volgt automatisch de systeeminstellingen van macOS en kan worden overschreven in Instellingen → Algemeen → Taal.

🗑️ Version Tracker verwijderen

De app naar de prullenmand slepen is voor de meeste mensen genoeg. Hier de volledige procedure als je niets wilt achterlaten.

Eenvoudige methode (aanbevolen)

• Open de Instellingen en zet Algemeen → Openen bij inloggen en Automatisering → Achtergrondscan.
• Sluit Version Tracker en zijn menubalkpictogram af (klik op het pictogram → Stop).
• Sleep Version Tracker.app uit /Applications naar de prullenmand en leeg de prullenmand.

Geen haast: ook zonder deze stap zijn eventuele restanten inert. Er draait niets, niets is root, niets gebruikt bronnen.

Voor een volledige verwijdering (optioneel)

Version Tracker installeert drie kleine onderdelen, alle door jou goedgekeurd bij de installatie: een bevoorrechte helper en een menubalkpictogram (beide in de app, die verdwijnen met de app mee) en een geplande scantaak (een apart bestand). Heb je de stap hierboven overgeslagen, verwijder die dan met de hand:

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

Wil je ook je app-back-ups en inventaris-momentopnamen weghalen (onomkeerbaar):

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

Staat Version Tracker ten slotte nog in Systeeminstellingen → Algemeen → Inloggen en extensies, verwijder dan de vermelding (die verdwijnt kort daarna vanzelf).

Van plan opnieuw te installeren of van Mac te wisselen?

• Opnieuw installeren op dezelfde Mac: raak niets aan. Je licentiesleutel blijft in de sleutelhanger staan en activeert vanzelf.
• Overstappen naar een andere Mac: maak eerst je activeringsplek vrij via Instellingen → Licentie → Deactiveren, vóórdat je de app weghaalt.

Wil de bevoorrechte helper niet opnieuw installeren? Zet in Systeeminstellingen → Algemeen → Inloggen en extensies Version Tracker uit en daarna weer aan (de hele cyclus zet de staat gelijk: alleen aanzetten is niet genoeg). Blijft het probleem, leeg dan de prullenmand en start opnieuw op.

🗑️ Pakketbeheerders verwijderen

Voordat je begint

• Open de app Terminal (Programma's → Hulpprogramma's). Het configuratiebestand van de shell dat hieronder staat is ~/.zshrc (de standaard van macOS).
• Verwijder alleen tools die jij voor Version Tracker hebt geïnstalleerd. Hangen andere software of projecten ervan af, houd ze dan.
• Verwijder eerst de losse tools en Homebrew als laatste: die verwijderen haalt alle pakketten weg die ermee zijn geïnstalleerd.
• Na het verwijderen stopt Version Tracker gewoon met het volgen van die bron. Je kunt elke tool op elk moment opnieuw installeren vanuit de configuratieassistent of de Instellingen.

1. Tools die Version Tracker zelf heeft geïnstalleerd (via Homebrew)

Homebrew weigert te verwijderen als andere formulae ervan afhangen. Dat is een beveiliging, geen fout.

⚠️ Homebrew (als laatste) verwijdert Homebrew en elk pakket dat ermee is geïnstalleerd:

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

Het script somt aan het eind de overgebleven mappen op (meestal /opt/homebrew op Apple Silicon, /usr/local/Homebrew op Intel).

2. Externe tools (geïnstalleerd via hun officiële handleiding)

Heb je een van deze met Homebrew geïnstalleerd in plaats van met het officiële installatieprogramma, gebruik dan gewoon brew uninstall <formula> in plaats daarvan.

Controleren

Voor elke verwijderde tool: command -v <tool> hoort niets te tonen (open eerst een nieuw Terminal-venster).

❓ Veelgestelde vragen

📩 Contact

De beste plek om een fout te melden of een functie te vragen is de openbare tracker op GitHub. Elke melding is voor iedereen zichtbaar, dus je kunt kijken of jouw probleem al gemeld is, je eigen details eraan toevoegen en het volgen tot het opgelost is.

• Fouten en functieverzoeken: open een issue op github.com/Version-Tracker/feedback
• Licentie, facturatie of privévragen: contact@version-tracker.app
• Snelle feedback: de knop Feedback in de app zelf

Een fout melden? Noem je macOS-versie, je Version Tracker-versie en welke app of bron het betreft. Omdat de tracker openbaar is, plak je nooit je licentiesleutel of persoonlijke gegevens in een issue: stuur die per e-mail.