Skip to content

Latest commit

 

History

History
80 lines (55 loc) · 2.42 KB

README.md

File metadata and controls

80 lines (55 loc) · 2.42 KB

🩸 BLEeding

BLEeding is a tool that allows you to jam Bluetooth and BLE devices. It can be used to spam DeAuth requests or L2CAP ping requests. It supports Linux, macOS, Windows and Raspberry PI.

This tool was created for educational purposes only. I do not take any responsibility for the misuse of this tool.

📦 Installing dependencies

🐧 Linux / 🍇 Raspberry PI

# Install dependencies.
sudo apt-get install git pkg-config python pip libbluetooth-dev libboost-python-dev libboost-thread-dev libglib2.0-dev

🍎 macOS

# Install dependencies.
brew install bluez

🟦 Windows

# Install dependencies.
choco install git python3

💻 Setup

# Clone the repository.
git clone https://github.com/sammwyy/bleeding

# Go to the repository.
cd bleeding

# Install the requirements.
pip install -r requirements.txt

Note: In order to use BLE in Linux, you must install "gattlib" python module. You can install it using the following command: pip install gattlib.

📚 Usage

python bleeding <options> COMMAND
Command Description Options OS Support
scan Scan for devices. ble 🐧 🍎 c 🍇
random-mac Generate random trusted MAC addresses 🐧 🍎 🟦 🍇
enum <TARGET> Enum device services 🐧 🍎 🟦 🍇
deauth <TARGET> Spam DeAuth requests port, protocol, size, threads 🐧 🍇 🟦
Option Short Description type Default
--ble -b Use BLE instead of Bluetooth. bool
--port -p Port to use. int 4097
--protocol -P Protocol to use. enum: l2cap, rfcomm l2cap
--size -s Size of the packets. int 512
--threads -t Number of threads. int (vcore count)

Note: All flags are optional. Windows doesn't support L2CAP protocol.

🤝 Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page.

❤️ Show your support

Give a ⭐️ if this project helped you! Or buy me a coffee-latte 🙌 Ko-fi

📝 License

Copyright © 2024 Sammwy. This project is MIT licensed.