libusb 1.0.30rc1

Python binding for the libusb C library.

libusb

Python binding for the libusb C library.

Overview

Python libusb module is a low-level binding for libusb C library.

It is an effort to allow python programs full access to the API implemented and provided by the well known libusb library.

PyPI record.

Documentation.

libusb is a lightweight Python package, based on the ctypes library.

It is fully compliant implementation of the original C libusb 1.0 API by implementing whole its functionality in a clean Python instead of C.

libusb API 1.0 documentation can be found at:

libusb-1.0 API Reference on Documentation.

libusb uses the underlying libusb C shared library as specified in libusb.cfg (included libusb-X.X.* is the default), but there is also ability to specify it programmatically by one of the following ways:

import libusb
libusb.config(LIBUSB="libusb C shared library absolute path")
# or
libusb.config(LIBUSB=None)  # included libusb-X.X.* will be used

About original libusb:

Borrowed from the original website:

A cross-platform user library to access USB devices

Overview

libusb is a C library that provides generic access to USB devices. It is intended to be used by developers to facilitate the production of applications that communicate with USB hardware.

It is portable: Using a single cross-platform API, it provides access to USB devices on Linux, macOS, Windows, etc.

It is user-mode: No special privilege or elevation is required for the application to communicate with a device.

It is version-agnostic: All versions of the USB protocol, from 1.0 to 3.1 (latest), are supported.

What platforms are supported?

Linux, macOS, Windows (Vista or newer), Android, OpenBSD/NetBSD, Haiku, Solaris.

For additional information, please consult the FAQ or the Wiki.

Requirements

• It is a fully independent package.

  All necessary things are installed during the normal installation process.

• ATTENTION: currently fully tested only for Windows.

Installation

Prerequisites:

• Python 3.10 or higher

  • https://www.python.org/

  • with C libusb 1.0.30 is a primary test environment.

• pip

  • https://pypi.org/project/pip/

To install run:

python -m pip install --upgrade libusb

Development

Prerequisites:

• Development is strictly based on nox. To install it run:

  python -m pip install --upgrade nox

Visit Development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/libusb libusb

and run:

python -m pip install ./libusb

or on development mode:

python -m pip install --editable ./libusb

License

Copyright (c) 2016-2026 Adam Karpierz

Licensed under the zlib/libpng License

https://opensource.org/license/zlib

Please refer to the accompanying LICENSE file.

Authors

• Adam Karpierz <[e-mail]>

Sponsoring

If you would like to sponsor the development of this project, your contribution is greatly appreciated.

As I am now retired, any support helps me dedicate more time to maintaining and improving this work.

Donate