Skip to content

vfo Documentation

vfo is an autonomous media optimization engine centered on three layers:

  • mezzanine (high-quality working inputs)
  • source (normalized intermediate, optional)
  • profile (delivery target)

The design goal is outcome ownership:

  • detect input characteristics
  • decide via profile/scenario rules
  • execute deterministic profile actions
  • verify results with observability and optional quality scoring

This site is built to answer three practical questions quickly:

  • Which stock profile should I use?
  • What exactly will a profile do to my media?
  • How does vfo flow from input to output?

Start Here

  1. Read Pipeline for end-to-end behavior.
  2. Read Flow Levels for interactive executive/operator/engine React Flow visuals.
  3. Read Profile Pack Strategy to understand how fixed pack names, subtitle policies, audio policies, and quality modes fit together.
  4. Read Subtitle Policy to understand smart_eng_sub, all_sub_preserve, and subtitle_convert.
  5. Read Quality Modes to understand standard and the shipped bounded aggressive_vmaf mode.
  6. Check Capability Matrix to see what each stock profile targets.
  7. Open Profile Info Sheets for deep behavior details per profile.
  8. Review Latest E2E Toolchain Report for the dependency versions used in recent CI verification.
  9. Read Observability Contract for the event model that feeds the browser app, logs, metrics, and traces.
  10. Read Deployment Modes to choose between local native, desktop-managed, and container lanes.
  11. Open Demo Pack Replay for the shareable browser view of the desktop wireframe.
  12. Read Profile Pack YAML Examples for the declarative draft shape.

Install and Verify

vfo --version
vfo doctor
vfo status
vfo visualize

Notes

  • Profile pages are generated from live stock presets and action scripts.
  • If profile behavior changes in code, docs are regenerated from source to reduce drift.