Metadata-Version: 2.4
Name: fifu
Version: 1.4.5
Summary: A cross-platform TUI for downloading YouTube videos from channels
Project-URL: Homepage, https://github.com/Dawaman43/fifu
Project-URL: Issues, https://github.com/Dawaman43/fifu/issues
Author-email: Dawaman43 <dawaman43@example.com>
License: MIT
Keywords: downloader,textual,tui,video,youtube,yt-dlp
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.10
Requires-Dist: click>=8.1.0
Requires-Dist: textual>=0.47.0
Requires-Dist: yt-dlp>=2024.1.0
Description-Content-Type: text/markdown

# 🎬 Fifu

**The Ultra-Fast, Cross-Platform TUI for Downloading YouTube Channel Content.**

[![Build Status](https://github.com/Dawaman43/fifu/actions/workflows/publish.yml/badge.svg)](https://github.com/Dawaman43/fifu/actions)
[![PyPI version](https://badge.fury.io/py/fifu.svg)](https://badge.fury.io/py/fifu)
[![AUR version](https://img.shields.io/aur/version/fifu)](https://aur.archlinux.org/packages/fifu)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

Fifu (Fetch It For Us) is a high-performance Terminal User Interface (TUI) designed for power users who want to download entire YouTube channels or playlists with zero friction. Built with **Textual** and powered by **yt-dlp**.

---

## ✨ Key Features

- 🚀 **Asynchronous Performance** - Multi-threaded metadata fetching and concurrent downloads (3 at a time).
- 🔍 **Smart Search** - Find any channel instantly, sorted by popularity (subscriber count).
- 📋 **Playlist Intelligence** - Direct support for downloading entire playlists or specific channel sections.
- ⚙️ **Custom Quality Profiles** - 1080p, 720p, 480p, or high-fidelity Audio (MP3/M4A).
- 💬 **Subtitle Support** - Automatically download and embed subtitles into your videos.
- 💾 **Safe History & Favorites** - One-click access to your most-visited channels.
- 🏁 **Graceful UX** - Beautiful progress bars, keyboard-first navigation, and instant shutdown.

---

## 🚀 Quick Start

The fastest way to install Fifu on any system is using **pipx**:

```bash
pipx install git+https://github.com/Dawaman43/fifu.git
```

---

## 📦 Installation Options

### 🐧 Linux

#### Arch Linux (AUR)

```bash
yay -S fifu
```

#### Debian / Ubuntu / Mint

Download the latest `.deb` from [Releases](https://github.com/Dawaman43/fifu/releases) and run:

```bash
sudo dpkg -i fifu.deb
```

#### Fedora / RHEL

Download the latest `.rpm` from [Releases](https://github.com/Dawaman43/fifu/releases) and run:

```bash
sudo rpm -i fifu.rpm
```

### 🪟 Windows

1. Download `fifu-win.exe` from [Releases](https://github.com/Dawaman43/fifu/releases).
2. Run it from your terminal or double-click to start.

### 🍎 macOS

```bash
curl -L -o fifu https://github.com/Dawaman43/fifu/releases/latest/download/fifu-macos
chmod +x fifu
./fifu
```

---

## ⌨️ Controls

| Key             | Action                     |
| :-------------- | :------------------------- |
| `Enter`         | Select / Confirm / Start   |
| `f`             | Toggle Channel as Favorite |
| `PageUp / Down` | Navigate search results    |
| `Escape`        | Go back                    |
| `q`             | Quit Safely                |

---

## 🛠️ Tech Stack

- **[Textual](https://textual.textualize.io/)** - Stunning TUI framework.
- **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** - The industry standard for video extraction.
- **[Asyncio](https://docs.python.org/3/library/asyncio.html)** - Powering concurrent downloads.

---

## 📜 License

Fifu is released under the **MIT License**. See [LICENSE](LICENSE) for details.

---

_Made with ❤️ by [Dawaman43](https://github.com/Dawaman43)_
