Omniform gives you a straightforward path from URL to finished file: paste a link, choose a format and quality, and click Add to queue. From there the app handles everything — fetching metadata, running the download, and converting the file — while keeping you updated with live progress. This page walks through every step of that workflow.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.
Supported platforms
Omniform uses yt-dlp under the hood to handle the actual downloading and media extraction. yt-dlp has broad platform support out of the box, including:- YouTube — videos, shorts, playlists, and live recordings
- TikTok — individual clips and user feeds
- Instagram — reels, posts, and stories
Any site supported by yt-dlp will work in Omniform. The full list of supported
sites is maintained in the yt-dlp repository.
If yt-dlp can download it from the command line, Omniform can download it too.
Pasting a URL
At the top of the Omniform window is a text input field with the placeholder “Paste a YouTube, TikTok, Instagram link…”. You can type or paste any valid HTTP or HTTPS URL directly into this field. The Add to queue button remains disabled as long as the URL field is empty; any non-empty string is accepted as input. The entire form — including the URL field, format chips, quality selector, and submit button — is also disabled while Omniform is still setting up its dependencies (yt-dlp and ffmpeg) or while no output folder has been selected yet.Automatic clipboard detection
Omniform watches your clipboard so you never have to manually paste. The detection works as follows:- When the app first opens, it immediately reads the clipboard.
- Each time the Omniform window regains focus, it reads the clipboard again.
- If the clipboard contains a valid HTTP or HTTPS URL and the URL field is currently empty, Omniform fills it in automatically and shows a “pasted from clipboard” badge next to the input.
Adding to the queue
Once the URL field is populated, select your desired output format and quality (see the Formats & Quality guide for a full breakdown), then click Add to queue.Choose a format
Select one of the seven available formats from the format chip buttons below the URL field. The format determines whether quality options show video resolutions or audio bitrates.
Choose quality
Pick a quality from the dropdown that appears to the right of the format selector. Video formats offer resolution caps; audio formats offer bitrate tiers.
What happens next
After you add a download, Omniform moves it through a series of statuses automatically. You can watch this progression live in the queue panel.Queued
The item has been added to the queue. Omniform is about to begin processing it.
Fetching info
Omniform runs yt-dlp with
--dump-json to retrieve the video’s title and thumbnail from the platform before the download begins. The queue item updates with the real title and thumbnail image as soon as this completes.Downloading
The actual file transfer is in progress. The queue item shows a live progress bar, download speed (e.g.
3.2 MiB/s), and ETA countdown.Converting
yt-dlp has finished downloading and ffmpeg is post-processing the file — merging separate video and audio streams for MP4, or extracting and re-encoding audio for formats like MP3 or FLAC. No user action is needed.