Intro

Quick Start

Clone the Repository

git clone https://github.com/nayandas69/Social-Media-Downloader.git
cd Social-Media-Downloader

Requirements

✅ Before running the tool, make sure FFmpeg is installed:

Install FFmpeg

• Windows: Download from ffmpeg.org and add bin folder to your System PATH.

• Linux:

sudo apt update
sudo apt install ffmpeg

Install the Tool

📚 Full Documentation

Our complete user guide is available online:

Docs: https://nayandas69.github.io/Social-Media-Downloader

Highlights:

• Requirements & Setup
• Using the Downloader
• Supported Platforms
• Common Issues
• Build & Troubleshooting
• Feature Roadmap

Features

• Multi-platform support: YouTube, TikTok, Instagram, etc.
• Batch downloads: Just paste multiple links in a .txt file
• Format options: Choose between MP4, MP3, or ID-based formats
• Download history tracking
• Update checker built-in
• Interactive CLI: Beginner-friendly and simple to use
• Works on both Windows and Linux

How It Works

1. Launch the tool (EXE or Python script)

2. Choose a platform (YouTube, Instagram, etc.)

3. Paste a public video URL

4. Select a format (e.g., mp3, 625)

5. The tool handles the rest! You'll see real-time progress.

6. For batch downloads:

   • Create a .txt file with one URL per line
   • Provide the file path when prompted

Your videos will be saved in the same folder where the tool is located.

Tested Environments

Legal & Usage Notice

🚫 This tool is provided for educational and personal use only. You must not:

• Use it to download private, copyrighted, or restricted content
• Violate any Terms of Service of the platforms supported
• Re-upload or redistribute videos without proper permission or credit

❗ The developer is not responsible for how this tool is used. Please respect digital ownership and platform policies.

Contributing

Have suggestions, bug reports, or ideas? We welcome contributions! 👉 Open an issue or submit a PR

Read the Contribution Guide

Credits & Community

Made with ❤️ by Nayan Das
Email: nayanchandradas@hotmail.com
Join us on Discord

🙌 Special thanks to all contributors

Thank You — 7K+ Users and Growing!

If this tool helped you, show some love by ⭐ starring the repo or Support! Your support keeps this project alive ❤️

This project is not affiliated with or endorsed by YouTube, TikTok, Instagram, Facebook, X or other platforms.

Full yt-dlp Support + Easy CLI Integration

This tool uses yt-dlp under the hood, so it supports all sites yt-dlp supports — not just the ones listed below.

Click here to view the full list of sites supported by yt-dlp

But we’ve gone a step further! In downloader.py, we’ve added CLI program support for the most commonly used social media platforms (like YouTube, TikTok, Reddit, X, etc.) via an internal allowed_domains list.

This makes it easier for users to:

• Paste a URL from a popular site
• Automatically validate it
• Download videos or extract audio seamlessly

✅ All without needing to memorize complex flags or command-line options!

You can even expand support by editing the allowed_domains list inside the script. This makes it super customizable for your own needs.

Built With

This tool wouldn't be possible without these amazing open-source projects:

• yt-dlp
• Instaloader

Huge thanks to their developers and contributors for making this tool possible!

License

This project is licensed under the MIT License.