Skip to content
The Swiss Army knife for 802.11, BLE and Ethernet networks reconnaissance and MITM attacks.
Go Other
  1. Go 99.5%
  2. Other 0.5%
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
builder new travis configuration (#1) Oct 18, 2019
caplets caplets: Swap Error Returns Nov 13, 2019
core Releasing v2.26.1 Oct 26, 2019
firewall misc: small fix or general refactoring i did not bother commenting Mar 30, 2019
log refact: refactored to use islazy and updated deps Oct 10, 2018
modules fix: fixed a bug with wifi.recon.channel clear when wifi.interface is… Nov 25, 2019
network fix: using iw instead of iwconfig whenever possible (fixes #657) Nov 25, 2019
packets Update broken tests Jun 30, 2019
session caplets: Swap Error Returns Nov 13, 2019
tls tls: fix CertConfigFromModule() return order Nov 13, 2019
.gitignore misc: added .idea to .gitignore Sep 26, 2019
.travis.yml misc: small fix or general refactoring i did not bother commenting Oct 18, 2019
Dockerfile Dockerfile: Use go modules instead of third party dependency tool (fe… Nov 6, 2019
ISSUE_TEMPLATE.md misc: small fix or general refactoring i did not bother commenting Mar 9, 2019
LICENSE.md Changing http links to https when possible Feb 21, 2018
Makefile misc: small fix or general refactoring i did not bother commenting Oct 18, 2019
README.md misc: small fix or general refactoring i did not bother commenting Apr 22, 2019
bettercap.service fix: fixed bettercap.service file to use the api.rest from the eval a… Sep 27, 2018
build.sh new: updated build script to generate a linux/armv6l image (rpi0w+ras… Oct 4, 2019
changelog.sh misc: small fix or general refactoring i did not bother commenting Feb 25, 2018
go.mod go get -u Oct 18, 2019
go.sum go get -u Oct 18, 2019
main.go new: new -version command line argument to print version, build infor… Mar 9, 2019
release.sh misc: small fix or general refactoring i did not bother commenting Oct 18, 2019

README.md

BetterCap

Release Software License Travis Go Report Card Code Coverage Packaging status

bettercap is a powerful, easily extensible and portable framework written in Go which aims to offer to security researchers, red teamers and reverse engineers an easy to use, all-in-one solution with all the features they might possibly need for performing reconnaissance and attacking WiFi networks, Bluetooth Low Energy devices, wireless HID devices and Ethernet networks.

UI

Main Features

  • WiFi networks scanning, deauthentication attack, clientless PMKID association attack and automatic WPA/WPA2 client handshakes capture.
  • Bluetooth Low Energy devices scanning, characteristics enumeration, reading and writing.
  • 2.4Ghz wireless devices scanning and MouseJacking attacks with over-the-air HID frames injection (with DuckyScript support).
  • Passive and active IP network hosts probing and recon.
  • ARP, DNS and DHCPv6 spoofers for MITM attacks on IP based networks.
  • Proxies at packet level, TCP level and HTTP/HTTPS application level fully scriptable with easy to implement javascript plugins.
  • A powerful network sniffer for credentials harvesting which can also be used as a network protocol fuzzer.
  • A very fast port scanner.
  • A powerful REST API with support for asynchronous events notification on websocket to orchestrate your attacks easily.
  • A very convenient web UI.
  • More!

About the 1.x Legacy Version

While the first version (up to 1.6.2) of bettercap was implemented in Ruby and only offered basic MITM, sniffing and proxying capabilities, the 2.x is a complete reimplementation using the Go programming language.

This ground-up rewrite offered several advantages:

  • bettercap can now be distributed as a single binary with very few dependencies, for basically any OS and any architecture.
  • 1.x proxies, although highly optimized and event based, used to bottleneck the entire network when performing a MITM attack, while the new version adds almost no overhead.
  • Due to such performance and functional limitations, most of the features that the 2.x version is offering were simply impossible to implement properly (read as: without killing the entire network ... or your computer).

For this reason, any version prior to 2.x is considered deprecated and any type of support has been dropped in favor of the new implementation. An archived copy of the legacy documentation is available here, however it is strongly suggested to upgrade.

Documentation and Examples

The project is documented here.

License

bettercap is made with ♥ by the dev team and it's released under the GPL 3 license.

Stargazers over time

Stargazers over time

You can’t perform that action at this time.