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).
