Metadata-Version: 2.4
Name: savehub-cli
Version: 1.0.0
Summary: Multilingual CLI tool to download videos, audio and images from social media platforms
Author: Sadiq Musayev
License: MIT
Project-URL: Homepage, https://github.com/Sadiq-Musayev/SaveHub-CLI
Project-URL: Repository, https://github.com/Sadiq-Musayev/SaveHub-CLI
Project-URL: Issues, https://github.com/Sadiq-Musayev/SaveHub-CLI/issues
Keywords: youtube,instagram,downloader,cli,mp3,mp4,social-media
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2024.1.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: requests>=2.31.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# SaveHub CLI

**Multilingual social media downloader — MP4 · MP3 · Silent Video**

> Supports: 🇦🇿 Azərbaycanca · 🇬🇧 English · 🇹🇷 Türkçe

---

## Install

```bash
pip install savehub-cli
```

> **Requires Python 3.10+** and [FFmpeg](https://ffmpeg.org/download.html) (for MP3 conversion).

---

## Usage

```bash
savehub-cli
# or
savehub
```

1. Select your language
2. Choose **Start Download Tool**
3. Paste any supported URL
4. Select format: **MP4 · MP3 · Silent Video**
5. Files are saved to the `downloads/` folder

---

## Supported Platforms

| Platform    | Video | Audio | Photo |
|-------------|:-----:|:-----:|:-----:|
| YouTube     | ✅    | ✅    | —     |
| Instagram   | ✅    | ✅    | ✅    |
| Facebook    | ✅    | —     | —     |
| X (Twitter) | ✅    | —     | —     |
| LinkedIn    | ✅    | —     | —     |
| Snapchat    | ✅    | —     | —     |

---

## Download Formats

| Format       | Description                  |
|--------------|------------------------------|
| MP4          | Video + Audio (best quality) |
| MP3          | Audio only (192kbps)         |
| Silent Video | Video only, no audio         |

---

## Controls During Download

| Key | Action         |
|-----|----------------|
| `S` | Pause / Resume |
| `C` | Cancel         |

---

## Requirements

- Python ≥ 3.10
- FFmpeg (for MP3 export) — [Download here](https://ffmpeg.org/download.html)
- Dependencies: `yt-dlp`, `questionary`, `colorama`, `requests`, `python-dotenv`

---

## Logs

All download events are saved in `logs/YYYY-MM-DD.log`.

---

## Contributing

1. Fork the repo
2. Create your branch: `git checkout -b feature/my-feature`
3. Commit: `git commit -m "Add my feature"`
4. Push: `git push origin feature/my-feature`
5. Open a Pull Request

Bug reports and feature requests → [GitHub Issues](https://github.com/Sadiq-Musayev/SaveHub-CLI/issues)

---

## License

[MIT](LICENSE) © 2025 Sadiq Musayev
