Metadata-Version: 2.4
Name: yt-termux
Version: 1.0.0
Summary: A user-friendly YouTube downloader CLI for Termux — powered by yt-dlp and aria2c with quality selection and full-bandwidth threading.
Author: yt-termux
License: MIT
Project-URL: Repository, https://github.com/yt-termux/yt-termux
Keywords: youtube,downloader,termux,yt-dlp,aria2c,android,cli
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: yt-dlp>=2024.1.1

# yt-termux

A user-friendly YouTube downloader CLI for **Termux** on Android.  
Powered by `yt-dlp` + `aria2c` with multi-connection threading, quality selection, and auto-saves to `/sdcard/Yt_downloads`.

---

## Install

```bash
pip install yt-termux
```

### Recommended (for max speed + MP4 merge support):

```bash
pkg install aria2 ffmpeg
pip install yt-termux
```

---

## Usage

Just type:

```bash
yt
```

1. Paste a YouTube URL  
2. Choose quality (4K / 1080p / 720p / 480p / 360p / Audio MP3)  
3. Download starts immediately — saved to `/sdcard/Yt_downloads`

---

## Features

- **Multi-connection downloads** via `aria2c` — uses full available bandwidth
- **Quality selection** — 4K, 2K, 1080p, 720p, 480p, 360p, or audio-only MP3
- **Threaded fragment downloads** — concurrent chunks for faster speeds
- **Default save path** — `/sdcard/Yt_downloads` (customizable per session)
- **Works without aria2c** — falls back gracefully to yt-dlp's built-in downloader

---

## Requirements

| Tool    | Install command          | Required? |
|---------|--------------------------|-----------|
| yt-dlp  | `pip install yt-dlp`     | Yes       |
| aria2   | `pkg install aria2`      | Recommended |
| ffmpeg  | `pkg install ffmpeg`     | Recommended |

---

## Environment Variables

| Variable           | Default                | Description                  |
|--------------------|------------------------|------------------------------|
| `YT_DOWNLOAD_DIR`  | `/sdcard/Yt_downloads` | Override default save folder |

---

## License

MIT
