insta-cli-sudeep 0.1.0__tar.gz

insta_cli_sudeep-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: insta-cli-sudeep
+Version: 0.1.0
+Summary: A terminal-based Instagram browser and downloader.
+Author-email: Sudeep <your.email@example.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: instagrapi>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: yt-dlp>=2024.1.0
+
+# insta-cli-sudeep 📸
+
+A terminal-based Instagram browser and downloader. Browse profiles, download posts, reels, and stories — all from your command line.
+
+## Installation
+
+```bash
+pip install insta-cli-sudeep
+```
+
+## Usage
+
+```bash
+insta
+```
+
+You'll be prompted to log in with your Instagram credentials. Your session is saved locally so you only log in once.
+
+## Features
+
+- 🔐 **Login with session saving** — log in once, reuse session forever
+- 👤 **Browse profiles** — view posts, reels, likes, captions in a clean table
+- 🎬 **Download posts & reels** — by URL or directly from profile browser
+- 📖 **Download stories** — grab all active stories from any user
+- 🔄 **yt-dlp fallback** — automatic fallback for tricky downloads
+
+## Downloaded files
+
+All downloads are saved to `~/insta_downloads/`:
+```
+~/insta_downloads/
+├── posts/
+├── reels/
+└── stories/
+    └── <username>/
+```
+
+## ⚠️ Important
+
+- Use a **secondary Instagram account** for testing — not your main one
+- This tool uses `instagrapi` which mimics the Instagram mobile app
+- Respect Instagram's Terms of Service and only download content you have rights to
+
+## Requirements
+
+- Python 3.8+
+- `instagrapi`, `rich`, `yt-dlp` (installed automatically)
+
+## License
+
+MIT

insta_cli_sudeep-0.1.0/README.md

@@ -0,0 +1,51 @@
+# insta-cli-sudeep 📸
+
+A terminal-based Instagram browser and downloader. Browse profiles, download posts, reels, and stories — all from your command line.
+
+## Installation
+
+```bash
+pip install insta-cli-sudeep
+```
+
+## Usage
+
+```bash
+insta
+```
+
+You'll be prompted to log in with your Instagram credentials. Your session is saved locally so you only log in once.
+
+## Features
+
+- 🔐 **Login with session saving** — log in once, reuse session forever
+- 👤 **Browse profiles** — view posts, reels, likes, captions in a clean table
+- 🎬 **Download posts & reels** — by URL or directly from profile browser
+- 📖 **Download stories** — grab all active stories from any user
+- 🔄 **yt-dlp fallback** — automatic fallback for tricky downloads
+
+## Downloaded files
+
+All downloads are saved to `~/insta_downloads/`:
+```
+~/insta_downloads/
+├── posts/
+├── reels/
+└── stories/
+    └── <username>/
+```
+
+## ⚠️ Important
+
+- Use a **secondary Instagram account** for testing — not your main one
+- This tool uses `instagrapi` which mimics the Instagram mobile app
+- Respect Instagram's Terms of Service and only download content you have rights to
+
+## Requirements
+
+- Python 3.8+
+- `instagrapi`, `rich`, `yt-dlp` (installed automatically)
+
+## License
+
+MIT

insta_cli_sudeep-0.1.0/insta_cli/__init__.py

@@ -0,0 +1 @@
+# insta-cli by sudeep

insta_cli_sudeep-0.1.0/insta_cli/auth.py

@@ -0,0 +1,59 @@
+import os
+import json
+from pathlib import Path
+from instagrapi import Client
+from instagrapi.exceptions import LoginRequired, TwoFactorRequired, BadPassword
+
+SESSION_FILE = Path.home() / ".insta_cli_session.json"
+
+
+def get_client() -> Client:
+    cl = Client()
+    cl.delay_range = [1, 3]  # Be polite, avoid rate limits
+    return cl
+
+
+def login(username: str = None, password: str = None) -> Client:
+    cl = get_client()
+
+    # Try loading existing session first
+    if SESSION_FILE.exists():
+        try:
+            session = json.loads(SESSION_FILE.read_text())
+            cl.set_settings(session)
+            cl.login(session["username"], "")  # reuse session
+            cl.get_timeline_feed()  # test if session is valid
+            return cl
+        except Exception:
+            SESSION_FILE.unlink(missing_ok=True)
+
+    # Fresh login
+    if not username:
+        username = input("Instagram username: ").strip()
+    if not password:
+        import getpass
+        password = getpass.getpass("Instagram password: ")
+
+    try:
+        cl.login(username, password)
+    except TwoFactorRequired:
+        code = input("2FA code: ").strip()
+        cl.login(username, password, verification_code=code)
+    except BadPassword:
+        print("❌ Wrong password. Try again.")
+        raise SystemExit(1)
+
+    # Save session
+    settings = cl.get_settings()
+    settings["username"] = username
+    SESSION_FILE.write_text(json.dumps(settings))
+    print(f"✅ Logged in as @{username} (session saved)")
+    return cl
+
+
+def logout():
+    if SESSION_FILE.exists():
+        SESSION_FILE.unlink()
+        print("✅ Logged out and session cleared.")
+    else:
+        print("No active session found.")

insta_cli_sudeep-0.1.0/insta_cli/browse.py

@@ -0,0 +1,76 @@
+from instagrapi import Client
+from rich.console import Console
+from rich.table import Table
+from rich import box
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+
+def browse_profile(cl: Client):
+    username = input("\nEnter username to browse: ").strip().lstrip("@")
+
+    try:
+        user = cl.user_info_by_username(username)
+    except Exception as e:
+        console.print(f"[red]Could not find user @{username}: {e}[/red]")
+        return
+
+    # Display profile info
+    console.print()
+    console.print(Panel(
+        f"[bold cyan]@{user.username}[/bold cyan]\n"
+        f"[white]{user.full_name}[/white]\n\n"
+        f"[yellow]{user.biography or 'No bio'}[/yellow]\n\n"
+        f"[green]Posts:[/green] {user.media_count}   "
+        f"[green]Followers:[/green] {user.follower_count:,}   "
+        f"[green]Following:[/green] {user.following_count:,}\n"
+        f"[dim]{'🔒 Private' if user.is_private else '🌐 Public'}   "
+        f"{'✅ Verified' if user.is_verified else ''}[/dim]",
+        title="Profile",
+        border_style="cyan"
+    ))
+
+    if user.is_private:
+        console.print("[yellow]⚠ This account is private.[/yellow]")
+        return
+
+    # Show recent posts
+    console.print("\n[bold]Recent Posts:[/bold]")
+    try:
+        medias = cl.user_medias(user.pk, amount=12)
+    except Exception as e:
+        console.print(f"[red]Could not fetch posts: {e}[/red]")
+        return
+
+    table = Table(box=box.ROUNDED, show_header=True, header_style="bold magenta")
+    table.add_column("#", style="dim", width=4)
+    table.add_column("Type", width=8)
+    table.add_column("Likes", justify="right", width=8)
+    table.add_column("Comments", justify="right", width=10)
+    table.add_column("Caption", width=50)
+    table.add_column("URL", width=40)
+
+    for i, media in enumerate(medias, 1):
+        media_type = {1: "📷 Photo", 2: "🎬 Reel", 8: "🖼 Album"}.get(media.media_type, "?")
+        caption = (media.caption_text or "")[:60].replace("\n", " ")
+        url = f"https://www.instagram.com/p/{media.code}/"
+        table.add_row(
+            str(i),
+            media_type,
+            str(media.like_count),
+            str(media.comment_count),
+            caption,
+            url
+        )
+
+    console.print(table)
+
+    # Offer to download
+    choice = input("\nDownload a post? Enter number (or press Enter to skip): ").strip()
+    if choice.isdigit():
+        idx = int(choice) - 1
+        if 0 <= idx < len(medias):
+            return medias[idx]
+    return None

insta_cli_sudeep-0.1.0/insta_cli/cli.py

@@ -0,0 +1,88 @@
+import sys
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+from rich.align import Align
+
+console = Console()
+
+
+def print_banner():
+    banner = Text()
+    banner.append("  ██╗███╗   ██╗███████╗████████╗ █████╗ \n", style="bold magenta")
+    banner.append("  ██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗\n", style="bold magenta")
+    banner.append("  ██║██╔██╗ ██║███████╗   ██║   ███████║\n", style="bold cyan")
+    banner.append("  ██║██║╚██╗██║╚════██║   ██║   ██╔══██║\n", style="bold cyan")
+    banner.append("  ██║██║ ╚████║███████║   ██║   ██║  ██║\n", style="bold blue")
+    banner.append("  ╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝\n", style="bold blue")
+    banner.append("         CLI  📸  by sudeep", style="dim white")
+
+    console.print(Panel(Align.center(banner), border_style="magenta", padding=(1, 4)))
+
+
+def print_menu():
+    console.print("\n[bold white]What do you want to do?[/bold white]\n")
+    console.print("  [bold cyan][1][/bold cyan]  Browse a profile")
+    console.print("  [bold cyan][2][/bold cyan]  Download post / reel by URL")
+    console.print("  [bold cyan][3][/bold cyan]  Download stories")
+    console.print("  [bold cyan][4][/bold cyan]  Logout")
+    console.print("  [bold cyan][0][/bold cyan]  Exit\n")
+
+
+def main():
+    from insta_cli.auth import login, logout
+    from insta_cli.browse import browse_profile
+    from insta_cli.download import download_media, download_stories, download_by_url
+
+    console.clear()
+    print_banner()
+    console.print("\n[dim]Logging in...[/dim]")
+
+    try:
+        cl = login()
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Cancelled.[/yellow]")
+        sys.exit(0)
+    except SystemExit:
+        sys.exit(1)
+
+    while True:
+        print_menu()
+
+        try:
+            choice = input("  Enter choice: ").strip()
+        except KeyboardInterrupt:
+            console.print("\n[yellow]Bye! 👋[/yellow]")
+            break
+
+        if choice == "1":
+            selected_media = browse_profile(cl)
+            if selected_media:
+                download_media(cl, selected_media)
+
+        elif choice == "2":
+            url = input("\nPaste Instagram URL: ").strip()
+            download_by_url(url)
+
+        elif choice == "3":
+            download_stories(cl)
+
+        elif choice == "4":
+            logout()
+            console.print("[yellow]Session cleared. Restart to log in again.[/yellow]")
+            break
+
+        elif choice == "0":
+            console.print("\n[yellow]Bye! 👋[/yellow]")
+            break
+
+        else:
+            console.print("[red]Invalid choice. Try again.[/red]")
+
+        input("\n[Press Enter to continue]")
+        console.clear()
+        print_banner()
+
+
+if __name__ == "__main__":
+    main()

insta_cli_sudeep-0.1.0/insta_cli/download.py

@@ -0,0 +1,95 @@
+import os
+import subprocess
+from pathlib import Path
+from instagrapi import Client
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+console = Console()
+DOWNLOAD_DIR = Path.home() / "insta_downloads"
+
+
+def ensure_dir(path: Path):
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def download_by_url(url: str):
+    """Use yt-dlp to download a reel or post by URL."""
+    out_dir = ensure_dir(DOWNLOAD_DIR / "reels")
+    console.print(f"\n[cyan]Downloading via yt-dlp...[/cyan]")
+    result = subprocess.run(
+        ["yt-dlp", "-o", str(out_dir / "%(title)s.%(ext)s"), url],
+        capture_output=False
+    )
+    if result.returncode == 0:
+        console.print(f"[green]✅ Saved to {out_dir}[/green]")
+    else:
+        console.print("[red]❌ yt-dlp failed. Make sure it's installed: pip install yt-dlp[/red]")
+
+
+def download_media(cl: Client, media=None):
+    """Download a post/reel using instagrapi or yt-dlp."""
+    if media is None:
+        url = input("\nPaste Instagram post/reel URL: ").strip()
+        download_by_url(url)
+        return
+
+    out_dir = ensure_dir(DOWNLOAD_DIR / "posts")
+
+    with Progress(SpinnerColumn(), TextColumn("[progress.description]{task.description}")) as progress:
+        task = progress.add_task("Downloading...", total=None)
+
+        try:
+            if media.media_type == 1:  # Photo
+                path = cl.photo_download(media.pk, folder=out_dir)
+                progress.update(task, description="Downloaded photo ✅")
+            elif media.media_type == 2:  # Video/Reel
+                path = cl.video_download(media.pk, folder=out_dir)
+                progress.update(task, description="Downloaded reel ✅")
+            elif media.media_type == 8:  # Album
+                paths = cl.album_download(media.pk, folder=out_dir)
+                progress.update(task, description=f"Downloaded {len(paths)} items ✅")
+                console.print(f"[green]✅ Album saved to {out_dir}[/green]")
+                return
+            else:
+                progress.update(task, description="Unknown media type")
+                return
+
+            console.print(f"[green]✅ Saved to {path}[/green]")
+        except Exception as e:
+            console.print(f"[red]❌ Download failed: {e}[/red]")
+            console.print("[yellow]Trying yt-dlp fallback...[/yellow]")
+            url = f"https://www.instagram.com/p/{media.code}/"
+            download_by_url(url)
+
+
+def download_stories(cl: Client):
+    """Download all stories from a user."""
+    username = input("\nEnter username to grab stories from: ").strip().lstrip("@")
+
+    try:
+        user = cl.user_info_by_username(username)
+        stories = cl.user_stories(user.pk)
+    except Exception as e:
+        console.print(f"[red]❌ Could not fetch stories: {e}[/red]")
+        return
+
+    if not stories:
+        console.print(f"[yellow]No active stories for @{username}[/yellow]")
+        return
+
+    out_dir = ensure_dir(DOWNLOAD_DIR / "stories" / username)
+    console.print(f"\n[cyan]Found {len(stories)} stories. Downloading...[/cyan]")
+
+    for i, story in enumerate(stories, 1):
+        try:
+            if story.media_type == 1:
+                path = cl.photo_download(story.pk, folder=out_dir)
+            else:
+                path = cl.video_download(story.pk, folder=out_dir)
+            console.print(f"  [{i}/{len(stories)}] ✅ {Path(path).name}")
+        except Exception as e:
+            console.print(f"  [{i}/{len(stories)}] ❌ Failed: {e}")
+
+    console.print(f"\n[green]✅ Stories saved to {out_dir}[/green]")

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: insta-cli-sudeep
+Version: 0.1.0
+Summary: A terminal-based Instagram browser and downloader.
+Author-email: Sudeep <your.email@example.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: instagrapi>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: yt-dlp>=2024.1.0
+
+# insta-cli-sudeep 📸
+
+A terminal-based Instagram browser and downloader. Browse profiles, download posts, reels, and stories — all from your command line.
+
+## Installation
+
+```bash
+pip install insta-cli-sudeep
+```
+
+## Usage
+
+```bash
+insta
+```
+
+You'll be prompted to log in with your Instagram credentials. Your session is saved locally so you only log in once.
+
+## Features
+
+- 🔐 **Login with session saving** — log in once, reuse session forever
+- 👤 **Browse profiles** — view posts, reels, likes, captions in a clean table
+- 🎬 **Download posts & reels** — by URL or directly from profile browser
+- 📖 **Download stories** — grab all active stories from any user
+- 🔄 **yt-dlp fallback** — automatic fallback for tricky downloads
+
+## Downloaded files
+
+All downloads are saved to `~/insta_downloads/`:
+```
+~/insta_downloads/
+├── posts/
+├── reels/
+└── stories/
+    └── <username>/
+```
+
+## ⚠️ Important
+
+- Use a **secondary Instagram account** for testing — not your main one
+- This tool uses `instagrapi` which mimics the Instagram mobile app
+- Respect Instagram's Terms of Service and only download content you have rights to
+
+## Requirements
+
+- Python 3.8+
+- `instagrapi`, `rich`, `yt-dlp` (installed automatically)
+
+## License
+
+MIT

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+insta_cli/__init__.py
+insta_cli/auth.py
+insta_cli/browse.py
+insta_cli/cli.py
+insta_cli/download.py
+insta_cli_sudeep.egg-info/PKG-INFO
+insta_cli_sudeep.egg-info/SOURCES.txt
+insta_cli_sudeep.egg-info/dependency_links.txt
+insta_cli_sudeep.egg-info/entry_points.txt
+insta_cli_sudeep.egg-info/requires.txt
+insta_cli_sudeep.egg-info/top_level.txt

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+insta = insta_cli.cli:main

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/requires.txt

@@ -0,0 +1,3 @@
+instagrapi>=2.0.0
+rich>=13.0.0
+yt-dlp>=2024.1.0

insta_cli_sudeep-0.1.0/insta_cli_sudeep.egg-info/top_level.txt

@@ -0,0 +1 @@
+insta_cli

insta_cli_sudeep-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "insta-cli-sudeep"
+version = "0.1.0"
+authors = [
+  { name="Sudeep", email="your.email@example.com" },
+]
+description = "A terminal-based Instagram browser and downloader."
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "instagrapi>=2.0.0",
+    "rich>=13.0.0",
+    "yt-dlp>=2024.1.0",
+]
+
+[project.scripts]
+insta = "insta_cli.cli:main"

insta_cli_sudeep-0.1.0/setup.cfg

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