Libusb-1.0-0 (required by the HID module) libnetfilter-queue (on Linux only, required by the packet.proxy module) Using Docker. BetterCAP is containerized using Alpine Linux - a security-oriented, lightweight Linux distribution based on musl libc and busybox. The resulting Docker image is relatively small and easy to manage the dependencies. Linux/libusb (using libusb-1.0) FreeBSD (using libusb-1.0) Mac (using IOHidManager) On Linux, either the hidraw or the libusb back-end can be used. There are tradeoffs, and the functionality supported is slightly different. Linux/hidraw (linux/hid.c).

If not, you can build from source as described in the libusb/hidapi README. Installation procedure for Windows is described in the libusb/hidapi README. Binary distributions are provided by libusb/hidapi. There are currently no official binary distributions for Mac, so you must build hidapi yourself. . Added DDK build distribution system. Official libusb-win32 releases (after 0.1.12.2) are built using Microsoft's WinDDK. (see make.cmd). Fixed 2658937 (reported by Tim Roberts) The libusb-win32 driver always acts as a power policy owner.

bettercap supports GNU/Linux, BSD, Android, Apple macOS and the Microsoft Windows operating systems - depending if you want to install the latest stable release or the bleeding edge from the GitHub repository, you have several choices.

Precompiled Binaries

For every new release, we distribute bettercap’s precompiled binaries. In order to be able to use them, you’ll need the following dependencies on your system:

• libpcap
• libusb-1.0-0 (required by the HID module)
• libnetfilter-queue (on Linux only, required by the packet.proxy module)

Using Docker

BetterCAP is containerized using Alpine Linux - a security-oriented, lightweight Linux distribution based on musl libc and busybox. The resulting Docker image is relatively small and easy to manage the dependencies. Since it is using a multi-stage build, a Docker version greater than 17.05 is required.

To pull latest stable version of the image:

To pull latest source code build of the image:

To run:

Compiling from Sources

In order to compile bettercap from sources, make sure that:

• You have a correctly configured Go >= 1.8 environment.
• $GOPATH is defined and $GOPATH/bin is in $PATH.

You’ll also need to install the dependencies:

• build-essential
• libpcap-dev
• libusb-1.0-0-dev (required by the HID module)
• libnetfilter-queue-dev (on Linux only, required by the packet.proxy module)

Once you’ve met this conditions, you can run the following commands to compile and install bettercap in /usr/local/bin/bettercap:

Compiling on Android

Termux Method

Install Termux and from its prompt type:

There’s a golang bug in termux about some hardcoded path, the fix is ugly but it works:

Linux Deploy Method Debian based (like Ubuntu)

Install Linux Deploy, JuiceSSH, in Linux Deploy install kalilinux_arm (u need the piggy helper and enable the SSH) and type:

You can now proceed with the compilation:

Once the build process is concluded, the binary will be located in go/bin/bettercap.

Linux Deploy Method Fedora based (like Redhat, Centos)

Released:

ctypes bindings for hidapi

Project description

pyhidapi is available on PyPI and can be installed using pip.

pyhidapi is dependant upon the hidapi library, which must be installed separately.

Linux

Installation procedures vary depending on your distribution.

Arch Linux

Binary distributions are available in the community repository.

1. Enable the community repository in /etc/pacman.conf

1. Install hidapi

CentOS/RHEL

Binary distributions are available through EPEL.

Fedora

Binary distributions are available.

Ubuntu/Debian

Binary distributions are available.

or

Others

Binary distributions may be available in your package repositories. If not, you can build from source as described in the libusb/hidapi README.

Windows

Installation procedure for Windows is described in the libusb/hidapi README

Binary distributions are provided by libusb/hidapi

OSX

There are currently no official binary distributions for Mac, so you must build hidapi yourself.

Installation instructions are described in the libusb/hidapi README

You can also use brew:

It should be noted that at this time, brew still uses the old signal11 repository which has long since been abandond.See Homebrew/homebrew-core#41122.

The details about a HID device can be printed with following code:

Release historyRelease notifications | RSS feed

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

Libusb Mac

0.1.1

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Hashes for hid-1.0.4-py2-none-any.whl

Libusb Mac M1

Hashes for hid-1.0.4.tar.gz

Libusb Macos Mojave