SK-404

Doc no. SK-404DatasheetRev 2026.11Sheet 2.8 of 4

A2

Better VERT

Local-first file converter: 250+ formats through FFmpeg and ImageMagick, plus anything-to-Markdown, in one Docker container with a web UI and a CLI.

Active

01

Block diagram

Web UI · CLIbrowser · vert · .sh FastAPI:8394 → :8000 output/lands on your disk media_engineFFmpeg · ImageMagick markitdownMarkItDown · OCR
Fig. 1: One container, two engines
02

Characteristics

Run./install.sh builds and starts it; then open http://localhost:8394 or use the vert CLI
Converts250+ formats across video, audio, image, document and data, plus cross-medium routes like video to PDF storyboard
Markdown & OCRIntegrates Microsoft MarkItDown with Tesseract OCR, Poppler PDF rendering and a live preview pane
Limits & bindingDefaults to a 2 GB per-file limit (MAX_UPLOAD_MB); binds to 127.0.0.1 only so nothing leaves localhost
Hardware accelUses NEON/AVX multi-core threads plus an optional host GPU bridge (VideoToolbox, NVENC, Quick Sync, VAAPI)
  • Docker
  • FFmpeg
  • ImageMagick
  • MarkItDown
03

Overview & build notes

Merges the broad format coverage of VERT with local Microsoft MarkItDown document parsing inside a single self-hosted Docker Compose stack (8394:8000). Everything stays on your machine with no external vertd cloud offload.

Two FastAPI-driven engines share one queue: media_engine.py wraps multi-threaded FFmpeg and ImageMagick across video, audio and image transcoding, while markitdown_engine.py handles PDF/Office/HTML conversion, OCR, PDF merge/split and batch folders.

Both the browser UI and the companion vert / ./convert.sh command-line tools write outputs straight to your local disk and expose an optional host bridge script for native GPU encoding.

04

Files & artifacts

KindFileDetailsSize
Sourcebackend/media_engine.pyMulti-threaded FFmpeg and ImageMagick format converter on GitHubGitHub
Sourcebackend/markitdown_engine.pyDocument-to-Markdown, Tesseract OCR and Poppler handler on GitHubGitHub
Composedocker-compose.ymlSingle-container stack definition bound to localhost:8394GitHub
Setupinstall.shPrerequisite checker, container builder and CLI installerGitHub