You are here: Home » Wireless Attacks » BoopSuite

BoopSuite

BoopSuite Description

BoopSuite is a set of tools written in Python designed for wireless auditing and security testing.

This set of Wi-Fi tools is designed for simple and effective use. The tools support frequencies of 2 GHz and 5 GHz. All of them are written in pure Python. There is a handshake sniffer, CLI and GUI, a script to enable the monitor mode and a script for deauthentication. All this is included in BoopSuite, and in the future it is planned to add new tools, including:

  • BoopCoil – Deauthentication attack detector
  • BoopDate – Script for updating boopsuite

Homepage: https://github.com/MisterBianco/BoopSuite

Author: Jarad Dingman

License: MIT

BoopSuite Help

Currently, the tool kit includes the following programs:

  • BoopMon is a script to set a wireless card to monitor mode and to managed mode
  • BoopSniff is a script to show access points in the range of accessibility and capture handshakes
  • BoopStrike is a script to perform deauthentication attacks
  • Boopsniff_gui is a new graphical user interface
  • Old_boopsniff_gui is an old graphical interface

BoopMon Help

usage:

BoopMon [-h] [-v] [-c [CHANNEL [CHANNEL ...]]] [-k] [-n NAME] -i {}
               [-m MAC]

optional arguments:

  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -c [CHANNEL [CHANNEL ...]], --channel [CHANNEL [CHANNEL ...]]
                        select a channel
  -k, --kill            sudo kill interfering processes.
  -n NAME, --name NAME  select a new card name
  -i {}, --interface {}
                        select an interface
  -m MAC, --mac MAC     Set Mac Address.

BoopSniff Help

usage:

BoopSniff [-h] [-v] [-c [CHANNEL [CHANNEL ...]]] [-k] [-u] [-N] [-O]
                 [-D] [-m MAC] -i {} [-f {2,5,all}] [-t [TARGET [TARGET ...]]]
                 [-T TIME]

optional arguments:

  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -c [CHANNEL [CHANNEL ...]], --channel [CHANNEL [CHANNEL ...]]
                        select a channel
  -k, --kill            sudo kill interfering processes.
  -u, --unassociated    Whether to show unassociated clients.
  -N, --No-clients      Switch for displaying any clients at all
  -O, --No-open         Switch for displaying open networks
  -D, --Diagnose        Switch for diagnostic mode.
  -m MAC, --mac MAC     Set Mac Address.
  -i {}, --interface {}
                        select an interface
  -f {2,5,all}, --frequency {2,5,all}
                        select a frequency (2/5/all)
  -t [TARGET [TARGET ...]], --target [TARGET [TARGET ...]]
                        Command for targeting a specific network.
  -T TIME, --Timeout TIME
                        Command for killing after a certain amount of time.

BoopStrike Help

usage:

BoopStrike [-h] [-v] [-c [CHANNEL [CHANNEL ...]]] [-k] [-s SKIP]
                  [-p PACKETS] -i {} [-f {2,5,all}] [-t [TARGET [TARGET ...]]]
                  [-T TIME]

optional arguments:

  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -c [CHANNEL [CHANNEL ...]], --channel [CHANNEL [CHANNEL ...]]
                        select a channel
  -k, --kill            sudo kill interfering processes.
  -s SKIP, --skip SKIP  Mac to not deauth (Usually your own...)
  -p PACKETS, --packets PACKETS
                        How many deauth packets to send, more than 5 is
                        usually unneccessary.
  -i {}, --interface {}
                        select an interface
  -f {2,5,all}, --frequency {2,5,all}
                        select a frequency (2/5/all)
  -t [TARGET [TARGET ...]], --target [TARGET [TARGET ...]]
                        Command for targeting a specific network.
  -T TIME, --Timeout TIME
                        Command for killing after a certain amount of time.

NOTE: boop will always switch the mode from managed to monitor and vice versa.

Note: all pcap files will be saved in the directory ~/pcaps

BoopSuite Usage Example

Set card to monitor mode:

sudo BoopMon -i wlan0

Set card to managed mode:

sudo BoopMon -i wlan0mon

Set card to a specific name:

sudo BoopMon -i wlan0 -n boop0

note: will enable or disable monitor mode accordingly.

Set channel on card:

sudo BoopMon -i wlan0 -c 11

Note: Will do error checking if you specify a channel the card doesnt support and is ready for cards supporting the 5GHz network.

Kill any interfering tasks:

sudo BoopMon -i wlan0 -k

Put it all together:

sudo BoopMon -i wlan0 -n boop1 -c 11 -k

To start sniffing:

sudo BoopSniff -i wlan0mon

To specify a channel:

sudo BoopSniff -i wlan0mon -c 6

Boop also works on the 5ghz spectrum if you have a supporting card:

sudo BoopSniff -i wlan0mon -f 5

If some processes are interfering then you can preemptively kill them with:

sudo BoopSniff -i wlan0mon -k

If you want to see unassociated clients:

sudo BoopSniff -i wlan0mon -u

If you want to filter by a specific AP mac address:

sudo BoopSniff -i wlan0mon -a xx:xx:xx:xx:xx:xx

To launch a deauth attack:

sudo BoopStrike -i wlan0mon

Deauth the 5ghz spectrum:

sudo BoopStrike -i wlan0mon -f 5

Deauth a single AP:

sudo BoopStrike -i wlan0mon -a xx:xx:xx:xx:xx:xx

Deauth everyone except one Access Point:

sudo BoopStrike -i wlan0mon -s xx:xx:xx:xx:xx:xx

New Update includes a gui tool:

boopsniff_gui

How to install BoopSuite

Installation on Kali Linux

git clone https://github.com/M1ND-B3ND3R/BoopSuite.git
cd BoopSuite
sudo pip install -r requirements.txt
chmod +x install.py
sudo ./install.py

Installation on Linux (Debian, Mint, Ubuntu)

sudo apt-get install git
git clone https://github.com/M1ND-B3ND3R/BoopSuite.git
cd BoopSuite
sudo pip install -r requirements.txt
chmod +x install.py
sudo ./install.py

BoopSuite Screenshots

BoopSuite Tutorials

Related tools

Also recommended: