sh-tiktok-studio 2.0.0__tar.gz

sh_tiktok_studio-2.0.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: sh-tiktok-studio
+Version: 2.0.0
+Summary: TikTok downloader & search tool with key-based access control, quality selection, and search history
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: pyfiglet
+Requires-Dist: pymongo
+Requires-Dist: dnspython
+
+# SH TikTok Studio
+
+TikTok downloader & search tool — no-watermark quality selection, paginated
+search, batch download, and search history.
+
+## Install
+
+```
+pip install sh-tiktok-studio
+```
+
+## Run
+
+```
+tiktok-dl
+```

sh_tiktok_studio-2.0.0/README.md

@@ -0,0 +1,16 @@
+# SH TikTok Studio
+
+TikTok downloader & search tool — no-watermark quality selection, paginated
+search, batch download, and search history.
+
+## Install
+
+```
+pip install sh-tiktok-studio
+```
+
+## Run
+
+```
+tiktok-dl
+```

sh_tiktok_studio-2.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sh-tiktok-studio"
+version = "2.0.0"
+description = "TikTok downloader & search tool with key-based access control, quality selection, and search history"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "requests",
+    "rich",
+    "pyfiglet",
+    "pymongo",
+    "dnspython",
+]
+
+[project.scripts]
+tiktok-dl = "sh_tiktok_studio.cli:main"
+
+[tool.setuptools]
+packages = ["sh_tiktok_studio"]

sh_tiktok_studio-2.0.0/setup.cfg

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

sh_tiktok_studio-2.0.0/sh_tiktok_studio/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

sh_tiktok_studio-2.0.0/sh_tiktok_studio/cli.py

@@ -0,0 +1,735 @@
+import os
+import re
+import json
+import time
+import secrets
+from datetime import datetime, timezone
+
+import requests
+from rich.console import Console
+from rich.panel import Panel
+from rich.align import Align
+from rich.text import Text
+from rich.rule import Rule
+from rich.prompt import Prompt, IntPrompt
+from rich.progress import Progress, BarColumn, TextColumn, TimeRemainingColumn, DownloadColumn, TransferSpeedColumn
+from rich.table import Table
+from rich.live import Live
+from rich import box
+
+try:
+    import pyfiglet
+    HAS_FIGLET = True
+except ImportError:
+    HAS_FIGLET = False
+
+try:
+    from pymongo import MongoClient
+    from pymongo.errors import PyMongoError
+    HAS_PYMONGO = True
+except ImportError:
+    HAS_PYMONGO = False
+
+console = Console()
+
+HISTORY_FILE = os.path.expanduser("~/.sh_tiktok_history.json")
+API_BASE = "https://www.tikwm.com/api/"
+API_SEARCH = "https://www.tikwm.com/api/feed/search/"
+UA_HEADERS = {'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36'}
+
+LOGO_COLORS = ["bright_cyan", "cyan", "bright_magenta", "magenta", "bright_white", "cyan"]
+
+# ==================== ACCESS CONTROL CONFIG ====================
+# IMPORTANT: the Mongo connection string is read from an environment
+# variable, NOT hardcoded here. This file gets published to PyPI — if the
+# real connection string were written directly into this source file,
+# literally everyone who runs `pip install` could open cli.py, copy the
+# string, and connect to your database directly (read every key/username,
+# generate their own "valid" keys, or delete the whole collection) —
+# completely bypassing the admin panel and this app entirely.
+#
+# Set it on YOUR device (and only where you run the admin panel / where
+# users run the app) with:
+#   export SH_TIKTOK_MONGO_URI="mongodb+srv://user:pass@cluster.mongodb.net"
+MONGODB_URI = os.environ.get("SH_TIKTOK_MONGO_URI", "")
+DB_NAME = os.environ.get("SH_TIKTOK_DB_NAME", "sh_tiktok_studio")
+KEYS_COLLECTION = "access_keys"
+ADMIN_SECRET = "sadesha2008"
+
+_mongo_client = None
+
+def get_keys_collection():
+    global _mongo_client
+    if not HAS_PYMONGO:
+        console.print("[bold red]❌ pymongo isn't installed. Run: pip install pymongo dnspython[/bold red]")
+        return None
+    if not MONGODB_URI:
+        console.print("[bold red]❌ SH_TIKTOK_MONGO_URI environment variable isn't set. See the top of cli.py for setup.[/bold red]")
+        return None
+    try:
+        if _mongo_client is None:
+            _mongo_client = MongoClient(MONGODB_URI, serverSelectionTimeoutMS=8000)
+            _mongo_client.admin.command('ping')  # fail fast if unreachable
+        coll = _mongo_client[DB_NAME][KEYS_COLLECTION]
+        coll.create_index('key', unique=True)
+        return coll
+    except PyMongoError as e:
+        console.print(f"[bold red]❌ Could not connect to the license database: {e}[/bold red]")
+        return None
+    except Exception as e:
+        console.print(f"[bold red]❌ Database error: {e}[/bold red]")
+        return None
+
+
+# ==================== UTILITIES ====================
+def clear_screen():
+    os.system('cls' if os.name == 'nt' else 'clear')
+
+def get_folder(subfolder):
+    primary = os.path.expanduser(f'/sdcard/Download/SH_Downloads/{subfolder}')
+    fallback = os.path.expanduser(f'./downloads/{subfolder}')
+    try:
+        os.makedirs(primary, exist_ok=True)
+        return primary
+    except Exception:
+        os.makedirs(fallback, exist_ok=True)
+        return fallback
+
+def format_size(num_bytes):
+    if not num_bytes:
+        return "—"
+    mb = int(num_bytes) / (1024 * 1024)
+    if mb < 1:
+        return f"{int(num_bytes) / 1024:.0f} KB"
+    return f"{mb:.1f} MB"
+
+def format_count(n):
+    try:
+        n = int(n)
+    except (TypeError, ValueError):
+        return "—"
+    if n >= 1_000_000:
+        return f"{n/1_000_000:.1f}M"
+    if n >= 1_000:
+        return f"{n/1_000:.1f}K"
+    return str(n)
+
+def format_duration(seconds):
+    try:
+        seconds = int(seconds)
+    except (TypeError, ValueError):
+        seconds = 0
+    mins, secs = divmod(seconds, 60)
+    return f"{mins}:{secs:02d}"
+
+def safe_filename(text, fallback="tiktok_video"):
+    clean = re.sub(r'[\\/*?:"<>|]', "", str(text))[:50].strip()
+    return clean or fallback
+
+
+# ==================== SEARCH HISTORY ====================
+def load_history():
+    try:
+        with open(HISTORY_FILE, 'r', encoding='utf-8') as f:
+            return json.load(f)
+    except Exception:
+        return []
+
+def save_history(query):
+    history = load_history()
+    query = query.strip()
+    history = [h for h in history if h.lower() != query.lower()]
+    history.insert(0, query)
+    history = history[:15]
+    try:
+        with open(HISTORY_FILE, 'w', encoding='utf-8') as f:
+            json.dump(history, f, ensure_ascii=False, indent=2)
+    except Exception:
+        pass
+    return history
+
+
+# ==================== UI: LOGO / BANNER / ANIMATION ====================
+def build_logo_text():
+    width = console.size.width
+    if HAS_FIGLET:
+        try:
+            if width >= 80:
+                font = 'slant'
+            elif width >= 55:
+                font = 'standard'
+            else:
+                font = 'small'
+            fig = pyfiglet.Figlet(font=font, width=max(width, 40))
+            return fig.renderText("TikTok").rstrip('\n')
+        except Exception:
+            pass
+    return "🎵  T I K T O K  🎵"
+
+def banner(subtitle="Verified Downloader & Search Engine"):
+    clear_screen()
+    logo = build_logo_text()
+    console.print(Align.center(Text(logo, style="bold bright_cyan")))
+    console.print(Align.center(Text(f"✨ {subtitle} ✨", style="bold yellow")))
+    console.print(Rule(style="magenta"))
+
+def animated_intro():
+    clear_screen()
+    logo = build_logo_text()
+    with Live(console=console, refresh_per_second=15) as live:
+        for i in range(14):
+            color = LOGO_COLORS[i % len(LOGO_COLORS)]
+            live.update(Align.center(Text(logo, style=f"bold {color}")))
+            time.sleep(0.06)
+        live.update(Align.center(Text(logo, style="bold bright_cyan")))
+        time.sleep(0.3)
+    banner()
+
+
+# ==================== ACCESS KEY SYSTEM ====================
+def generate_key():
+    return "SH-" + secrets.token_hex(4).upper()
+
+def admin_generate_keys(count):
+    coll = get_keys_collection()
+    if coll is None:
+        return []
+    created = []
+    for _ in range(count):
+        for _try in range(10):
+            k = generate_key()
+            try:
+                coll.insert_one({
+                    'key': k,
+                    'username': None,
+                    'status': 'unused',
+                    'created_at': datetime.now(timezone.utc),
+                })
+                created.append(k)
+                break
+            except PyMongoError:
+                continue  # key collision (astronomically rare) — retry with a new one
+    return created
+
+def admin_count_keys():
+    coll = get_keys_collection()
+    if coll is None:
+        return 0
+    return coll.count_documents({})
+
+def admin_list_keys(page=1, per_page=20):
+    coll = get_keys_collection()
+    if coll is None:
+        return [], 0
+    total = coll.count_documents({})
+    cursor = coll.find({}).sort('created_at', 1).skip((page - 1) * per_page).limit(per_page)
+    return list(cursor), total
+
+def validate_or_bind_key(key, username):
+    """Returns (ok: bool, message: str)."""
+    coll = get_keys_collection()
+    if coll is None:
+        return False, "Could not reach the license database."
+
+    doc = coll.find_one({'key': key})
+    if not doc:
+        return False, "Invalid key."
+
+    if doc.get('status') == 'unused':
+        coll.update_one(
+            {'_id': doc['_id']},
+            {'$set': {'username': username, 'status': 'used', 'activated_at': datetime.now(timezone.utc)}}
+        )
+        return True, f"Key activated — welcome, {username}!"
+
+    bound_username = (doc.get('username') or '')
+    if bound_username.lower() == username.lower():
+        return True, f"Welcome back, {username}!"
+
+    return False, "This key is already in use under a different username."
+
+
+# ==================== ADMIN PANEL ====================
+def admin_generate_keys_menu():
+    banner("ADMIN — Generate Keys")
+    count = IntPrompt.ask("[bold cyan]How many keys do you want to generate?[/bold cyan]", default=1)
+    if count <= 0:
+        return
+    with console.status(f"[bold green]Generating {count} key(s)...[/bold green]", spinner="dots12"):
+        created = admin_generate_keys(count)
+
+    if not created:
+        console.print("[bold red]❌ No keys were generated — check the database connection above.[/bold red]")
+        Prompt.ask("[dim]Press Enter to go back...[/dim]")
+        return
+
+    table = Table(title=f"✅ {len(created)} Key(s) Generated", border_style="green", box=box.ROUNDED)
+    table.add_column("No", justify="center")
+    table.add_column("Key", style="bold yellow")
+    for idx, k in enumerate(created, 1):
+        table.add_row(str(idx), k)
+    console.print(table)
+    Prompt.ask("[dim]Press Enter to go back...[/dim]")
+
+def admin_view_keys_menu():
+    page = 1
+    per_page = 20
+    while True:
+        with console.status("[bold cyan]Loading keys...[/bold cyan]", spinner="dots12"):
+            keys, total = admin_list_keys(page=page, per_page=per_page)
+        total_pages = max(1, (total + per_page - 1) // per_page)
+
+        banner("ADMIN — All Keys")
+        table = Table(title=f"🔑  Access Keys  (Page {page}/{total_pages}, {total} total)", border_style="cyan", box=box.ROUNDED)
+        table.add_column("Key", style="bold yellow")
+        table.add_column("Status", justify="center")
+        table.add_column("Username", style="white")
+
+        if not keys:
+            console.print("[yellow]No keys generated yet.[/yellow]")
+        else:
+            for doc in keys:
+                status_icon = "✅" if doc.get('status') == 'used' else "⏸️"
+                table.add_row(doc.get('key', '—'), status_icon, doc.get('username') or "-")
+            console.print(table)
+
+        nav_bits = []
+        if page > 1:
+            nav_bits.append("[P]revious")
+        if page < total_pages:
+            nav_bits.append("[N]ext")
+        nav_bits.append("[0] Back")
+        console.print(f"\n[dim]{'   '.join(nav_bits)}[/dim]")
+
+        choice = Prompt.ask("[bold yellow]Choice[/bold yellow]").strip().lower()
+        if choice in ('n', 'next') and page < total_pages:
+            page += 1
+        elif choice in ('p', 'prev', 'previous') and page > 1:
+            page -= 1
+        elif choice in ('0', 'back', 'exit'):
+            return
+        else:
+            console.print("[red]Invalid choice.[/red]")
+            time.sleep(1)
+
+def admin_panel():
+    while True:
+        banner("🛡️  ADMIN PANEL")
+        with console.status("[dim]Checking database...[/dim]", spinner="dots"):
+            total = admin_count_keys()
+        console.print(Align.center(Text(f"Total keys issued: {total}", style="bold dim")))
+        console.print()
+        console.print("  [1] 🆕  Generate new keys")
+        console.print("  [2] 📋  View all keys (used / unused)")
+        console.print("  [3] 🔙  Back to login\n")
+
+        choice = Prompt.ask("[bold yellow]Select option[/bold yellow]", choices=["1", "2", "3"])
+        if choice == "1":
+            admin_generate_keys_menu()
+        elif choice == "2":
+            admin_view_keys_menu()
+        elif choice == "3":
+            return
+
+
+# ==================== LOGIN FLOW ====================
+def login_flow():
+    while True:
+        banner()
+        console.print(Align.center(Text("🔒 ACCESS REQUIRED", style="bold underline bright_yellow")))
+        console.print()
+        entry = Prompt.ask("[bold cyan]🔑 Enter your access key[/bold cyan]").strip()
+
+        if entry == ADMIN_SECRET:
+            admin_panel()
+            continue
+
+        if not entry:
+            console.print("[red]A key is required.[/red]")
+            time.sleep(1)
+            continue
+
+        username = Prompt.ask("[bold cyan]👤 Enter your username[/bold cyan]").strip()
+        if not username:
+            console.print("[red]A username is required.[/red]")
+            time.sleep(1)
+            continue
+
+        with console.status("[bold green]Verifying key...[/bold green]", spinner="dots12"):
+            ok, msg = validate_or_bind_key(entry, username)
+
+        if ok:
+            console.print(f"[bold green]✔ {msg}[/bold green]")
+            time.sleep(1)
+            return username
+        else:
+            console.print(f"[bold red]❌ {msg}[/bold red]")
+            time.sleep(1.5)
+
+
+# ==================== TIKWM API ====================
+def get_video_full_info(url):
+    """Fetch full metadata + all quality links/sizes for a single video."""
+    data = {'url': url, 'count': 12, 'cursor': 0, 'web': 1, 'hd': 1}
+    try:
+        res = requests.post(API_BASE, data=data, headers=UA_HEADERS, timeout=15)
+        j = res.json()
+        if j.get('code') != 0:
+            console.print(f"[red]❌ TikTok API error: {j.get('msg', 'unknown error')}[/red]")
+            return None
+        return j.get('data')
+    except Exception as e:
+        console.print(f"[red]❌ Failed to fetch video info: {e}[/red]")
+        return None
+
+def search_tiktok_page(query, cursor=0, count=10):
+    """One page of search results. Returns (results, has_more, next_cursor)."""
+    data = {'keywords': query, 'count': count, 'cursor': cursor, 'web': 1, 'hd': 1}
+    try:
+        res = requests.post(API_SEARCH, data=data, headers=UA_HEADERS, timeout=15)
+        j = res.json()
+        if j.get('code') != 0:
+            console.print(f"[dim]⚠ TikTok search API: {j.get('msg', 'unknown error')}[/dim]")
+            return [], False, cursor
+        payload = j.get('data') or {}
+        videos = payload.get('videos', [])
+        results = []
+        for v in videos:
+            vid = v.get('video_id') or v.get('id')
+            author = v.get('author') or {}
+            handle = author.get('unique_id') or author.get('uniqueId') or author.get('nickname')
+            if vid and handle:
+                url = f"https://www.tiktok.com/@{handle}/video/{vid}"
+                results.append({
+                    'title': (v.get('title') or vid).strip() or vid,
+                    'author': author.get('nickname') or handle,
+                    'duration': format_duration(v.get('duration', 0)),
+                    'plays': v.get('play_count'),
+                    'likes': v.get('digg_count'),
+                    'url': url,
+                })
+        has_more = bool(payload.get('hasMore', len(videos) >= count))
+        next_cursor = payload.get('cursor', cursor + count)
+        return results, has_more, next_cursor
+    except Exception as e:
+        console.print(f"[dim]⚠ TikTok search API failed: {e}[/dim]")
+        return [], False, cursor
+
+
+# ==================== DOWNLOAD CORE ====================
+def stream_download(url, filepath, label="Downloading"):
+    try:
+        r = requests.get(url, headers=UA_HEADERS, stream=True, timeout=30)
+        total_size = int(r.headers.get('content-length', 0))
+        with Progress(
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(bar_width=None),
+            DownloadColumn(),
+            TransferSpeedColumn(),
+            TimeRemainingColumn(),
+            console=console
+        ) as progress:
+            task = progress.add_task(f"[cyan]{label}...", total=total_size if total_size > 0 else None)
+            with open(filepath, 'wb') as f:
+                for chunk in r.iter_content(chunk_size=4096):
+                    if chunk:
+                        f.write(chunk)
+                        if total_size > 0:
+                            progress.update(task, advance=len(chunk))
+        return True
+    except Exception as e:
+        console.print(f"[bold red]❌ Download Error: {e}[/bold red]")
+        return False
+
+def normalize_media_url(url):
+    """tikwm sometimes returns relative paths like '/video/media/wmplay/x.mp4'
+    instead of a full URL — that was causing 'Invalid URL: No scheme supplied'."""
+    if not url:
+        return url
+    if url.startswith('//'):
+        return 'https:' + url
+    if url.startswith('/'):
+        return 'https://www.tikwm.com' + url
+    return url
+
+def build_quality_options(v):
+    """Video-only quality ladder — audio download was removed entirely."""
+    options = []
+    if v.get('hdplay'):
+        options.append({'label': 'HD (No Watermark)', 'url': normalize_media_url(v['hdplay']), 'size': v.get('hd_size'), 'kind': 'video', 'ext': 'mp4'})
+    if v.get('play'):
+        options.append({'label': 'SD (No Watermark)', 'url': normalize_media_url(v['play']), 'size': v.get('size'), 'kind': 'video', 'ext': 'mp4'})
+    if v.get('wmplay'):
+        options.append({'label': 'Watermarked', 'url': normalize_media_url(v['wmplay']), 'size': v.get('wm_size'), 'kind': 'video', 'ext': 'mp4'})
+    return options
+
+
+def download_with_quality(v):
+    options = build_quality_options(v)
+    if not options:
+        console.print("[bold red]❌ No downloadable streams found for this video.[/bold red]")
+        return
+
+    table = Table(title="🎚  Available Quality Options", border_style="cyan", box=box.ROUNDED)
+    table.add_column("No", justify="center", style="bold yellow")
+    table.add_column("Quality", style="white")
+    table.add_column("Est. Size", style="green", justify="right")
+    for idx, opt in enumerate(options, 1):
+        table.add_row(str(idx), opt['label'], format_size(opt['size']))
+    console.print(table)
+
+    choice = IntPrompt.ask("[bold yellow]Select quality to download (0 to cancel)[/bold yellow]")
+    if choice == 0 or choice > len(options):
+        return
+
+    opt = options[choice - 1]
+    title_clean = safe_filename(v.get('title'))
+    folder = get_folder("TikTok/Video")
+    quality_tag = re.sub(r'[^A-Za-z0-9]+', '_', opt['label']).strip('_')
+    filepath = os.path.join(folder, f"{title_clean}_{quality_tag}.{opt['ext']}")
+
+    ok = stream_download(opt['url'], filepath, label=f"Downloading {opt['label']}")
+    if ok:
+        console.print(f"\n[bold green]✔ Saved to: TikTok/Video/{os.path.basename(filepath)}[/bold green]\n")
+
+
+# ==================== VIDEO DETAILS ====================
+def show_video_details(v):
+    author = v.get('author') or {}
+    table = Table(title="📋  Video Details", border_style="magenta", box=box.ROUNDED, show_header=False)
+    table.add_column("Field", style="bold cyan")
+    table.add_column("Value", style="white")
+
+    table.add_row("Title", (v.get('title') or '—')[:120])
+    table.add_row("Author", f"{author.get('nickname', '—')}  (@{author.get('unique_id', '—')})")
+    table.add_row("Duration", format_duration(v.get('duration', 0)))
+    table.add_row("Plays", format_count(v.get('play_count')))
+    table.add_row("Likes", format_count(v.get('digg_count')))
+    table.add_row("Comments", format_count(v.get('comment_count')))
+    table.add_row("Shares", format_count(v.get('share_count')))
+    table.add_row("Downloads", format_count(v.get('download_count')))
+
+    created = v.get('create_time')
+    if created:
+        try:
+            table.add_row("Uploaded", datetime.fromtimestamp(int(created)).strftime('%Y-%m-%d %H:%M'))
+        except Exception:
+            pass
+
+    music = v.get('music_info') or {}
+    if music.get('title'):
+        table.add_row("Music", f"{music.get('title', '—')} — {music.get('author', '—')}")
+
+    console.print(table)
+
+
+def video_detail_flow(basic_result):
+    with console.status("[bold green]Fetching full video details...[/bold green]", spinner="dots12"):
+        v = get_video_full_info(basic_result['url'])
+    if not v:
+        return
+    banner()
+    show_video_details(v)
+    console.print()
+    if Prompt.ask("[bold yellow]Download this video? (y/n)[/bold yellow]", choices=["y", "n"], default="y") == "y":
+        download_with_quality(v)
+
+
+# ==================== DIRECT URL DOWNLOAD ====================
+def download_tiktok_by_url(url):
+    with console.status("[bold green]Fetching TikTok video data...[/bold green]", spinner="dots12"):
+        v = get_video_full_info(url)
+    if not v:
+        console.print("[bold red]❌ Unable to parse TikTok URL. Make sure the link is public.[/bold red]")
+        return
+    banner()
+    show_video_details(v)
+    console.print()
+    download_with_quality(v)
+
+
+# ==================== BATCH DOWNLOAD ====================
+def batch_download(results, numbers_str):
+    try:
+        indices = [int(x.strip()) for x in numbers_str.split(',') if x.strip().isdigit()]
+    except ValueError:
+        console.print("[red]Invalid selection. Use comma-separated numbers like 1,3,5[/red]")
+        return
+
+    indices = [i for i in indices if 1 <= i <= len(results)]
+    if not indices:
+        console.print("[red]No valid numbers selected.[/red]")
+        return
+
+    console.print(f"[bold cyan]📦 Batch downloading {len(indices)} video(s) at best available quality...[/bold cyan]\n")
+    succeeded, failed = 0, 0
+    for n in indices:
+        item = results[n - 1]
+        console.print(Rule(f"[yellow]{n}. {item['title'][:40]}[/yellow]", style="dim"))
+        v = get_video_full_info(item['url'])
+        if not v:
+            failed += 1
+            continue
+        options = build_quality_options(v)
+        if not options:
+            failed += 1
+            continue
+        best = options[0]  # HD listed first
+        title_clean = safe_filename(v.get('title'))
+        folder = get_folder("TikTok/Video")
+        filepath = os.path.join(folder, f"{title_clean}.{best['ext']}")
+        ok = stream_download(best['url'], filepath, label=f"{n}. {title_clean[:25]}")
+        if ok:
+            succeeded += 1
+        else:
+            failed += 1
+
+    console.print(f"\n[bold green]✔ Batch complete — {succeeded} succeeded, {failed} failed[/bold green]\n")
+
+
+# ==================== SEARCH & BROWSE (PAGINATED) ====================
+def search_tiktok_paginated(query):
+    cursor = 0
+    page = 1
+    cursor_stack = []
+
+    while True:
+        with console.status(f"[bold cyan]Searching '{query}' (page {page})...[/bold cyan]", spinner="bouncingBall"):
+            results, has_more, next_cursor = search_tiktok_page(query, cursor=cursor, count=10)
+
+        if not results:
+            if page == 1:
+                console.print("[yellow]No search results found for this keyword.[/yellow]")
+                return
+            else:
+                console.print("[yellow]No more results.[/yellow]")
+                page -= 1
+                cursor = cursor_stack.pop() if cursor_stack else 0
+                continue
+
+        banner()
+        table = Table(title=f"🔎  TikTok Search — '{query}'  (Page {page})", border_style="yellow", box=box.ROUNDED)
+        table.add_column("No", style="cyan", justify="center")
+        table.add_column("Title", style="white")
+        table.add_column("Author", style="green")
+        table.add_column("Duration", style="magenta", justify="center")
+        table.add_column("Likes", style="red", justify="right")
+
+        for idx, r in enumerate(results, 1):
+            title_short = (r['title'][:38] + "…") if len(r['title']) > 38 else r['title']
+            table.add_row(str(idx), title_short, r['author'], r['duration'], format_count(r['likes']))
+
+        console.print(table)
+
+        nav_bits = []
+        if page > 1:
+            nav_bits.append("[P]revious")
+        if has_more:
+            nav_bits.append("[N]ext")
+        nav_bits.append("[B]atch download (e.g. b 1,3,5)")
+        nav_bits.append("[0] Back to menu")
+        console.print(f"[dim]{'   '.join(nav_bits)}   or type a number for full details[/dim]")
+
+        choice = Prompt.ask("[bold yellow]Choice[/bold yellow]").strip().lower()
+
+        if choice in ('n', 'next') and has_more:
+            cursor_stack.append(cursor)
+            cursor = next_cursor
+            page += 1
+        elif choice in ('p', 'prev', 'previous') and page > 1:
+            page -= 1
+            cursor = cursor_stack.pop() if cursor_stack else 0
+        elif choice.startswith('b'):
+            nums = choice[1:].strip()
+            if not nums:
+                nums = Prompt.ask("[bold cyan]Enter numbers to batch download (e.g. 1,3,5)[/bold cyan]")
+            batch_download(results, nums)
+            Prompt.ask("[dim]Press Enter to continue...[/dim]")
+        elif choice in ('0', 'back', 'exit'):
+            return
+        elif choice.isdigit() and 1 <= int(choice) <= len(results):
+            video_detail_flow(results[int(choice) - 1])
+            Prompt.ask("[dim]Press Enter to continue...[/dim]")
+        else:
+            console.print("[red]Invalid choice.[/red]")
+            time.sleep(1)
+
+
+# ==================== MENUS ====================
+def search_menu():
+    history = load_history()
+    banner()
+    if history:
+        console.print("[bold cyan]🕘 Recent searches:[/bold cyan]")
+        for i, h in enumerate(history[:8], 1):
+            console.print(f"  [dim]{i}.[/dim] {h}")
+        console.print()
+    query = Prompt.ask("[bold cyan]Enter search keyword (or a number from recent searches)[/bold cyan]")
+    query = query.strip()
+    if query.isdigit() and 1 <= int(query) <= len(history[:8]):
+        query = history[int(query) - 1]
+    if not query:
+        return
+    save_history(query)
+    search_tiktok_paginated(query)
+
+def about_menu():
+    banner()
+    folder = get_folder("TikTok/Video")
+    table = Table(title="ℹ️  About / Settings", border_style="cyan", box=box.ROUNDED, show_header=False)
+    table.add_column("Field", style="bold cyan")
+    table.add_column("Value", style="white")
+    table.add_row("Download folder", folder)
+    try:
+        n_files = len([f for f in os.listdir(folder) if os.path.isfile(os.path.join(folder, f))])
+    except Exception:
+        n_files = 0
+    table.add_row("Videos downloaded (this device)", str(n_files))
+    table.add_row("Search history entries", str(len(load_history())))
+    console.print(table)
+    Prompt.ask("\n[dim]Press Enter to go back...[/dim]")
+
+def main_menu(username):
+    while True:
+        banner(f"Logged in as {username}")
+        console.print(Align.center(Text("MAIN MENU", style="bold underline bright_yellow")))
+        console.print()
+        console.print("  [1] 🔗  Download via TikTok Link")
+        console.print("  [2] 🔎  Search & Browse Videos")
+        console.print("  [3] 🕘  Search History")
+        console.print("  [4] ℹ️   About / Settings")
+        console.print("  [5] 🚪  Exit\n")
+
+        choice = Prompt.ask("[bold yellow]Select option[/bold yellow]", choices=["1", "2", "3", "4", "5"])
+
+        if choice == "1":
+            url = Prompt.ask("[bold cyan]Enter TikTok URL[/bold cyan]").strip()
+            if url:
+                download_tiktok_by_url(url)
+                Prompt.ask("[dim]Press Enter to continue...[/dim]")
+        elif choice == "2":
+            search_menu()
+        elif choice == "3":
+            history = load_history()
+            banner()
+            if not history:
+                console.print("[yellow]No search history yet.[/yellow]")
+            else:
+                for i, h in enumerate(history, 1):
+                    console.print(f"  [cyan]{i}.[/cyan] {h}")
+            Prompt.ask("\n[dim]Press Enter to go back...[/dim]")
+        elif choice == "4":
+            about_menu()
+        elif choice == "5":
+            banner("Thanks for using SH TikTok Studio!")
+            console.print(Align.center(Text("👋 Goodbye!", style="bold magenta")))
+            break
+
+
+def main():
+    animated_intro()
+    username = login_flow()
+    main_menu(username)
+
+if __name__ == "__main__":
+    main()

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: sh-tiktok-studio
+Version: 2.0.0
+Summary: TikTok downloader & search tool with key-based access control, quality selection, and search history
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: pyfiglet
+Requires-Dist: pymongo
+Requires-Dist: dnspython
+
+# SH TikTok Studio
+
+TikTok downloader & search tool — no-watermark quality selection, paginated
+search, batch download, and search history.
+
+## Install
+
+```
+pip install sh-tiktok-studio
+```
+
+## Run
+
+```
+tiktok-dl
+```

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+sh_tiktok_studio/__init__.py
+sh_tiktok_studio/cli.py
+sh_tiktok_studio.egg-info/PKG-INFO
+sh_tiktok_studio.egg-info/SOURCES.txt
+sh_tiktok_studio.egg-info/dependency_links.txt
+sh_tiktok_studio.egg-info/entry_points.txt
+sh_tiktok_studio.egg-info/requires.txt
+sh_tiktok_studio.egg-info/top_level.txt

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tiktok-dl = sh_tiktok_studio.cli:main

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/requires.txt

@@ -0,0 +1,5 @@
+requests
+rich
+pyfiglet
+pymongo
+dnspython

sh_tiktok_studio-2.0.0/sh_tiktok_studio.egg-info/top_level.txt

@@ -0,0 +1 @@
+sh_tiktok_studio