Skip to main content

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

Project description

USB Inspector

Coverage

Overview

A simple package that 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

python3 -m pip install usb-inspector

Example Usage

Command Line:

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

usb-inspector update-db
usb-inspector delete-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.1.0 (2025-10-30)

  • First release

0.1.1 (2025-10-30)

  • Added start as an alias for monitor.

Project details


Download files

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

Source Distribution

usb_inspector-0.1.1.tar.gz (491.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

usb_inspector-0.1.1-py3-none-any.whl (489.0 kB view details)

Uploaded Python 3

File details

Details for the file usb_inspector-0.1.1.tar.gz.

File metadata

  • Download URL: usb_inspector-0.1.1.tar.gz
  • Upload date:
  • Size: 491.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for usb_inspector-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d13f1c730153e36ab14f72209a71af1b024372b300d7b195d1936d86f9ba6b94
MD5 11b4869b7c4241ac316f9da098dce559
BLAKE2b-256 270cb34e7d432151b8d1e314b293d746a7385120fef1aa3b75438cdb931e93d3

See more details on using hashes here.

File details

Details for the file usb_inspector-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: usb_inspector-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 489.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for usb_inspector-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 35b484ae5071f41818c3d9ddc53b589ab095ee824cd29f0ba6a6bbd19dd2e6f1
MD5 d845f3df4a62767b4c57496546e9c24a
BLAKE2b-256 9e8e8e04c8942a515bbc74aee139593bc8f92260cbbf68c08d5168ce5f1cb87d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page