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
