savehub-cli 1.0.0__py3-none-any.whl

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/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/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/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']

savehub_cli/modules/downloader.py

@@ -0,0 +1,415 @@
+"""
+SaveHub CLI - Download Module
+Uses yt-dlp for multimedia downloading
+Database-ready download logging structure
+"""
+
+import os
+import sys
+import threading
+import time
+from datetime import datetime
+from questionary import text as questionary_text, select
+import yt_dlp
+from savehub_cli.translations import get_text
+import logging
+from savehub_cli.modules.utils import validate_url, get_platform_from_url, log_event
+
+# Suppress all console log output — logs go to file only
+logging.getLogger().setLevel(logging.CRITICAL)
+
+
+# ─────────────────────────────────────────────
+# Database-ready download record structure
+# TODO: Replace with actual DB insert when DB is connected
+# ─────────────────────────────────────────────
+def create_download_record(url, platform, format_type, filename, status,
+                           error=None, duration_sec=None, file_size_bytes=None):
+    """
+    Creates a structured download record.
+    Ready to be inserted into a database table:
+
+    Table: downloads
+    ┌──────────────────┬──────────────┐
+    │ Column           │ Type         │
+    ├──────────────────┼──────────────┤
+    │ id               │ INTEGER PK   │
+    │ url              │ TEXT         │
+    │ platform         │ TEXT         │
+    │ format_type      │ TEXT         │
+    │ filename         │ TEXT         │
+    │ status           │ TEXT         │
+    │ error            │ TEXT NULL    │
+    │ duration_sec     │ REAL NULL    │
+    │ file_size_bytes  │ INTEGER NULL │
+    │ created_at       │ DATETIME     │
+    └──────────────────┴──────────────┘
+    """
+    record = {
+        'url':             url,
+        'platform':        platform,
+        'format_type':     format_type,
+        'filename':        filename,
+        'status':          status,        # 'success' | 'failed' | 'paused' | 'cancelled'
+        'error':           error,
+        'duration_sec':    duration_sec,
+        'file_size_bytes': file_size_bytes,
+        'created_at':      datetime.now().isoformat(),
+    }
+
+    # TODO: db.insert('downloads', record)
+    log_event(f"[DB_RECORD] {record}")
+    return record
+
+
+# ─────────────────────────────────────────────
+# Download state manager — pause / stop / cancel
+# ─────────────────────────────────────────────
+class DownloadController:
+    """
+    Thread-safe controller for pause / resume / cancel.
+
+    States:
+      running   → download in progress
+      paused    → download suspended (S key)
+      cancelled → user chose to terminate (C key)
+    """
+
+    def __init__(self):
+        self._state = 'running'
+        self._lock  = threading.Lock()
+
+    @property
+    def is_paused(self):
+        with self._lock:
+            return self._state == 'paused'
+
+    @property
+    def is_cancelled(self):
+        with self._lock:
+            return self._state == 'cancelled'
+
+    @property
+    def is_running(self):
+        with self._lock:
+            return self._state == 'running'
+
+    @property
+    def state(self):
+        with self._lock:
+            return self._state
+
+    def pause(self):
+        with self._lock:
+            if self._state == 'running':
+                self._state = 'paused'
+
+    def resume(self):
+        with self._lock:
+            if self._state == 'paused':
+                self._state = 'running'
+
+    def cancel(self):
+        with self._lock:
+            self._state = 'cancelled'
+
+    def toggle_pause(self):
+        with self._lock:
+            if self._state == 'running':
+                self._state = 'paused'
+            elif self._state == 'paused':
+                self._state = 'running'
+
+
+# ─────────────────────────────────────────────
+# Keyboard listener thread (cross-platform)
+# ─────────────────────────────────────────────
+def _start_key_listener(controller: DownloadController):
+    """
+    Listens for keypresses in a background thread:
+      S / s  → pause / resume
+      C / c  → cancel
+    Works on Windows (msvcrt) and Unix (tty/termios).
+    """
+    def _listen():
+        if sys.platform == 'win32':
+            import msvcrt
+            while not controller.is_cancelled:
+                if msvcrt.kbhit():
+                    key = msvcrt.getwch().lower()
+                    if key == 's':
+                        controller.toggle_pause()
+                    elif key == 'c':
+                        controller.cancel()
+                        break
+                time.sleep(0.05)
+        else:
+            import tty
+            import termios
+            fd  = sys.stdin.fileno()
+            old = termios.tcgetattr(fd)
+            try:
+                tty.setraw(fd)
+                while not controller.is_cancelled:
+                    ch = sys.stdin.read(1).lower()
+                    if ch == 's':
+                        controller.toggle_pause()
+                    elif ch == 'c':
+                        controller.cancel()
+                        break
+            finally:
+                termios.tcsetattr(fd, termios.TCSADRAIN, old)
+
+    t = threading.Thread(target=_listen, daemon=True)
+    t.start()
+    return t
+
+
+# ─────────────────────────────────────────────
+# Progress bar with pause/cancel controls
+# ─────────────────────────────────────────────
+class ProgressBar:
+    """
+    Clean terminal progress bar.
+    Shows controls:  [S] Stop/Resume   [C] Cancel
+    """
+
+    BAR_WIDTH = 34
+
+    def __init__(self, controller: DownloadController):
+        self.controller   = controller
+        self.current_item = 0
+        self.total_items  = 1
+        self._last_line   = ''
+
+    def hook(self, d):
+        while self.controller.is_paused:
+            self._render(paused=True)
+            time.sleep(0.3)
+
+        if self.controller.is_cancelled:
+            raise yt_dlp.utils.DownloadCancelled()
+
+        if d['status'] == 'downloading':
+            raw = d.get('_percent_str', '0%').strip()
+            raw = ''.join(c for c in raw if c.isdigit() or c in '.%')
+            try:
+                percent = float(raw.replace('%', ''))
+            except ValueError:
+                percent = 0.0
+
+            speed = d.get('_speed_str', '').strip() or '?'
+            eta   = d.get('_eta_str',   '').strip() or '?'
+            size  = d.get('_total_bytes_str',
+                          d.get('_total_bytes_estimate_str', '?')).strip()
+
+            self._render(percent=percent, speed=speed, eta=eta, size=size)
+
+        elif d['status'] == 'finished':
+            print()
+
+    def _render(self, percent=0.0, speed='', eta='', size='', paused=False):
+        filled = int(self.BAR_WIDTH * percent / 100)
+        bar    = '█' * filled + '░' * (self.BAR_WIDTH - filled)
+
+        item_info = (
+            f" [{self.current_item}/{self.total_items}]"
+            if self.total_items > 1 else ""
+        )
+
+        if paused:
+            status_icon = '⏸ PAUSED '
+            right        = '  [S] Resume   [C] Cancel'
+        else:
+            status_icon = '▶ '
+            right        = '  [S] Stop   [C] Cancel'
+
+        line = (
+            f"\r  {status_icon}{bar} {percent:5.1f}%"
+            f"  {size}  {speed}  ETA {eta}{item_info}{right}   "
+        )
+        print(line, end='', flush=True)
+        self._last_line = line
+
+
+def show_format_menu(lang='en'):
+    """Show format selection menu"""
+    if lang == 'az':
+        choices = [
+            '1️⃣  MP4 (Video+Audio) - Səs və video ilə indir',
+            '2️⃣  MP3 (Səs) - Yalnız səs indir',
+            '3️⃣  Silent Video - Yalnız video (səssiz) indir',
+        ]
+    elif lang == 'tr':
+        choices = [
+            '1️⃣  MP4 (Video+Ses) - Ses ve video ile indir',
+            '2️⃣  MP3 (Ses) - Sadece ses indir',
+            '3️⃣  Sessiz Video - Sadece video indir (ses yok)',
+        ]
+    else:
+        choices = [
+            '1️⃣  MP4 (Video+Audio) - Download with audio and video',
+            '2️⃣  MP3 (Audio) - Download audio only',
+            '3️⃣  Silent Video - Download video only (no audio)',
+        ]
+
+    answer = select(
+        get_text('select_format', lang),
+        choices=choices,
+        use_arrow_keys=True
+    ).ask()
+
+    if answer is None:
+        return 'mp4'
+    if '1️⃣' in answer:
+        return 'mp4'
+    elif '2️⃣' in answer:
+        return 'mp3'
+    else:
+        return 'silent'
+
+
+def download_media(url: str, format_type: str, lang: str = 'en') -> bool:
+    """Download media from URL with pause/resume/cancel support."""
+
+    if not validate_url(url):
+        msgs = {'az': '❌ Düzgün olmayan URL formatı!',
+                'tr': '❌ Geçersiz URL formatı!'}
+        print(f"\n{msgs.get(lang, '❌ Invalid URL format!')}")
+        return False
+
+    platform = get_platform_from_url(url)
+    if not platform:
+        msgs = {'az': '❌ Dəstəkləməyən platforma!',
+                'tr': '❌ Desteklenmeyen platform!'}
+        print(f"\n{msgs.get(lang, '❌ Unsupported platform!')}")
+        return False
+
+    print(f"\n  Platform : {platform}")
+    print(f"  Format   : {format_type.upper()}")
+    print(f"  {get_text('downloading', lang)}")
+    print(f"  Controls : [S] Stop/Resume   [C] Cancel\n")
+
+    os.makedirs('downloads', exist_ok=True)
+
+    controller  = DownloadController()
+    progress    = ProgressBar(controller)
+    saved_files = []
+    start_time  = time.time()
+
+    _start_key_listener(controller)
+
+    ydl_opts = {
+        'outtmpl':        'downloads/%(title)s.%(ext)s',
+        'quiet':          True,
+        'no_warnings':    True,
+        'noprogress':     True,
+        'progress_hooks': [progress.hook],
+    }
+
+    if format_type == 'mp4':
+        ydl_opts['format'] = 'best[ext=mp4]/best'
+    elif format_type == 'mp3':
+        ydl_opts['format'] = 'bestaudio/best'
+        ydl_opts['postprocessors'] = [{
+            'key':              'FFmpegExtractAudio',
+            'preferredcodec':   'mp3',
+            'preferredquality': '192',
+        }]
+    elif format_type == 'silent':
+        ydl_opts['format'] = 'bestvideo[ext=mp4]/bestvideo'
+
+    info_opts = dict(ydl_opts)
+    info_opts['quiet']          = True
+    info_opts['no_warnings']    = True
+    info_opts['extract_flat']   = 'in_playlist'
+    info_opts['progress_hooks'] = []
+
+    try:
+        with yt_dlp.YoutubeDL(info_opts) as ydl_info:
+            meta = ydl_info.extract_info(url, download=False)
+            if meta and 'entries' in meta:
+                entries = [e for e in meta['entries'] if e]
+                progress.total_items = len(entries)
+                print(f"  Playlist : {meta.get('title', '')}  ({progress.total_items} items)\n")
+            else:
+                progress.total_items = 1
+
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(url, download=True)
+
+            if 'entries' in info:
+                for entry in info['entries']:
+                    if entry:
+                        saved_files.append(ydl.prepare_filename(entry))
+            else:
+                saved_files.append(ydl.prepare_filename(info))
+
+        duration     = round(time.time() - start_time, 2)
+        download_dir = os.path.abspath('downloads')
+
+        print(f"\n  ✅ {get_text('download_complete', lang)}")
+        print(f"  📂 {download_dir}")
+        if len(saved_files) == 1:
+            fname = saved_files[0]
+            fsize = os.path.getsize(fname) if os.path.exists(fname) else None
+            print(f"  📄 {os.path.basename(fname)}")
+            if fsize:
+                print(f"  💾 {fsize / (1024*1024):.2f} MB  ⏱ {duration}s")
+            create_download_record(url, platform, format_type, fname,
+                                   'success', duration_sec=duration,
+                                   file_size_bytes=fsize)
+        else:
+            print(f"  📄 {len(saved_files)} files saved  ⏱ {duration}s")
+            for f in saved_files:
+                fsize = os.path.getsize(f) if os.path.exists(f) else None
+                create_download_record(url, platform, format_type, f,
+                                       'success', duration_sec=duration,
+                                       file_size_bytes=fsize)
+
+        log_event(f"Download completed: {len(saved_files)} file(s) from {platform} in {duration}s")
+        return True
+
+    except (yt_dlp.utils.DownloadCancelled, KeyboardInterrupt):
+        controller.cancel()
+        print(f"\n\n  🚫 {get_text('download_cancelled', lang)}")
+        create_download_record(url, platform, format_type, '', 'cancelled')
+        log_event(f"Download cancelled: {url}")
+        return False
+
+    except Exception as e:
+        print(f"\n  ❌ {get_text('error_download', lang)}: {str(e)}")
+        create_download_record(url, platform, format_type, '', 'failed', error=str(e))
+        log_event(f"Download error: {str(e)}", 'ERROR')
+        return False
+
+
+def start_download(lang: str = 'en') -> None:
+    """Start download process"""
+    os.system('cls' if os.name == 'nt' else 'clear')
+
+    print("\n" + "=" * 50)
+    print(f"  ▶️  {get_text('welcome', lang)}")
+    print("=" * 50 + "\n")
+
+    url = questionary_text(
+        get_text('enter_url', lang),
+        validate=lambda x: len(x.strip()) > 5 or get_text('error_invalid_url', lang)
+    ).ask()
+
+    if not url or not url.strip():
+        print(f"\n  ❌ {get_text('error_no_url', lang)}")
+        try:
+            input(f"\n{get_text('press_enter', lang)}")
+        except (EOFError, KeyboardInterrupt):
+            pass
+        return
+
+    url         = url.strip()
+    format_type = show_format_menu(lang)
+    download_media(url, format_type, lang)
+
+    try:
+        input(f"\n{get_text('press_enter', lang)}")
+    except (EOFError, KeyboardInterrupt):
+        pass

savehub_cli/modules/menu.py

@@ -0,0 +1,348 @@
+"""
+SaveHub CLI - Interactive Menu Module
+Supports: Azərbaycanca, English, Türkçe
+"""
+
+import os
+from questionary import select
+from savehub_cli.translations import get_text
+
+
+def clear_screen():
+    """Clear terminal screen"""
+    os.system('cls' if os.name == 'nt' else 'clear')
+
+
+def display_header(lang='en'):
+    """Display ASCII art header"""
+    header = """
+        ███████╗ █████╗ ██╗   ██╗███████╗██╗  ██╗██╗   ██╗██████╗ 
+        ██╔════╝██╔══██╗██║   ██║██╔════╝██║  ██║██║   ██║██╔══██╗
+        ███████╗███████║██║   ██║█████╗  ███████║██║   ██║██████╔╝
+        ╚════██╗██╔══██║╚██╗ ██╔╝██╔══╝  ██╔══██║██║   ██║██╔══██╗
+        ███████║██║  ██║ ╚████╔╝ ███████╗██║  ██║╚██████╔╝██████╔╝
+        ╚══════╝╚═╝  ╚═╝  ╚═══╝  ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝
+        """
+    print(header)
+    print("[Version 1.0.0] - Made with ❤️  by Sadiq Musayev\n")
+
+
+def select_language():
+    """Language selection menu"""
+    print("\n" + "=" * 50)
+    print("🌍 SELECT YOUR LANGUAGE / DİLİNİZİ SEÇİN / DİLİ SEÇİN")
+    print("=" * 50 + "\n")
+
+    choices = [
+        '🇦🇿 Azərbaycanca',
+        '🇬🇧 English',
+        '🇹🇷 Türkçe'
+    ]
+
+    answer = select(
+        'Language / Dil / Dil:',
+        choices=choices,
+        use_arrow_keys=True,
+        use_indicator=True
+    ).ask()
+
+    if 'Azərbaycanca' in answer:
+        return 'az'
+    elif 'English' in answer:
+        return 'en'
+    else:
+        return 'tr'
+
+
+_OPTION_KEYS = ['option_docs', 'option_terms', 'option_feedback', 'option_start', 'option_exit']
+
+
+def show_main_menu(lang='en'):
+    """
+    Main menu display.
+    Returns the internal option key string (e.g. 'option_start')
+    so that main.py can match on it reliably — regardless of language.
+    """
+    label_to_key = {get_text(key, lang): key for key in _OPTION_KEYS}
+
+    answer = select(
+        get_text('main_menu_question', lang),
+        choices=list(label_to_key.keys()),
+        use_arrow_keys=True,
+        use_indicator=True
+    ).ask()
+
+    return label_to_key.get(answer, answer)
+
+
+def show_documentation(lang='en'):
+    """Display documentation"""
+    if lang == 'az':
+        doc_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║           📚 SAVEHUB CLI - İSTİFADƏÇİ KƏLAVUZu           ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    🎥 DƏSTƏKLƏNƏN PLATFORMALAR:
+       • YouTube - Videolar və playlist
+       • Instagram - Foto və videolar
+       • Facebook - Videolar
+       • X (Twitter) - Videolar və GIF
+       • LinkedIn - Videolar
+       • Snapchat - Videolar
+
+    📊 FORMAT SEÇİMLƏRİ:
+       • MP4 (Video+Audio) - Səs və video ilə indir
+       • MP3 (Səs) - Yalnız səs indir
+       • Silent Video - Yalnız video (səssiz) indir
+
+    ⚙️ NECƏ İSTİFADƏ EDƏCƏKSINIZ:
+       1. "Endirmə aləti başlat" seçin
+       2. Media linkini daxil edin
+       3. Formatı seçin
+       4. Yükləmə avtomatik başlanacaq
+       5. Fayllar 'downloads' qovluğunda saxlanılır
+
+    🔒 XƏBƏRDARLIQLAR:
+       • Yalnız qanuni məqsədlər üçün istifadə edin
+       • Müəlliflik hüquqlarına hörmət edin
+       • Başqasının kontentini paylaşmayın
+
+    📁 LOGLAR:
+       • Bütün əməliyyatlar 'logs' qovluğunda saxlanılır
+       • Tarih və vaxt ilə adlandırılmış fayllar
+            """
+    elif lang == 'tr':
+        doc_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║          📚 SAVEHUB CLI - KULLANICI KILAVUZu             ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    🎥 DESTEKLENEN PLATFORMLAR:
+       • YouTube - Videolar ve oynatma listeleri
+       • Instagram - Fotoğraflar ve videolar
+       • Facebook - Videolar
+       • X (Twitter) - Videolar ve GIF'ler
+       • LinkedIn - Videolar
+       • Snapchat - Videolar
+
+    📊 FORMAT SEÇENEKLERİ:
+       • MP4 (Video+Ses) - Ses ve video ile indir
+       • MP3 (Ses) - Sadece ses indir
+       • Sessiz Video - Sadece video indir (ses yok)
+
+    ⚙️ NASIL KULLANILIR:
+       1. "İndirme Aracını Başlat" seçin
+       2. Medya linkini girin
+       3. Formatı seçin
+       4. İndirme otomatik başlayacak
+       5. Dosyalar 'downloads' klasöründe kaydedilir
+
+    🔒 UYARILAR:
+       • Sadece yasal amaçlar için kullanın
+       • Telif haklarına saygı gösterin
+       • Başkasının içeriğini paylaşmayın
+
+    📁 KAYITLAR:
+       • Tüm işlemler 'logs' klasöründe kaydedilir
+       • Tarih ve saat ile adlandırılmış dosyalar
+            """
+    else:
+        doc_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║              📚 SAVEHUB CLI - USER GUIDE                 ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    🎥 SUPPORTED PLATFORMS:
+       • YouTube - Videos and playlists
+       • Instagram - Photos and videos
+       • Facebook - Videos
+       • X (Twitter) - Videos and GIFs
+       • LinkedIn - Videos
+       • Snapchat - Videos
+
+    📊 DOWNLOAD FORMATS:
+       • MP4 (Video+Audio) - Download with audio and video
+       • MP3 (Audio) - Download audio only
+       • Silent Video - Download video only (no audio)
+
+    ⚙️ HOW TO USE:
+       1. Select "Start Download Tool"
+       2. Enter media URL
+       3. Select format
+       4. Download will start automatically
+       5. Files will be saved in 'downloads' folder
+
+    🔒 WARNINGS:
+       • Use only for legal purposes
+       • Respect copyright rights
+       • Do not share others' content
+
+    📁 LOGS:
+       • All operations are saved in 'logs' folder
+       • Files are named with date and time
+            """
+
+    print(doc_text)
+
+
+def show_terms(lang='en'):
+    """Display terms of use"""
+    if lang == 'az':
+        terms_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║                📋 İSTİFADƏ ŞƏRTLƏRI                     ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    1. 🔒 HÜQUQI MƏSULIYYƏT
+       SaveHub CLI yalnız qanuni və şəxsi məqsədlər üçün
+       istifadə edilməlidir.
+
+    2. 📋 PLATFORM QANUNLARI
+       Hər platformanın öz şərtləri vardır. Platformaların
+       şərtlərinə riayət edin.
+
+    3. ⚖️ MƏSULIYYƏT REDDI
+       Müəlliflik hüquqları orijinal müəllifə aiddir.
+       SaveHub yaradıcı deyil, yardımçıdır.
+
+    4. 🚫 MƏHDUDIYYƏTLƏR
+       • Kütləvi endirmə qadağandır
+       • Kommersial məqsədlərlə istifadə qadağandır
+       • Başqasının kontentini paylaşmaq qadağandır
+
+    5. ✅ QƏBUL
+       Bu proqramı istifadə edərək şərtləri qəbul edirsiniz.
+            """
+    elif lang == 'tr':
+        terms_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║              📋 KULLANIM ŞARTLARI                        ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    1. 🔒 YASAL SORUMLULUK
+       SaveHub CLI sadece yasal ve kişisel amaçlar için
+       kullanılmalıdır.
+
+    2. 📋 PLATFORM YASALARI
+       Her platformanın kendi şartları vardır. Platform
+       şartlarına uyun.
+
+    3. ⚖️ SORUMLULUK REDDI
+       Telif hakları orijinal sahibine aittir.
+       SaveHub yaratıcı değil, kolaylaştırıcıdır.
+
+    4. 🚫 KISITLAMALAR
+       • Toplu indirme yasaktır
+       • Ticari amaçla kullanım yasaktır
+       • Başkasının içeriğini paylaşmak yasaktır
+
+    5. ✅ KABUL
+       Bu programı kullanarak şartları kabul edersiniz.
+            """
+    else:
+        terms_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║               📋 TERMS OF USE                            ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    1. 🔒 LEGAL RESPONSIBILITY
+       SaveHub CLI should only be used for legal and
+       personal purposes.
+
+    2. 📋 PLATFORM LAWS
+       Each platform has its own terms. Comply with
+       platform terms.
+
+    3. ⚖️ DISCLAIMER
+       Copyright rights belong to the original author.
+       SaveHub is a facilitator, not a creator.
+
+    4. 🚫 RESTRICTIONS
+       • Bulk downloading is prohibited
+       • Commercial use is prohibited
+       • Sharing others' content is prohibited
+
+    5. ✅ ACCEPTANCE
+       By using this program, you accept these terms.
+            """
+
+    print(terms_text)
+
+
+def show_feedback(lang='en'):
+    """Display feedback information"""
+    if lang == 'az':
+        feedback_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║                   💬 RƏY GÖNDƏR                          ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    Sizin fikirləriniz bizə çox maraqlıdır!
+
+    📧 ƏLAQƏ YOLLARI:
+
+       1️⃣  GitHub Issues
+          https://github.com/Sadiq-Musayev/SaveHub-CLI/issues
+
+       2️⃣  GitHub Repository
+          https://github.com/Sadiq-Musayev/SaveHub-CLI
+
+    💡 MÜŞTƏRƏK OLMAQ İÇƏN:
+       • Xətaları bildir
+       • Yeni xüsusiyyətlər təklif et
+       • Kodda dəyişikliklər göndər
+       • Sənədləşməni yaxşılaşdır
+
+    Sizin dəstəyiniz üçün təşəkkürlər! ❤️
+            """
+    elif lang == 'tr':
+        feedback_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║               💬 GERİ BİLDİRİM GÖNDER                   ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    Görüşleriniz bize çok önemli!
+
+    📧 İLETİŞİM YOLLARI:
+
+       1️⃣  GitHub Issues
+          https://github.com/Sadiq-Musayev/SaveHub-CLI/issues
+
+       2️⃣  GitHub Repository
+          https://github.com/Sadiq-Musayev/SaveHub-CLI
+
+    🤝 KATKIDA BULUNMAK İÇİN:
+       • Hataları bildir
+       • Yeni özellikler öner
+       • Kodda değişiklikler gönder
+       • Belgeleri iyileştir
+
+    Desteğiniz için teşekkür ederiz! ❤️
+            """
+    else:
+        feedback_text = """
+    ╔════════════════════════════════════════════════════════════╗
+    ║                 💬 SEND FEEDBACK                         ║
+    ╚════════════════════════════════════════════════════════════╝
+
+    Your opinions are very important to us!
+
+    📧 CONTACT WAYS:
+
+       1️⃣  GitHub Issues
+          https://github.com/Sadiq-Musayev/SaveHub-CLI/issues
+
+       2️⃣  GitHub Repository
+          https://github.com/Sadiq-Musayev/SaveHub-CLI
+
+    🤝 HOW TO CONTRIBUTE:
+       • Report bugs
+       • Suggest new features
+       • Submit code changes
+       • Improve documentation
+
+    Thank you for your support! ❤️
+            """
+
+    print(feedback_text)

savehub_cli/modules/utils.py

@@ -0,0 +1,85 @@
+"""
+SaveHub CLI - Utilities Module
+"""
+
+import re
+import logging
+from datetime import datetime
+from pathlib import Path
+
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger(__name__)
+
+SUPPORTED_PLATFORMS = {
+    'YouTube':    [r'(youtube\.com|youtu\.be)'],
+    'Instagram':  [r'instagram\.com'],
+    'Facebook':   [r'(facebook\.com|fb\.watch)'],
+    'Twitter/X':  [r'(twitter\.com|x\.com)'],
+    'LinkedIn':   [r'linkedin\.com'],
+    'Snapchat':   [r'snapchat\.com'],
+}
+
+
+def validate_url(url: str) -> bool:
+    """Validates whether the given string is a properly formatted URL."""
+    if not url or not isinstance(url, str):
+        return False
+    regex = re.compile(
+        r'^https?://'
+        r'(?:(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+[A-Z]{2,6}\.?|'
+        r'localhost|'
+        r'\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})'
+        r'(?::\d+)?'
+        r'(?:/?|[/?]\S+)$',
+        re.IGNORECASE
+    )
+    return re.match(regex, url) is not None
+
+
+def is_valid_url(url: str) -> bool:
+    """Alias for validate_url (backward compatibility)."""
+    return validate_url(url)
+
+
+def get_platform_from_url(url: str) -> str | None:
+    """Detects which supported platform a URL belongs to."""
+    if not url:
+        return None
+    for platform, patterns in SUPPORTED_PLATFORMS.items():
+        for pattern in patterns:
+            if re.search(pattern, url, re.IGNORECASE):
+                return platform
+    return None
+
+
+def log_event(message: str, level: str = 'INFO') -> None:
+    """Logs an event to console and to a dated log file."""
+    level = level.upper()
+    if level == 'ERROR':
+        logger.error(message)
+    elif level == 'WARNING':
+        logger.warning(message)
+    else:
+        logger.info(message)
+
+    try:
+        Path('logs').mkdir(exist_ok=True)
+        log_filename = f"logs/{datetime.now().strftime('%Y-%m-%d')}.log"
+        timestamp    = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+        with open(log_filename, 'a', encoding='utf-8') as f:
+            f.write(f"[{timestamp}] [{level}] {message}\n")
+    except OSError as e:
+        logger.warning(f"Could not write to log file: {e}")
+
+
+def log_message(message: str) -> None:
+    """Alias for log_event (backward compatibility)."""
+    log_event(message)
+
+
+def helper_function():
+    """Placeholder helper function for future use."""
+    pass

savehub_cli/translations.py

@@ -0,0 +1,119 @@
+"""
+SaveHub CLI - Translations Module
+Supports: Azərbaycanca (AZ), English (EN), Türkçe (TR)
+"""
+
+TRANSLATIONS = {
+    'hello': {
+        'en': 'Hello',
+        'az': 'Salam',
+        'tr': 'Merhaba'
+    },
+    'goodbye': {
+        'en': 'Goodbye',
+        'az': 'Sağol',
+        'tr': 'Hoşça kal'
+    },
+    'thank_you': {
+        'en': 'Thank you',
+        'az': 'Təşəkkür edirəm',
+        'tr': 'Teşekkür ederim'
+    },
+    'press_enter': {
+        'en': 'Press Enter to continue...',
+        'az': 'Davam etmək üçün Enter basın...',
+        'tr': 'Devam etmek için Enter\'a basın...'
+    },
+    'see_you': {
+        'en': 'See you next time!',
+        'az': 'Görüşənədək!',
+        'tr': 'Görüşürüz!'
+    },
+    'main_menu_question': {
+        'en': 'What would you like to do?',
+        'az': 'Nə etmək istəyirsiniz?',
+        'tr': 'Ne yapmak istersiniz?'
+    },
+    'option_docs': {
+        'en': '📚 Documentation',
+        'az': '📚 Sənədləşmə',
+        'tr': '📚 Belgeler'
+    },
+    'option_terms': {
+        'en': '📋 Terms of Use',
+        'az': '📋 İstifadə Şərtləri',
+        'tr': '📋 Kullanım Şartları'
+    },
+    'option_feedback': {
+        'en': '💬 Send Feedback',
+        'az': '💬 Rəy Göndər',
+        'tr': '💬 Geri Bildirim Gönder'
+    },
+    'option_start': {
+        'en': '▶️  Start Download Tool',
+        'az': '▶️  Endirmə Alətini Başlat',
+        'tr': '▶️  İndirme Aracını Başlat'
+    },
+    'option_exit': {
+        'en': '🚪 Exit',
+        'az': '🚪 Çıxış',
+        'tr': '🚪 Çıkış'
+    },
+    'welcome': {
+        'en': 'SaveHub Download Tool',
+        'az': 'SaveHub Endirmə Aləti',
+        'tr': 'SaveHub İndirme Aracı'
+    },
+    'enter_url': {
+        'en': 'Enter media URL:',
+        'az': 'Media linkini daxil edin:',
+        'tr': 'Medya linkini girin:'
+    },
+    'select_format': {
+        'en': 'Select download format:',
+        'az': 'Endirmə formatını seçin:',
+        'tr': 'İndirme formatını seçin:'
+    },
+    'downloading': {
+        'en': 'Downloading, please wait...',
+        'az': 'Yüklənir, zəhmət olmasa gözləyin...',
+        'tr': 'İndiriliyor, lütfen bekleyin...'
+    },
+    'download_complete': {
+        'en': 'Download complete!',
+        'az': 'Yükləmə tamamlandı!',
+        'tr': 'İndirme tamamlandı!'
+    },
+    'error_download': {
+        'en': 'Download error',
+        'az': 'Endirmə xətası',
+        'tr': 'İndirme hatası'
+    },
+    'error_invalid_url': {
+        'en': 'Please enter a valid URL',
+        'az': 'Zəhmət olmasa düzgün URL daxil edin',
+        'tr': 'Lütfen geçerli bir URL girin'
+    },
+    'error_no_url': {
+        'en': 'No URL entered!',
+        'az': 'URL daxil edilmədi!',
+        'tr': 'URL girilmedi!'
+    },
+    'download_cancelled': {
+        'en': 'Download cancelled.',
+        'az': 'Yükləmə dayandırıldı.',
+        'tr': 'İndirme iptal edildi.'
+    },
+}
+
+
+def get_text(key: str, lang: str = 'en') -> str:
+    """
+    Get translated text for a given key and language.
+    Falls back to English if language not found,
+    then to the key itself if completely missing.
+    """
+    entry = TRANSLATIONS.get(key)
+    if entry is None:
+        return key
+    return entry.get(lang) or entry.get('en') or key

savehub_cli-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,14 @@
+savehub_cli/__init__.py,sha256=RS7zal1RgLE87V9s2XmAO5R-KMln9MF_YcMma6EKgKs,195
+savehub_cli/config.py,sha256=Q1qw0oHC-VUS9X3OH8nhzyiXSAgKb0_dHxzKfFE1Rts,950
+savehub_cli/main.py,sha256=SgER40JruwoVe-8yJ-s86bn8D1fpBtnSCyofEOESUsc,2485
+savehub_cli/translations.py,sha256=KjJLv_vX-2-0XZ3kY4X28dzGT4nLMsMLgKfQ855wlJ4,3469
+savehub_cli/modules/__init__.py,sha256=OCgLPqYyE0OFm2IKDQUMZ7JIxAAbOI6uWk-fb9czKJQ,208
+savehub_cli/modules/downloader.py,sha256=iSI9oEdOY5IwT-vtDH_ink3XMy3FGJu6mr4nZIpxRdg,15079
+savehub_cli/modules/menu.py,sha256=c9dmfYHUdTPw3t-TWCpbYgvjfIHCPp8zdIb1FCsLDuk,14113
+savehub_cli/modules/utils.py,sha256=OvNS1omdtOJH4pBs3Xm7Etn4hYnZ5h4dMX5PkFiJ7Vg,2494
+savehub_cli-1.0.0.dist-info/licenses/LICENSE,sha256=CpCEkJEQYbnyJs8h4fBHS6n-OIR4HoIthkpZ9CZqqrM,1070
+savehub_cli-1.0.0.dist-info/METADATA,sha256=JWYhKPoYUo1EEQvii436ucP62Pub7sQ9JMiGBxzdCHo,3351
+savehub_cli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+savehub_cli-1.0.0.dist-info/entry_points.txt,sha256=TuiuWSzWYtMEHhZhGfsE4LCEIFIhhUae_q3em2urcCQ,86
+savehub_cli-1.0.0.dist-info/top_level.txt,sha256=quzfCkswKTGU8QYhcprTD6ra2a61FdUd38JwaCYfcDk,12
+savehub_cli-1.0.0.dist-info/RECORD,,

savehub_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

savehub_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+savehub = savehub_cli.main:main
+savehub-cli = savehub_cli.main:main

savehub_cli-1.0.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+savehub_cli