Skip to content
Medix

Quick Start

This walks through a typical first run. Swap the paths for your own.

1. Install

Section titled “1. Install”
Terminal window
pip install medix

2. Point Medix at a file

Section titled “2. Point Medix at a file”
Terminal window
medix /path/to/video.vob

Or a whole directory:

Terminal window
medix /path/to/videos/

3. Let Medix check FFmpeg

Section titled “3. Let Medix check FFmpeg”

If FFmpeg is missing, Medix will offer to install it for you. Accept, and it runs the right brew / apt / winget command under the hood.

4. Pick an output format

Section titled “4. Pick an output format”

Medix lists discovered files, then asks which output format you want:

? Choose output format
  MP4 (H.264 + AAC — universal playback)
  MKV (H.264 + AAC — flexible container)
  WebM (VP9 + Opus — web streaming)
  MOV (H.264 + AAC — Apple ecosystem)
  AVI (H.264 + MP3 — legacy)
  TS (H.264 + AAC — broadcast)

5. (Optional) Tweak encoding

Section titled “5. (Optional) Tweak encoding”

Say yes to advanced settings if you want to override the defaults — video codec, resolution, frame rate, CRF, preset, audio bitrate.

6. Confirm and watch it run

Section titled “6. Confirm and watch it run”

Medix shows the conversion plan, you confirm, and the progress bars take over.

Common invocations

Section titled “Common invocations”
Terminal window
# Single file
medix video.mp4


# Directory
medix ~/Videos/


# Recurse into subdirectories
medix ~/Videos/ -r


# Custom output directory
medix ~/Videos/ -o ~/Converted/


# Preview without converting
medix ~/Videos/ --dry-run


# Recurse + dry run + custom output
medix ~/Videos/ -r -o ~/Converted/ --dry-run

Next steps

Section titled “Next steps”