How reco-project/video-stitcher works
Reco is a GPU-accelerated panoramic sports-video stitcher, provided as a CLI, desktop app, and OBS plugin. The main workflow is to ingest paired video or live-camera frames, calibrate camera geometry and synchronization, optionally detect and track players or a ball to drive framing, render a stitched panorama, and encode or display the result. The graph also preserves documented replay, stacked-video, operator-control, and calibration-profile capabilities. Edges use README statements or source-index references; unsampled implementation details are not asserted.
Main entry points: mod.rs Stitch Session · stitch_job.rs Stitch Job · src/main.rs Desktop App · src/main.rs CLI
Components 22
Applications
- CLI
crates/reco-cli/src/main.rs - Desktop App
crates/reco-gui/src/main.rs - OBS Plugin
crates/reco-obs/src/source.rs - Calibration Command
crates/reco-cli/src/calibrate.rs - OBS Source Output
crates/reco-obs/src/source.rs
Media I/O
- Stitch Job
crates/reco-io/src/stitch_job.rs - Video Decode
crates/reco-io/src/ffmpeg/decoder.rs - Camera Ingest
crates/reco-io/src/gstreamer/camera.rs - Video Encoding
crates/reco-io/src/ffmpeg/encoder.rs - Replay and Stacked Video
crates/reco-io/src/stacked_video/replay.rs
Stitch Engine
- Stitch Session
crates/reco-core/src/session/mod.rs - GPU Context
crates/reco-core/src/gpu/mod.rs - Panorama Renderer
crates/reco-core/src/render/renderer.rs - Stitch Pipeline
crates/reco-core/src/render/pipeline.rs
Calibration and Tracking
- Calibration Pipeline
crates/reco-calibrate/src/pipeline.rs - Lens Profiles
crates/reco-calibrate/src/lens_database.rs - Detection and Tracking
crates/reco-core/src/detect/director.rs - Inference Backends
crates/reco-detect/src/detectors/mod.rs - Auto Framing
crates/reco-autocam/src/panners/field.rs
Live Operations
- Operator Controls
crates/reco-control/src/lib.rs - Pipeline Events
crates/reco-core/src/detect/pipeline_event.rs
Other components
- Operator
Connections 24
- Operator → CLI: invokes
README.md - Operator → Desktop App: operates
README.md - Operator → OBS Plugin: configures
README.md - CLI → Calibration Command: dispatches
crates/reco-cli/src/main.rs - CLI → Stitch Job: runs
README.md - Calibration Command → Calibration Pipeline: runs
- Desktop App → Calibration Pipeline: calibrates
- Desktop App → Stitch Job: exports
- OBS Plugin → Stitch Session: submits frames
README.md - Stitch Job → Video Decode: decodes
crates/reco-io/src/stitch_job.rs - Stitch Job → Video Encoding: encodes output
crates/reco-io/src/stitch_job.rs - Stitch Job → Replay and Stacked Video: uses replay
crates/reco-io/src/stitch_job.rs - Camera Ingest → Stitch Session: supplies frames
- Calibration Pipeline → Lens Profiles: loads profiles
crates/reco-calibrate/src/pipeline.rs - Stitch Session → Detection and Tracking: dispatches detection
crates/reco-core/src/session/mod.rs - Detection and Tracking → Inference Backends: runs inference
- Stitch Session → Auto Framing: applies framing
- Stitch Session → Stitch Pipeline: submits frames
crates/reco-core/src/session/mod.rs - Stitch Pipeline → GPU Context: uses device
crates/reco-core/src/render/pipeline.rs - Stitch Pipeline → Panorama Renderer: renders
crates/reco-core/src/render/pipeline.rs - Stitch Session → Pipeline Events: emits events
crates/reco-core/src/detect/pipeline_event.rs - Operator Controls → Desktop App: translates intent
crates/reco-gui/src/main.rs - Replay and Stacked Video → Video Encoding: writes video
- OBS Plugin → OBS Source Output: presents frames
crates/reco-obs/src/source.rs