How jens-duttke/video-stereo-converter works
This is a command-line 2D-to-stereoscopic-video converter. A user initializes a workflow for a video, then extracts frames, estimates depth, generates side-by-side images, encodes chunks, and concatenates them with audio. The orchestrator coordinates batch workflows, parallelizes eligible steps, tracks resumable state, and manages disk space. The README documents the pipeline and its capabilities; sampled source and the source index support the internal links shown. Several processing modules were not sampled, so their internal behavior is not inferred.
Main entry points: workflow_orchestrator.py Batch orchestrator · config_manager.py Workflow config · depth_map_generator.py Depth estimation · sbs_generator.py SBS generation
Components 17
Workflow control
- Workflow initializer
workflow_init.py - Workflow config
helper/config_manager.py - Batch orchestrator
workflow_orchestrator.py - Workflow state
helper/workflow_state.py - Progress metrics
helper/workflow_metrics.py
Video processing
- Frame extraction
frame_extractor.py - Depth estimation
depth_map_generator.py - SBS generation
sbs_generator.py - Chunk encoding
chunk_generator.py - Video concatenation
video_concatenator.py
Stereo tools
- SBS settings tester
sbs_tester.py - Stereo core
helper/stereo_core.py
Shared support
- FFmpeg helpers
helper/ffmpeg_utils.py - Frame and console utilities
helper
Other components
- Video operator
- Input video
- Stereo video
Connections 30
- Video operator → Workflow initializer: initializes
README.md - Input video → Workflow initializer: selects video
README.md - Workflow initializer → Workflow config: creates settings
workflow_init.py - Video operator → Batch orchestrator: starts batch
README.md - Batch orchestrator → Workflow state: persists status
workflow_orchestrator.py - Batch orchestrator → Progress metrics: checks progress
workflow_orchestrator.py - Batch orchestrator → Frame extraction: dispatches
README.md - Batch orchestrator → Depth estimation: dispatches
README.md - Batch orchestrator → SBS generation: dispatches
README.md - Batch orchestrator → Chunk encoding: dispatches
README.md - Batch orchestrator → Video concatenation: dispatches
README.md - Input video → Frame extraction: provides frames
README.md - Frame extraction → Depth estimation: supplies frames
README.md - Depth estimation → SBS generation: supplies depth maps
README.md - SBS generation → Chunk encoding: supplies images
README.md - Chunk encoding → Video concatenation: supplies segments
README.md - Video concatenation → Stereo video: produces video
README.md - SBS generation → Stereo core: uses stereo processing
sbs_generator.py - SBS settings tester → Stereo core: previews stereo
sbs_tester.py - SBS settings tester → Workflow config: loads and saves settings
sbs_tester.py - Frame extraction → Workflow config: loads workflow settings
frame_extractor.py - Depth estimation → Workflow config: loads workflow settings
depth_map_generator.py - Chunk encoding → Workflow config: loads workflow settings
chunk_generator.py - Video concatenation → Workflow config: loads workflow settings
video_concatenator.py - Video concatenation → FFmpeg helpers: uses metadata helpers
video_concatenator.py - Chunk encoding → FFmpeg helpers: uses metadata helpers
chunk_generator.py - Progress metrics → Workflow config: resolves workflow paths
helper/workflow_metrics.py - Workflow state → Progress metrics: checks chunk completion
helper/workflow_state.py - Depth estimation → Frame and console utilities: uses frame helpers
depth_map_generator.py - SBS generation → Frame and console utilities: uses frame helpers
sbs_generator.py