Giter Club home page Giter Club logo

boopsuite's Introduction

BoopSuite

Synopsis:

BoopSuite is an up and coming suite of wireless tools designed to be easy to use and powerful in scope, that support both the 2 and 5 GHz spectrums. Written purely in python. A handshake sniffer (CLI and GUI), a monitor mode enabling script and a deauth script are all parts of this suite with more to come.

This Used To Be An Image But Now It Is Not. :(

Another Wireless pentesting suite.

  • A wireless sniffer
  • Two gui's for the wireless sniffer (old/new)
  • A wireless deauther
  • A monitor mode enabler and disabler

Note:

I hope my project can aid everyone in their pentesting needs, and this project is going to continue to grow as I add new handlers for additional packet types.

Changelog located in CHANGELOG file.

Hopefully others find it useful. If you do please email me and let me know I would love to hear about it.

Donate

What else is coming?

I am going to add scripts to do the following:

  • BoopCoil - Deauth attack detector
  • BoopDate - A script to update boopsuite

More ideas are welcome. Email me @: [email protected]

Examples:

This Used To Be An Image But Now It Is Not. :(

To start sniffing:

boopsniff -i wlan1mon

To specify a channel:

boopsniff -i wlan1mon -c 6

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

boopsniff -i wlan1mon -f 5

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

boopsniff -i wlan1mon -k

If you want to see unassociated clients:

boopsniff -i wlan1mon -u

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

boopsniff -i wlan1mon -a xx:xx:xx:xx:xx:xx

To launch a deauth attack:

boopstrike -i wlan1mon

Deauth the 5ghz spectrum:

boopstrike -i wlan1mon -f 5

Deauth a single AP:

boopstrike -i wlan1mon -a xx:xx:xx:xx:xx:xx

Deauth everyone except one Access Point:

boopstrike -i wlan1mon -s xx:xx:xx:xx:xx:xx

New Update includes a gui tool:

boopsniff_gui

Set card to monitor mode:

boop -i wlan1

Set card to managed mode:

boop -i wlan1mon

Set card to a specific name:

boop -i wlan1 -n boop1

note: will enable or disable monitor mode accordingly.

Set channel on card:

boop -i wlan1 -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:

boop -i wlan1 -k

Put it all together:

boop -i wlan1 -n boop1 -c 11 -k

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

I'm working on updating the GUI so it will be much cleaner and way better looking, stay tuned.

This Used To Be An Image But Now It Is Not. :(

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

Computer Usage

The sniffer which is the heaviest CPU part uses really low CPU and memory, memory which is going to shrink in upcoming versions.

This Used To Be An Image But Now It Is Not. :(

More options are coming in the future.

Installation:

To install open a terminal and type:

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

The setup includes creating symbolic links for the tool so it can be run from anywhere.

Upgrade:

To upgrade open a terminal and type:

Requires root to install

Root is dangerous so always check packages before running them as root. My code is not malicious, however, you should always be wary.

git clone https://github.com/M1ND-B3ND3R/BoopSuite.git
cd BoopSuite
chmod +x install.py
./install.py

Reference:

The top line is formatted as follows for the sniffer:

[+] Time: TIME_ELAPSED Slithering: [CHANNEL] - [boopstrike: RECENT HANDHAKE CAPTURED] - [AMOUNT OF HANDSHAKES]

Next line is the start of the Access Point table and is formatted as follows:

[Mac address] [Encryption] [Channel] [Vendor] [Signal] [Beacons] [SSID]

The Line that starts the client table is formatted as follows:

[Mac address] [AP Mac address] [Noise] [Signal] [AP SSID]

Contributors:

  • M1ND-B3ND3R
  • Sean Bangerter - Proofing my readme
  • Boop - My pet ball python

Motivation:

I am motivated by the want to be better. To prove others wrong and to prove to myself that I can do things that were previously impossible to me.

In Progress:

  • Wireless card discovery in VM for kali.

  • Code Fixes will be happening.

License:

MIT License (c) Jarad Dingman, 2017

boopsuite's People

Contributors

vesche avatar

Watchers

James Cloos avatar Alex Bander avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.