Knuckles-Team/media-downloader
3.3
If you are the rightful owner of media-downloader and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Media Downloader is a versatile tool designed to download videos and audio from various online platforms, supporting both CLI and MCP server functionalities.
Tools
1
Resources
0
Prompts
0
Media Downloader
Version: 2.1.7
Download videos and audio from the internet!
MCP Server Support!
This repository is actively maintained - Contributions are welcome!
Supports:
- YouTube
- 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
}
}
}
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:
