Vega

English | Français

Universal CLI utility to download videos (YouTube, TikTok, Instagram, etc.) via yt-dlp, with a modern interface powered by rich.

Requirements

• Python 3.9+
• FFmpeg installed and available in your PATH (needed to merge audio/video and for conversions)

Installation

The simplest way to get the vega command available everywhere on your system, without worrying about virtual environments, is pipx:

# Install pipx once, if you don't have it yet
python -m pip install --user pipx
python -m pipx ensurepath

# Install Vega
pipx install vega-dlp

Restart your terminal, then run vega --help to confirm it's installed.

pip install vega-dlp

git clone https://github.com/Poutoo/Vega.git
cd Vega

python -m venv venv
venv\Scripts\Activate.ps1   # PowerShell
# or: venv\Scripts\activate.bat   # CMD

pip install -e .

Usage

vega <url> [options]

Prefer a browser over the terminal? Vega also ships a local web UI — see Web UI below.

Commands and options

Examples

# Simple download (best quality, video + audio)
vega https://www.youtube.com/watch?v=XXXXXXXXXXX

# Audio only download (MP3)
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -a

# Video only, no sound
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -vo

# Limit resolution to 720p
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -q 720

# Combine options: video only, capped at 1080p
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -vo -q 1080

# Download only the 0:00-3:00 clip
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -s 0:00 -e 3:00

# Audio-only clip, from 1:23:45 to the end of the video
vega https://www.youtube.com/watch?v=XXXXXXXXXXX -a -s 1:23:45

# Show help
vega --help

Note: clipping uses --force-keyframes-at-cuts internally for a frame-accurate cut, which requires a light local re-encode (via FFmpeg) and therefore takes a bit longer than a regular download.

Web UI

For anyone not comfortable with a terminal, Vega also ships a local web interface with the same download options and a live progress view. It's an optional extra, kept out of the default install to keep the base CLI lightweight.

# pipx
pipx install "vega-dlp[web]"

# or plain pip
pip install "vega-dlp[web]"

vega web

This starts a server bound to 127.0.0.1 only (never exposed to your network) and opens it in your default browser. Options:

How it works

• Videos are automatically sorted into the user's Downloads/<Platform> folder (e.g. Downloads/Youtube/).
• Every download is logged to history.json (title, URL, platform, path, date). This file stays local and is not versioned.
• A system notification is shown when the download finishes (success or error).

License

Distributed under the MIT license.