SocialDL 📥

A simple and user-friendly command-line tool to download videos and audio from YouTube and other supported platforms using yt-dlp.

✨ Features

• 🎥 Download videos in best quality
• 🎯 Choose specific video resolution
• 🎵 Extract audio only (MP3 format)
• 📁 Automatically saves to Downloads folder
• 🚀 Clean and intuitive interface

📋 Prerequisites

• Python 3.7 or higher
• FFmpeg (required for audio extraction and video merging)

Installing FFmpeg

Windows:

# Using Chocolatey
choco install ffmpeg

# Or download from: https://ffmpeg.org/download.html

macOS:

brew install ffmpeg

Linux:

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# For other distributions, use your package manager or visit: https://ffmpeg.org/download.html

🚀 Installation

1. Clone this repository:

git clone https://github.com/emircanmurat/SocialDL.git
cd SocialDL

2. Install required Python packages:

pip install -r requirements.txt

💻 Usage

Run the script:

python main.py

Follow the interactive prompts:

1. Enter the video URL
2. Choose download option:
   • Option 1: Download best quality video
   • Option 2: Select specific resolution
   • Option 3: Download audio only (MP3)

Example

Enter video URL: https://youtube.com/watch?v=example
Title: Example Video

What would you like to download?
1) Best quality video
2) Choose specific resolution (available: 1080p, 720p, 480p, 360p)
3) Audio only (mp3)
Choice (1/2/3): 1

Downloading best quality video…
Download completed ✅

🌐 Supported Platforms

This tool supports all platforms compatible with yt-dlp, including:

• YouTube
• Vimeo
• Dailymotion
• Twitter/X
• Facebook
• Instagram
• And many more

📂 Output Location

All downloaded files are saved to your default Downloads folder:

• Windows: C:\Users\YourUsername\Downloads
• macOS/Linux: ~/Downloads

🔧 Troubleshooting

"FFmpeg not found" error:

• Make sure FFmpeg is installed and added to your system PATH

Download fails:

• Check your internet connection
• Verify the URL is correct and accessible
• Some videos may be restricted or require authentication

Import error:

• Ensure all dependencies are installed: pip install -r requirements.txt

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

📜 License

This project is open source and available under the MIT License.

⚠️ Disclaimer

This tool is for personal use only. Please respect copyright laws and the terms of service of the platforms you download from. Only download content you have the right to access.

🙏 Acknowledgments

Built with yt-dlp - A youtube-dl fork with additional features and fixes.