Metadata-Version: 2.4
Name: navig-download
Version: 0.1.2
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>=3.24.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
Dynamic: license-file

# navig-download

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.
