A powerful Flask-based web application that allows you to download content from multiple social media platforms including YouTube, Instagram, TikTok, Twitter/X, Facebook, Reddit, and more.
Made by: mdimran.py
- YouTube: Videos, Shorts, Playlists, Subtitles
- Instagram: Posts, Stories, Reels, IGTV, Carousel posts
- TikTok: Videos with metadata
- Twitter/X: Videos, Images, Threads
- Facebook: Videos and Posts
- Reddit: Videos, Images, GIFs
- Generic: Any platform supported by yt-dlp
- Auto-Platform Detection: Automatically detects the platform from URL
- Bulk Downloads: Download multiple URLs at once
- High Quality: Downloads in best available quality (up to 1080p)
- Metadata Preservation: Saves video information and metadata
- Subtitle Support: Downloads subtitles when available
- Organized Storage: Creates timestamped folders for each download
- Web Interface: Easy-to-use web interface
- File Management: Browse, download, and manage downloaded files
- ZIP Downloads: Download entire folders as ZIP files
- Language: Python 3
- Web framework: Flask (+ Werkzeug), HTML templates
- Downloaders: yt-dlp, Instaloader
- HTTP: requests
- Deployment: Vercel config (
vercel.json)
- Python 3.7 or higher
- pip (Python package installer)
pip install flask requests yt-dlp instaloader werkzeugpip install -r requirements.txtCreate a requirements.txt file with:
Flask==2.3.3
requests==2.31.0
yt-dlp==2023.10.13
instaloader==4.10.3
Werkzeug==2.3.7
python app.pyThe server will start on http://localhost:5000
- Open your browser and go to
http://localhost:5000 - Paste any supported social media URL
- Click download and wait for completion
- Access downloaded files through the web interface
POST /download
Content-Type: application/json
{
"url": "https://www.youtube.com/watch?v=VIDEO_ID"
}POST /bulk-download
Content-Type: application/json
{
"urls": [
"https://www.youtube.com/watch?v=VIDEO_ID1",
"https://www.instagram.com/p/POST_ID/",
"https://www.tiktok.com/@user/video/VIDEO_ID"
]
}GET /downloadsGET /download-file/<filename>GET /download-folder/<foldername>POST /clear-downloadsGET /supported-platformsImportant: Change the secret key before production use:
app.config['SECRET_KEY'] = 'your-unique-secret-key-here'By default, files are downloaded to a downloads folder in the current directory. You can modify this in the code:
DOWNLOAD_DIR = os.path.join(os.getcwd(), 'downloads')your-project/
│
├── app.py # Main Flask application
├── templates/
│ └── index.html # Web interface template
├── downloads/ # Downloaded files (auto-created)
│ ├── youtube_20231201_120000/
│ ├── instagram_20231201_120500/
│ └── ...
└── README.md
- Supports videos, shorts, and playlists
- Downloads subtitles (English by default)
- Quality up to 1080p
- Preserves uploader and title information
- Posts: Single images/videos and carousel posts
- Stories: Download user stories (requires login)
- Reels: Instagram Reels with metadata
- IGTV: Long-form videos
- Profile: Download recent posts from a profile
- Downloads videos with original quality
- Preserves creator information and captions
- Downloads videos and images from tweets
- Supports thread downloads
- Preserves tweet metadata
- Downloads public videos and posts
- Supports various Facebook video formats
- Downloads videos, images, and GIFs
- Supports various Reddit media formats
The application includes comprehensive error handling:
- Invalid URLs are rejected with helpful messages
- Platform-specific errors are caught and reported
- Download failures are logged with detailed error information
- Bulk download continues even if individual URLs fail
- Instagram Stories: May require authentication for private accounts
- Private Content: Cannot download private or protected content
- Rate Limiting: Some platforms may rate-limit requests
- Geographic Restrictions: Some content may be geo-blocked
- Copyright: Respect copyright laws and platform terms of service
-
ModuleNotFoundError: Install required dependencies
pip install -r requirements.txt
-
Download Failures: Check if the URL is valid and publicly accessible
-
Permission Errors: Ensure the application has write permissions for the downloads directory
-
Instagram Issues: For stories and private content, authentication may be required
The application runs in debug mode by default. For production:
app.run(debug=False, host='0.0.0.0', port=5000)- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
This tool is for educational and personal use only. Users are responsible for:
- Complying with platform terms of service
- Respecting copyright laws
- Obtaining necessary permissions for content use
- Not using downloaded content for commercial purposes without permission
This project is licensed under the MIT License - see the LICENSE file for details.
For issues and questions:
- Check the troubleshooting section
- Review error messages carefully
- Ensure URLs are valid and publicly accessible
- Verify all dependencies are installed
- Initial release
- Multi-platform support
- Web interface
- Bulk download feature
- File management system
- API endpoints
Made with ❤️ by mdimran.py
Note: This application uses yt-dlp and instaloader libraries. Make sure to keep them updated for the best compatibility with supported platforms.