๐ Professional BLE Security Analysis Tool for Researchers, Developers & Security Professionals Worldwide
BlueFusion is an enterprise-grade, AI-powered Bluetooth Low Energy (BLE) analysis platform that combines macOS native BLE capabilities with professional USB sniffer dongles for comprehensive wireless protocol analysis, security testing, and IoT device research.
๐ Keywords: BLE Security, Bluetooth Analysis, IoT Security Testing, Wireless Protocol Analyzer, BLE Sniffer, Bluetooth Hacking Tool, IoT Penetration Testing, GATT Protocol Analyzer, BLE Packet Inspector, Wireless Security Research
- Security Researchers - Analyze BLE vulnerabilities in IoT devices
- Penetration Testers - Professional wireless security assessments
- IoT Developers - Debug and optimize BLE implementations
- Forensic Analysts - Investigate BLE communications
- Academic Researchers - Study wireless protocols and security
- Hardware Engineers - Reverse engineer BLE devices
- Real-time BLE packet capture and analysis
- GATT protocol dissection with deep packet inspection
- Vulnerability scanning for common BLE security issues
- Man-in-the-Middle (MITM) testing capabilities
- Encryption analysis with AES-CCM support
- Custom fuzzing for BLE services and characteristics
- Dual Interface Technology - Simultaneous macOS BLE + USB sniffer support
- AI-Powered Pattern Recognition - Detect anomalies and security patterns
- WebSocket Streaming - Real-time packet streaming for automation
- RESTful API - Integrate with existing security workflows
- Hex Pattern Matching - Advanced packet filtering and analysis
- Channel Hopping - Monitor all BLE advertising channels
- Interactive Web Dashboard - Real-time visualization
- Packet Inspector - Detailed protocol analysis
- Export Capabilities - PCAP, JSON, CSV formats
- Custom Scripting - Python API for automation
- Comprehensive Logging - Audit trail for compliance
BlueFusion supports BLE analysis worldwide with:
- Multi-language documentation (Coming soon: ไธญๆ, ๆฅๆฌ่ช, Espaรฑol, Deutsch, Franรงais)
- International BLE standards compliance
- Region-specific frequency support
- Global IoT device database integration
# Clone the repository
git clone https://github.com/yourusername/BlueFusion.git
cd BlueFusion
# Run the installer
./install.sh# Create virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Start BlueFusion
python -m src.api.fastapi_serverdocker pull bluefusion/bluefusion:latest
docker run -p 8000:8000 bluefusion/bluefusion# Start BlueFusion
python bluefusion.py start
# Quick scan for nearby devices
python bluefusion.py scan
# Connect to specific device
python bluefusion.py connect AA:BB:CC:DD:EE:FF# Example: Analyze GATT services
from src.analyzers.packet_inspector import PacketInspector
from src.interfaces.macbook_ble import MacBookBLE
# Initialize interfaces
ble = MacBookBLE()
inspector = PacketInspector()
# Start security analysis
await ble.scan_for_vulnerabilities()# Start API server
python -m src.api.fastapi_server
# Access API documentation
open http://localhost:8000/docs
# WebSocket streaming
wscat -c ws://localhost:8000/streamBlueFusion/
โโโ src/
โ โโโ analyzers/ # Protocol analysis engines
โ โ โโโ hex_pattern_matcher.py
โ โ โโโ packet_inspector.py
โ โ โโโ protocol_parsers/
โ โโโ interfaces/ # Hardware interfaces
โ โ โโโ macbook_ble.py
โ โ โโโ sniffer_dongle.py
โ โ โโโ auto_connect_manager.py
โ โโโ api/ # RESTful API
โ โ โโโ fastapi_server.py
โ โโโ ui/ # Web interface
โ โ โโโ gradio_interface.py
โ โ โโโ characteristic_monitor.py
โ โโโ utils/ # Security utilities
โ โโโ ble_crypto/
โโโ tests/ # Comprehensive test suite
โโโ docs/ # Documentation
โโโ examples/ # Usage examples
# config.json
{
"sniffer": {
"type": "ubertooth",
"port": "/dev/ttyUSB0",
"baudrate": 115200
}
}# Enable advanced security features
{
"security": {
"enable_mitm_detection": true,
"log_encrypted_packets": true,
"vulnerability_scanning": true
}
}- Analyze smart home devices (locks, cameras, sensors)
- Test medical device BLE security
- Audit industrial IoT implementations
- Test vehicle keyless entry systems
- Analyze in-car BLE communications
- Research V2X communications
- Test mobile app BLE implementations
- Analyze wearable device security
- Research beacon technologies
- Packet Capture Rate: Up to 1000 packets/second
- Simultaneous Connections: 20+ devices
- Analysis Latency: <10ms per packet
- Storage Efficiency: Compressed packet storage
- API Response Time: <50ms average
We welcome contributions from the global security community! See CONTRIBUTORS.md for guidelines.
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
# Code formatting
black src/ tests/
# Linting
ruff check src/BlueFusion is designed for legitimate security research and testing:
- Always obtain proper authorization before testing
- Follow responsible disclosure practices
- Comply with local laws and regulations
- Use ethically and responsibly
MIT License - see LICENSE file for details.
- GitHub Issues: Report bugs or request features
- Discord Community: Join our Discord
- Twitter: @BlueFusionBLE
- Blog: bluefusion.security
- Windows & Linux support
- Cloud-based analysis platform
- Machine learning anomaly detection
- Automated vulnerability reporting
- Integration with popular security frameworks
BlueFusion - Empowering security researchers worldwide to analyze and secure the Internet of Things.
๐ต Made with โค๏ธ by the Ebowwa Labs Team | ๐ Global BLE Security Community