<div align="center">
# Social Media Downloader
A fast, simple, and open-source tool to grab **public videos** from all your favorite platforms — including YouTube, TikTok, Instagram, Facebook, X and see all [supported platforms](https://nayandas69.github.io/Social-Media-Downloader/supported-platforms). Whether you're a techie or a casual user, this tool works seamlessly across **Windows** and **Linux**. Download single videos or entire batches, pick your desired format, and save content hassle-free. With a user-friendly command-line interface, you can easily download videos in just a few clicks.
[](https://pypi.org/project/social-media-downloader)
[](https://nayandas69.github.io/Social-Media-Downloader)
</div>
> [!NOTE]
> This tool **only works with publicly available videos**. It **cannot download private, restricted, or protected content**. Attempting to do so will result in an error.
> Please use responsibly and respect content ownership and privacy.
## Intro
## Quick Start
### Clone the Repository
```bash
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](https://ffmpeg.org/download.html) and add bin folder to your **System PATH**.
* **Linux:**
```bash
sudo apt update
sudo apt install ffmpeg
```
## Install the Tool
<details>
<summary><strong>Click to expand the installation options for Social Media Downloader</strong></summary>
### Installation Options
| Platform | Method | Instructions |
| ---------- | ------------------- | ------------------------------------------------------------------------------------------------------------- |
| Windows | Standalone `.exe` | Download from [Releases](https://github.com/nayandas69/Social-Media-Downloader/releases), double-click to run |
| Linux | `Binary` / `.deb` | Use the `.deb` installer or download the `binary` for direct execution |
| Universal | `pip` (recommended) | `pip install social-media-downloader` |
| Manual | From Source | Clone repo → install deps → python smd/downloader.py |
</details>
> [!TIP]
> Choose the method that works best for your setup. Full guide: [Installation Guide](https://nayandas69.github.io/Social-Media-Downloader/installation)
## 📚 Full Documentation
Our complete user guide is available online:
**Docs:** [https://nayandas69.github.io/Social-Media-Downloader](https://nayandas69.github.io/Social-Media-Downloader)
### Highlights:
* [Requirements & Setup](https://nayandas69.github.io/Social-Media-Downloader/installation/)
* [Using the Downloader](https://nayandas69.github.io/Social-Media-Downloader/usage/)
* [Supported Platforms](https://nayandas69.github.io/Social-Media-Downloader/supported-platforms/)
* [Common Issues](https://nayandas69.github.io/Social-Media-Downloader/faq/)
* [Build & Troubleshooting](https://nayandas69.github.io/Social-Media-Downloader/build/)
* [Feature Roadmap](https://nayandas69.github.io/Social-Media-Downloader/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
| OS | Status |
| ----------- | -------------- |
| Windows 11/10 | ✅ Tested |
| Kali Linux / Parrot OS | ✅ Tested |
| macOS | ⚠️ Not tested |
| Other Linux | ⚠️ Should work |
## 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](https://github.com/nayandas69/Social-Media-Downloader/issues) or [submit a PR](https://github.com/nayandas69/Social-Media-Downloader/pulls)
Read the [Contribution Guide](https://github.com/nayandas69/Social-Media-Downloader/blob/dev/.github/CONTRIBUTING.md)
## Credits & Community
Made with ❤️ by [**Nayan Das**](https://nayandas69.github.io/link-in-bio)
Email: [nayanchandradas@hotmail.com](mailto:nayanchandradas@hotmail.com)
Join us on [Discord](https://discord.gg/skHyssu)
🙌 Special thanks to all [contributors](https://github.com/nayandas69/Social-Media-Downloader/blob/dev/docs/contributors.md)
## Thank You — 7K+ Users and Growing!
If this tool helped you, show some love by ⭐ starring the repo or [Support](https://www.patreon.com/nayandas69)!
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**](https://github.com/yt-dlp/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](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)**
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**](https://github.com/yt-dlp/yt-dlp)
* [**Instaloader**](https://github.com/instaloader/instaloader)
> **Huge thanks** to their developers and contributors for making this tool possible!
## License
This project is licensed under the [MIT License](LICENSE).
Raw data
{
"_id": null,
"home_page": null,
"name": "social-media-downloader",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "smd, cli tool, video downloader, tiktok downloader, youtube downloader, facebook downloader, instagram downloader, social media downloader",
"author": null,
"author_email": "nayandas69 <nayanchandradas@hotmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5a/8a/6ad1e1981512877b92b5baa2b942d8bd78cd630e4dce2412c5eae401cd2b/social_media_downloader-1.1.10.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# Social Media Downloader\n\nA fast, simple, and open-source tool to grab **public videos** from all your favorite platforms \u2014 including YouTube, TikTok, Instagram, Facebook, X and see all [supported platforms](https://nayandas69.github.io/Social-Media-Downloader/supported-platforms). Whether you're a techie or a casual user, this tool works seamlessly across **Windows** and **Linux**. Download single videos or entire batches, pick your desired format, and save content hassle-free. With a user-friendly command-line interface, you can easily download videos in just a few clicks.\n\n\n\n[](https://pypi.org/project/social-media-downloader)\n\n\n[](https://nayandas69.github.io/Social-Media-Downloader) \n\n</div>\n\n> [!NOTE] \n> This tool **only works with publicly available videos**. It **cannot download private, restricted, or protected content**. Attempting to do so will result in an error. \n> Please use responsibly and respect content ownership and privacy.\n\n## Intro\n\n\n## Quick Start\n\n### Clone the Repository\n```bash\ngit clone https://github.com/nayandas69/Social-Media-Downloader.git\ncd Social-Media-Downloader\n```\n\n## Requirements\n\n> \u2705 Before running the tool, make sure **FFmpeg** is installed:\n\n### Install FFmpeg\n\n* **Windows:**\n Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add bin folder to your **System PATH**.\n\n* **Linux:**\n\n```bash\nsudo apt update\nsudo apt install ffmpeg\n```\n\n## Install the Tool\n\n<details>\n\n<summary><strong>Click to expand the installation options for Social Media Downloader</strong></summary>\n\n### Installation Options\n\n| Platform | Method | Instructions |\n| ---------- | ------------------- | ------------------------------------------------------------------------------------------------------------- |\n| Windows | Standalone `.exe` | Download from [Releases](https://github.com/nayandas69/Social-Media-Downloader/releases), double-click to run |\n| Linux | `Binary` / `.deb` | Use the `.deb` installer or download the `binary` for direct execution |\n| Universal | `pip` (recommended) | `pip install social-media-downloader` |\n| Manual | From Source | Clone repo \u2192 install deps \u2192 python smd/downloader.py |\n\n</details>\n\n> [!TIP]\n> Choose the method that works best for your setup. Full guide: [Installation Guide](https://nayandas69.github.io/Social-Media-Downloader/installation)\n\n## \ud83d\udcda Full Documentation\n\nOur complete user guide is available online:\n\n**Docs:** [https://nayandas69.github.io/Social-Media-Downloader](https://nayandas69.github.io/Social-Media-Downloader)\n\n### Highlights:\n\n* [Requirements & Setup](https://nayandas69.github.io/Social-Media-Downloader/installation/)\n* [Using the Downloader](https://nayandas69.github.io/Social-Media-Downloader/usage/)\n* [Supported Platforms](https://nayandas69.github.io/Social-Media-Downloader/supported-platforms/)\n* [Common Issues](https://nayandas69.github.io/Social-Media-Downloader/faq/)\n* [Build & Troubleshooting](https://nayandas69.github.io/Social-Media-Downloader/build/)\n* [Feature Roadmap](https://nayandas69.github.io/Social-Media-Downloader/roadmap/)\n\n## Features\n\n* **Multi-platform** support: YouTube, TikTok, Instagram, etc.\n* **Batch downloads**: Just paste multiple links in a .txt file\n* **Format options**: Choose between MP4, MP3, or ID-based formats\n* **Download history** tracking\n* **Update checker** built-in\n* **Interactive CLI**: Beginner-friendly and simple to use\n* Works on both **Windows** and **Linux**\n\n## How It Works\n\n1. Launch the tool (EXE or Python script)\n2. Choose a platform (YouTube, Instagram, etc.)\n3. Paste a **public video URL**\n4. Select a format (e.g., `mp3`, `625`)\n5. The tool handles the rest! You'll see real-time progress.\n6. For **batch downloads**:\n\n * Create a `.txt` file with one URL per line\n * Provide the file path when prompted\n\nYour videos will be saved in the same folder where the tool is located.\n\n## Tested Environments\n\n| OS | Status |\n| ----------- | -------------- |\n| Windows 11/10 | \u2705 Tested |\n| Kali Linux / Parrot OS | \u2705 Tested |\n| macOS | \u26a0\ufe0f Not tested |\n| Other Linux | \u26a0\ufe0f Should work |\n\n## Legal & Usage Notice\n\n> \ud83d\udeab This tool is provided for **educational and personal use only**. You **must not**:\n>\n> * Use it to download **private, copyrighted, or restricted** content\n> * Violate any **Terms of Service** of the platforms supported\n> * Re-upload or redistribute videos without proper permission or credit\n>\n> \u2757 The developer is **not responsible** for how this tool is used. Please respect digital ownership and platform policies.\n\n## Contributing\n\nHave suggestions, bug reports, or ideas?\nWe welcome contributions!\n\ud83d\udc49 [Open an issue](https://github.com/nayandas69/Social-Media-Downloader/issues) or [submit a PR](https://github.com/nayandas69/Social-Media-Downloader/pulls)\n\nRead the [Contribution Guide](https://github.com/nayandas69/Social-Media-Downloader/blob/dev/.github/CONTRIBUTING.md)\n\n## Credits & Community\n\nMade with \u2764\ufe0f by [**Nayan Das**](https://nayandas69.github.io/link-in-bio) \nEmail: [nayanchandradas@hotmail.com](mailto:nayanchandradas@hotmail.com) \nJoin us on [Discord](https://discord.gg/skHyssu) \n\n\ud83d\ude4c Special thanks to all [contributors](https://github.com/nayandas69/Social-Media-Downloader/blob/dev/docs/contributors.md)\n\n## Thank You \u2014 7K+ Users and Growing!\n\nIf this tool helped you, show some love by \u2b50 starring the repo or [Support](https://www.patreon.com/nayandas69)!\nYour support keeps this project alive \u2764\ufe0f\n\n> *This project is not affiliated with or endorsed by YouTube, TikTok, Instagram, Facebook, X or other platforms.*\n\n## Full yt-dlp Support + Easy CLI Integration\n\nThis tool uses [**yt-dlp**](https://github.com/yt-dlp/yt-dlp) under the hood, so it supports **all sites yt-dlp supports** \u2014 not just the ones listed below.\n\n**[Click here to view the full list of sites supported by yt-dlp](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)**\n\nBut we\u2019ve gone a step further!\nIn `downloader.py`, we\u2019ve added **CLI program support for the most commonly used social media platforms** (like YouTube, TikTok, Reddit, X, etc.) via an internal `allowed_domains` list.\n\nThis makes it easier for users to:\n\n* Paste a URL from a popular site\n* Automatically validate it\n* Download videos or extract audio seamlessly\n\n\u2705 All without needing to memorize complex flags or command-line options!\n\nYou can even expand support by **editing the `allowed_domains` list** inside the script. This makes it super customizable for your own needs.\n\n## Built With\n\nThis tool wouldn't be possible without these amazing open-source projects:\n\n* [**yt-dlp**](https://github.com/yt-dlp/yt-dlp)\n* [**Instaloader**](https://github.com/instaloader/instaloader)\n\n> **Huge thanks** to their developers and contributors for making this tool possible!\n\n## License\nThis project is licensed under the [MIT License](LICENSE).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "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.",
"version": "1.1.10",
"project_urls": {
"Bug Tracker": "https://github.com/nayandas69/Social-Media-Downloader/issues",
"Documentation": "https://github.com/nayandas69/Social-Media-Downloader#readme",
"Source Code": "https://github.com/nayandas69/Social-Media-Downloader"
},
"split_keywords": [
"smd",
" cli tool",
" video downloader",
" tiktok downloader",
" youtube downloader",
" facebook downloader",
" instagram downloader",
" social media downloader"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5bd8d6b4ebf897a1091149ba42bfc2b78641a7a5c70948e2682aa25dc1e7c699",
"md5": "e0062383e93fbf411eb01398a6b98797",
"sha256": "c5215359c566b76bf6b0d6ba71ec48c52884f8df1baa5f7cec03f20d127dddf2"
},
"downloads": -1,
"filename": "social_media_downloader-1.1.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e0062383e93fbf411eb01398a6b98797",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 15656,
"upload_time": "2025-07-09T11:49:47",
"upload_time_iso_8601": "2025-07-09T11:49:47.557739Z",
"url": "https://files.pythonhosted.org/packages/5b/d8/d6b4ebf897a1091149ba42bfc2b78641a7a5c70948e2682aa25dc1e7c699/social_media_downloader-1.1.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5a8a6ad1e1981512877b92b5baa2b942d8bd78cd630e4dce2412c5eae401cd2b",
"md5": "c5e6b372a61757ac001e9dd5e69fc3ee",
"sha256": "3a8115ff4f47363f9f205e5c356c9298698bb4ca0be2b5ad997536fa82276659"
},
"downloads": -1,
"filename": "social_media_downloader-1.1.10.tar.gz",
"has_sig": false,
"md5_digest": "c5e6b372a61757ac001e9dd5e69fc3ee",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 18910,
"upload_time": "2025-07-09T11:49:48",
"upload_time_iso_8601": "2025-07-09T11:49:48.650697Z",
"url": "https://files.pythonhosted.org/packages/5a/8a/6ad1e1981512877b92b5baa2b942d8bd78cd630e4dce2412c5eae401cd2b/social_media_downloader-1.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 11:49:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nayandas69",
"github_project": "Social-Media-Downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "yt-dlp",
"specs": [
[
">=",
"2023.7.6"
]
]
},
{
"name": "instaloader",
"specs": [
[
">=",
"4.10.0"
]
]
},
{
"name": "tqdm",
"specs": [
[
">=",
"4.65.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "ffmpeg-python",
"specs": [
[
">=",
"0.2.0"
]
]
},
{
"name": "certifi",
"specs": [
[
">=",
"2023.7.22"
]
]
},
{
"name": "setuptools",
"specs": [
[
">=",
"65.5.0"
]
]
},
{
"name": "wheel",
"specs": [
[
">=",
"0.38.4"
]
]
},
{
"name": "pyfiglet",
"specs": [
[
">=",
"0.8.post1"
]
]
},
{
"name": "termcolor",
"specs": [
[
">=",
"2.3.0"
]
]
},
{
"name": "tabulate",
"specs": [
[
">=",
"0.9.0"
]
]
}
],
"lcname": "social-media-downloader"
}
JSON
