← retour aux outils back to tools

# Bluelog

Scanner Bluetooth et outil de site-survey qui journalise dans le temps chaque appareil détectable vu dans une zone. Bluetooth scanner and site-survey tool that logs every discoverable device seen in an area over time.

↗ https://github.com/MS3FGX/Bluelog

## Overview

Bluelog is a lightweight Linux Bluetooth scanner designed to run unattended for long periods (a “Bluetooth site survey”), logging the MAC address, device name, and class of every discoverable device that passes within range. It’s built for passive, high-volume logging rather than interactive querying — useful for surveying foot traffic or device density at a physical location during an assessment.

## Common Usage

Basic scan, log to default output file

    sudo bluelog

Run continuously as a daemon

    sudo bluelog -d

Live output mode — print discoveries to the terminal as they happen

    sudo bluelog -l

Specify output file and scan interval (seconds)

    sudo bluelog -o survey.log -i 10

Bluelog Live — generates a self-refreshing HTML page of current devices

    sudo bluelog -lv

## Site Survey Workflow

Leave running for the duration of a physical assessment

    sudo bluelog -d -o survey_$(date +%Y%m%d).log

Afterward, count unique devices seen

    awk -F, '{print $2}' survey_20260810.log | sort -u | wc -l

## Tips

- Only sees devices in discoverable mode — non-discoverable devices are invisible to a passive scan
- Bluelog Live mode is handy for a dashboard display during a live physical security assessment
- For BLE-capable coverage alongside classic Bluetooth, pair with Blue Hydra

Help / Man page

    Bluelog - Passive Bluetooth Discovery/Logging Tool

    Usage: bluelog [options]

    Options:
      -i INTERVAL   Scan interval in seconds (default: 8)
      -o FILE       Output log file (default: ./bluelog-<date>.log)
      -d            Run as a daemon
      -l            Live mode, print output to console
      -v            Verbose device info (name, class)
      -lv           Bluelog Live: generate self-refreshing HTML output
      -q            Quiet, no console output
      -h            Show this help

## Vue d’ensemble

Bluelog est un scanner Bluetooth Linux léger conçu pour tourner sans surveillance pendant de longues périodes (un “site survey Bluetooth”), en journalisant l’adresse MAC, le nom et la classe de chaque appareil détectable qui passe à portée. Il est fait pour une journalisation passive à haut volume plutôt que pour de l’interrogation interactive : utile pour relever le passage ou la densité d’appareils sur un lieu physique lors d’une évaluation.

## Utilisation courante

    # Scan de base, journalise vers le fichier de sortie par défaut
    sudo bluelog

    # Tourner en continu comme démon
    sudo bluelog -d

    # Mode sortie en direct : affiche les découvertes dans le terminal au fil de l'eau
    sudo bluelog -l

    # Spécifier le fichier de sortie et l'intervalle de scan (secondes)
    sudo bluelog -o survey.log -i 10

    # Bluelog Live : génère une page HTML auto-rafraîchissante des appareils actuels
    sudo bluelog -lv

## Workflow de site survey

    # Laisser tourner pour toute la durée d'une évaluation physique
    sudo bluelog -d -o survey_$(date +%Y%m%d).log

    # Ensuite, compter les appareils uniques vus
    awk -F, '{print $2}' survey_20260810.log | sort -u | wc -l

## Conseils

- Ne voit que les appareils en mode détectable : les appareils non détectables sont invisibles à un scan passif
- Le mode Bluelog Live est pratique pour un affichage tableau de bord pendant une évaluation de sécurité physique en direct
- Pour une couverture BLE en plus du Bluetooth classique, combinez avec Blue Hydra

Aide / Page de manuel

    Bluelog - Passive Bluetooth Discovery/Logging Tool

    Usage: bluelog [options]

    Options:
      -i INTERVAL   Scan interval in seconds (default: 8)
      -o FILE       Output log file (default: ./bluelog-<date>.log)
      -d            Run as a daemon
      -l            Live mode, print output to console
      -v            Verbose device info (name, class)
      -lv           Bluelog Live: generate self-refreshing HTML output
      -q            Quiet, no console output
      -h            Show this help