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 split between video and audio. Choosing the right format and quality depends on how you plan to use the file — whether that is sharing a clip, archiving a recording, playing music offline, or embedding media on a website. This page describes every available option and the yt-dlp arguments Omniform uses to achieve each one.
ffmpeg must be present for format conversion to work. On first launch Omniform automatically downloads and sets up both yt-dlp and ffmpeg. If you see a dependency banner at the top of the app, wait for setup to complete (or click Retry if it stalled) before adding downloads.

Video formats

Select a video format — MP4 or WebM — to download a file that contains both a video track and an audio track. The Quality dropdown switches to resolution-based options when any video format is active.
MP4 is the most universally compatible container format. Omniform instructs yt-dlp to fetch the best available MP4 video stream ([ext=mp4]) and an M4A audio stream ([ext=m4a]), then merges them with ffmpeg into a single .mp4 file using --merge-output-format mp4.MP4 is the right choice for most users — it plays on every major operating system, media player, phone, and smart TV without additional codecs.

Video quality options

Quality labelResolution capyt-dlp format selector
Best availableNone — highest resolution the platform offersbestvideo[ext=mp4]+bestaudio[ext=m4a]/best
1080pHeight ≤ 1080 pxbestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080]
720pHeight ≤ 720 pxbestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720]
480pHeight ≤ 480 pxbestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480]
For all video quality levels, the -f flag passes the format selector to yt-dlp, and --merge-output-format ensures the final container is the format you chose (e.g. mp4).

Audio formats

Select an audio format to extract only the audio track from the source video. Omniform passes the -x (extract audio) and --audio-format flags to yt-dlp, which handles the extraction and re-encoding via ffmpeg. The Quality dropdown switches to bitrate-based options when any audio format is active.
MP3 (MPEG Audio Layer III) is the most universally compatible audio format. It is supported by every device, media player, and streaming platform. MP3 is the best default choice for music, podcasts, and general audio use.

Audio quality options

Audio quality maps to yt-dlp’s VBR (variable bitrate) quality scale via --audio-quality:
Quality labelyt-dlp quality valueApproximate bitrate
High (320kbps)0 (best)~320 kbps
Medium (160kbps)2~160 kbps
Low (96kbps)5~96 kbps
Lower quality values on the VBR scale mean higher quality audio. A value of 0 instructs the encoder to use the best quality it can achieve, which typically results in a bitrate around 320 kbps for MP3.

Choosing the right combination

Use caseRecommended formatRecommended quality
Music library (lossless archive)FLACHigh
Music library (space-efficient)MP3High (320kbps)
Podcast or spoken audioMP3Medium (160kbps)
Raw audio for editing/DAWWAVHigh
Apple devices / iTunesM4AHigh
Web or game audioOGGMedium (160kbps)
Video — general sharingMP4Best available
Video — smaller file sizeMP4720p
Video — web embeddingWebMBest available
Video — archivingMP4Best available

Build docs developers (and LLMs) love