/hydra

Bettercap web UI

Primary LanguageTypeScript

Hydra

Software License

Hydra

Hydra is a UI crafted on top of bettercap, this project is still work in progress.

Prerequisites

What things you need to install the software and how to install them

  • Node
  • NPM

Getting Started

In order to run the web ui, first clone the repo somewhere and build the source:

git clone https://github.com/bettercap/hydra.git ~/hydra
cd ~/hydra
npm install --save
ng build --prod

This shoud generate the ~/hydra/dist/hydra folder, then you can use bettercap (make sure it's updated) for both the REST API and to serve the web ui itself via the http.server module:

sudo bettercap

Then from bettercap's interactive session, enable a few modules:

wifi.recon on 
ble.recon on
hid.recon on

Setup the api.rest module (change these default credentials!):

set api.rest.username changeme 
set api.rest.password changeme 
api.rest on

And start serving the UI (by default on port 80 of the IP address of the interface):

set http.server.address 127.0.0.1
set http.server.path /path/to/hydra/dist/hydra 
http.server on

The UI will be available at http://127.0.0.1/, you can login with the credentials provided to api.rest.

For further information, refer to bettercap's documentation.

License

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