Welcome to libusb-uvc’s documentation!

Libusb-UVC is a lightweight toolkit built on top of libusb1 and pyusb to provide a reliable, Pythonic interface to USB Video Class (UVC) devices. This documentation combines getting started guides, conceptual explanations, and API reference material so you can introspect camera controls and stream video with confidence.

User Guide

• Getting Started
  • Installation
  • System Dependencies
  • Building Distribution Artifacts
  • Udev Rules
  • First Stream
  • Targeting a Specific Camera
  • Multiple Sensors on One Device
  • Minimal Python Usage
  • Next Steps
• Understanding Controls and Streaming
  • Video Control Units
  • Extension Units and Quirks
  • Streaming Interfaces
  • Frame Objects
  • Device Reset and Kernel Cooperation
  • Further Reading
• Example Scripts
  • uvc_capture_video.py
  • uvc_display_frame.py
  • uvc_led_preview.py
  • uvc_inspect.py
  • uvc_ir_inspect.py
  • uvc_capture_still.py
  • uvc_ir_torch_demo.py
  • exposure_sweep.py
  • uvc_generate_quirk.py
  • uvc_capture_stereo.py
  • Integrating Scripts
  • Future Work
• Stereo Capture Strategy
  • Architecture Overview
  • Queueing and Drop Policy
  • Timestamp Handling
  • CPU Affinity and Coordination
  • Recommended Command
  • Tuning Checklist
• Troubleshooting
  • Permission Errors
  • uvcvideo Node Disappears
  • Probe/Commit Fails
  • Dropped or Corrupted Frames
  • Frame-based H.264/H.265 Quirks
  • Recording Plays Too Fast/Slow
  • Recording Files Are Empty
  • Controls Missing or Unnamed
  • VC Interface Busy
  • Still Capture Returns Empty Payloads
  • Further Help

How-to Recipes

• How-to Recipes
  • USB Gadget Testing on Debian
  • Run Unit Tests
  • USB Gadget Integration Tests
  • Disable Auto Exposure
  • Sweep Exposure While Streaming
  • Toggle an Indicator LED
  • Graceful Shutdown
  • Next Steps

API Reference

• API Reference

Project Information

• Release Notes

Indices and tables

• Index

• Module Index

• Search Page