# BrokenSource/DepthFlow

🌊 Images to 3D parallax videos

Repository: https://github.com/BrokenSource/DepthFlow
Canonical: https://ross.abutalabs.com/products/depthflow
Homepage: https://depth.tremeschin.com/
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: depth-prediction, image-to-video, monocular-depth, monocular-depth-estimation, parallax, image-parallax, parallax-effect, depth-map, depthy, depth-maps, shadertoy, immersity, immersityai, depthflow, shaderflow, computer-vision
Last push: 2026-08-25T10:30:58+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 67, longevity 83
- inputs: {"age_days": 1166, "days_push": 8, "days_rel": 8, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1512, forks 121 (observed 2026-08-28T04:04:55.998031+00:00)

## What it is
DepthFlow is a free, open-source Python application and library that converts still images into 3D parallax effect videos using monocular depth estimation models and an optimized ray-marching GLSL shader. It renders high-quality, seamless-loop videos at any resolution via FFmpeg, with both a CLI and a Python API.

## Use cases
- turn photos into 3D parallax videos
- animate still images with depth effect
- generate looping parallax animations for social media
- estimate depth maps from single images
- create 2.5D motion from digital art
- batch render image-to-video animations locally

## When to choose
- you want free, local, watermark-free image-to-video parallax rendering
- you need high-resolution (up to 8K) GPU-accelerated output with seamless loops
- you want programmatic control over camera and animation via a Python API
- you want to use SOTA depth estimation models like Depth Anything v2

## When to avoid
- you need a polished GUI or web interface (the Gradio WebUI was removed in v1.0)
- you want commercial use of non-Small Depth Anything models (CC BY-NC license restrictions)
- you need batch processing built in (removed in v1.0; use scripts instead)
- you lack a GPU or FFmpeg for rendering and encoding

## Facets
- artifact type: application
- maturity: active
- function: image-processing, video-processing, computer-vision, machine-learning, graphics, cli
- domain: computer-vision, image-processing, graphics, artificial-intelligence
- platform: python, cross-platform, cli
- tags: parallax-effect, depth-estimation, depth-map, image-to-video, ray-marching, glsl-shader, ffmpeg, depth-anything, monocular-depth, video, gpu

## Member repositories
- BrokenSource/DepthFlow (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:55.998031+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:32:18.053979+00:00, confidence not recorded.
  - readme: https://github.com/BrokenSource/DepthFlow (fetched 2026-08-28T04:04:55.998031+00:00, sha 49520ec92c55)
  - homepage: https://depth.tremeschin.com/ (fetched 2026-08-29T11:36:17.275353+00:00, sha 9c265420ab9b)
  - site_page: https://depth.tremeschin.com/docs (fetched 2026-08-29T11:36:17.284524+00:00, sha 08189c8ed31b)
  - site_page: https://depth.tremeschin.com/docs/inputs (fetched 2026-08-29T11:36:17.288805+00:00, sha f600dcf11bf2)
  - site_page: https://depth.tremeschin.com/docs/estimators (fetched 2026-08-29T11:36:17.290686+00:00, sha f37da36ac33e)
  - site_page: https://depth.tremeschin.com/docs/camera (fetched 2026-08-29T11:36:17.292689+00:00, sha 526e41d2e120)
  - site_page: https://depth.tremeschin.com/docs/animation (fetched 2026-08-29T11:36:17.294607+00:00, sha ae057b389010)
  - site_page: https://depth.tremeschin.com/docs/exporting (fetched 2026-08-29T11:36:17.296243+00:00, sha 30260a64230f)
  - registry_pypi: https://pypi.org/pypi/depthflow/json (fetched 2026-08-29T11:36:17.298329+00:00, sha 377b030a2fa4)
  - site_page: https://depth.tremeschin.com/changelog (fetched 2026-08-29T11:36:17.286372+00:00, sha 789e9d1c5013)
- Data as of 2026-08-30T08:39:29.467469+00:00.