media-downloader 2.1.8

Download audio/videos from the internet!

Media Downloader

Version: 2.1.8

Download videos and audio from the internet!

MCP Server Support!

This repository is actively maintained - Contributions are welcome!

Supports:

• YouTube
• Twitter
• Rumble
• BitChute
• Vimeo
• And More!

Usage:

CLI

Short Flag	Long Flag	Description
-h	--help	See usage
-a	--audio	Download audio only
-c	--channel	YouTube Channel/User - Downloads all videos
-f	--file	File with video links
-l	--links	Comma separated links
-d	--directory	Location to save videos

Using an an MCP Server:

AI Prompt:

Download me this video: https://youtube.com/watch?askdjfa

AI Response:

Sure thing, the video has been downloaded to:

"C:\Users\User\Downloads\YouTube Video - Episode 1.mp4"

Example:

Use in CLI

media-downloader --file "C:\Users\videos.txt" --directory "C:\Users\Downloads" --channel "WhiteHouse" --links "URL1,URL2,URL3"

Use in Python

# Import library
from media_downloader import MediaDownloader

# Set URL of video/audio here
url = "https://YootToob.com/video"

# Instantiate vide_downloader_instance
video_downloader_instance = MediaDownloader()

# Set the location to save the video
video_downloader_instance.set_save_path("C:/Users/you/Downloads")

# Add URL to download
video_downloader_instance.append_link(url)

# Download all videos appended
video_downloader_instance.download_all()

# Optional - Set Audio to True, Default is False if unspecified.
video_downloader_instance.set_audio(audio=True)

# Optional - Open a file of video/audio URL(s)
video_downloader_instance.open_file("FILE")

# Optional - Enter a YouTube channel name and download their latest videos
video_downloader_instance.get_channel_videos("YT-Channel Name")

Use with AI

Deploy MCP Server as a Service

docker pull knucklessg1/media-downloader:latest

Modify the compose.yml

services:
  media-downloader-mcp:
    image: knucklessg1/media-downloader:latest
    volumes:
      - downloads:/root/Downloads
    environment:
      - HOST=0.0.0.0
      - PORT=8000
    ports:
      - 8000:8000

Configure mcp.json

{
  "mcpServers": {
    "media_downloader": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "media-downloader",
        "media-downloader-mcp"
      ],
      "env": {
        "DOWNLOAD_DIRECTORY": "~/Downloads", // Optional - Can be specified at prompt
        "AUDIO_ONLY": false // Optional - Can be specified at prompt
      },
      "timeout": 300000
    }
  }
}

Run as a docker container:

services:
  media-downloader-mcp:
    image: docker.io/knucklessg1/media-downloader:latest
    ports:
      - "8000:8000"
    volumes:
      - "/home/genius/Downloads:/downloads"
    environment:
      - HOST=0.0.0.0
      - PORT=8000
      - TRANSPORT=http
      - DOWNLOAD_DIRECTORY=/downloads
      - AUDIO_ONLY=false

Installation Instructions:

Install Python Package

python -m pip install media-downloader

Geniusbot Application

Use with a GUI through Geniusbot

Visit our GitHub for more information

Installation Instructions with Geniusbot:

Install Python Package

python -m pip install geniusbot

Repository Owners: