Mode d'emploi

🚀 Démarrage rapide

1. Lancez Version Tracker. Au premier démarrage, un assistant de configuration vous guide : autorisation d'Accès complet au disque (nécessaire pour scanner vos applications), puis installation optionnelle des gestionnaires de paquets que vous souhaitez suivre. Tout reste modifiable plus tard dans les Réglages.
2. Profitez de l'essai gratuit. Un essai de 7 jours de la version complète démarre automatiquement, sans carte bancaire. À la fin, l'app revient à la version gratuite (le scan reste toujours disponible).
3. Patientez pendant le premier scan. Selon le nombre d'applications installées et de sources actives, le scan initial dure de 10 à 60 secondes.
4. Consultez l'onglet « Toutes ». C'est ici que se concentrent toutes les mises à jour disponibles, toutes sources confondues.
5. Cliquez sur « Tout mettre à jour » pour lancer toutes les mises à jour en une fois, ou utilisez les boutons individuels pour gérer chaque application.

Installer avec Homebrew

Version Tracker est disponible depuis son propre tap Homebrew.

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

Vous avez déjà installé Version Tracker à la main ? Ajoutez --force pour que Homebrew reprenne la copie existante :

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

Version Tracker se met à jour tout seul : brew upgrade ne viendra pas se battre avec son propre système de mise à jour.

🗃️ Sources prises en charge

Version Tracker détecte les mises à jour pour :

Réglages → Sources liste les 51 sources, chacune avec deux interrupteurs :

• Active : la source est scannée. La désactiver masque ses éléments et raccourcit le scan.
• Groupée : la source participe à Tout mettre à jour, Tout traiter et Tout télécharger. Désactivez-la pour garder une source visible et scannée, mais hors des gros boutons. Ses lignes restent modifiables une par une.

Groupée est grisée tant que Active est désactivée : une source qui n'est pas scannée n'a rien à apporter à un lot.

Note : Adobe Camera Raw est un plug-in et non une application, mais il est listé et mis à jour avec les autres produits Creative Cloud.

🖥️ L'interface

L'écran principal se divise en trois colonnes, surmontées d'une barre d'outils :

Barre latérale gauche

La navigation est organisée en sections repliables, que vous pouvez réordonner par glisser-déposer. Le compteur en regard de chaque catégorie indique le nombre d'éléments qu'il contient, sa couleur précisant lesquels (voir ce que signifient les couleurs des badges).

• APERÇU : Tableau de bord (vue d'ensemble, activité récente, dernier instantané) et Instantanés
• MISES À JOUR : Toutes (toutes les mises à jour en une seule liste), Applications, Paquets, Homebrew, Mises à jour système, Apple Developer Tools, Reportées (voir mettre une mise à jour de côté)…
• Puis des sections par domaine (APPLICATIONS, SYSTÈME, IA, JavaScript, Python, Rust, éditeurs…) : seules celles correspondant à ce qui est réellement installé sur votre Mac apparaissent.

Barre d'outils

• Scanner : relance un scan complet (le bouton permet aussi d'annuler un scan en cours)
• Réglages et Feedback : accès direct aux préférences et au formulaire de retour
• Deux boutons pour afficher/masquer la barre latérale et le panneau Détails

Zone centrale

La liste des éléments pour la catégorie sélectionnée, avec un champ de recherche. Chaque ligne affiche :

• L'icône et le nom de l'application ou du paquet
• La version actuelle et la version disponible
• Un bouton d'action contextuel (Mettre à jour, Télécharger, Ouvrir, Afficher dans le Finder…)

La recherche couvre aussi bien les applications que les paquets, gems, crates, paquets yarn et outils uv compris. La saisie filtre immédiatement, quelle que soit la taille de votre inventaire. Choisir un résultat ouvre la bonne catégorie, sélectionne la ligne et la fait défiler jusqu'à l'écran ; une app dont la seule ligne est son cask Homebrew arrive sur cette ligne.

Les colonnes mémorisent chaque largeur que vous définissez, y compris celle du nom, et chaque tableau ajuste ses colonnes à la place disponible quand vous redimensionnez la fenêtre.

Chaque liste indique quand elle a été établie, y compris les listes de paquets, Adoptables et Ignorées. Une liste vide explique pourquoi elle est vide au lieu de ne rien afficher.

Barre latérale droite (Détails)

Détails de l'élément sélectionné, répartis sur quatre onglets : description, versions, notes de version, source, chemin sur disque et contrôles de sécurité.

• Les boutons Mettre à jour et Télécharger sont ici aussi, pas seulement sur la ligne. Un téléchargement affiche sa barre de progression, puis devient Afficher dans le Finder.
• Copier le rapport place dans le presse-papiers, en un clic, tout ce que les quatre onglets savent de l'élément.
• Plus d'actions → Signaler une détection erronée ouvre un formulaire déjà rempli avec ce que Version Tracker a vu : vous n'avez qu'à dire ce qui cloche.
• Le panneau rouvre sur l'onglet que vous utilisiez, et pendant un lot il passe directement d'une app à la suivante au lieu de se vider entre les deux.
• Ses boutons sont grisés pendant un scan, un lot ou un téléchargement, comme l'étaient déjà les lignes.

Note : la largeur de la fenêtre est mémorisée entre les sessions. La taille minimale est conçue pour afficher confortablement les trois colonnes.

🔄 Mettre à jour des applications

Mise à jour individuelle

Cliquez sur le bouton vert « Mettre à jour » d'une ligne (nécessite une licence active ou l'essai, voir Licence & essai). Selon la source :

• Mac App Store : utilise CommerceKit (mise à jour silencieuse en arrière-plan)
• Homebrew Cask/Formula : lance brew upgrade (avec authentification admin si nécessaire, voir plus bas). Si brew refuse la mise à jour en place, Version Tracker applique automatiquement la réinstallation forcée que brew recommande.
• Sparkle : télécharge le DMG/ZIP, démonte l'ancien et installe le nouveau
• GitHub : télécharge et installe le binaire le plus récent
• Téléchargement direct : voir section suivante

Sauvegarde automatique : lorsque le helper privilégié est activé, l'ancienne version de l'app est sauvegardée avant chaque mise à jour. En cas de problème, restaurez-la depuis Réglages → Sauvegardes (durée de conservation et nombre de copies réglables).

Mise à jour en lot

Bouton « Tout mettre à jour » dans la vue Toutes : après une confirmation qui récapitule le nombre de mises à jour, toutes les mises à jour automatisables sont lancées en séquence. Vous pouvez quitter la vue, l'opération continue en arrière-plan ; un résumé s'affiche à la fin de l'opération (y compris les mises à jour reportées).

Vous pouvez aussi sélectionner plusieurs lignes et ne mettre à jour que cette sélection, depuis le menu.

Un lot ne prend que les sources dont l'interrupteur Groupée est activé (voir Sources prises en charge). Quatre règles décident de ce qui est écarté en plus :

• Les apps en cours d'exécution et les mises à niveau majeures sont exclues par le filtre de sécurité (Réglages → Mises à jour). Vous pouvez toujours les mettre à jour une par une.
• Les mises à jour exigeant un macOS plus récent que le vôtre sont exclues, et la ligne indique la version requise.
• Une mise à jour sans aucune signature est annoncée par un avertissement avant toute installation. Une mise à jour dont la signature échoue à la vérification reste bloquée, point final.
• Sur un Mac Intel, les formules Homebrew qui risquent d'être compilées depuis les sources sont écartées d'un lot global, et le rapport dit lesquelles et pourquoi. Mettez-les à jour individuellement si vous voulez continuer : Version Tracker accorde alors jusqu'à huit heures par formule, et vous pouvez annuler à tout moment.

Si une ligne échoue alors que son fichier était déjà téléchargé, le téléchargement vous est remis au lieu d'être jeté : la ligne propose Afficher dans le Finder.

Mettre une mise à jour de côté

Une mise à jour dont vous ne voulez pas tout de suite peut être reportée plutôt qu'ignorée. Faites un clic droit sur la ligne, choisissez Reporter, puis la durée : 1 jour, 3 jours, 1 semaine, 2 semaines, 1 mois ou Indéfiniment.

La ligne rejoint la catégorie Reportées dans la barre latérale, qui rassemble toutes les apps, paquets et extensions dont la mise à jour est passée ou reportée. Elle quitte les listes de mises à jour et les compteurs, donc elle cesse de vous solliciter, mais elle n'est jamais perdue : Ne plus reporter la ramène aussitôt.

Reportées n'est pas Ignorées. Ignorées regroupe les éléments dont Version Tracker ne peut rien faire. Reportées est votre propre décision, avec une date attachée, et la ligne revient d'elle-même quand le délai est écoulé.

Téléchargement manuel (« Télécharger »)

Certaines apps n'ont pas de mécanisme automatique mais exposent une URL de téléchargement directe (PKG, DMG, ZIP). Pour celles-ci :

• Le bouton orange « Télécharger » apparaît
• Le fichier est téléchargé dans votre dossier de téléchargements (par défaut ~/Téléchargements, modifiable dans les Réglages)
• Une fois téléchargé, le bouton devient « Afficher dans le Finder » pour finaliser l'installation manuellement

Le bouton « Tout télécharger » lance le téléchargement en lot pour toutes les apps éligibles.

En cas d'erreur (HTTP 403, fichier introuvable, etc.), le bouton bascule sur « Ouvrir » : Version Tracker lance l'app installée pour que celle-ci gère elle-même sa mise à jour.

📸 Instantanés

La vue Instantanés (section APERÇU) photographie l'état logiciel complet de votre Mac : applications, paquets, outils, versions installées et mises à jour connues.

• Créer un instantané (⇧+⌘+N) : capture l'inventaire actuel. Vous pouvez ensuite le renommer ou l'épingler.
• Comparer : sélectionnez deux instantanés pour voir tout ce qui a changé entre les deux (éléments installés, supprimés ou mis à jour), avec filtres par type de changement.
• Exporter… : exporte un instantané ou une comparaison en JSON, CSV ou Markdown. Deux profils de confidentialité : Complet (conserve les chemins et le nom de la machine, à garder en local) ou Partageable (chemins absolus, nom d'utilisateur et nom de machine masqués).

Cas d'usage typiques : documenter une machine avant une migration ou une réinstallation, suivre ce qu'une session de mises à jour a réellement changé, ou partager un inventaire propre.

Instantanés automatiques

Deux options dans Réglages → Mises à jour :

• Instantanés automatiques avant/après « Tout mettre à jour » : crée un instantané de l'inventaire avant et après chaque mise à jour groupée, pour comparer et documenter les changements.
• Instantané après chaque scan planifié : à la fin de chaque scan automatique, crée un instantané, uniquement si quelque chose a changé depuis le dernier.

📋 La barre des menus

Version Tracker propose une icône dans la barre des menus avec le nombre de mises à jour en attente. L'icône s'anime pendant un scan ou une mise à jour.

Le panneau

Un clic sur l'icône ouvre un panneau qui liste les mises à jour disponibles (votre version → nouvelle version), avec :

• Des actions par ligne : Mettre à jour, Télécharger ou Ouvrir selon la source
• Les boutons Analyser, Tout mettre à jour et Tout télécharger
• Un pied de panneau avec la date de la dernière analyse et le nombre d'éléments suivis
• Un chevron dans l'en-tête pour replier ou déployer la liste (« Masquer la liste » / « Afficher la liste ») : replié, le panneau se réduit à son en-tête et son pied

Autonome, même app fermée

• Ouvrir à la connexion (Réglages → Général) : lance uniquement l'icône de la barre des menus au démarrage de session, sans ouvrir la fenêtre principale.
• Les mises à jour lancées depuis le panneau s'exécutent dans un processus d'arrière-plan, sans ouvrir la fenêtre principale ni l'icône du Dock.
• Avec le Scan en arrière-plan (Réglages → Automatisation), les scans planifiés, par intervalle ou à heure fixe quotidienne, tournent même quand l'application est quittée : badge et notifications restent à jour.

⚙️ Réglages

Les Réglages sont organisés en panneaux :

Dossiers analysés

Par défaut, Version Tracker cherche là où macOS range les applications. Réglages → Sources → Dossiers analysés permet de changer cela :

• Dossiers à analyser en plus : ajoutez un dossier, un second disque par exemple, pour que vos apps qui s'y trouvent soient détectées aussi.
• Dossiers à laisser de côté : Version Tracker n'y regardera pas.

Si le même dossier figure dans les deux listes, le laisser de côté l'emporte. Retirer un dossier d'une liste le retire de la liste et ne touche à rien de ce qu'il contient.

Infobulles

Posez le pointeur sur un bouton ou un réglage et une phrase explique ce qu'il fait, aussi bien dans la fenêtre que dans le panneau de la barre des menus.

Les infobulles sont désactivées par défaut en version 1.3. Activez-les dans Réglages → Apparence → Infobulles. L'interrupteur gouverne toute l'application, pas un écran sur deux.

Masquer l'icône de la barre des menus

Réglages → Général → Masquer l'icône de la barre des menus retire complètement l'icône, que la fenêtre soit ouverte ou fermée. Fermer la fenêtre la masque alors simplement, et vous la rouvrez depuis le Dock ou avec ⌘+Tab.

Fermeture de la fenêtre

• Fermer la fenêtre principale (⌘+W ou le bouton rouge) masque la fenêtre : l'app reste active en arrière-plan.
• L'option « Fermer la fenêtre ne garde que la barre de menus » (Réglages → Général) quitte l'application principale à la fermeture et ne conserve que l'icône de la barre des menus.
• ⌘+Q quitte réellement l'application (une alerte vous prévient si une mise à jour est en cours).

🔐 Authentification administrateur

Certaines mises à jour nécessitent des privilèges administrateur. Version Tracker propose deux mécanismes :

1. Helper privilégié (recommandé) : un petit daemon signé, activé une fois pour toutes via Réglages → Général → Helper privilégié → Activer.
2. Authentification ponctuelle : si le helper n'est pas installé, une boîte de dialogue système demande votre mot de passe administrateur à chaque opération.

Ce que le helper apporte :

• Plus de mot de passe demandé à chaque mise à jour
• Installation atomique (l'app ne reste jamais à moitié remplacée)
• Vérification de signature et de Team ID côté root
• Sauvegarde automatique de l'ancienne version avant chaque mise à jour

Le helper ne répond plus ? Après une mise à jour de l'app, utilisez le bouton « Réparer » du panneau Helper privilégié : il réenregistre le daemon sans redemander votre mot de passe.

🔑 Licence & essai

Version Tracker fonctionne selon un modèle freemium :

• Version gratuite : le scan et l'inventaire complets restent toujours disponibles. Vous voyez tout ce qui est obsolète, sur toutes les sources.
• Licence (Mono, Solo ou Family) : débloque l'installation des mises à jour en un clic, les mises à jour groupées et les mises à jour depuis la barre des menus. Voir les offres et tarifs.
• Essai gratuit de 7 jours : démarre automatiquement au premier lancement, sans carte bancaire. À la fin de l'essai, l'app revient automatiquement à la version gratuite.

Activer une licence : ouvrez Réglages → Licence et collez la clé reçue par e-mail après l'achat. Vous pouvez désactiver la licence sur un Mac pour libérer un siège et l'activer sur un autre.

Un siège appartient à un compte utilisateur, pas à un Mac. Votre clé est conservée dans votre trousseau de session, que macOS garde séparé pour chaque compte. Un second compte sur le même Mac démarre donc sans licence et consomme son propre siège quand vous l'y activez. Comptez un siège par compte utilisateur qui fera tourner Version Tracker.

Clé de licence perdue, ou besoin d'une facture ? Ouvrez My Orders et connectez-vous avec votre e-mail d'achat. Sans mot de passe, juste un lien magique. Vous y retrouvez chaque commande, votre clé de licence et vos fichiers à télécharger. Pour gérer votre abonnement (moyen de paiement, TVA, changement de forfait), utilisez plutôt le portail d'abonnement.

🖱️ Raccourcis clavier

Pour relancer un scan complet, utilisez le bouton Scanner de la barre d'outils ou le bouton Analyser du panneau de la barre des menus.

🌍 Langues

Version Tracker est disponible en :

• 🇫🇷 Français
• 🇬🇧 Anglais
• 🇩🇪 Allemand
• 🇪🇸 Espagnol
• 🇵🇹 Portugais (Portugal)
• 🇮🇹 Italien
• 🇳🇱 Néerlandais

La langue suit automatiquement les réglages système macOS, et peut être forcée dans Réglages → Général → Langue.

🗑️ Désinstaller Version Tracker

Mettre l'application à la Corbeille suffit dans la grande majorité des cas. Voici la procédure complète si vous voulez ne laisser aucune trace.

Méthode simple (recommandée)

• Ouvrez Réglages et désactivez Général → Ouvrir à la connexion et Automatisation → Vérification automatique.
• Quittez Version Tracker et son icône de barre des menus (clic sur l'icône → Quitter).
• Glissez Version Tracker.app de /Applications vers la Corbeille, puis videz la Corbeille.

Aucune urgence : même sans cette étape, les traces éventuelles sont inertes. Rien ne tourne, rien n'est root, rien ne consomme de ressources.

Pour une suppression complète (facultatif)

Version Tracker installe trois petits composants, tous approuvés par vous à l'installation : un assistant privilégié et une icône de barre des menus (tous deux à l'intérieur de l'app, ils disparaissent avec elle), et une tâche d'analyse planifiée (un fichier séparé). Si vous avez sauté l'étape ci-dessus, supprimez-la manuellement :

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

Pour aussi supprimer vos sauvegardes d'apps et vos instantanés d'inventaire (irréversible) :

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

Enfin, si Version Tracker figure encore dans Réglages Système → Général → Ouverture et extensions, retirez l'entrée (elle disparaît d'elle-même peu après).

Vous comptez réinstaller ou changer de Mac ?

• Réinstallation sur le même Mac : ne touchez à rien. Votre clé de licence reste dans le trousseau et s'active automatiquement.
• Passage à un autre Mac : libérez d'abord votre siège d'activation via Réglages → Licence → Désactiver, avant de supprimer l'app.

L'assistant privilégié refuse de se réinstaller ? Dans Réglages Système → Général → Ouverture et extensions, désactivez puis réactivez Version Tracker (le cycle complet resynchronise l'état, activer seul ne suffit pas). Si le problème persiste, videz la Corbeille et redémarrez.

🗑️ Désinstaller les gestionnaires de paquets

Avant de commencer

• Ouvrez l'application Terminal (Applications → Utilitaires). Le fichier de configuration du shell mentionné ci-dessous est ~/.zshrc (par défaut sur macOS).
• Ne supprimez que les outils que vous avez installés pour Version Tracker. Si un autre logiciel ou projet en dépend, conservez-les.
• Désinstallez les outils individuels d'abord, et Homebrew en dernier : le désinstaller supprime tous les paquets installés avec lui.
• Après désinstallation, Version Tracker cessera simplement de suivre la source concernée. Vous pourrez réinstaller n'importe quel outil depuis l'onboarding ou les Réglages.

1. Outils installés directement par Version Tracker (via Homebrew)

Homebrew refusera la désinstallation si d'autres formules en dépendent. C'est une protection, pas une erreur.

⚠️ Homebrew (en dernier) supprime Homebrew et tous les paquets installés avec lui :

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

Le script liste à la fin les dossiers résiduels éventuels (généralement /opt/homebrew sur Apple Silicon, /usr/local/Homebrew sur Intel).

2. Outils externes (installés via leur guide officiel)

Si vous avez installé l'un de ces outils avec Homebrew plutôt qu'avec son installateur officiel, préférez simplement brew uninstall <formule>.

Vérification

Pour chaque outil désinstallé : command -v <outil> ne doit plus rien afficher (ouvrez une nouvelle fenêtre de Terminal au préalable).

❓ Questions fréquentes

📩 Contact

Le meilleur endroit pour signaler un bug ou demander une fonctionnalité est le suivi public sur GitHub. Chaque signalement est visible par tous : vous pouvez vérifier si votre problème a déjà été remonté, y ajouter vos propres précisions, et suivre son avancement jusqu'à la correction.

• Bugs et demandes de fonctionnalités : ouvrez un ticket sur github.com/Version-Tracker/feedback
• Licence, facturation ou question privée : contact@version-tracker.app
• Retour rapide : le bouton Feedback directement dans l'application

Vous signalez un bug ? Indiquez votre version de macOS, votre version de Version Tracker, et l'application ou la source concernée. Le suivi étant public, ne collez jamais votre clé de licence ni de données personnelles dans un ticket : envoyez-les plutôt par e-mail.