usb-inspector 0.2.0

A cross-platform tool to monitor and inspect USB devices connected to the host system.

USB Inspector

Overview

A simple package that leverages pyusb and allows you to lookup USB vendor and device IDs and get back a human readable vendor and device name. It includes ability to manually update the USB DB without installing a new version of usb-inspector.

Installation

uv add usb-inspector
# via pip
python3 -m pip install usb-inspector

IMPORTANT: On Windows ensure you have libusb-1.0.dll (64bit) in C:\Windows\System32 or you will get a NoBackendError. You can get it from here.

Raspberry Pi

• Raspberry Pi 3B+ trixie aarch64 64bit

Example Usage

Command Line:

usb-inspector lookup --vendor-id 1A40
usb-inspector lookup --vendor-id 1A40 --device-id 0801

# To manually update the USB DB
usb-inspector delete-data
usb-inspector update-db

from usb_inspector.monitor import USBDeviceMonitor

usb_monitor = USBDeviceMonitor(poll_interval=1.0)
usb_monitor.monitor()
# Do stuff
...
usb_monitor.stop()

Issues

If you experience any issues, please create an issue on Bitbucket.

Development

To get a list of all commands with descriptions simply run make.

make env
make pip_install_editable

Testing

make pytest
make coverage
make open_coverage

History

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

0.2.0 (2025-11-21)

• FIXED Connecting/Disconnecting the same physical device to the same port now correctly identifies the device as the same device on Windows/Linux.

0.1.9 (2025-11-21)

• FIXED Cached sql db lookup so it occurs only once.

0.1.8 (2025-11-20)

• FIXED turned default packaged logging to ERROR. Was INFO...Sorry!

0.1.7 (2025-11-13)

• FIXED is_connected bug introduced in last patch.
• ADDED improved tracking of devices allowing multiple of the same vendor/device ID to be connected.

0.1.6 (2025-11-13)

• FIXED last_seen timestamp for each device, only updates when connected/disonnected.

0.1.5 (2025-11-05)

• Locked pandas to version 2.3.3 for Raspberry Pi compatability (it pulls the pre-built wheel from piwheels.org)

0.1.4 (2025-11-05)

• Added last_seen timestamp for each device.

0.1.4 (2025-10-31)

• update-db cli command only adds new Vendors and Devices to the existing DB rather than requiring deletion and recreation of the DB.
• Track which devices are connected/disconnected.

0.1.2 (2025-10-30)

• Fix lookup error

0.1.1 (2025-10-30)

• Added start as an alias for monitor.

0.1.0 (2025-10-30)

• First release