ghunt/sh

// utilisateurs windows

GHunt pour Windows, sans la douleur de l'installation

Le GHunt original est un CLI Python. Le lancer sur Windows veut dire installer Python, configurer le PATH, jongler avec des virtualenvs et faire fonctionner l'extension Companion pour capturer une session Google. ghunt.sh saute tout ça. Ouvrez l'URL dans n'importe quel navigateur Windows, collez un email, récupérez le rapport.

Lancer GHunt

Pourquoi GHunt sur Windows est plus pénible que sur Linux ou Mac

GHunt a été écrit pour un environnement Unix. Les instructions du README supposent que vous avez une chaîne d'outils Python fonctionnelle et un terminal qui se comporte comme bash. Windows n'est pas cet environnement par défaut. Sur Windows, même les parties supposément simples de l'installation créent une vraie friction :

  • Installation de Python. Il faut Python 3.10 ou plus récent. La version du Microsoft Store marche parfois, parfois non, selon la version courante. L'installation depuis python.org demande de cocher manuellement "Add Python to PATH", sinon vous passez une heure à comprendre pourquoi votre terminal ne trouve pas python ou pip.
  • Environnements virtuels. Activer une venv sous Windows utilise une commande différente de Linux, et PowerShell bloque le script d'activation tant que vous ne changez pas la politique d'exécution. Beaucoup de gens abandonnent ici.
  • pip sous Windows. Certaines dépendances Python ont besoin d'outils de build qui ne sont pas installés par défaut. Vous pouvez finir par télécharger les Visual Studio Build Tools juste pour qu'une seule dépendance compile.
  • Antivirus. Les machines Windows en entreprise bloquent souvent les scripts Python qui appellent des endpoints inhabituels, ce qui est exactement ce que fait GHunt.
  • WSL n'est pas magique. Certains guides vous disent de lancer GHunt dans WSL. WSL fonctionne, mais l'installation de WSL est elle-même un processus multi-étapes qui exige des droits élevés, et une fois dans WSL il faut encore installer Python et l'extension Companion séparément.
  • Extension Companion. Même une fois le CLI installé, il vous faut l'extension de navigateur pour capturer une session Google. L'extension n'est pas toujours disponible dans tous les navigateurs et casse avec les mises à jour de Google.

Aucun de ces points n'est fatal individuellement. Ensemble, ils transforment une idée de cinq minutes ("tiens, je vais checker cet email") en un après-midi de debug.

Le chemin simple sous Windows : utilisez ghunt.sh dans un navigateur

ghunt.sh est conçu pour supprimer chacune de ces étapes. Il fait tourner les mêmes recherches que le GHunt original, mais vous y accédez via une URL. Les utilisateurs Windows obtiennent :

  • Pas d'installation Python, pas de configuration de PATH.
  • Pas de virtualenv à activer, pas de bataille avec la politique d'exécution PowerShell.
  • Pas de pip, pas d'erreurs de compilation, pas d'outils de build.
  • Pas d'extension Companion à gérer.
  • Fonctionne dans Edge, Chrome, Firefox ou n'importe quel autre navigateur Windows.
  • Même flux sur Windows, Mac et Linux, donc un tutoriel que vous lisez n'a pas besoin d'être spécifique à Windows.

Ce que vous pouvez faire depuis un navigateur Windows

Depuis une machine Windows, dans n'importe quel navigateur, vous pouvez lancer une recherche style GHunt complète contre une adresse email Google et récupérer :

  • Le profil Google public, y compris nom affiché, photo, couverture et langue.
  • Le Gaia ID et les identifiants de pivot associés.
  • Si le compte est un Gmail personnel ou un compte Workspace.
  • Les contributions publiques sur Google Maps : avis, photos, lieux ajoutés.
  • Les entrées publiques du Google Calendar, quand le compte en expose un.
  • Le profil Play Games quand il existe.

Vous obtenez aussi un export PDF du rapport, ce que le CLI ne fait pas. C'est utile sous Windows parce que vous pouvez déposer directement le rapport dans un dossier OneDrive, un brouillon Outlook ou un chat Teams sans écrire le moindre outillage.

Quand vous pourriez quand même vouloir le CLI sous Windows

Le CLI sous Windows n'est le bon choix que dans des cas restreints :

  • Vous scriptez GHunt dans un pipeline Windows plus large et vous avez besoin de JSON brut en local.
  • Vous êtes sur une machine Windows que vous contrôlez totalement et vous avez une exigence stricte que les recherches viennent de vos propres credentials Google.
  • Vous êtes un développeur qui utilise Windows et qui contribue au framework.

En dehors de ça, ghunt.sh couvre votre cas sans aucune configuration. Voir la comparaison plus longue entre la version web et le CLIpour le tableau d'ensemble.

Comment utiliser ghunt.sh sous Windows

  1. Ouvrez ghunt.sh dans Edge, Chrome, Firefox ou n'importe quel autre navigateur Windows.
  2. Collez un email Google dans la barre de recherche.
  3. Cliquez sur Enquêter. Patientez quelques secondes.
  4. Lisez le rapport consolidé. Utilisez le bouton PDF pour sauvegarder ou partager.

Pour aller plus loin