Skip to content
OpenSelenaPublic

About

Fast terminal media downloader and TUI for 1,800+ sites powered by yt-dlp and gallery-dl.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

Open Omni

Fast terminal media downloader and TUI for 1,800+ sites.
Download videos, music, and photo galleries from YouTube, Instagram, X, TikTok, and more.

npm version CI Node version License

Open Omni Interface


Contents


Why Open Omni

You want to download a video, an audio track, or a photo set without clicking through suspicious popups, fake download buttons, or ad-laden web converters. You also don't want to memorize dozens of complicated command-line flags.

Open Omni combines the flexibility of an interactive terminal interface with scriptable command-line speed. Paste a link from your clipboard with one key, preview available formats, and download directly to your machine.

Under the hood, Open Omni automatically provisions and manages yt-dlp, gallery-dl, and ffmpeg binaries so you never have to manually configure external dependencies.


Key features

  • Press o on completion to highlight the downloaded file in your file manager (Explorer, Finder, or Linux file managers).
  • Route downloads through HTTP, HTTPS, or SOCKS5 proxies with --proxy, or pass country codes with --geo-bypass and --geo-country. Passwords in proxy URLs are masked in logs.
  • Throttle download speeds with --limit-rate (for example, 1.5M or 500K).
  • Skip sponsored segments and channel intros during download with --sponsorblock and --sponsorblock-remove.
  • Automatically routes video extractors to yt-dlp and multi-photo social carousels to gallery-dl.
  • Skips already-downloaded files using --skip-existing by checking the local history ledger against disk.
  • Interactive terminal interface with clipboard paste (Tab), format selection, and progress bars.

How It Compares

Open Omni yt-dlp Web converters
Interface Keyboard-driven terminal TUI Command-line flags Browser UI with ads
Engines Auto-provisions yt-dlp, gallery-dl, ffmpeg Manual binary or Python setup Hosted / unknown backends
Media Video, audio, photos & carousels Video & audio Inconsistent / compressed
Selection Interactive checklist (Space / A keys) Index ranges (--playlist-items) Single URL at a time
Workflow Tab clipboard paste → pick format → Enter Build flags manually Paste → wait → download
Local-first 100% local, zero telemetry 100% local, open-source Remote servers & ad trackers

Installation

One-liner (macOS & Linux)

curl -fsSL https://mint.dev.cv | sh

Via Homebrew (macOS & Linux)

brew install OpenSelena/tap/open-omni

Via Winget (Windows)

winget install OpenSelena.OpenOmni

Via npm (Global)

npm install -g open-omni

Run Directly via npx

npx open-omni [url]

Once installed, Open Omni is accessible via any of these commands:

  • open-omni (canonical)
  • openomni (hyphen-free)
  • omni (concise)
  • oo (ultra-fast alias)

Requirements: Node 20+ (when using npm or Homebrew; standalone Windows package bundles its own runtime). Extraction engines (yt-dlp, gallery-dl, and ffmpeg) are downloaded automatically to ~/.open-omni/bin on demand.


Quick Start

Launch interactive mode:

open-omni

Or pass a URL directly to inspect available media formats:

open-omni https://youtu.be/dQw4w9WgXcQ

Direct scriptable downloads:

# Download highest resolution video directly
open-omni <url> --best

# Watch clipboard and auto-download copied links
open-omni --watch
open-omni -w --best

# Extract audio to MP3 or lossless FLAC in a specific directory
open-omni <url> --mp3 -o ~/Music
open-omni <url> --audio-format flac -o ~/Music

# Download video in specific container format (mp4, mkv, webm)
open-omni <url> --video-format mkv

# Download specific time range or clip section
open-omni <url> --time 01:00-02:30

# Skip items already downloaded and recorded in download ledger
open-omni <url> --skip-existing

# Download with embedded subtitles
open-omni <url> --embed-subs --subs=en,es

# Embed metadata tags and chapter markers into media container
open-omni <url> --metadata --embed-chapters

# Download thumbnail artwork and embed into file
open-omni <url> --thumb --embed-thumb

# Download only photos from an Instagram or X gallery
open-omni <url> --photos-only

# Zero-config: extract cookies automatically from local browser session
open-omni <url> --cookies-from-browser auto

# Target a specific browser or profile explicitly
open-omni <url> --cookies-from-browser firefox

# Download using an exported Netscape cookie file
open-omni <url> --cookies ~/cookies.txt

# Route downloads through HTTP/HTTPS/SOCKS proxy
open-omni <url> --proxy http://127.0.0.1:8080

# Bypass geographic restriction with synthetic header or country code
open-omni <url> --geo-bypass
open-omni <url> --geo-country US

# Throttle bandwidth consumption
open-omni <url> --limit-rate 1.5M

# Remove sponsored segments using SponsorBlock
open-omni <url> --sponsorblock
open-omni <url> --sponsorblock-remove sponsor,intro

# Custom filename template
open-omni <url> --output-template "%(uploader)s - %(title)s.%(ext)s"

# Parallel batch downloads (e.g. 4 concurrent downloads)
open-omni <url> --concurrency 4

# Update bundled extraction engines (yt-dlp and gallery-dl)
open-omni -U

Interactive Interface

Format and quality picker

  • URL Input: Paste URLs directly or press Tab to insert the current clipboard contents.
  • Format Picker: Select from highest quality video, optimized 1080p/720p tiers, or audio-only extraction.
  • Playlists & Carousels: Toggle individual tracks with Space or select all with A.
  • Themes: Switch between dark, light, and auto terminal palette integration.
  • Reveal in Folder: Press O on completion screen to reveal downloaded media in your native file manager.

CLI Reference

Flag Description
[url] Video, playlist, or gallery URL
--best Download highest available video quality directly
--mp3 Extract audio track as MP3 directly
--audio-format <fmt> Audio extraction format (best, aac, flac, mp3, m4a, opus, vorbis, wav, alac)
--video-format <fmt> Video container format (mp4, mkv, webm)
--metadata Embed metadata (artist, title, date, etc.) into media container
--add-metadata Alias for --metadata
--embed-chapters Embed chapter markers into media container
--subs [langs] Download subtitles (e.g. --subs=en,es)
--embed-subs Mux subtitles into the video container
--thumb Save video thumbnail image
--embed-thumb Embed thumbnail artwork into media container
--photos-only Download only images from social post or carousel
--videos-only Download only videos from social post or carousel
--skip-existing Skip download if recorded in ledger and present on disk
--time <range> Download specific time range (e.g. 01:00-02:30 or 60-150)
--section <range> Alias for --time
--cookies <path> Load session cookies from a Netscape format file
--cookies-from-browser <spec> Extract cookies from browser (auto, firefox, chrome, zen, etc.)
--proxy <url> Route requests via HTTP/HTTPS/SOCKS proxy (e.g. socks5://...)
--geo-bypass Bypass geographic restriction via synthetic X-Forwarded-For header
--geo-country <code> Bypass geographic restriction with 2-letter country code (e.g. US, DE)
--limit-rate <rate> Limit download bandwidth (e.g. 50K, 1.5M, 2G)
--sponsorblock Remove sponsored segments using SponsorBlock
--sponsorblock-remove <cats> SponsorBlock categories to remove (default: all)
--output-template <pattern> Custom filename template (e.g. %(uploader)s/%(title)s.%(ext)s or {title}.{ext})
-c, --concurrency <N> Maximum parallel download workers for batch queue
-o, --output <dir> Destination folder (default: Downloads or $OPEN_OMNI_DIR)
-U, --update Update bundled yt-dlp and gallery-dl binaries
--update-ytdlp Update only bundled yt-dlp binary
--update-gallerydl Update only bundled gallery-dl binary
--force Force overwrite existing downloads or re-fetch binaries
--theme <mode> Color theme: auto, light, or dark
--completion <shell> Generate completions (bash, zsh, fish, powershell)
-h, --help Show help screen
-v, --version Show version number

Configuration

Settings can be customized in ~/.config/open-omni/config.json:

{
  "outputDir": "~/Downloads",
  "theme": "auto",
  "format": "best",
  "audioFormat": "mp3",
  "videoFormat": "mp4",
  "proxy": "http://127.0.0.1:8080",
  "geoBypass": true,
  "geoCountry": "US",
  "limitRate": "1.5M",
  "sponsorblock": true,
  "sponsorblockRemove": "all",
  "metadata": {
    "enabled": true,
    "embedChapters": true
  },
  "cookiesFromBrowser": "firefox",
  "subtitles": {
    "enabled": true,
    "languages": "en,es",
    "embed": false
  },
  "thumbnail": {
    "enabled": true,
    "embed": true
  }
}

Precedence: Command-line flags > Environment variables (ALL_PROXY, OPEN_OMNI_DIR) > config.json > OS default Downloads.


Shell Autocompletion

Add autocomplete support to your shell profile:

# Bash (~/.bashrc)
eval "$(open-omni --completion bash)"

# Zsh (~/.zshrc)
eval "$(open-omni --completion zsh)"

# Fish (~/.config/fish/config.fish)
open-omni --completion fish | source

# PowerShell ($PROFILE)
if (Get-Command open-omni -ErrorAction SilentlyContinue) {
    open-omni --completion powershell | Out-String | Invoke-Expression
}

Privacy & Local First

Open Omni runs entirely on your local machine:

  • No Remote Telemetry: No tracking, metrics, analytics, or third-party servers.
  • Direct Fetch: Network connections are established exclusively between your computer and the target media platform.
  • Local Storage: All media, metadata, and engine binaries remain under your local user directory.

Fair Use Notice

Open Omni is an open-source educational utility intended for personal archiving, local offline study, and fair-use research.

Copyright and Tool Purpose

The software functions as an automated terminal interface to established media extraction backends (yt-dlp and gallery-dl). Analogous to a standard web browser or media player, Open Omni retrieves publicly available media streams strictly at the direct instruction of the user. Open Omni does not operate remote media servers, store or index content, bypass digital rights management (DRM) encryption, or circumvent technical access controls or digital paywalls.

Fair Use Principles

Applicable copyright laws (such as Section 107 of the U.S. Copyright Act and comparable fair-dealing statutes internationally) permit the use of copyrighted works without express authorization under specific circumstances, including:

  • Non-commercial personal archiving and format shifting for offline viewing
  • Criticism, commentary, parody, and transformative research
  • News reporting, classroom teaching, scholarship, and academic analysis

Whether a specific download or utilization qualifies as fair use depends on jurisdictional statutory factors, including the purpose and character of the use, the nature of the copyrighted work, the amount and substantiality of the portion used, and the effect upon the potential market or value of the work.

User Responsibility & Disclaimers

  • No Grant of Ownership or Rights: Open Omni is an open-source tool and does not grant users copyright ownership, licenses, or authorization to reproduce, distribute, publicly display, or monetize protected content unlawfully.
  • User Responsibility: Users are solely responsible for ensuring that their capture and subsequent use of any media complies with applicable local copyright laws, intellectual property rights, and third-party terms of service.
  • Not Legal Advice: This notice is provided for informational and educational purposes only and does not constitute formal legal counsel.

License & Inquiries

Open Omni is released under the MIT License.

Contact & Inquiries

For copyright concerns, legal inquiries, bug reports, security reports, or general questions regarding this project, please reach out directly:

About

Fast terminal media downloader and TUI for 1,800+ sites powered by yt-dlp and gallery-dl.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages