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.

🗃️ Unterstützte Quellen

Version Tracker erkennt Updates für:

Jede Quelle kann individuell in den Einstellungen aktiviert oder deaktiviert werden.

🖥️ 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 die Anzahl der verfügbaren Updates.

• Ü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…
• 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…)

Rechte Seitenleiste (Details)

Details des ausgewählten Elements: Beschreibung, Versionen, Release Notes, Quelle, Pfad auf der Festplatte.

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).

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 :

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 (Solo, Family oder Pro) — 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.

🖱️ 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)

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

Um einen Bug zu melden, eine Verbesserung vorzuschlagen oder einfach Feedback zu teilen : contact@version-tracker.app — oder verwenden Sie den Feedback-Button direkt in der App.