ig-dlp 0.1.0__tar.gz

ig_dlp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [Henry Schneider]
+
+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.

ig_dlp-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: ig-dlp
+Version: 0.1.0
+Summary: A terminal UI clipboard monitor to automatically download Instagram posts and reels.
+Author-email: Henry Schneider <support@henryschneider.es>
+License: MIT
+Keywords: instagram,downloader,clipboard,tui,cli
+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
+License-File: LICENSE
+Requires-Dist: instaloader>=4.10
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# ig-dlp
+
+**ig-dlp** is a lightweight Terminal UI (TUI) clipboard monitor that automatically detects copied Instagram post or reel links and downloads them instantly into a local `output/` directory.
+
+---
+
+## Features
+
+* **Real-time Clipboard Monitoring:** Seamlessly watches your system clipboard for Instagram URLs (`/p/`, `/reel/`, `/tv/`).
+* **Interactive TUI Dashboard:** Powered by `rich`, providing a clean live status display showing the current state, last copied URL, and recent download history.
+* **Automatic Local Storage:** Organizes downloaded media, metadata, and captions directly into an `output/` folder where you launch the application.
+* **Graceful Control:** Press `q` followed by `Enter` at any time to exit the application cleanly.
+
+---
+
+## Installation
+
+You can install `ig-dlp` directly from PyPI:
+
+```bash
+pip install ig-dlp
+
+```
+
+### Manual Installation (From Source)
+
+If you are cloning the repository locally:
+
+```bash
+git clone https://github.com/yourusername/ig-dlp.git
+cd ig-dlp
+pip install .
+
+```
+
+---
+
+## Usage
+
+1. Launch the TUI in your terminal:
+```bash
+ig-dlp
+
+```
+
+
+2. Browse Instagram normally in your web browser.
+3. Copy any post or reel link (`Ctrl+C` or `Cmd+C`).
+4. The application will automatically detect the link, fetch the media via `instaloader`, and save it to your `./output` folder!
+5. Type **`q`** and press **`Enter`** to exit.
+
+---
+
+## Requirements
+
+* Python 3.8 or higher
+* [instaloader](https://github.com/instaloader/instaloader)
+* [pyperclip](https://github.com/asweigart/pyperclip)
+* [rich](https://github.com/Textualize/rich)
+
+---
+
+## Author
+
+* **Henry Schneider** — [support@henryschneider.es](mailto:support@henryschneider.es)
+
+---
+
+## License
+
+This project is licensed under the [MIT License](https://www.google.com/search?q=MIT LICENSE).

ig_dlp-0.1.0/README.md

@@ -0,0 +1,71 @@
+# ig-dlp
+
+**ig-dlp** is a lightweight Terminal UI (TUI) clipboard monitor that automatically detects copied Instagram post or reel links and downloads them instantly into a local `output/` directory.
+
+---
+
+## Features
+
+* **Real-time Clipboard Monitoring:** Seamlessly watches your system clipboard for Instagram URLs (`/p/`, `/reel/`, `/tv/`).
+* **Interactive TUI Dashboard:** Powered by `rich`, providing a clean live status display showing the current state, last copied URL, and recent download history.
+* **Automatic Local Storage:** Organizes downloaded media, metadata, and captions directly into an `output/` folder where you launch the application.
+* **Graceful Control:** Press `q` followed by `Enter` at any time to exit the application cleanly.
+
+---
+
+## Installation
+
+You can install `ig-dlp` directly from PyPI:
+
+```bash
+pip install ig-dlp
+
+```
+
+### Manual Installation (From Source)
+
+If you are cloning the repository locally:
+
+```bash
+git clone https://github.com/yourusername/ig-dlp.git
+cd ig-dlp
+pip install .
+
+```
+
+---
+
+## Usage
+
+1. Launch the TUI in your terminal:
+```bash
+ig-dlp
+
+```
+
+
+2. Browse Instagram normally in your web browser.
+3. Copy any post or reel link (`Ctrl+C` or `Cmd+C`).
+4. The application will automatically detect the link, fetch the media via `instaloader`, and save it to your `./output` folder!
+5. Type **`q`** and press **`Enter`** to exit.
+
+---
+
+## Requirements
+
+* Python 3.8 or higher
+* [instaloader](https://github.com/instaloader/instaloader)
+* [pyperclip](https://github.com/asweigart/pyperclip)
+* [rich](https://github.com/Textualize/rich)
+
+---
+
+## Author
+
+* **Henry Schneider** — [support@henryschneider.es](mailto:support@henryschneider.es)
+
+---
+
+## License
+
+This project is licensed under the [MIT License](https://www.google.com/search?q=MIT LICENSE).

ig_dlp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ig-dlp"
+version = "0.1.0"
+description = "A terminal UI clipboard monitor to automatically download Instagram posts and reels."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Henry Schneider", email = "support@henryschneider.es" }
+]
+keywords = ["instagram", "downloader", "clipboard", "tui", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "instaloader>=4.10",
+    "pyperclip>=1.8.2",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+ig-dlp = "ig_dlp.app:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

ig_dlp-0.1.0/setup.cfg

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

ig_dlp-0.1.0/src/ig_dlp/__init__.py

@@ -0,0 +1,3 @@
+__version__ = "0.1.0"
+
+from .app import main

ig_dlp-0.1.0/src/ig_dlp/app.py

@@ -0,0 +1,132 @@
+import os
+import re
+import threading
+import time
+import pyperclip
+import instaloader
+from rich.console import Console
+from rich.panel import Panel
+from rich.live import Live
+from rich.layout import Layout
+from rich.text import Text
+
+console = Console()
+loader = instaloader.Instaloader()
+
+# Application state tracking
+state = "Waiting..."
+current_url = "None"
+download_status = "Idle"
+history = []
+running = True
+
+def listen_for_quit():
+    """Background thread to listen for 'q' to quit gracefully."""
+    global running
+    while running:
+        try:
+            line = input()
+            if line.strip().lower() == 'q':
+                running = False
+                break
+        except EOFError:
+            break
+
+def generate_layout():
+    """Constructs the responsive TUI dashboard layout."""
+    layout = Layout()
+    
+    header = Panel(
+        Text("📸 INSTAGRAM CLIPBOARD DOWNLOADER (Press 'q' + Enter to quit)", style="bold magenta", justify="center"),
+        style="cyan"
+    )
+    
+    status_text = Text()
+    status_text.append(f"Status:     ", style="bold")
+    status_text.append(f"{state}\n", style="yellow" if "Downloading" in state else ("green" if "Downloaded" in state else "dim"))
+    status_text.append(f"Last URL:   ", style="bold")
+    status_text.append(f"{current_url}\n", style="blue")
+    status_text.append(f"Progress:   ", style="bold")
+    status_text.append(f"{download_status}", style="cyan")
+    
+    body = Panel(status_text, title="Live Status", border_style="green")
+    
+    history_content = "\n".join(history[-5:]) if history else "No downloads yet in this session."
+    footer = Panel(history_content, title="Recent History", border_style="dim")
+    
+    layout.split_column(
+        Layout(header, size=3),
+        Layout(body, size=7),
+        Layout(footer)
+    )
+    return layout
+
+def main():
+    global state, current_url, download_status, history, running
+    recent_value = ""
+
+    # Start quit listener thread
+    quit_thread = threading.Thread(target=listen_for_quit, daemon=True)
+    quit_thread.start()
+
+    with Live(generate_layout(), refresh_per_second=4, screen=False) as live:
+        while running:
+            try:
+                clipboard_text = pyperclip.paste().strip()
+
+                if clipboard_text != recent_value:
+                    recent_value = clipboard_text
+                    match = re.search(r"instagram\.com\/(?:p|reel|tv)\/([^\/?#]+)", clipboard_text)
+
+                    if match and running:
+                        shortcode = match.group(1)
+                        current_url = clipboard_text
+                        
+                        # State: Found
+                        state = "Found!"
+                        download_status = f"Target acquired: {shortcode}"
+                        live.update(generate_layout())
+                        time.sleep(0.5)
+
+                        # State: Downloading
+                        state = "Downloading..."
+                        download_status = "Fetching media via Instaloader..."
+                        live.update(generate_layout())
+
+                        # Execute download
+                        post = instaloader.Post.from_shortcode(loader.context, shortcode)
+                        loader.download_post(post, target=shortcode)
+                        
+                        # Extract account handle
+                        account_name = post.owner_username
+
+                        # State: Downloaded
+                        state = "Downloaded!"
+                        download_status = f"Successfully saved {shortcode}"
+                        history.append(f"[✓] {shortcode} (@{account_name}) - Saved successfully")
+                        live.update(generate_layout())
+                        
+                        time.sleep(2)
+                        state = "Waiting..."
+                        download_status = "Idle"
+                        live.update(generate_layout())
+
+            except Exception as e:
+                if not running:
+                    break
+                state = "Error"
+                download_status = str(e)[:45]
+                live.update(generate_layout())
+                time.sleep(2)
+                state = "Waiting..."
+                download_status = "Idle"
+
+            time.sleep(1)
+
+    console.print("\n[bold red]Exiting application. Goodbye![/bold red]")
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        console.print("\n[bold red]Exiting application. Goodbye![/bold red]")

ig_dlp-0.1.0/src/ig_dlp.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: ig-dlp
+Version: 0.1.0
+Summary: A terminal UI clipboard monitor to automatically download Instagram posts and reels.
+Author-email: Henry Schneider <support@henryschneider.es>
+License: MIT
+Keywords: instagram,downloader,clipboard,tui,cli
+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
+License-File: LICENSE
+Requires-Dist: instaloader>=4.10
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# ig-dlp
+
+**ig-dlp** is a lightweight Terminal UI (TUI) clipboard monitor that automatically detects copied Instagram post or reel links and downloads them instantly into a local `output/` directory.
+
+---
+
+## Features
+
+* **Real-time Clipboard Monitoring:** Seamlessly watches your system clipboard for Instagram URLs (`/p/`, `/reel/`, `/tv/`).
+* **Interactive TUI Dashboard:** Powered by `rich`, providing a clean live status display showing the current state, last copied URL, and recent download history.
+* **Automatic Local Storage:** Organizes downloaded media, metadata, and captions directly into an `output/` folder where you launch the application.
+* **Graceful Control:** Press `q` followed by `Enter` at any time to exit the application cleanly.
+
+---
+
+## Installation
+
+You can install `ig-dlp` directly from PyPI:
+
+```bash
+pip install ig-dlp
+
+```
+
+### Manual Installation (From Source)
+
+If you are cloning the repository locally:
+
+```bash
+git clone https://github.com/yourusername/ig-dlp.git
+cd ig-dlp
+pip install .
+
+```
+
+---
+
+## Usage
+
+1. Launch the TUI in your terminal:
+```bash
+ig-dlp
+
+```
+
+
+2. Browse Instagram normally in your web browser.
+3. Copy any post or reel link (`Ctrl+C` or `Cmd+C`).
+4. The application will automatically detect the link, fetch the media via `instaloader`, and save it to your `./output` folder!
+5. Type **`q`** and press **`Enter`** to exit.
+
+---
+
+## Requirements
+
+* Python 3.8 or higher
+* [instaloader](https://github.com/instaloader/instaloader)
+* [pyperclip](https://github.com/asweigart/pyperclip)
+* [rich](https://github.com/Textualize/rich)
+
+---
+
+## Author
+
+* **Henry Schneider** — [support@henryschneider.es](mailto:support@henryschneider.es)
+
+---
+
+## License
+
+This project is licensed under the [MIT License](https://www.google.com/search?q=MIT LICENSE).

ig_dlp-0.1.0/src/ig_dlp.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/ig_dlp/__init__.py
+src/ig_dlp/app.py
+src/ig_dlp.egg-info/PKG-INFO
+src/ig_dlp.egg-info/SOURCES.txt
+src/ig_dlp.egg-info/dependency_links.txt
+src/ig_dlp.egg-info/entry_points.txt
+src/ig_dlp.egg-info/requires.txt
+src/ig_dlp.egg-info/top_level.txt

ig_dlp-0.1.0/src/ig_dlp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ig_dlp-0.1.0/src/ig_dlp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ig-dlp = ig_dlp.app:main

ig_dlp-0.1.0/src/ig_dlp.egg-info/requires.txt

@@ -0,0 +1,3 @@
+instaloader>=4.10
+pyperclip>=1.8.2
+rich>=13.0.0

ig_dlp-0.1.0/src/ig_dlp.egg-info/top_level.txt

@@ -0,0 +1 @@
+ig_dlp