The Swiss Army knife for 802.11, BLE, IPv4 and IPv6 networks reconnaissance and MITM attacks.
Find a file
2019-02-22 14:48:32 +01:00
caplets fix: fixed a bug which prevented loading caplets from absolute paths 2019-01-26 12:50:58 +01:00
core fix: fixes 'iw executable not found in path' error on macOS (fixes #454) 2019-02-20 12:27:01 +01:00
firewall revert ! 2018-10-28 17:42:25 +01:00
log refact: refactored to use islazy and updated deps 2018-10-10 19:00:25 +02:00
modules misc: small fix or general refactoring i did not bother commenting 2019-02-22 14:48:32 +01:00
network Merge branch 'master' into hid_recon 2019-02-21 12:12:47 +01:00
packets misc: small fix or general refactoring i did not bother commenting 2019-02-13 12:14:57 +01:00
session new: hid.recon, hid.show and hid.sniff 2019-02-19 21:47:24 +01:00
tls misc: small fix or general refactoring i did not bother commenting 2019-02-21 13:51:30 +01:00
vendor misc: updated deps 2019-02-22 12:59:11 +01:00
.gitignore misc: small fix or general refactoring i did not bother commenting 2019-02-14 13:27:45 +01:00
.travis.yml misc: small fix or general refactoring i did not bother commenting 2019-02-12 10:31:25 +01:00
bettercap.service fix: fixed bettercap.service file to use the api.rest from the eval argument instead as an autostarted module 2018-09-27 16:56:01 +02:00
build.sh removed crosscompilations as libusb makes everything overcomplicated 2019-02-21 13:11:30 +01:00
changelog.sh misc: small fix or general refactoring i did not bother commenting 2018-02-25 13:45:26 +01:00
Dockerfile misc: small fix or general refactoring i did not bother commenting 2019-02-21 15:06:52 +01:00
Gopkg.lock misc: updated deps 2019-02-22 12:59:11 +01:00
Gopkg.toml misc: small fix or general refactoring i did not bother commenting 2019-02-12 16:59:00 +01:00
ISSUE_TEMPLATE.md misc: small fix or general refactoring i did not bother commenting 2018-03-13 14:50:44 +01:00
LICENSE.md Changing http links to https when possible 2018-02-21 21:42:19 +01:00
main.go fix: commands passed with -eval are executed after modules in autostart are activated 2019-02-15 13:59:21 +01:00
Makefile Add gofmt -s to the build 2018-10-23 03:27:38 +02:00
README.md misc: small fix or general refactoring i did not bother commenting 2019-02-21 15:06:22 +01:00
release.sh misc: small fix or general refactoring i did not bother commenting 2019-01-18 20:17:27 +01:00
snapcraft.yaml misc: small fix or general refactoring i did not bother commenting 2019-02-22 12:03:26 +01:00

BetterCap

Release Software License Travis Go Report Card Code Coverage

bettercap is the Swiss Army knife for 802.11, BLE and Ethernet networks reconnaissance and attacks.

How to Install

Get it from the Snap Store

A precompiled version is available for each release, alternatively you can use the latest version of the source code from this repository in order to build your own binary.

Make sure you have a correctly configured Go >= 1.8 environment, that $GOPATH/bin is in $PATH, that the libusb-1.0, libpcap-dev, libnetfilter-queue-dev (this one is only required on Linux) package installed for your system and then:

$ go get github.com/bettercap/bettercap
$ cd $GOPATH/src/github.com/bettercap/bettercap
$ make build && sudo make install

This command will download bettercap, install its dependencies, compile it and move the bettercap executable to /usr/local/bin.

Now you can use sudo bettercap -h to show the basic command line options and just sudo bettercap to start an interactive session on your default network interface, otherwise you can load a caplet.

Once bettercap is installed, you can download/update system caplet with the command:

sudo bettercap -eval "caplets.update; q"

Update

In order to update to an unstable but bleeding edge release from this repository, run the commands below:

$ go get -u github.com/bettercap/bettercap
$ cd $GOPATH/src/github.com/bettercap/bettercap
$ make build && sudo make install

Documentation and Examples

The project is documented in this wiki.

License

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