Metadata-Version: 2.2
Name: social-media-downloader
Version: 1.0.4
Summary: ✨ Snatch the hottest content from YouTube, TikTok, Instagram, & Facebook effortlessly! 🚀💖 Whether it's viral vids, inspo reels, or iconic memes—this tool's gotchu covered. 🌟🔥
Home-page: https://github.com/nayandas69/Social-Media-Downloader
Author: Nayan Das
Author-email: nayanchandradas@hotmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/nayandas69/Social-Media-Downloader/issues
Project-URL: Documentation, https://github.com/nayandas69/Social-Media-Downloader#readme
Project-URL: Source Code, https://github.com/nayandas69/Social-Media-Downloader
Project-URL: Discord Community, https://discord.gg/skHyssu
Keywords: social media downloader,downloader,youtube downloader,tiktok downloader,instagram downloader,facebook downloader,cli tool,video downloader,content saver
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Internet
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2023.7.6
Requires-Dist: instaloader>=4.10.0
Requires-Dist: beautifulsoup4>=4.12.2
Requires-Dist: tqdm>=4.65.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: flake8>=6.0; extra == "dev"
Requires-Dist: black>=23.1; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<div align="center">  
  <h1>✨ Social Media Downloader v1.0.4 ✨</h1>  
  <p>Your go-to tool for snagging viral vids, reels, and epic posts from YouTube, TikTok, Instagram, and Facebook. 🚀💖</p>  

![Issues](https://img.shields.io/github/issues/nayandas69/Social-Media-Downloader?style=flat-square&color=red&logo=github&logoColor=white)
![Stars](https://img.shields.io/github/stars/nayandas69/Social-Media-Downloader?style=flat-square&color=yellow&logo=github&logoColor=white)
![Forks](https://img.shields.io/github/forks/nayandas69/Social-Media-Downloader?style=flat-square&color=brightgreen&logo=github&logoColor=white)
![Discussions](https://img.shields.io/github/discussions/nayandas69/Social-Media-Downloader?style=flat-square&color=cyan&logo=discourse&logoColor=white)
![Python Version](https://img.shields.io/pypi/pyversions/social-media-downloader?style=flat-square&color=blueviolet&logo=python&logoColor=white)
![Version](https://img.shields.io/pypi/v/social-media-downloader?style=flat-square&color=green&logo=pypi&logoColor=white)
![Downloads](https://img.shields.io/pypi/dm/social-media-downloader?style=flat-square&color=orange&logo=pypi&logoColor=white)
![Total Downloads](https://img.shields.io/pypi/dt/social-media-downloader.svg?style=flat-square&color=purple&logo=pypi&logoColor=white)
</div>  

---

## 🌟 What’s the 411?  
**Social Media Downloader v1.0.4** lets you snatch the juiciest content from:  
- **YouTube** 🎥  
- **TikTok** 🎶  
- **Instagram** 📸  
- **Facebook** 📵  

Whether it’s memes, inspo reels, or iconic videos, this tool is here to SERVE. ⚡

---

## 🔥 Features  

💡 **What’s poppin’ in v1.0.4:**  
- **Smarter vibes only:** Auto-detects when you’re offline (and politely asks you to reconnect 🫡).   
- **Turbo speed:** Faster downloads ‘cause nobody likes waiting. 🏎️💨  
- **MP3 perfection:** Choose audio quality (128, 192, or 320 kbps) for music vibes that match your mood 🎧.  
- **Batch download pro:** Queue up multiple links and let us do the heavy lifting 💪.  
- **Logs/history glow-up:** Full transparency. Every win, every fail—documented like a boss 📝.  

---

## 🚀 How to Download  

### 💻 Windows  
1. **Get Python first:**  
   Download it from [python.org](https://www.python.org/downloads/).  
   - Don’t skip "Add Python to PATH." Check with:  
     ```cmd  
     python --version  
     ```  

2. **Install the downloader:**  
   ```cmd  
   pip install social-media-downloader  
   ```  

3. **Run it like a pro:**  
   ```cmd  
   social-media-downloader  
   ```  
   OR grab the `.exe` from our [releases](https://github.com/nayandas69/Social-Media-Downloader/releases/latest).  

---  

### 🖥️ Linux  
1. Install Python & pip:  
   ```bash  
   sudo apt install python3 python3-pip  # For Ubuntu/Debian  
   sudo dnf install python3 python3-pip  # For Fedora/RHEL  
   sudo pacman -S python python-pip  # For Arch-based  
   ```  

2. Get the downloader:  
   ```bash  
   pip install social-media-downloader  
   ```  

3. Flex your skills:  
   ```bash  
   social-media-downloader  
   ```  

---  

### 🍎 MacOS  
1. Use Homebrew for Python (if not done yet):  
   ```bash  
   brew install python  
   ```  

2. Install the tool:  
   ```bash  
   pip install social-media-downloader  
   ```  

3. Start the party:  
   ```bash  
   social-media-downloader  
   ```  

---

## 🎶 Pro Tip: FFmpeg Setup  

🎧 **Why you need FFmpeg:** Merging, converting, and pure magic.  

- **Windows:** [Download here](https://ffmpeg.org/download.html). Add the `bin` folder to PATH.  
- **Linux:** Install via your package manager:  
  ```bash  
  sudo apt install ffmpeg  # Ubuntu/Debian  
  sudo dnf install ffmpeg  # Fedora/RHEL  
  sudo pacman -S ffmpeg  # Arch-based  
  ```  
- **MacOS:**  
  ```bash  
  brew install ffmpeg  
  ```  

---

## 📋 Usage 101  

### **One Download at a Time**:  
Run the tool and drop your link:  
```bash  
social-media-downloader  
```  

### **Batch Download (for the multitaskers 💼)**:  
Add URLs (one per line) in a text file:  
```bash  
social-media-downloader -batch my_urls.txt  
```  

---

## 💡 Customize It  

Modify `config.json` to:  
- Change default directories.  
- Adjust MP3 download quality.  
- Customize batch downloads.  

---

## 📜 Logs + Receipts  

- Logs? Peep `downloader.log` for all the tea (successes AND errors).  
- Download history? Check `download_history.csv`.   

---

## ⚡ Legal Disclaimer  

> 🛑 **Heads up:**  
This tool is for **personal use only.** Download responsibly! Don’t break the law, fam. 🙏  

---

## 🙌 Wanna Join the Squad?  

- **Report issues**: [Log ‘em here](https://github.com/nayandas69/Social-Media-Downloader/issues).  
- **Wanna code?** Fork it, slay it, and PR it.  
- **Discuss with the fam**: [Hit us up here](https://github.com/nayandas69/Social-Media-Downloader/discussions).  

---  

<div align="center">  
  <h3>💾 Grab It. Save It. Flex It. 💾</h3>  
  <p>✨ The internet’s greatest hits, all in your pocket. ✨</p>  
</div>
