social-media-downloader 1.1.7

A command-line tool to download videos from various social media platforms like YouTube, TikTok, Facebook, Instagram, X & more. It supports instagram batch downloads, format selection, and maintains a download history.

Social Media Downloader

A powerful and easy-to-use tool to download public videos from your favorite social media platforms. Whether you're on Windows or Linux, technical or not — we've got you covered. Download in batches, choose your formats, and even use it as a command-line tool or standalone app. Built with love, open-source, and fully community-driven. 100% Free (but hey, a coffee wouldn’t hurt!)

[!NOTE] This tool only supports public links. It does not work on private or restricted content. If you try to use it on private content, it will throw an error. Please respect the privacy of others.

Supported Social Media Platforms

• YouTube
• TikTok
• Instagram
• Facebook
• X (Twitter) & more! See the full list Here: Supported Platforms

Features

• Multiple Platforms – YouTube, Instagram & more
• Batch Downloads – Download multiple links at once ( only public links Instagram)
• Choose Formats – MP4, MP3, or whatever you vibe with
• History Log – Keeps track of what you downloaded
• Update Checker – Always stay fresh with the latest version
• Interactive CLI – Easy to use, even for non-techies

Preview

Usage

Clone this repo (Recommended)

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

Then navigate to the directory:

cd Social-Media-Downloader

Recommended (Create a virtual environment)

Windows

python -m venv .venv            # (Recommended)
.venv\Scripts\activate
pip install -r requirements.txt
python downloader.py

Linux

python3 -m venv .venv            # (Recommended)
source .venv/bin/activate
pip3 install -r requirements.txt
python3 downloader.py

Requirements Must Be Installed

Install FFmpeg

• Windows
  Download from: https://ffmpeg.org/download.html
  Add the bin path to your system environment variables.

• Linux

sudo apt update
sudo apt install ffmpeg

Installation Options

Install via PIP (Python Users Only)

Run the following command to install the tool:

pip install social-media-downloader

Then just run from anywhere:

social-media-downloader

also you can run it shortcut command smd

smd

[!NOTE] Listen if you are using 1.1.4 or later version, you can run the tool using smd or social-media-downloader command. If you are using 1.1.3 or earlier version, you can run the tool using social-media-downloader command. If you want to update to the latest version, run:

pip install --upgrade social-media-downloader

Install via .deb package

[!NOTE] This is only for Debian-based systems (like Ubuntu). If you are using other Linux distros, please use the prebuilt binaries or build from source.

1. Download the .deb file from Releases
2. Open a terminal and navigate to the directory where you downloaded the file.
3. Run the following command:

sudo dpkg -i social-media-downloader_VERSION_amd64.deb

4. If you get any dependency errors, run:

sudo apt-get install -f

5. After installation, you can run the tool by typing smd in the terminal.
6. To uninstall, run:

sudo apt-get remove social-media-downloader

Prebuilt Binaries & EXE

READ THIS BEFORE USING! These are prebuilt binaries and EXE files. For EXE/Binaries don't forget to install FFmpeg. Always use the latest version from the Releases page. If you have any issues, please open an issue on GitHub. Prebuilt binaries & exe don't require Python or any dependencies. Just download and run! Note: These builds are not signed, so you may get a warning from Windows Defender or your antivirus. If you get a warning, click "More Info" and then "Run Anyway". This is normal for unsigned builds. You can safely ignore it and run the EXE. If you are not sure about the build, please build it from source using the Build Instructions above. We are not responsible for any issues caused by using untrusted builds. DO NOT use modified EXE/Binaries files outside this repository. For your security, only use trusted builds.

Windows EXE (Prebuilt)

1. Download the EXE from Releases
2. Double-click & run like a normal app
3. Boom! You're ready to download videos!

Prebuilt Linux Binaries

Download the smd-linux.tar.gz from Releases and:

tar -xvzf smd-linux.tar.gz
sudo chmod +x smd
./smd

Visit SMD Web Portal/SMD Docs/Release to Download the EXE/Binaries/.deb files

[!NOTE] This is a web portal to download the EXE or Binaries files. You can also use the web portal to download the latest version of the tool. The web portal is hosted on GitHub Pages and is updated automatically whenever a new version is released.

Check out the official page: nayandas69.github.io/Social-Media-Downloader

Check out the official documentation: nayandas69.github.io/smd-docsite

How to Use

1. Run the tool (either via command line or double-click the EXE)
2. Select the platform you want to download from (YouTube, Instagram, etc.)
3. Paste the public link of a video
4. Choose output format ID available like 625 (or type mp3 for audio-only)
5. Sit back and let the tool work its magic!
6. Wait for the download to finish (it’ll show you the progress)
7. Batch download? No problem! Just follow these steps:
   • Create a .txt file with each URL on a new line
   • For batch download, enter the path to your .txt file containing URLs.
   • For example: C:\path\to\batch_links.txt or /home/user/batch_links.txt
8. Find your downloaded files in the same directory as the tool
9. Enjoy your videos!

Tested Platforms

• Windows 11
• Windows 10
• Kali Linux
• Parrot OS
• macOS (Not tested)
• Other Linux Distros (Should work but not tested)

Legal & Ethical Use

[!WARNING] READ THIS BEFORE USING! This tool is for PERSONAL USE ONLY and only works with public videos. You CANNOT use it to:

• Download private, copyrighted, or restricted content
• Repost videos without credit (be a decent human, c’mon)
• Violate YouTube, Instagram, Facebook, TikTok or other social media TOS I'm not responsible if you break the rules. Use this ethically and responsibly!

Read More:

• License
• What's New
• Change Log
• Contributing
• CONTRIBUTORS.md
• Details

Read the full documentation

• Social Media Downloader Documentation

Planned Features

See Roadmap for more details: Roadmap

Contributing & Support

Have suggestions? We'd love to hear them! Open an issue on GitHub or join our Discord community. Your feedback is invaluable in making this tool even better!

Love the tool? Help improve it! Open an issue or PR on GitHub.

Who contributed to this project?

• See the list of contributors

Contact Me:

• Made by Nayan Das
• Email: [e-mail]
• Discord: Join here!

Thank You, 4.7K+ Users!

This project is maintained by nayandas69.
Thanks for downloading & supporting! Share your reviews and feedback.
Your support means the world to me!

Disclaimer:
This tool is not affiliated with or endorsed by YouTube, TikTok, Instagram, Facebook, X, or other social media. Use at your own discretion.