Features

• Photos & Videos: Batch download high-resolution photos, reels, videos, and posts.
• Instagram Stories & Highlights: Extract stories and highlight archives automatically.
• Smart Anti-Duplicate Archiving: Automatic archive.txt tracking avoids re-downloading existing media.
• Automated Cookie Integration: Supports Netscape cookie files and browser session extraction (--cookies-from-browser).
• Cookie Fallback & Retry Logic: Automatically attempts anonymous fallbacks and handles rate-limits gracefully.
• Terminal UI: Powered by rich with customizable contrast themes (light / dark).

Supported Platforms

Installation

Install nami directly via pip:

pip install nami

All dependencies (rich, gallery-dl, yt-dlp) are automatically installed.

To upgrade to the latest release:

pip install -U nami

Usage Flow

1. Project Workspace Initializer

When you launch nami for the first time, it automatically creates your local workspace structure:

Nami/
├── downloads/      # Extracted media organized by platform & account
├── cookies/        # Optional Netscape cookie files (*_cookies.txt)
└── profiles/       # Target account URL text files (*_profiles.txt)

2. Configure Profile Sources

Add your target account URLs into the designated text files inside Nami/profiles/:

Nami/profiles/
├── instagram_profiles.txt  # Add Instagram profile URLs (one per line)
├── tiktok_profiles.txt     # Add TikTok profile URLs
├── facebook_profiles.txt   # Add Facebook profile URLs
└── x_profiles.txt          # Add X / Twitter profile URLs

3. Session Authentication

Place Netscape-formatted cookie files inside Nami/cookies/ to download private content or bypass login restrictions:

• instagram.com_cookies.txt
• facebook.com_cookies.txt
• x.com_cookies.txt

4. Interactive Execution & Filtering

Launch the application to run batch downloads across your configured profile lists:

nami

┌──────────────────────── Nami ────────────────────────┐
│ What do you want to download?                        │
│                                                      │
│ 1  Photos only                                       │
│ 2  Videos only                                       │
│ 3  Stories only                                      │
│ 4  Highlights only                                   │
│ 5  Photos + Videos                                   │
│ 6  Stories + Highlights                              │
│ 7  All                                               │
│ 8  Settings                                          │
│ 0  Exit                                              │
└──────────────────────────────────────────────────────┘

Configuration & Environment Variables

User settings are saved automatically in ~/.nami/nami_config.json. You can also configure Nami via environment variables:

Customizing Theme Contrast

Adjust terminal theme styling by setting NAMI_THEME:

# Light Terminal Theme
export NAMI_THEME=light

# Dark Terminal Theme (Default)
export NAMI_THEME=dark

License

Distributed under the MIT License. Developed and maintained by Igect under OpenSelena.