Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

BlueWatch

Monitor pasivo de Bluetooth para Raspberry Pi y Linux que ofrece radar en vivo, clasificación automática de dispositivos y alertas. Incluye dashboard web y análisis de patrones de presencia. Actualmente en fase Alpha, no apto para producción.

Ficha actualizada 22 sept 2026, 16:09 · upstream 20 sept 2026, 8:15 · release v0.1.4

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es BlueWatch

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

BlueWatch es una herramienta de monitorización pasiva de Bluetooth diseñada para entornos Linux y Raspberry Pi. Escanea continuamente dispositivos BLE y Clásicos, identificando vendedores mediante MAC y UUIDs de servicios. Proporciona un radar visual con fuerza de señal (RSSI) y permite organizar dispositivos en categorías personalizadas mediante arrastrar y soltar. La interfaz web muestra estadísticas horarias, mapas de calor de actividad y permite exportar datos a CSV. El proyecto se basa en Python y Next.js, integrando alertas vía ntfy.sh para notificaciones push sobre la llegada o salida de dispositivos vigilados.

Es importante destacar que el software está en desarrollo activo (fase Alpha) y no debe utilizarse en entornos críticos sin supervisión. Requiere una instalación previa del stack BlueZ en el sistema anfitrión, ya que el contenedor Docker accede al hardware directamente. El proyecto ha divergido de su predecesor Bluehood, añadiendo capacidades como resolución de direcciones IRK y búsqueda en WiGLE.net, aunque mantiene la licencia MIT original para componentes heredados.

CASOS DE USO
  • Auditoría de privacidad local detectando dispositivos no autorizados
  • Análisis de patrones de presencia para identificar rutinas habituales
  • Monitoreo de seguridad perimetral mediante detección de vehículos o drones
  • Gestión de inventario de dispositivos IoT en el hogar o oficina
  • Visualización de actividad de red Bluetooth en tiempo real
PUNTOS DESTACADOS
  • Dashboard web en vivo con radar de señal y log de eventos
  • Clasificación automática de tipos de dispositivos (móviles, wearables, vehículos)
  • Soporte nativo para despliegue Docker Compose en Raspberry Pi 64-bit
  • Integración con ntfy.sh para notificaciones push configurables
  • Exportación de datos a CSV y limpieza automática de base de datos
  • Capacidad de filtrar direcciones MAC aleatorizadas para privacidad
PRECAUCIONES
  • Software en fase Alpha, no apto para producción sin precauciones
  • Requiere BlueZ instalado y activo en el host Linux (no incluido en Docker)
  • Despliegue Docker falla en arquitecturas ARM 32-bit con imágenes estándar
  • Datos recopilados deben considerarse experimentales y no garantizados
  • Dependencia de adaptadores Bluetooth que soporten rol Central BLE
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Instalar BlueZ en el host antes de iniciar Docker. Usar Raspberry Pi OS 64-bit para evitar fallos de compilación. Configurar variables de entorno para adaptadores BLE/Clásico si se usan múltiples hci. Habilitar autenticación web opcional. Asegurar que el puerto 8080 esté disponible. No usar en entornos donde la privacidad sea crítica sin consentimiento.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
808030009199
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.