Metadata-Version: 2.1
Name: social-media-downloader
Version: 1.0.0
Summary: A versatile downloader for YouTube, TikTok, Instagram, and Facebook.
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
Keywords: downloader,social media downloader,youtube,tiktok,instagram,facebook,video downloader,cli downloader
Classifier: Programming Language :: Python :: 3
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

# Social Media Downloader

## Overview  
**Social Media Downloader** is a versatile tool designed to download videos and posts from popular platforms like YouTube, TikTok, Instagram, and Facebook. It provides an intuitive CLI interface for Windows and Linux users and is also available on PyPI for easy installation via `pip`.  

This tool is intended for **personal use only**. Unauthorized downloading of copyrighted material is prohibited.  

---

## Key Features  
- **Platform Support**:  
  - Download videos from **YouTube**, **TikTok**, and **Facebook**.  
  - Download posts from **Instagram**.  
- **Batch Download**: Download multiple URLs in one go using a text file.  
- **Update Checker**: Keep the software updated with the latest features and fixes.  
- **Customizable**: Configure download directory and format preferences.  
- **Platform Compatibility**:  
  - Windows CLI support with `.exe` file.  
  - Linux CLI support via terminal commands.  
  - Python users can install it using `pip`.  

---

## Installation  

### Option 1: Install via PyPI (Python 3.7+ required)  
```bash
pip install social-media-downloader
```

### Option 2: Download Executable for Windows  
1. Visit the **[Latest Releases](https://github.com/nayandas69/Social-Media-Downloader/releases/latest)** page.  
2. Download the `.exe` file.  
3. Run the executable directly via command prompt or double-click to start.  

### Option 3: Use on Linux  
1. Download the Linux binary from the **[Latest Releases](https://github.com/nayandas69/Social-Media-Downloader/releases/latest)** page.  
2. Extract the downloaded archive:  
   ```bash
   unzip SocialMediaDownloader_latest_Linux.zip  
   ``` 
   or
   ```bash  
   tar -xzvf SocialMediaDownloader_latest_Linux.tar.gz  
   ```  
3. Run the binary:  
   ```bash
   ./SocialMediaDownloader_latest
   ```  

---

## Requirements  
- **FFmpeg**: Required for video/audio conversion.  
  - Install on Linux:  
    ```bash
    sudo apt update
    sudo apt install ffmpeg
    ```  
  - Install on Windows: Download FFmpeg from [ffmpeg.org](https://ffmpeg.org/), add it to your PATH.  

---

## Usage  

### Running the Tool  
For all platforms:  
```bash
social-media-downloader
```  

Alternatively, on Windows:  
```bash
SocialMediaDownloader_latest.exe
```  

### Features and Options  
1. **Download YouTube/TikTok Video**: Provide the video URL to download in your desired format.  
2. **Download Facebook Video**: Enter the video URL to download directly.  
3. **Download Instagram Post**: Provide the Instagram post URL to save it locally.  
4. **Batch Download**: Provide a text file containing URLs (one per line).  
5. **Check for Updates**: Ensure you are using the latest version.  
6. **Help**: Learn more about using the tool.  

---

## Configuration  
Modify the `config.json` file to customize:  
- **Default Download Directory**  
- **Default History File**  
- **Default Format Behavior**  

---

## Example Commands  

### Download YouTube/TikTok Video  
```bash
social-media-downloader
# Select Option 1 and enter the URL
```

### Batch Download  
```bash
social-media-downloader
# Select Option 4 and provide the text file path
```

---

## Logs and History  
- All downloads are logged in `downloader.log`.  
- A detailed history of downloads is saved in `download_history.csv`.  

---

## Disclaimer  
This software is intended for **personal use only**. Downloading content without the permission of the content owner may violate copyright laws. The developer is not responsible for any misuse of this tool.  

---

## Troubleshooting and Support  
If you encounter any issues or have feature requests:  
- Contact the author: **Nayan Das**  
- Email: **nayanchandradas@hotmail.com**  
- Website: [https://socialportal.nayanchandradas.com](https://socialportal.nayanchandradas.com)  
- Report issues on [GitHub Issues](https://github.com/nayandas69/Social-Media-Downloader/issues).  

Enjoy using Social Media Downloader! 🎉  
