savehub-cli 1.0.0__tar.gz

savehub_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sadiq Musayev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

savehub_cli-1.0.0/PKG-INFO

@@ -0,0 +1,126 @@
+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

savehub_cli-1.0.0/README.md

@@ -0,0 +1,95 @@
+# 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

savehub_cli-1.0.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "savehub-cli"
+version = "1.0.0"
+description = "Multilingual CLI tool to download videos, audio and images from social media platforms"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Sadiq Musayev" }
+]
+keywords = ["youtube", "instagram", "downloader", "cli", "mp3", "mp4", "social-media"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "yt-dlp>=2024.1.0",
+    "questionary>=2.0.0",
+    "colorama>=0.4.6",
+    "requests>=2.31.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+savehub-cli = "savehub_cli.main:main"
+savehub     = "savehub_cli.main:main"
+
+[project.urls]
+Homepage   = "https://github.com/Sadiq-Musayev/SaveHub-CLI"
+Repository = "https://github.com/Sadiq-Musayev/SaveHub-CLI"
+Issues     = "https://github.com/Sadiq-Musayev/SaveHub-CLI/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"savehub_cli" = ["py.typed"]

savehub_cli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

savehub_cli-1.0.0/src/savehub_cli/__init__.py

@@ -0,0 +1,8 @@
+"""
+SaveHub CLI - Multilingual Social Media Downloader
+Supports: Azərbaycanca (AZ), English (EN), Türkçe (TR)
+"""
+
+__version__ = "1.0.0"
+__author__ = "Sadiq Musayev"
+__license__ = "MIT"

savehub_cli-1.0.0/src/savehub_cli/config.py

@@ -0,0 +1,25 @@
+# SaveHub CLI - Configuration
+
+LANGUAGES = ['AZ', 'EN', 'TR']
+
+PLATFORM_CONFIG = {
+    'YouTube':   {'patterns': ['youtube.com', 'youtu.be'],    'supports': ['video', 'playlist', 'audio']},
+    'Instagram': {'patterns': ['instagram.com'],               'supports': ['video', 'photo']},
+    'Facebook':  {'patterns': ['facebook.com', 'fb.watch'],   'supports': ['video']},
+    'Twitter/X': {'patterns': ['twitter.com', 'x.com'],       'supports': ['video', 'gif']},
+    'LinkedIn':  {'patterns': ['linkedin.com'],                'supports': ['video']},
+    'Snapchat':  {'patterns': ['snapchat.com'],                'supports': ['video']},
+}
+
+FORMAT_SETTINGS = {
+    'date_format':        '%Y-%m-%d',
+    'time_format':        '%H:%M:%S',
+    'log_filename_format': '%Y-%m-%d',
+}
+
+DOWNLOAD_SETTINGS = {
+    'output_dir':     'downloads',
+    'log_dir':        'logs',
+    'mp3_quality':    '192',
+    'default_format': 'mp4',
+}

savehub_cli-1.0.0/src/savehub_cli/main.py

@@ -0,0 +1,73 @@
+"""
+SaveHub CLI - Main Entry Point
+Multilingual Multimedia Downloader
+Supports: Azərbaycanca (AZ), English (EN), Türkçe (TR)
+"""
+
+import sys
+import os
+from pathlib import Path
+
+
+def main():
+    """Main application entry point — called by pip-installed console script."""
+
+    # Ensure working directories exist in user's CWD (not package dir)
+    Path('downloads').mkdir(exist_ok=True)
+    Path('logs').mkdir(exist_ok=True)
+
+    from savehub_cli.modules.menu import select_language, show_main_menu, display_header
+    from savehub_cli.modules.menu import show_documentation, show_terms, show_feedback
+    from savehub_cli.modules.downloader import start_download
+    from savehub_cli.translations import get_text
+
+    try:
+        language = select_language()
+
+        while True:
+            os.system('cls' if os.name == 'nt' else 'clear')
+            display_header(language)
+
+            choice = show_main_menu(language)
+
+            if choice == 'option_docs':
+                os.system('cls' if os.name == 'nt' else 'clear')
+                show_documentation(language)
+                input(f"\n{get_text('press_enter', language)}")
+
+            elif choice == 'option_terms':
+                os.system('cls' if os.name == 'nt' else 'clear')
+                show_terms(language)
+                input(f"\n{get_text('press_enter', language)}")
+
+            elif choice == 'option_feedback':
+                os.system('cls' if os.name == 'nt' else 'clear')
+                show_feedback(language)
+                input(f"\n{get_text('press_enter', language)}")
+
+            elif choice == 'option_start':
+                start_download(language)
+
+            elif choice == 'option_exit':
+                os.system('cls' if os.name == 'nt' else 'clear')
+                print(f"\n{get_text('goodbye', language)}")
+                print(f"{get_text('see_you', language)}\n")
+                break
+
+    except (KeyboardInterrupt, EOFError):
+        print("\n\n👋 Goodbye!")
+        sys.exit(0)
+    except Exception as e:
+        import traceback
+        log_msg = traceback.format_exc()
+        try:
+            from savehub_cli.modules.utils import log_event
+            log_event(f"Unhandled exception: {log_msg}", 'ERROR')
+        except Exception:
+            pass
+        print("\n❌ Unexpected error occurred. Check logs for details.")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

savehub_cli-1.0.0/src/savehub_cli/modules/__init__.py

@@ -0,0 +1,12 @@
+"""
+SaveHub CLI - Modules Package
+"""
+
+__version__ = '1.0.0'
+__author__ = 'Sadiq Musayev'
+
+from . import downloader
+from . import menu
+from . import utils
+
+__all__ = ['downloader', 'menu', 'utils']