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.

0.1.2 (2025-10-30)

  • Fix lookup error

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.2.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.2-py3-none-any.whl (489.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: usb_inspector-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 a1c8a85207110da58480b5557219696a16162929f2c8c13f0dc17d5c0f05763c
MD5 d06b5243b29f6bb9ad4ac0cad7350ad7
BLAKE2b-256 cf8b4e04c0be0ff8677a43daa3d8f5d035ad6293725e19f348264a6c681a1452

See more details on using hashes here.

File details

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

File metadata

  • Download URL: usb_inspector-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a817ccaa29825166bd81937606f9196b948cca9a2a6d05990dcb60b8caf701c8
MD5 fcc06f2fbb129a0de230c1b714adc233
BLAKE2b-256 cdd42dd3e2a5bf048e32dbafd97e1140a49830808b3bb8f8b35949d29b7f1677

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