Metadata-Version: 2.4
Name: navig-download
Version: 0.2.0
Summary: NAVIG Download module — universal media downloader (yt-dlp): video, audio & files from YouTube, TikTok and any supported site. A first-party navig plugin (free, toggleable).
Author-email: NAVIG Development Team <opensource@navig.run>
License-Expression: Apache-2.0
Project-URL: Homepage, https://navig.run
Project-URL: Documentation, https://navig.run/docs
Keywords: navig,cli,agent,automation,plugin,download,media,yt-dlp,video
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: navig-sdk>=2.8.0
Requires-Dist: typer>=0.14.0
Requires-Dist: rich>=13.7.0
Requires-Dist: yt-dlp
Requires-Dist: curl_cffi>=0.7.0
Requires-Dist: tqdm>=4.0.0
Requires-Dist: urllib3>=1.26.0
Requires-Dist: requests>=2.25.0
Provides-Extra: vault
Requires-Dist: navig-vault>=0.7.0; extra == "vault"
Dynamic: license-file

# navig-download

<!-- navig:plugin-card:start -->
<!-- Generated by scripts/gen_plugin_catalog.py — edit the plugin's pyproject.toml, not this block. -->

> Universal media downloader (yt-dlp): video, audio & files from YouTube, TikTok and any supported site.

**Works on its own** — its own CLI, no navig required · v0.2.0 · [PyPI](https://pypi.org/project/navig-download/)

**On its own** (no navig needed)

```bash
pip install navig-download
navig-download --help   # no navig needed
```

**With navig**

```bash
pip install "navig[download]"
navig download --help
```

<details><summary>Commands</summary>

| Command | What it does |
|---|---|
| `navig dl analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig dl batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig dl comments` | List the top comments, ranked by likes. |
| `navig dl download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig dl info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig dl login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig dl logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig dl music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig dl post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig dl profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |
| `navig download analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig download batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig download comments` | List the top comments, ranked by likes. |
| `navig download download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig download info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig download login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig download logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig download music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig download post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig download profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |
| `navig generate download` | Download a video (TikTok & friends) — same engine as `navig download`. |
| `navig generate tiktok analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig generate tiktok batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig generate tiktok comments` | List the top comments, ranked by likes. |
| `navig generate tiktok download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig generate tiktok info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig generate tiktok login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig generate tiktok logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig generate tiktok music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig generate tiktok post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig generate tiktok profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |
| `navig media download` | Download a video (TikTok & friends) — same engine as `navig download`. |
| `navig media tiktok analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig media tiktok batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig media tiktok comments` | List the top comments, ranked by likes. |
| `navig media tiktok download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig media tiktok info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig media tiktok login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig media tiktok logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig media tiktok music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig media tiktok post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig media tiktok profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |
| `navig tiktok analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig tiktok batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig tiktok comments` | List the top comments, ranked by likes. |
| `navig tiktok download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig tiktok info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig tiktok login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig tiktok logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig tiktok music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig tiktok post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig tiktok profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |
| `navig tt analyse` | AI markdown briefing of a post (description + best comments combined). |
| `navig tt batch` | Download every URL in a links file (videos via yt-dlp, /photo/ posts via the browser). |
| `navig tt comments` | List the top comments, ranked by likes. |
| `navig tt download` | Download TikTok posts (organized <out>/<creator>/<id>) — concurrent, resumable. |
| `navig tt info` | Show metadata: creator, description, stats (and image URLs for /photo/ posts). |
| `navig tt login` | Log into TikTok once and vault the session; afterwards every command uses it automatically. |
| `navig tt logout` | Forget the vaulted TikTok session (go back to anonymous browsing). |
| `navig tt music-links` | Resolve a music link to the same track on every other platform (via song.link). |
| `navig tt post` | Read a whole post via the browser in ONE pass — description + stats + comments. |
| `navig tt profile` | Download a creator's whole profile — videos, slideshows images, audio, or just metadata. |

</details>

<!-- navig:plugin-card:end -->

NAVIG **Download** — a universal media downloader (yt-dlp) for video, audio & files from
YouTube, TikTok and any supported site. A first-party navig plugin (free, toggleable),
extracted from `navig-media`.

## What it does

- **Download** organized, resumable, concurrent media via the bundled yt-dlp engine.
- **TikTok extras** — metadata, top comments, and AI briefings for TikTok links.
- **Music links** — resolve a Spotify/Apple Music/Deezer/… link to the same track on every
  platform (song.link / Odesli, no API key).

## Commands

```
navig download <url…>       # download (organized <out>/<creator>/<id>)   (alias: dl)
navig download batch <file> # download every URL in a text file
navig download profile <u>  # whole profile (filters, archive, limits)
navig download info <url>   # metadata: creator · country · description · stats
navig download comments <url>
navig download analyse <url> # AI markdown briefing
navig download music-links <url>  # resolve a music link across all 18+ platforms (song.link)
```

`navig tiktok` / `tt` remain as back-compat aliases of the same app.

## Install

Bundled with a full `navig` install (the `download` extra); standalone:
`navig store install pip:navig-download` — or `pip install navig-download` once published.
Requires `navig-core` in the same environment.
