Skip to main content

CosmicDL - Professional Multi-Platform Video Downloader

Project description

๐ŸŽฌ CosmicDL

Version Python License PyPI Downloads

Professional Multi-Platform Video Downloader with Style! โœจ

A powerful, feature-rich downloader with a beautiful CLI, comprehensive Python API, and a Modern GUI

Installation โ€ข Features โ€ข Usage CLI โ€ข Usage GUI


๐Ÿ“ฆ Installation

With CosmicDLSetup.exe file

just download and install it, no actions needed

From PyPI โœ…

pip install CosmicDL

Quick Install (Linux/macOS)

chmod +x install.sh
./install.sh

Quick Install (Windows)

install.bat

๐ŸŒ Supported Sites

See the full list with details: Supported Sites


โœจ Features

  • Multi-Site Support - Download from 7+ major video sites
  • Automatic Site Detection - Just paste any supported URL
  • Beautiful GUI - Modern, Glassmorphism design with React & Python
  • Advanced Queue - Priority-based download queue with Pause/Resume
  • Fast Downloads - Multi-threaded + aria2c support (up to 16 connections)
  • Quality Selection - Choose from available qualities (up to 4K!)
  • Batch Downloads - Download multiple videos concurrently
  • Playlist/Channel Support - Download entire channels
  • Advanced Search - Integrated search for supported sites
  • Favorites & History - Manage your favorite videos and view download history
  • Proxy Manager - Rotating proxy support (HTTP/HTTPS/SOCKS)
  • Rate Limiting - Smart limits to prevent temporary IP bans
  • System Integration - System Tray icon and Desktop Notifications (Windows)
  • Python API - Use as a library for automation

NEW in v3.0.0 โœจ

  • Complete Rebranding - New name, new identity
  • Queue Management - Reorder, prioritize, and schedule downloads
  • Proxy Rotation - Automatically switch proxies on failure
  • Search & Favorites - Built-in search engine and folders for favorites
  • System Tray - Minimize to tray background running
  • Drag & Drop - Drag URLs directly into the app
  • Theme Support - Light/Dark mode toggle

๐Ÿš€ Usage (GUI) v3.0.0+

Download the CosmicDLSetup.exe file and install it.

Key Capabilities:

  1. Dashboard: View real-time stats and download speeds.
  2. Search: Search specific sites or all sites at once.
  3. Queue: Manage your downloads, change priorities, or pause the queue.
  4. Extras: Use the Batch Downloader for multiple links or configure Proxies.

๐Ÿš€ Usage (CLI)

Interactive Mode (Recommended for beginners)

Simply run without arguments:

CosmicDL

You'll get a beautiful interactive menu:

โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
โ•‘  โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—      โ•‘
โ•‘  โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘     โ•‘
โ•‘  โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ•‘
โ•‘  โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ•šโ•โ•โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ•‘
โ•‘  โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ•šโ•โ• โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ•‘
โ•‘   โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ•โ•โ•šโ•โ•     โ•šโ•โ•โ•šโ•โ• โ•šโ•โ•โ•โ•โ•โ•โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ•โ•โ•‘
โ•‘       Professional Multi-Platform Video Downloader              โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
                    version 3.0.0 โ€ข CosmicDL

Command Line Mode

# Download from any supported site
CosmicDL "VIDEO_URL"

# Specify quality
CosmicDL "URL" -q 720

# Custom output
CosmicDL "URL" -o my_video.mp4

# Use proxy
CosmicDL "URL" -p http://127.0.0.1:1080

๐Ÿ“š Documentation

Complete documentation available in docs/:


๐Ÿ”ง Requirements

Required

  • Python 3.10 or higher
  • Internet connection

Optional (Recommended)

  • FFmpeg - For automatic MP4 conversion
    • Ubuntu/Debian: sudo apt install ffmpeg
    • macOS: brew install ffmpeg
    • Windows: Download from ffmpeg.org

๐Ÿค Contributing

Contributions are welcome! Feel free to:

  • Report bugs
  • Suggest new features
  • Submit pull requests

๐Ÿ“œ License

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


โš–๏ธ Disclaimer

This tool is for educational purposes only. Please respect copyright laws and the terms of service of the websites you download from. The developers are not responsible for any misuse of this software.


Made with โค๏ธ by CosmicDL Team

If this tool helped you, consider giving it a โญ on GitHub!

GitHub โ€ข PyPI โ€ข Documentation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cosmicdl-3.0.0.tar.gz (74.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cosmicdl-3.0.0-py3-none-any.whl (97.8 kB view details)

Uploaded Python 3

File details

Details for the file cosmicdl-3.0.0.tar.gz.

File metadata

  • Download URL: cosmicdl-3.0.0.tar.gz
  • Upload date:
  • Size: 74.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for cosmicdl-3.0.0.tar.gz
Algorithm Hash digest
SHA256 4c7421b7a6e4088d6794ecbd01b5d4ef24fbb7ec62f36354654a453108e4883f
MD5 48a6a0f39a5f7a772b4f79b5874c29d9
BLAKE2b-256 c3636db988854e8446d0ea310e25649103afa6660c734a7e814da26ef625e579

See more details on using hashes here.

File details

Details for the file cosmicdl-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: cosmicdl-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 97.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for cosmicdl-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7bcb526f804fa0c53f0b025815ca5cde168829ad588e5b9a11967a3bbd0fd637
MD5 e57b6d9f9819ee5157a5f08a48966a81
BLAKE2b-256 211f4fa9157e98d1bc177ce5959bc6f63d7d053dfc8ef549455a09792a4969f0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page