v1.0 — Universal CLI Video Downloader

mz any URL.
1000+ sites. One command.

Download from YouTube, Instagram, TikTok, Twitter, Facebook, and 1000+ sites. Rich quality menu, live progress bar, ffmpeg merging — all from your terminal.

--high --fast --mute --clip -o DIR
View on GitHub See Commands
mz — download session
user@box:~$ mz https://youtube.com/watch?v=dQw4w9WgXcQ
 
[MAZE] Fetching video metadata...
[TITLE] Rick Astley — Never Gonna Give You Up
[SRC] YouTube · 3:32 · 1080p available
 
Select quality:
1] 360p 2] 480p 3] 720p
4] 1080p 5] Best 6] Audio
 
> 4
 
[D/L] Downloading 1080p...
[PRG] ████████████░░░░ 72% · 3.2 MB/s · ETA 12s
 
[✓] Saved to D:\downloads\Rick Astley - Never Gonna Give You Up.mp4
 
user@box:~$
1000+
Supported Sites
Python
Language
yt-dlp
Engine
Free
Open Source
What is Maze?

Download anything. Anywhere.

One CLI command to download videos from any site. No GUI, no bloat, no nonsense.

1000+ Sites

YouTube, Instagram, TikTok, Twitter, Facebook, Twitch, Vimeo, and 1000+ more via yt-dlp.

Rich Quality Menu

Interactive picker with available resolutions. Or skip it with --high / --fast.

Live Progress Bar

Real-time speed, ETA, and percentage via Rich-powered terminal UI.

Usage

mz <url> [flags]

Flags can be in any order. Mix and match as needed.

CommandWhat it does
mz <url>Fetch video, show interactive quality menu
mz <url> --highAuto-download best available quality
mz <url> --fastAuto-download 480p (or closest)
mz <url> --muteVideo only, no audio track
mz --clipRead URL from clipboard
mz <url> -o "C:\path"Save to custom output directory
Flags: --high --fast --mute --clip -o DIR combine any flags
Quality Options
144p 240p 360p 480p 720p 1080p 2K 4K 8K Best Audio Only
Why Maze?

Built for downloaders.

For people who want to download videos without navigating ad-infested web tools or remembering 50 yt-dlp flags.

One Syntax

mz <url> is all you need. No complex flag memorization.

Interactive Menu

See all available resolutions. Pick with a single keypress. Cancel anytime with q.

Skip the Menu

--high for best quality, --fast for 480p. One flag and you're done.

Clipboard Ready

mz --clip reads URL from clipboard. Perfect for mobile sharing.

Mute Mode

--mute downloads video-only streams. No audio track.

Auto-Merge

If ffmpeg is installed, video+audio are merged to AAC. Falls back gracefully otherwise.

Edge Cases

Battle-tested downloads.

Maze handles the gotchas so you don't have to.

ScenarioBehavior
Invalid URLClear error message, exits cleanly
Private/deleted video"No formats found" error
No ffmpeg installedFalls back to single-file combined formats
Opus audio codecAuto-converts to AAC for Windows Media Player
AV1 video 416 errorSkips AV1 codec, picks next best format
Empty clipboard"Clipboard is empty" error message
Ctrl+C during downloadClean exit, no partial file crash
Unknown durationShows --:-- in progress bar
Install

One line. Global install.

Python 3.8+ required. Works on Windows, macOS, and Linux.

pip — all platforms
pip install git+https://github.com/subhradeepsarkae-ai/maze.git
Windows — PowerShell
powershell -c "iwr -useb https://raw.githubusercontent.com/subhradeepsarkae-ai/maze/main/install.ps1 | iex"
Manual — any platform
git clone https://github.com/subhradeepsarkae-ai/maze.git && cd maze && pip install .
Source Code Windows Setup Linux Setup