No description
Find a file
2026-05-28 07:20:58 +00:00
btstrike.py Add files via upload 2026-02-12 20:55:00 +01:00
LICENSE Initial commit 2026-02-12 20:51:55 +01:00
README.md Actualiser README.md 2026-05-28 07:20:58 +00:00
requirements.txt Create requirements.txt 2026-02-12 20:53:21 +01:00

Python Bluetooth

⚠️ WARNING: SECURITY RESEARCH TOOL

BTStrike is a Bluetooth L2CAP stress testing framework designed to assess the resilience and security posture of Bluetooth-enabled devices against denial-of-service attacks. This tool is intended for cybersecurity research, penetration testing, and educational purposes in authorized environments only.

USE RESPONSIBLY. The developers are not responsible for any misuse, unauthorized access, privacy violations, or illegal activities performed with this tool. Unauthorized testing of devices you do not own or have explicit permission to test is ILLEGAL and may result in criminal prosecution.


🔥 Features

Advanced Device Discovery:

  • Automated HCI scanning - Real-time Bluetooth device enumeration
  • Multi-interface support - Automatic detection of hci0, hci1, hci2+
  • Device identification - MAC address and name resolution
  • Interactive selection - ID-based or direct MAC targeting
  • Connection validation - Pre-attack connectivity verification

L2CAP Stress Testing:

  • Multi-threaded flood attacks - Configurable 1-200 concurrent threads
  • Customizable packet sizes - 1-65535 bytes payload control
  • Intelligent thread management - Auto-restart on worker failure
  • Resource optimization - Daemon threads with graceful cleanup
  • Real-time monitoring - Live thread count and status display

Security Features:

  • 🔐 Root privilege validation - Automatic permission checking
  • 🛡️ Dependency verification - Pre-flight BlueZ tool detection
  • MAC address validation - Regex-based format verification
  • 📊 Input sanitization - Parameter bounds and type checking
  • 🧹 Process cleanup - Automatic l2ping termination on exit

Interface:

  • 🎨 Color-coded output - ANSI terminal styling
  • 📋 Structured logging - Timestamp-based event tracking
  • Progress indicators - Real-time attack status
  • 🎯 Tabular device lists - Clean scanning results
  • 💬 Interactive prompts - User-friendly input flow

Operational Reliability:

  • Thread-safe operations - Mutex-protected state management
  • Exception handling - Comprehensive error recovery
  • Graceful interrupts - Ctrl+C signal handling
  • Timeout protection - Prevents hanging operations
  • Minimal resource footprint - Optimized for embedded systems