Skip to content
The Swiss Army knife for 802.11, BLE and Ethernet networks reconnaissance and MITM attacks.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
caplets fix: caplet code is loaded entirely and comments are only skipped whi… Mar 24, 2019
core misc: small fix or general refactoring i did not bother commenting Apr 22, 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: setting RemoteAddr field of a proxied request Jun 13, 2019
network fix: api.rest and https.server certificates are now correctly generat… Apr 21, 2019
packets fix: syn.scanner now uses a dedicated pcap handle to prevent deadlock… Apr 21, 2019
session new: implemented mDNS server / spoofer (closes #542) Apr 22, 2019
tls fix: api.rest and https.server certificates are now correctly generat… Apr 21, 2019
vendor fix: updated dependencies (fixes #561) May 1, 2019
.gitignore misc: small fix or general refactoring i did not bother commenting Mar 1, 2019
.travis.yml misc: small fix or general refactoring i did not bother commenting Apr 18, 2019
Dockerfile Fixed certificate issues Mar 22, 2019
Gopkg.lock fix: updated dependencies (fixes #561) May 1, 2019
Gopkg.toml fix: updated dependencies (fixes #561) May 1, 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: added race detector build to Makefile Mar 17, 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 misc: small fix or general refactoring i did not bother commenting Mar 9, 2019
changelog.sh misc: small fix or general refactoring i did not bother commenting Feb 25, 2018
main.go new: new -version command line argument to print version, build infor… Mar 9, 2019
release.sh Add docker image latest Apr 27, 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.