novadl 1.0.2

A high-performance ANSI TUI for downloading videos and audio

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):

pip install novadl

🚀 Usage

Interactive Mode

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

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:

# 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.