Metadata-Version: 2.1
Name: ytplay-cli
Version: 0.4.0
Summary: Search and play YouTube videos from the terminal using mpv and fzf
Author: Naveen
Project-URL: Homepage, https://github.com/naveen07-c/yt-cli
Project-URL: Repository, https://github.com/naveen07-c/yt-cli
Project-URL: Issues, https://github.com/naveen07-c/yt-cli/issues
Keywords: youtube,cli,terminal,mpv,fzf
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp

# yt-cli

Search, preview, and play YouTube videos directly from the terminal.

`yt-cli` is a lightweight command-line tool that allows users to search YouTube, browse results interactively, preview video information, and play or download videos — all without leaving the terminal.

The tool combines several powerful utilities:

- **yt-dlp** → fetches YouTube metadata and streams
- **fzf** → interactive fuzzy search interface
- **mpv** → video/audio playback
- **jq** → JSON parsing for preview data

This makes it possible to build a fast, terminal-based YouTube experience.

---

# Features

- Search YouTube from the terminal
- Interactive video selection using **fzf**
- Preview video metadata while browsing results
- Play videos directly with **mpv**
- Play **audio-only** mode
- Download videos using **yt-dlp**
- Open selected video in the browser
- Choose playback **quality**
- Adjust playback **speed**
- Maintain **search history**
- Clean CLI interface designed for Linux environments

---

# Installation

The recommended installation method is **pipx**.

`pipx` installs Python CLI applications globally but keeps dependencies isolated.

Install pipx if not installed:

```bash
sudo apt install pipx
pipx ensurepath
