Metadata-Version: 2.4
Name: nami
Version: 2.3.7
Summary: Multi-platform media downloader (Instagram, TikTok, Facebook, X) powered by gallery-dl and yt-dlp
Author: Igect
License-Expression: MIT
Project-URL: Homepage, https://github.com/OpenSelena/nami
Project-URL: Issues, https://github.com/OpenSelena/nami/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich
Requires-Dist: gallery-dl
Requires-Dist: yt-dlp
Dynamic: license-file

# Nami

Nami is an interactive, multi-platform media downloader CLI for Instagram, TikTok, Facebook, and X (Twitter), powered by `gallery-dl` and `yt-dlp`.

## Installation

```bash
pip install nami
```

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

## Quick Start

Run Nami from your terminal:

```bash
nami
```

### First-run Setup
On your first run, Nami prompts you to create a storage directory containing:

- `Nami/downloads/` — Downloaded media output
- `Nami/cookies/` — Netscape cookie files (`instagram.com_cookies.txt`, etc.)
- `Nami/profiles/` — Profile URL list files (`instagram_profiles.txt`, `tiktok_profiles.txt`, etc.)

### Usage
1. Add target profile URLs (one per line) into the `.txt` files in `Nami/profiles/`.
2. (Optional) Place exported Netscape format cookie files into `Nami/cookies/` for accounts requiring authentication.
3. Launch `nami` and select what media types you want to download (Photos, Videos, Stories, Highlights, or All).

## Configuration & Theme

- Settings and path configurations are saved automatically to `~/.nami/nami_config.json`.
- Customize theme contrast using the environment variable:
  ```bash
  export NAMI_THEME=light   # or dark
  ```

## License

[MIT License](LICENSE) © Igect
