Linux HDMI microscope and USB capture-card inspection workstation for electronics repair, PCB analysis, solder inspection, OCR, measurements, focus stacking, HDR fusion, and recording.
Designed primarily for:
- MacroSilicon HDMI USB capture cards
- HDMI microscopes
- USB microscopes
- Linux V4L2 devices
Built with:
- Python
- PySide6
- OpenCV
- NumPy
- PyAV
- FFmpeg
- Tesseract OCR
MAIN UI
LIVE MICROSCOPE VIEWER
- Realtime HDMI microscope display
- Multi-device V4L2 support
- MJPG/YUYV support
- Zoom and pan
- Crosshair and ruler overlays
IMAGE PROCESSING
- Brightness
- Contrast
- Gamma
- Saturation
- CLAHE local contrast
- Sharpening
- Denoising
- Edge detection
- Threshold modes
- False-color visualization
MEASUREMENT TOOLS
- Pixel/mm calibration
- Locked measurements
- mm and mil conversion
- Trace-width estimation
ELECTRONICS INSPECTION
- OCR chip-marking reader
- Solder bridge candidate detection
- Pad/component segmentation
- Focus scoring
CAPTURE TOOLS
- PNG snapshots
- MP4 recording
- Focus stacking
- HDR fusion
- Panorama stitching
- HTML report generation
modern/ Current recommended versions
legacy/ Historical development versions
docs/ Reference documentation
screenshots/ UI and example images
FFMPEG EDITION Uses external ffmpeg subprocess recording.
Best for:
- Maximum reliability
- Simpler dependencies
- Stable Linux systems
Requirements: sudo apt install ffmpeg v4l-utils tesseract-ocr pip install -r requirements-ffmpeg.txt
Run: python3 modern/microcam_benchscope_ffmpeg.py
PYAV EDITION Uses PyAV internal FFmpeg bindings.
Best for:
- Cleaner Python-native recording
- Better future extensibility
- Advanced workflows
Requirements: sudo apt install v4l-utils tesseract-ocr pip install -r requirements-pyav.txt
Run: python3 modern/microcam_benchscope_pyav.py
The legacy folder contains the original development history of the project.
These versions are:
- simpler
- easier to hack
- useful for experimentation
- educational references
Included:
- microcam_original.py
- microcam_v2.py
- microcam_v3.py
- microcam_hyperlab.py
Resolution: 1920x1080
FPS: 30
FOURCC: MJPG
Recommended filters: CLAHE ON Sharpen ON
W A S D Pan
MouseWheel Zoom
P Snapshot
R Record
SPACE Pause
L Lock measurement
C Clear measurements
- MacroSilicon USB HDMI capture cards
- HDMI digital microscopes
- USB microscopes
- Linux systems with V4L2 support
This project is intentionally practical and repair-bench focused.
It prioritizes:
- realtime usability
- low-latency inspection
- easy modification
- Linux compatibility
- single-file experimentation
- practical electronics workflows