Metadata-Version: 2.4
Name: novadl
Version: 1.0.2
Summary: A high-performance ANSI TUI for downloading videos and audio
Home-page: https://github.com/ShovonSheikh
Author: MD. Shahariar Ahmmed Shovon
Author-email: "MD. Shahariar Ahmmed Shovon" <shovonali885@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ShovonSheikh
Keywords: youtube-dl,yt-dlp,downloader,tui,termux,video,audio
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Video
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# novadl - Nova Downloader v3.0

*fast & clean · video / audio fetcher*

A beautifully designed terminal user interface (TUI) for downloading videos and audio from various platforms. Nova Downloader features a rich, gradient-accented interface, real-time progress tracking, and robust queue management.

## ✨ Features

- 🎨 **Modern TUI Interface:** Rich ANSI colors, gradient ASCII wordmarks, and dynamic platform-specific accent colors.
- 🎵 **Audio & Video Modes:** Easily toggle between Video (MP4) and Audio-Only (MP3) downloads.
- ⚡ **Concurrent Playlists:** Download entire playlists blazingly fast with multi-threading (default: 3 workers).
- 📜 **Download History:** Keep track of your past downloads natively with the built-in history log.
- ⏳ **Resume Support:** Automatically resumes partial downloads if your connection drops.
- 📥 **Interactive Queueing:** Add multiple URLs to a queue in interactive mode before processing them all at once.
- 🔄 **Smart Dependencies:** Auto-checks and updates `yt-dlp` and `ffmpeg` in the background.
- 📱 **Termux Native:** First-class Android/Termux support with automatic setup for the Termux Media Scanner API.

## 📦 Installation

**From PyPI (Recommended):**
```bash
pip install novadl
````

## 🚀 Usage

### Interactive Mode

Simply run the command without arguments to enter the interactive queue and setup wizard:

```bash
novadl
```

1.  Enter a video or playlist URL (or type `h` for history, `q` to quit).
2.  Choose your mode: `[v]ideo` or `[a]udio`.
3.  Toggle auto-open and set your concurrent workers.
4.  Add more URLs to the queue or press enter to start batch downloading\!

### CLI Arguments

You can also bypass the interactive mode using standard flags:

```bash
# Download a single video
novadl "[https://youtube.com/watch?v=](https://youtube.com/watch?v=)..."

# Download audio only (MP3)
novadl "[https://youtube.com/watch?v=](https://youtube.com/watch?v=)..." -a

# Download a playlist using 5 parallel workers
novadl "[https://youtube.com/playlist?list=](https://youtube.com/playlist?list=)..." -w 5

# Download and automatically open the folder when finished
novadl "[https://youtube.com/watch?v=](https://youtube.com/watch?v=)..." -o

# Force a fresh download (ignore partial/temp files)
novadl "[https://youtube.com/watch?v=](https://youtube.com/watch?v=)..." --no-resume

# View your recent download history
novadl --history
```

## 📱 Termux Setup (Android)

If you are running `novadl` on Android via Termux, the app will automatically detect your environment and guide you through installing the `termux-api` package and the Termux:API companion app. This allows `novadl` to trigger the Android Media Scanner so your downloaded videos and songs immediately appear in your gallery and music apps\!

## 📝 License

This project is licensed under the [MIT License](https://www.google.com/search?q=LICENSE).
