Libusb is a library for USB device access from Linux, macOS, Windows, OpenBSD/NetBSD, Haiku and Solaris userspace. It is written in C (Haiku backend in C) and licensed under the GNU Lesser General Public License version 2.1 or, at your option, any later version (see COPYING).
Latest versionReleased:
ctypes bindings for hidapi
Project description
- Download libusb for free. A cross-platform library that gives apps easy access to USB devices. Library to enable user space application programs to communicate with USB devices.
- 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.
- 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.

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.
- Enable the community repository in
/etc/pacman.conf
- 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
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.
| Filename, size | File type | Python version | Upload date | Hashes |
|---|---|---|---|---|
| Filename, size hid-1.0.4-py2-none-any.whl (3.8 kB) | File type Wheel | Python version py2 | Upload date | Hashes |
| Filename, size hid-1.0.4.tar.gz (3.9 kB) | File type Source | Python version None | Upload date | Hashes |
Hashes for hid-1.0.4-py2-none-any.whl
| Algorithm | Hash digest |
|---|---|
| SHA256 | fba9913f07030b01059b822b24c83b370ca3f444e9e6443bd662f9f1aa3f0780 |
| MD5 | 8070e677da7a4aeae62cd30c03e5a324 |
| BLAKE2-256 | b35c76d7423965942242206a49aeb391874efb3fb6feff2b18c49d1977d348cd |
Hashes for hid-1.0.4.tar.gz
| Algorithm | Hash digest |
|---|---|
| SHA256 | f61b0382f37a334bc8ba8604bc84b94875ee4f594fbbaf82b2c3b3e827883fc1 |
| MD5 | d02bce9b9eee3fbece8b9f4cafd34973 |
| BLAKE2-256 | 96bae1923a3f7f865cd9f3c388bf6a42b4ed149ae1a00e68f71eec49ea3d3da4 |
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.
$GOPATHis defined and$GOPATH/binis in$PATH.
Libusb Macos Catalina
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:
Libusb For Mac
Compiling on Android
Termux Method
Install Termux and from its prompt type:
Libusb Mac Download
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.
Libusb Macos 10.15
Linux Deploy Method Fedora based (like Redhat, Centos)
