Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sammwyy/bleeding

Bluetooth/BLE jamming, signal inhibition, DoS and DeAuth attack.
https://github.com/sammwyy/bleeding

bluetooth bluetooth-connection bluetooth-low-energy ddos dos hacking hardware-hacking inhibition jammer jamming raspberry-pi wireless

Last synced: about 7 hours ago
JSON representation

Bluetooth/BLE jamming, signal inhibition, DoS and DeAuth attack.

Awesome Lists containing this project

README

        

# 🩸 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**

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

**🍎 macOS**

```bash
# Install dependencies.
brew install bluez
```

**🟦 Windows**

```bash
# Install dependencies.
choco install git python3
```

## 💻 Setup

```bash
# 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

```bash
python bleeding COMMAND
```

| Command | Description | Options | OS Support |
| ------- | ----------- | ------- | ------- |
| `scan` | Scan for devices. | `ble` | 🐧 🍎 c 🍇 |
| `random-mac` | Generate random trusted MAC addresses | | 🐧 🍎 🟦 🍇 |
| `enum ` | Enum device services | | 🐧 🍎 🟦 🍇 |
| `deauth ` | 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](https://github.com/sammwyy/bleeding/issues).

## ❤️ Show your support

Give a ⭐️ if this project helped you! Or buy me a coffee-latte 🙌 [Ko-fi](https://ko-fi.com/sammwy)

## 📝 License

Copyright © 2024 [Sammwy](https://github.com/sammwyy).
This project is [MIT](LICENSE) licensed.