Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/damianiglesias/omniform/llms.txt

Use this file to discover all available pages before exploring further.

Omniform supports seven output formats divided into two categories — video and audio. Video formats preserve the visual stream alongside audio, while audio formats extract only the audio track using yt-dlp’s -x flag and re-encode it via ffmpeg. Each category has its own quality dimension: resolution for video and bitrate (VBR level) for audio.

​
Output formats

The table below lists every format Omniform exposes in its UI and the internal details of each.
FormatKindExtensionDescription
mp4Video.mp4H.264 video + AAC audio, merged via ffmpeg
webmVideo.webmVP9/Opus open web format
mp3Audio.mp3Lossy, universal compatibility
wavAudio.wavUncompressed PCM, lossless, large files
flacAudio.flacLossless compression
m4aAudio.m4aAAC in MPEG-4 container
oggAudio.oggVorbis, open format, good for web and games

​
Video quality options

Video quality is expressed as a maximum resolution. Omniform translates each option into a yt-dlp format selector that prefers an MP4 container with an M4A audio stream, falling back to the best combined stream if no matching format is available.
ValueLabelyt-dlp format selector
bestBest availablebestvideo[ext=mp4]+bestaudio[ext=m4a]/best
1080p1080pbestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080]
720p720pbestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720]
480p480pbestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480]
The best selector does not cap resolution. Use it when you want the highest quality the source provides, regardless of file size.

​
Audio quality options

Audio quality maps to yt-dlp’s --audio-quality flag, which uses VBR level numbers where 0 is best and 10 is worst. Omniform exposes three presets covering the most practical range.
ValueLabelyt-dlp --audio-qualityApproximate bitrate
highHigh (320kbps)0 (VBR best)~320 kbps
mediumMedium (160kbps)2~160 kbps
lowLow (96kbps)5~96 kbps
The exact bitrate depends on the source material and codec. VBR quality level 0 targets the best achievable quality for the chosen format, not a fixed 320 kbps. Actual file size will vary accordingly.

​
Audio extraction flags

When any audio format is selected, Omniform passes the following yt-dlp flags to extract and re-encode the audio stream: 
yt-dlp -x --audio-format <format> --audio-quality <quality> <url>
For example, to extract a high-quality MP3: 
yt-dlp -x --audio-format mp3 --audio-quality 0 https://www.youtube.com/watch?v=dQw4w9WgXcQ
The -x flag instructs yt-dlp to discard the video stream after download. ffmpeg is then invoked automatically by yt-dlp to convert the raw audio into the requested format.

​
TypeScript type reference

The OutputFormat and Quality union types in src/types/index.ts are the single source of truth for valid values passed to the start_download command. 
type OutputFormat = "mp4" | "mp3" | "wav" | "flac" | "m4a" | "webm" | "ogg";

type Quality =
  | "best"
  | "1080p"
  | "720p"
  | "480p"
  | "audio-only"
  | "high"
  | "medium"
  | "low";
Passing a quality value from the video set (e.g. "1080p") alongside an audio format (e.g. "mp3") — or vice versa — will produce unexpected results. Always pair video formats with video quality values and audio formats with audio quality values.

Build docs developers (and LLMs) love

Get started for freeTalk to us