Yt2Cli

A simple command-line (CLI) tool for searching and playing YouTube videos directly from the terminal, without needing to open a browser.

Features

• Search YouTube videos by keyword
• Display search results (title + channel)
• Play any video from the list through an external player
• Cross-platform: works on Windows, macOS, and Linux

Requirements

1. Python

Recommended version: Python 3.11 or older (to avoid compatibility issues with some packages).

2. mpv for video playback (optinal)

The app relies on mpv as the default player. If it's not installed, the app will fall back to opening the link with the system's default application.

Installing mpv:

Installation

  pip install yt2cli

Usage

poetry run yt2cli

Available Commands

Example

Yt2Cli Run: search python tutorial
0-Python Basics , BY CHANNEL [Programming Academy]
--------------------
1-Learn Python for Beginners , BY CHANNEL [Code Channel]
--------------------

Yt2Cli Run: open 0

Project Structure

yt2cli/
├── __init__.py     # App export entry point
├── App.py          # Core logic and command handling
├── Backend.py
├── Player.py
└── cli.py            # Entry point

Notes

• The app uses yt-dlp to search and extract video playback URLs.

License

MIT