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.

🗃️ Sources prises en charge

Version Tracker détecte les mises à jour pour :

Chaque source peut être activée ou désactivée individuellement dans les Réglages.

🖥️ 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 de mises à jour disponibles.

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

Barre latérale droite (Détails)

Détails de l'élément sélectionné : description, versions, notes de version, source, chemin sur disque.

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

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 :

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

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

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

Pour signaler un bug, suggérer une amélioration ou simplement partager un retour : contact@version-tracker.app — ou utilisez le bouton Feedback directement dans l'application.