Skip to content
/ ULTIMATE-MEDIA-DOWNLOADER Public

A powerful, feature-rich command-line tool for downloading media from 1000+ platforms with beautiful UI, intelligent metadata handling, and multi-platform support.

License

View license
38 stars 17 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

NK2552003/ULTIMATE-MEDIA-DOWNLOADER

BranchesTags

Repository files navigation

Ultimate Media Downloader

Download media from 1000+ platforms with one command: umd

Python Version License GitHub Stars Last Commit

Features - Installation - Quick Start - Documentation - Contributing - Code of Conduct

⚠️ Disclaimer This software is provided for educational and personal use only. Users are responsible for complying with the terms of service of any websites or platforms from which they download content. The authors and contributors of this software:

  • Do not endorse or encourage copyright infringement
  • Are not responsible for any misuse of this software
  • Recommend users only download content they have the right to access
  • Advise users to respect intellectual property rights and applicable laws

By using this software, you agree to use it responsibly and in compliance with all applicable laws and regulations in your jurisdiction.

Overview

Ultimate Media Downloader is a professional-grade, open-source media downloading tool supporting 100+ platforms (YouTube, Spotify, JioSaavn, Gaana, SoundCloud, Instagram, TikTok, Apple Music and more). Built with Python, it features a beautiful Rich CLI interface and enterprise-level capabilities with consumer-friendly simplicity.

Why Choose Ultimate Media Downloader?

Feature Description
One Command Install once, use umd from anywhere
100+ Platforms YouTube, Spotify, JioSaavn, Gaana, Apple Music, Instagram, TikTok, SoundCloud, and more
Auto-Update Automatically checks and updates to latest version
No Virtual Env Clean installation with pipx
Auto Organization Downloads saved to ~/Downloads/UltimateDownloader
Beautiful UI Modern CLI with progress bars and rich formatting
Fast Downloads Concurrent downloads with resume support
High Quality 4K/8K video, 320kbps audio, metadata embedding
Active Development Regular updates and improvements

Features

Core Capabilities

Type Platforms & Features
Video YouTube (4K/8K), Vimeo, Dailymotion, Live streams, Age-restricted, Custom quality, HiAnime
Audio Spotify (via YouTube search), JioSaavn (via YouTube search), Gaana (via YouTube search), SoundCloud, Apple Music, 320kbps, FLAC, MP3
Playlists YouTube, Spotify, JioSaavn, Gaana, SoundCloud, TikTok, Instagram, Batch download
Social Instagram, TikTok, Facebook, Twitter/X, Twitch, LinkedIn (direct posts), Pinterest (profiles/boards), Reddit (posts/users), IGTV, Reels, Stories
Generic 1000+ sites via yt-dlp, SSL/TLS bypass, proxy rotation

Installation

Quick Install (Recommended)

Install in just 2 commands - no virtual environment needed!

git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
./scripts/install.sh

Windows users:

git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
scripts\install.bat

That's it! Now use from anywhere:

umd <URL>

What Gets Installed

No virtual environment needed
Global umd command available everywhere
All dependencies handled automatically
FFmpeg installed/verified
Downloads directory created at ~/Downloads/UltimateDownloader

Installation time: 2-5 minutes

Prerequisites

Before installing, ensure you have:

Check your Python version:

python3 --version

Alternative Installation Methods

Method 1: Using pipx (Manual) 
# Install pipx if not already installed
brew install pipx  # macOS
# or
pip install --user pipx  # Linux/Windows

# Clone and install
git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
pipx install -e .
Method 2: Using pip 
git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
pip3 install -e .
Method 3: Virtual Environment 
git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python ultimate_downloader.py <URL>

️ Platform-Specific Installation

macOS 
# Install prerequisites
brew install [email protected] ffmpeg pipx

# Clone and install
git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
./scripts/setup.sh

If umd command not found, add to PATH:

echo 'export PATH="$PATH:$HOME/Library/Python/3.11/bin"' >> ~/.zshrc
source ~/.zshrc
Linux (Ubuntu/Debian) 
# Install prerequisites
sudo apt update
sudo apt install -y python3 python3-pip ffmpeg git

# Clone and install
git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
./scripts/install.sh

If umd command not found, add to PATH:

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc
🪟 Windows

Step 1: Install Prerequisites

  1. Install Python from python.org (Check "Add Python to PATH")
  2. Install Git from git-scm.com
  3. Install FFmpeg:
    • Using Chocolatey: choco install ffmpeg
    • Or download from ffmpeg.org

Step 2: Install Ultimate Media Downloader

git clone https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git
cd ULTIMATE-MEDIA-DOWNLOADER
scripts\setup.bat

Verify Installation

# Check if installed
umd --version

# Show help
umd --help

# Test with a video
umd "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --info

Detailed Installation Guide

For comprehensive installation instructions, troubleshooting, and platform-specific guides, see:

📖 Installation Guide

Keeping Updated

Automatic Updates (Built-in)

Ultimate Media Downloader automatically checks for updates every time you run it!

  • No manual checking needed - Updates are detected automatically
  • One-click updates - Just press 'Y' when prompted
  • Non-intrusive - Silent when up-to-date
  • Smart caching - Checks once per hour to avoid delays

When an update is available, you'll see:

⚠️  New version available: v2.2.0 (current: v2.1.0)
Would you like to update now? (Y/n):

Manual Update

Update at any time using the update scripts:

macOS/Linux:

cd ULTIMATE-MEDIA-DOWNLOADER
./scripts/update.sh

Windows:

cd ULTIMATE-MEDIA-DOWNLOADER
scripts\update.bat

Or use pip directly:

pip install --upgrade git+https://github.com/NK2552003/ULTIMATE-MEDIA-DOWNLOADER.git

📖 Auto-Update Documentation

Quick Start

Basic Usage

# Interactive mode (easiest for beginners)
umd

# Download a video
umd "https://youtube.com/watch?v=VIDEO_ID"

# Download audio only as MP3
umd "https://youtube.com/watch?v=VIDEO_ID" --audio-only --format mp3

# Download in specific quality
umd "URL" --quality 1080p

# Download entire playlist
umd "https://youtube.com/playlist?list=PLAYLIST_ID"

# Show all available options
umd --help

Advanced Examples

# Download with metadata and thumbnail
umd "URL" --audio-only --embed-metadata --embed-thumbnail

# Batch download from file
umd --batch-file urls.txt --audio-only

# Parallel batch download
umd --batch-file urls.txt --optimized-batch --max-concurrent 5

# Custom output directory
umd "URL" --output /path/to/folder

# Show available formats
umd "URL" --show-formats

# Download specific quality video
umd "URL" --quality 1080p --format mp4

Download Locations

Downloads are automatically saved to:

~/Downloads/UltimateDownloader/
├── Artist Name - Song Title.mp3
├── Video Title.mp4
├── Playlist Name/
│   ├── Song 1.mp3
│   ├── Song 2.mp3
│   └── Song 3.mp3
└── Album Name/
    └── tracks...

For more examples and detailed usage, see Usage Guide

Documentation

️ System Requirements

Minimum Requirements

  • Operating System: Linux, macOS 10.12+, Windows 10+
  • Python: 3.9 or higher
  • RAM: 2GB minimum, 4GB recommended
  • Storage: 100MB for installation + space for downloads
  • Internet: Stable internet connection

Required Software

  • Python 3.9+: Core runtime
  • FFmpeg: Video/audio processing (can be auto-installed)
  • pip: Python package manager

Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

For information about third-party licenses used in this project, see THIRD_PARTY_LICENSES.md.

Acknowledgments

Built with:

  • yt-dlp - Media extraction engine
  • Rich - Beautiful terminal formatting
  • FFmpeg - Media processing
  • SpotDL - Spotify integration

Support & Contact

Made with ❤️ by NK2552003

⭐ Star this repository if you find it useful!

Report Bug • Request Feature • Documentation

About

A powerful, feature-rich command-line tool for downloading media from 1000+ platforms with beautiful UI, intelligent metadata handling, and multi-platform support.

Topics

python music cli multi-platform downloader video-downloader command-line-tool twitter-downloader instagram-downloader music-downloader youtube-video-downloader media-downloader apple-music-downloader any-video-downloader spotify-music-downloader youtube-music-downlaoder media-downloader-cli any-audio-downloader

Resources

Readme

License

View license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

38 stars

Watchers

0 watching

Forks

17 forks
Report repository

Releases 5

Ultimate Media Downloader v2.1.0 Latest
Jan 8, 2026
+ 4 releases

Packages

No packages published

Languages