Home
Welcome to the official documentation for Social Media Downloader — a fast, simple, and open-source command-line tool for downloading public videos from your favorite platforms including YouTube, TikTok, Facebook, Instagram, and many more.
Start Here
This documentation is your guide to getting started, troubleshooting issues, exploring features, and contributing to the project.
Why Use Social Media Downloader?¶
In today’s digital world, media moves fast — and so do you. Whether you're a developer, content creator, researcher, or just someone who wants a quick way to save videos offline, Social Media Downloader is designed to do one thing exceptionally well:
Download public media reliably and efficiently from a wide range of platforms.
Why Thousands Trust It
- Available as
.exe
,.deb
,pip
and Linux binary - Built with ❤️ using Python — lightweight and powerful
- 100% free and open-source
- Works on Windows & Linux
- No bloated GUIs — pure CLI simplicity
What You Get¶
When you install Social Media Downloader, you gain:
- A clean and powerful command-line interface (CLI)
- Automatic format detection and download options
- Lightweight performance with no third-party junk
- Easy integration into your own scripts or tools
Tip
If you're automating workflows or building scraping utilities, SMD fits right in with your shell scripts or Python pipelines.
Supported Platforms¶
We currently support public video links from:
- YouTube
- TikTok
- X (formerly Twitter)
- And more... View the full list of supported platforms.
Constantly Evolving
We’re actively adding support for more platforms. Have a request? Open an issue or submit a pull request!
For Developers
Our modular architecture makes it easy to add new platform handlers. Come contribute — it’s simpler than you think!
Easy Installation¶
We provide builds for all major systems:
Download the pip
, .exe
, smd-linux.tar.gz
, .deb
or source code
file from our GitHub Releases.
Looking for older versions? Visit the archive page.
Platform | Format |
---|---|
Any | pip |
Windows | .exe |
Linux | .tar.gz |
Debian | .deb |
Only Use Official Sources
Always download from our official GitHub page to ensure your version is safe and up-to-date. Avoid third-party sources.
Features At a Glance¶
- One-line installation
- Format selection for downloads
- Video metadata preview
- Logs and download history
- GitHub-powered updates
Minimal CLI, Maximum Power
Get everything you need, right from your terminal — no fluff, just function.
Contributing¶
Want to help us improve?
You can:
- Report bugs
- Suggest features
- Improve this documentation
- Submit pull requests
See the Contribute Guide for details.
Note
We welcome contributors of all levels — from fixing typos to implementing new modules.
Where to Go Next¶
Explore the full documentation:
- Installation Guide →
- How to Use the CLI →
- Build for Your OS →
- All Releases →
- FAQ →
- Troubleshooting →
Thanks for Being Here¶
You’re now part of a growing community dedicated to making content downloading open, accessible, and efficient for everyone.
License & Maintenance
This project is licensed under MIT and maintained by @nayandas69. All downloads must comply with the terms of the source platform.
Stay curious. Stay creative. Stay in control.
— The Social Media Downloader Team