UMD
+ GET UMD
Python 3.10+Apache 2.0Free Forever

Ultimate
Mediav3.0.1
Downloader

Ultimate
Mediav3.0.1
Downloader

Media Downloading

A professional-grade, open-source media downloading tool supporting 115+ platforms. Built with Python, it features a beautiful Rich CLI interface and enterprise-level capabilities with consumer-friendly simplicity. Download from YouTube, Spotify, Amazon Music, and more with just one command.

Parallel Downloads
High Quality
Playlist Support
Resume Support
Windows 10/11
macOS (M1/Intel)
Linux & distros
Docker / CLI
++
++
[ EXEC_MODE: ON ]
[ INTERACTIVE CLI EXPERIENCE ]

Command Line

[ VIDEO ][ AUDIO ][ SOCIAL ]

115+ PLATFORMS. LOSSLESS EXTRACTION. ZERO CONFIGURATION.

Finder
File
Edit
View
Go
Window
Help
10:00 AM
nitishkumar — bash — 80x24
Ultimate Downloader
Favorites
Downloads
Documents
Desktop
Downloads > UltimateDownloader
Archive
Music
Jo Tum Mere Ho
Anuv Jain
[ CORE FEATURES ]

Download Anything.
Keep it useful.

Write it, speak it, paste it — UMD handles the rest, quietly and without fuss.

Download from anywhere

YouTube, Spotify, Instagram, TikTok, SoundCloud, Twitter/X, Vimeo, Reddit, and 50+ more. Paste any URL and UMD figures out the rest.

Audio extraction

Extract lossless audio in MP3, FLAC, M4A, OPUS, WAV. Automatic format detection and conversion powered by ffmpeg.

Interactive & headless modes

Run interactively with guided prompts, or fully headless for scripts and automation. Both modes support the same full feature set.

Batch & playlist downloads

Download entire playlists, channels, or albums in one command. Smart duplicate detection skips files you already have.

Quality control

Choose your preferred quality or let UMD pick the best available. Supports 4K, 1080p, lossless audio, and everything in between.

4K wallpapers built in

Browse and download curated 4K wallpapers directly from the CLI. A hidden feature that actually gets used.

Totoro using a Mac

Works on any Mac

MacBook with a notch? Hover to open. Also works on older Mac models. Same app, same features, every Mac running macOS 10 Sequoia or later.

MacBook ProMacBook AirMacMac MiniMac Studio
[ SUPPORTED PLATFORMS ]

Built for what
you use

UMD uses yt-dlp under the hood — supporting virtually every major video and audio platform.

Spotify
Apple Music
TikTok
Instagram
Tumblr
LinkedIn
Reddit
Pinterest
Amazon Music
Twitch
Rumble
Vimeo
Dailymotion
Kick
TED
Flickr
PeerTube
Audiomack
Apple Podcasts
YouTube
Developers

Developers

Save API keys, terminal output, code snippets, and reference docs without switching context.

Music lovers

Music lovers

Collect tracks, albums, and playlists in lossless FLAC. Metadata preserved. Library stays organized.

Content creators

Content creators

Download reference footage, pull stock video, grab audio stems — all without leaving your terminal.

Everyone

Everyone

If you've ever wanted to keep a video or song locally, UMD does it cleanly and without bloat.

++
++
[ INSTALLATION ]

Up and running in seconds.

UMD requires Python 3.9+ and ffmpeg for audio conversion.

root@umd-installer:~
$# Easiest: Download .pkg from Releases
$# Or install via terminal:
$
$git clone https://codeberg.org/nk2552003/umd.git
$cd umd
$./scripts/install.sh
$
$umd --version
$

Quick Commands

umd
Interactive mode (easiest for beginners)
umd "https://youtube.com/watch?v=VIDEO_ID"
Download a video
umd "URL" --audio-only --format mp3
Download audio only as MP3
umd "URL" --quality 1080p
Download in specific quality
umd "https://youtube.com/playlist?list=PLAYLIST_ID"
Download entire playlist
umd "URL" --audio-only --embed-metadata --embed-thumbnail
Download with metadata and thumbnail
umd --batch-file urls.txt --audio-only
Batch download from file
umd --batch-file urls.txt --optimized-batch --max-concurrent 5
Parallel batch download
umd "URL" --output /path/to/folder
Custom output directory
umd "URL" --show-formats
Show available formats
umd --help
Show all available commands
umd --version
Check installed version
[ DOCUMENTATION ]

Everything explained.
Nothing hidden.

Read the source documentation in your browser, clone it locally, or open it directly in Codeberg. Diagrams use Mermaid, so the system stays understandable as it grows.

Open documentation index ↗
01

Installation

Set up UMD on macOS, Windows, or Linux.

Read .md ↗02

Usage guide

Commands, quality choices, batch jobs, and playlists.

Read .md ↗03

Configuration

Make downloads fit your workflow.

Read .md ↗04

Architecture

How handlers, utilities, and the CLI work together.

Read .md ↗05

Handler reference

Extend UMD with platform-aware handlers.

Read .md ↗06

Troubleshooting

Resolve common setup and download issues.

Read .md ↗
System at a glance

One command,
clear flow.

URL validation routes requests to a dedicated handler when it can. A reliable generic pathway remains available for supported sites.

URL→CLI→Validator→Handler→Media
[ FAQ ]

Frequently Asked Questions

Everything you need to know about UMD, answered directly.

UMD supports 110+ platforms via yt-dlp, including YouTube, Spotify, Instagram, TikTok, SoundCloud, Twitter/X, Vimeo, Reddit, Facebook, Twitch, Dailymotion, and many more. If yt-dlp supports it, UMD can download it.
By default, media is saved to ~/Downloads/UltimateDownloader/. You can configure this by editing the settings in the interactive menu.
Yes. Paste a playlist or album URL and UMD will download all tracks automatically. It also detects duplicates so you won't re-download files you already have.
UMD supports MP3, FLAC (lossless), M4A, OPUS, and WAV. You choose the format in the interactive prompt, or specify it via command-line flags.
ffmpeg is required for audio extraction and format conversion. Install it via brew (macOS), apt (Linux), or download from ffmpeg.org (Windows). UMD will warn you if it's missing.
Yes. UMD is fully free, with no ads, no telemetry, and no tracking. The source code is hosted publicly on Codeberg under an open-source license.
Absolutely. UMD supports a headless/non-interactive mode suitable for cron jobs, shell scripts, and CI pipelines. Run umd help to see all available flags.