Benutzerhandbuch

🚀 Schnellstart

1. Version Tracker starten. Beim ersten Start führt Sie ein Einrichtungsassistent durch die Freigabe des Festplattenvollzugriffs (nötig zum Scannen Ihrer Anwendungen) und optional durch die Installation der Paketmanager, die Sie verfolgen möchten. Alles lässt sich später in den Einstellungen ändern.
2. Kostenlose Testphase nutzen. Eine 7-tägige Testphase der Vollversion startet automatisch, ohne Kreditkarte. Danach kehrt die App zur kostenlosen Version zurück (das Scannen bleibt immer verfügbar).
3. Den ersten Scan abwarten. Je nach Anzahl der installierten Apps und aktiven Quellen dauert der erste Scan 10 bis 60 Sekunden.
4. « Alle » Tab prüfen. Hier werden alle verfügbaren Updates aus allen Quellen zusammengefasst.
5. Auf « Alle aktualisieren » klicken, um alle Updates auf einmal zu starten, oder die einzelnen Buttons zur Verwaltung jeder App verwenden.

Mit Homebrew installieren

Version Tracker ist über ein eigenes Homebrew-Tap verfügbar.

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

Version Tracker bereits von Hand installiert? Fügen Sie --force hinzu, damit Homebrew die vorhandene Kopie übernimmt:

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

Version Tracker hält sich selbst aktuell, brew upgrade kommt dem eigenen Updater der App also nicht in die Quere.

🗃️ Unterstützte Quellen

Version Tracker erkennt Updates für:

Einstellungen → Quellen listet die 51 Quellen mit je zwei Schaltern auf :

• Aktiv : Die Quelle wird gescannt. Ausschalten blendet ihre Einträge aus und verkürzt den Scan.
• Gruppiert : Die Quelle nimmt an Alle aktualisieren, Alles verarbeiten und Alle herunterladen teil. Schalten Sie sie aus, um eine Quelle sichtbar und gescannt zu halten, aber aus den großen Buttons herauszunehmen. Ihre Zeilen lassen sich weiterhin einzeln aktualisieren.

Gruppiert ist ausgegraut, solange Aktiv aus ist : Eine Quelle, die nicht gescannt wird, kann zu einem Stapel nichts beitragen.

Hinweis: Adobe Camera Raw ist ein Plug-in und keine App, wird aber zusammen mit den übrigen Creative-Cloud-Produkten aufgeführt und aktualisiert.

🖥️ Die Oberfläche

Der Hauptbildschirm ist in drei Spalten unterteilt, darüber eine Symbolleiste :

Linke Seitenleiste

Die Navigation ist in einklappbare Bereiche gegliedert, die Sie per Drag-and-Drop neu anordnen können. Der Zähler neben jeder Kategorie zeigt, wie viele Einträge sie enthält, und die Farbe zeigt, um welche es sich handelt (siehe was die Farben der Zähler bedeuten).

• ÜBERSICHT: Dashboard (Überblick, letzte Aktivität, letzter Schnappschuss) und Schnappschüsse
• AKTUALISIERUNGEN: Alle (sämtliche Updates in einer Liste), Apps, Pakete, Homebrew, Systemupdates, Apple Developer Tools, Zurückgestellt (siehe ein Update zurückstellen)…
• Danach Bereiche nach Domäne (ANWENDUNGEN, SYSTEM, KI, JavaScript, Python, Rust, Editoren…): Es erscheinen nur die, die zu tatsächlich installierten Dingen auf Ihrem Mac passen.

Symbolleiste

• Scannen: startet einen vollständigen Scan (über den Button lässt sich ein laufender Scan auch abbrechen)
• Einstellungen und Feedback: direkter Zugriff auf die Voreinstellungen und das Feedback-Formular
• Zwei Buttons zum Ein-/Ausblenden der Seitenleiste und des Details-Panels

Zentraler Bereich

Die Liste der Elemente für die ausgewählte Kategorie, mit Suchfeld. Jede Zeile zeigt :

• Das Icon und den Namen der App oder des Pakets
• Die aktuelle und die verfügbare Version
• Einen kontextbezogenen Action-Button (Aktualisieren, Herunterladen, Öffnen, Im Finder anzeigen…)

Die Suche erfasst Apps und Pakete gleichermaßen, einschließlich Gems, Crates, Yarn-Paketen und uv-Tools. Die Eingabe filtert sofort, wie umfangreich Ihr Bestand auch sei. Ein ausgewähltes Ergebnis öffnet die richtige Kategorie, markiert die Zeile und scrollt sie ins Bild ; eine App, deren einzige Zeile ihr Homebrew-Cask ist, landet auf dieser Zeile.

Die Spalten merken sich jede von Ihnen gewählte Breite, auch die der Namensspalte, und jede Tabelle passt ihre Spalten beim Verändern der Fenstergröße an den verfügbaren Platz an.

Jede Liste nennt, wann sie erstellt wurde, auch die Paketlisten sowie Adoptierbar und Ignoriert. Eine leere Liste erklärt, warum sie leer ist, statt nichts zu zeigen.

Rechte Seitenleiste (Details)

Details des ausgewählten Elements, verteilt auf vier Tabs: Beschreibung, Versionen, Release Notes, Quelle, Pfad auf der Festplatte und die Sicherheitsprüfungen.

• Die Buttons Aktualisieren und Herunterladen finden sich auch hier, nicht nur in der Zeile. Ein Download zeigt seinen Fortschrittsbalken und wird dann zu Im Finder zeigen.
• Bericht kopieren legt mit einem Klick alles in die Zwischenablage, was die vier Tabs über das Element wissen.
• Weitere Aktionen → Falsche Erkennung melden öffnet ein bereits ausgefülltes Formular mit dem, was Version Tracker gesehen hat ; Sie müssen nur noch sagen, was nicht stimmt.
• Das Panel öffnet wieder auf dem zuletzt benutzten Tab, und während eines Stapels wechselt es direkt von einer App zur nächsten, statt dazwischen leer zu bleiben.
• Seine Buttons sind während eines Scans, eines Stapels oder eines Downloads ausgegraut, wie es die Zeilen bereits waren.

Hinweis: Die Fensterbreite wird zwischen den Sitzungen gespeichert. Die Mindestgröße ist so gewählt, dass alle drei Spalten bequem Platz haben.

🔄 Anwendungen aktualisieren

Einzelne Aktualisierung

Klicken Sie auf den grünen « Aktualisieren »-Button einer Zeile (erfordert eine aktive Lizenz oder die Testphase, siehe Lizenz & Testphase). Je nach Quelle :

• Mac App Store: verwendet CommerceKit (stille Hintergrund-Aktualisierung)
• Homebrew Cask/Formula: startet brew upgrade (mit Admin-Authentifizierung falls nötig, siehe unten). Verweigert brew das In-Place-Upgrade, wendet Version Tracker automatisch die von brew empfohlene erzwungene Neuinstallation an.
• Sparkle: lädt das DMG/ZIP herunter, hängt das alte ab und installiert das neue
• GitHub: lädt das neueste Binärfile herunter und installiert es
• Direkter Download: der orangefarbene « Herunterladen »-Button lädt die Datei in Ihren Download-Ordner; danach wird er zu « Im Finder anzeigen », um die Installation manuell abzuschließen. « Alle herunterladen » startet den Stapel-Download.

Automatische Sicherung: Ist der privilegierte Helper aktiviert, wird die alte Version der App vor jedem Update gesichert. Bei Problemen stellen Sie sie unter Einstellungen → Sicherungen wieder her (Aufbewahrungsdauer und Anzahl der Kopien einstellbar).

Stapel-Aktualisierung

Der « Alle aktualisieren »-Button startet nach einer Bestätigung, die die Anzahl der Updates zusammenfasst, alle automatisierbaren Updates in Folge. Sie können die Ansicht verlassen: der Vorgang läuft im Hintergrund weiter, und am Ende erscheint eine Zusammenfassung (einschließlich zurückgestellter Updates).

Sie können auch mehrere Zeilen auswählen und über das Menü nur diese Auswahl aktualisieren.

Ein Stapel berücksichtigt nur Quellen, deren Schalter Gruppiert an ist (siehe Unterstützte Quellen). Vier Regeln entscheiden, was sonst noch draußen bleibt :

• Laufende Apps und große Versionssprünge schließt der Sicherheitsfilter aus (Einstellungen → Updates). Einzeln lassen sie sich weiterhin aktualisieren.
• Updates, die ein neueres macOS verlangen als das laufende, werden ausgeschlossen, und die Zeile nennt die benötigte Version.
• Ein Update ganz ohne Signatur wird vor jeder Installation mit einer Warnung angekündigt. Ein Update, dessen Signatur die Prüfung nicht besteht, bleibt blockiert, ohne Ausnahme.
• Auf einem Intel-Mac bleiben Homebrew-Formeln, die aus dem Quelltext kompiliert werden könnten, aus einem globalen Stapel draußen, und der Bericht nennt welche und warum. Aktualisieren Sie sie einzeln, wenn Sie fortfahren wollen : Version Tracker gewährt dann bis zu acht Stunden pro Formel, und Sie können jederzeit abbrechen.

Schlägt eine Zeile fehl, obwohl ihre Datei bereits heruntergeladen war, wird der Download nicht verworfen, sondern Ihnen übergeben : Die Zeile bietet Im Finder zeigen an.

Ein Update zurückstellen

Ein Update, das Sie gerade nicht wollen, können Sie zurückstellen statt ignorieren. Rechtsklick auf die Zeile, Zurückstellen wählen und die Dauer festlegen : 1 Tag, 3 Tage, 1 Woche, 2 Wochen, 1 Monat oder Unbefristet.

Die Zeile wandert in die Kategorie Zurückgestellt in der Seitenleiste, die alle Apps, Pakete und Erweiterungen sammelt, deren Update übersprungen oder zurückgestellt ist. Sie verlässt die Update-Listen und die Zähler, meldet sich also nicht mehr, ist aber nie verloren : Nicht mehr zurückstellen holt sie sofort zurück.

Zurückgestellt ist nicht Ignoriert. Ignoriert sammelt Einträge, mit denen Version Tracker nichts anfangen kann. Zurückgestellt ist Ihre eigene Entscheidung, mit einem Datum daran, und die Zeile kehrt von selbst zurück, wenn die Frist abgelaufen ist.

Manueller Download (« Herunterladen »)

Manche Apps haben keinen automatischen Mechanismus, stellen aber eine direkte Download-URL bereit (PKG, DMG, ZIP). Für diese gilt:

• Der orange Button « Herunterladen » erscheint
• Die Datei landet in Ihrem Download-Ordner (standardmäßig ~/Downloads, in den Einstellungen änderbar)
• Nach dem Laden wird der Button zu « Im Finder zeigen », um die Installation von Hand abzuschließen

Der Button « Alle herunterladen » startet die Stapel-Downloads für alle infrage kommenden Apps.

Bei einem Fehler (HTTP 403, Datei nicht gefunden usw.) wechselt der Button zu « Öffnen »: Version Tracker startet die installierte App, damit diese ihr Update selbst durchführt.

📸 Schnappschüsse

Die Ansicht Schnappschüsse (Bereich ÜBERSICHT) hält den kompletten Software-Zustand Ihres Macs fest: Anwendungen, Pakete, Tools, installierte Versionen und bekannte Updates.

• Schnappschuss erstellen (⇧+⌘+N): erfasst das aktuelle Inventar. Anschließend können Sie ihn umbenennen oder anpinnen.
• Vergleichen: wählen Sie zwei Schnappschüsse, um alles zu sehen, was sich dazwischen geändert hat (installierte, entfernte oder aktualisierte Elemente), mit Filtern nach Änderungstyp.
• Exportieren…: exportiert einen Schnappschuss oder Vergleich als JSON, CSV oder Markdown. Zwei Datenschutz-Profile: Vollständig (behält Pfade und Rechnernamen, lokal aufbewahren) oder Teilbar (absolute Pfade, Benutzer- und Rechnername werden maskiert).

Typische Anwendungsfälle: einen Mac vor einer Migration oder Neuinstallation dokumentieren, nachvollziehen, was eine Update-Sitzung tatsächlich geändert hat, oder ein sauberes Inventar teilen.

Automatische Schnappschüsse

Zwei Optionen unter Einstellungen → Updates :

• Automatische Schnappschüsse vor/nach „Alle aktualisieren“: erstellt vor und nach jeder Stapel-Aktualisierung einen Inventar-Schnappschuss, um die Änderungen zu vergleichen und zu dokumentieren.
• Schnappschuss nach jedem geplanten Scan: erstellt am Ende jedes automatischen Scans einen Schnappschuss, nur wenn sich seit dem letzten etwas geändert hat.

📋 Die Menüleiste

Version Tracker bietet ein Menüleisten-Symbol mit der Anzahl ausstehender Updates. Das Symbol animiert, während ein Scan oder ein Update läuft.

Das Panel

Ein Klick auf das Symbol öffnet ein Panel mit den verfügbaren Updates (Ihre Version → neue Version), mit :

• Aktionen pro Zeile: Aktualisieren, Herunterladen oder Öffnen, je nach Quelle
• Den Buttons Scannen, Alle aktualisieren und Alle herunterladen
• Einer Fußzeile mit dem Datum des letzten Scans und der Anzahl der verfolgten Elemente
• Einem Chevron in der Kopfzeile zum Ein- und Ausklappen der Liste („Liste ausblenden“ / „Liste einblenden“): eingeklappt schrumpft das Panel auf Kopf- und Fußzeile

Autonom, auch bei geschlossener App

• Bei Anmeldung öffnen (Einstellungen → Allgemein): startet beim Anmelden nur das Menüleisten-Symbol, ohne das Hauptfenster zu öffnen.
• Vom Panel aus gestartete Updates laufen in einem Hintergrundprozess, ohne Hauptfenster oder Dock-Symbol.
• Mit dem Hintergrund-Scan (Einstellungen → Automatisierung) laufen geplante Scans, nach Intervall oder zu fester täglicher Uhrzeit, auch bei beendeter App weiter: Badge und Benachrichtigungen bleiben aktuell.

⚙️ Einstellungen

Die Einstellungen sind in Bereiche gegliedert :

Durchsuchte Ordner

Standardmäßig sucht Version Tracker dort, wo macOS Programme ablegt. Einstellungen → Quellen → Durchsuchte Ordner ändert das :

• Zusätzlich zu durchsuchende Ordner : Fügen Sie einen Ordner hinzu, etwa eine zweite Festplatte, damit Ihre Apps auch dort gefunden werden.
• Auszulassende Ordner : Version Tracker sieht dort nicht hinein.

Steht derselbe Ordner in beiden Listen, gewinnt das Auslassen. Einen Ordner aus einer Liste zu entfernen, nimmt ihn von der Liste und rührt nichts an, was darin liegt.

Kurzinfos

Zeigen Sie auf einen Button oder eine Einstellung, und ein Satz erklärt, was er tut — im Fenster wie im Menüleisten-Panel.

Kurzinfos sind in Version 1.3 standardmäßig aus. Schalten Sie sie unter Einstellungen → Erscheinungsbild → Kurzinfos ein. Der Schalter gilt für die ganze App, nicht für einen von zwei Bereichen.

Menüleistensymbol ausblenden

Einstellungen → Allgemein → Menüleistensymbol ausblenden entfernt das Symbol vollständig, ob das Fenster offen ist oder nicht. Das Fenster zu schließen, blendet es dann einfach aus ; Sie öffnen es wieder über das Dock oder mit ⌘+Tab.

Fenster schließen

• Das Schließen des Hauptfensters (⌘+W oder roter Button) blendet das Fenster aus: Die App bleibt im Hintergrund aktiv.
• Die Option « Fenster schließen behält nur die Menüleiste » (Einstellungen → Allgemein) beendet die Haupt-App beim Schließen und behält nur das Menüleisten-Symbol.
• ⌘+Q beendet die Anwendung wirklich (läuft gerade ein Update, warnt ein Hinweis).

🔐 Administrator-Authentifizierung

Einige Updates erfordern Administratorrechte. Version Tracker bietet zwei Mechanismen :

1. Privilegierter Helper (empfohlen): ein kleiner signierter Daemon, einmalig aktiviert über Einstellungen → Allgemein → Privilegierter Helper → Aktivieren.
2. Einmal-Authentifizierung: ohne Helper fragt ein Systemdialog bei jeder Operation nach Ihrem Admin-Passwort.

Was der Helper bringt :

• Keine Passwortabfrage mehr bei jedem Update
• Atomare Installation (die App bleibt nie halb ersetzt zurück)
• Signatur- und Team-ID-Prüfung auf Root-Seite
• Automatische Sicherung der alten Version vor jedem Update

Helper antwortet nicht? Nach einem App-Update verwenden Sie den « Reparieren »-Button im Helper-Bereich: Er registriert den Daemon neu, ohne erneut nach Ihrem Passwort zu fragen.

🔑 Lizenz & Testphase

Version Tracker folgt einem Freemium-Modell :

• Kostenlose Version: vollständiges Scannen und Inventar bleiben immer verfügbar. Sie sehen alles, was veraltet ist, über alle Quellen hinweg.
• Lizenz (Mono, Solo oder Family): schaltet Ein-Klick-Updates, Stapel-Updates und Updates aus der Menüleiste frei. Siehe Angebote und Preise.
• 7-tägige kostenlose Testphase: startet automatisch beim ersten Start, ohne Kreditkarte. Nach Ablauf kehrt die App automatisch zur kostenlosen Version zurück.

Lizenz aktivieren: öffnen Sie Einstellungen → Lizenz und fügen Sie den nach dem Kauf per E-Mail erhaltenen Schlüssel ein. Sie können die Lizenz auf einem Mac deaktivieren, um einen Platz freizugeben und sie auf einem anderen zu aktivieren.

Ein Platz gehört zu einem Benutzerkonto, nicht zu einem Mac. Ihr Schlüssel liegt in Ihrem Anmeldeschlüsselbund, den macOS für jedes Konto getrennt führt. Ein zweites Konto auf demselben Mac startet also ohne Lizenz und belegt einen eigenen Platz, sobald Sie sie dort aktivieren. Rechnen Sie mit einem Platz pro Benutzerkonto, das Version Tracker ausführen wird.

Lizenzschlüssel verloren oder eine Rechnung benötigt? Öffnen Sie My Orders und melden Sie sich mit Ihrer Kauf-E-Mail an. Kein Passwort, nur ein Magic Link. Dort finden Sie jede Bestellung, Ihren Lizenzschlüssel und die Download-Dateien. Zur Verwaltung Ihres Abos (Zahlungsmethode, USt-Angaben, Planwechsel) nutzen Sie stattdessen das Abo-Portal.

🖱️ Tastatur-Kürzel

Für einen neuen vollständigen Scan verwenden Sie den Scannen-Button in der Symbolleiste oder im Panel der Menüleiste.

🌍 Sprachen

Version Tracker ist verfügbar in :

• 🇩🇪 Deutsch
• 🇬🇧 Englisch
• 🇫🇷 Französisch
• 🇪🇸 Spanisch
• 🇵🇹 Portugiesisch (Portugal)
• 🇮🇹 Italienisch
• 🇳🇱 Niederländisch

Die Sprache folgt automatisch den macOS-Systemeinstellungen und kann unter Einstellungen → Allgemein → Sprache geändert werden.

🗑️ Version Tracker deinstallieren

In den meisten Fällen genügt es, die App in den Papierkorb zu ziehen. Hier die vollständige Vorgehensweise, wenn Sie keine Spuren hinterlassen möchten.

Einfache Methode (empfohlen)

• Öffnen Sie Einstellungen und deaktivieren Sie Allgemein → Bei Anmeldung öffnen sowie Automatisierung → Hintergrund-Scan.
• Beenden Sie Version Tracker und sein Menüleisten-Symbol (Klick auf das Symbol → Beenden).
• Ziehen Sie Version Tracker.app aus /Applications in den Papierkorb und leeren Sie ihn.

Keine Eile : auch ohne diesen Schritt sind etwaige Spuren inaktiv. Nichts läuft, nichts läuft als root, nichts verbraucht Ressourcen.

Für eine vollständige Entfernung (optional)

Version Tracker installiert drei kleine Komponenten, alle von Ihnen bei der Installation genehmigt : einen privilegierten Helper und ein Menüleisten-Symbol (beide innerhalb der App, sie verschwinden mit ihr), sowie eine geplante Scan-Aufgabe (eine separate Datei). Falls Sie den obigen Schritt übersprungen haben, entfernen Sie sie manuell :

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

Um auch Ihre App-Backups und Inventar-Schnappschüsse zu entfernen (unwiderruflich) :

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

Falls Version Tracker noch unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen aufgeführt ist, entfernen Sie den Eintrag (er verschwindet kurz darauf von selbst).

Planen Sie eine Neuinstallation oder einen Mac-Wechsel?

• Neuinstallation auf demselben Mac : nichts weiter nötig. Ihr Lizenzschlüssel bleibt im Schlüsselbund und aktiviert sich automatisch.
• Wechsel zu einem anderen Mac : geben Sie zuerst Ihren Aktivierungsplatz frei über Einstellungen → Lizenz → Deaktivieren, bevor Sie die App entfernen.

Der privilegierte Helper lässt sich nicht neu installieren? Deaktivieren Sie Version Tracker unter Systemeinstellungen → Allgemein → Anmeldeobjekte & Erweiterungen und aktivieren Sie es anschließend wieder (erst der vollständige Zyklus synchronisiert den Status neu, nur Aktivieren genügt nicht). Besteht das Problem weiterhin, leeren Sie den Papierkorb und starten Sie neu.

🗑️ Paketmanager deinstallieren

Bevor Sie beginnen

• Öffnen Sie die App Terminal (Programme → Dienstprogramme). Die unten erwähnte Shell-Konfigurationsdatei ist ~/.zshrc (Standard unter macOS).
• Entfernen Sie nur Werkzeuge, die Sie für Version Tracker installiert haben. Wenn andere Software oder Projekte davon abhängen, behalten Sie sie.
• Deinstallieren Sie zuerst die einzelnen Werkzeuge und Homebrew zuletzt: Seine Deinstallation entfernt alle damit installierten Pakete.
• Nach der Deinstallation verfolgt Version Tracker die betroffene Quelle einfach nicht mehr. Sie können jedes Werkzeug jederzeit über das Onboarding oder die Einstellungen neu installieren.

1. Direkt von Version Tracker installierte Werkzeuge (über Homebrew)

Homebrew verweigert die Deinstallation, wenn andere Formeln davon abhängen. Das ist ein Schutzmechanismus, kein Fehler.

⚠️ Homebrew (zuletzt) entfernt Homebrew und alle damit installierten Pakete:

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

Das Skript listet am Ende eventuelle Restordner auf (üblicherweise /opt/homebrew auf Apple Silicon, /usr/local/Homebrew auf Intel).

2. Externe Werkzeuge (über ihre offiziellen Anleitungen installiert)

Falls Sie eines dieser Werkzeuge mit Homebrew statt mit dem offiziellen Installer installiert haben, verwenden Sie einfach brew uninstall <Formel>.

Überprüfung

Für jedes deinstallierte Werkzeug: command -v <werkzeug> darf nichts mehr ausgeben (vorher ein neues Terminal-Fenster öffnen).

❓ Häufige Fragen

📩 Kontakt

Der beste Ort, um einen Bug zu melden oder eine Funktion vorzuschlagen, ist der öffentliche Tracker auf GitHub. Jede Meldung ist für alle sichtbar: Sie können prüfen, ob Ihr Problem bereits gemeldet wurde, eigene Details ergänzen und den Fortschritt bis zur Behebung verfolgen.

• Bugs und Funktionswünsche: eröffnen Sie ein Issue auf github.com/Version-Tracker/feedback
• Lizenz, Abrechnung oder private Fragen: contact@version-tracker.app
• Schnelles Feedback: der Feedback-Button direkt in der App

Sie melden einen Bug? Nennen Sie Ihre macOS-Version, Ihre Version-Tracker-Version und die betroffene App oder Quelle. Da der Tracker öffentlich ist, fügen Sie niemals Ihren Lizenzschlüssel oder persönliche Daten in ein Issue ein: senden Sie diese stattdessen per E-Mail.