security enabled verified medium v1.0.0

btlejack

Bluetooth Low Energy (BLE) sniffing and jamming tool for security assessments of BLE devices.

📋 Live Preview 
btlejack -s
btlejack -s

Sandbox: execFile · Timeout: 86400s

Capabilities

ble.sniff
ble.jam
ble.scan
ble.capture

Parameters

Name Type Required Default Description Aliases
interface string No - BLE interface (hciX) -i, --interface
debug boolean No - Enable debug output -d, --debug
sniff boolean No - Sniff BLE connections -s, --sniff
follow boolean No - Follow a BLE connection -f, --follow
jam boolean No - Jam BLE connections -j, --jam
timeout integer No - Timeout in seconds -t, --timeout
channel string No - BLE channel (0-39) -c, --channel
output string No - Output file path -o, --output
verbose boolean No - Enable verbose output -v, --verbose
advertisements boolean No - Sniff advertisements only -a, --advertisements
write string No - Write capture to file -w, --write
read file No - Read from capture file -r, --read

Artifacts

TypeDescriptionMIMESchemaTrust
ble.capture.dumpCaptured BLE traffic dumpapplication/octet-stream-verified
ble.device.listDiscovered BLE devicestext/plain-verified

Contract

Inputs

ble.interface

BLE interface (hciX)

ble.channel

BLE channel to monitor

Outputs

ble.capture.dump

Captured BLE traffic

ble.device.list

Discovered BLE devices

Side effects: raw_socket_accessnetwork_traffic

Workflow Edges

Produces

ble.capture.dumpble.device.list

Consumes

ble.interfaceble.channel

Resource Profile

ResourceValue
CPUmedium
Memory64 MB
Networklow
Disk I/Omedium

Examples

Scan for BLE devices

btlejack -s

Sniff on specific interface

btlejack -i hci0 -s

Jam active BLE connections

btlejack -j

Follow existing BLE connection

btlejack -f

Sniff with output to file

btlejack -s -o capture.dump

Sniff advertisements only

btlejack -a -o ads.dump

Sniff with debug and verbose

btlejack -i hci0 -s -d -v

Specific channel sniffing

btlejack -c 37 -s

Documentation

Btlejack — Bluetooth Low Energy Sniffer

Btlejack is a Bluetooth Low Energy (BLE) sniffing and jamming tool. It can capture BLE packets, follow connections, and jam BLE devices for security assessment purposes.

Capabilities

  • Sniffing: Passive capture of BLE advertising and data channels
  • Jamming: Active jamming of BLE connections
  • Connection following: Decrypt and follow established BLE connections
  • Dump reading: Offline analysis of captured BLE traffic

Dependencies

python3

Related Tools

bluetoothctlbettercaphcitool

References