yt-cli 📺

The Ultimate Terminal Media Center

Launch infinite media streams straight from your terminal. Skip the ads. Build your library. Never leave the command line.

🚀 Why yt-cli?

yt-cli isn't just a search tool—it's a drastically optimized terminal environment that transforms your command line into a highly professional YouTube Jukebox and Video Sandbox.

• 📻 Infinite Radio: Start a song and let yt-cli endlessly queue intelligent YouTube Mixes. The music never stops.
• 🚫 Native SponsorBlock: We don't ask you if you want ads. They are sliced out and skipped natively so you never hear a sponsorship segment again.
• 📚 Local Hub Library: Save endless tracks to your persistent terminal vault (~/.yt-cli-library.json), and access them instantly without searching.
• 🎵 Auto/Audio-Only Modes: Want to just vibe while you code? Drop it in background audio mode smoothly.
• ⬇️ 1-Click Downloads: Rip any media straight to your PC in one stroke.
• 💻 Minimalist & Pristine: Inspired by tools like ani-cli, the entire UI aggressively clears to maintain a distraction-free hacking aesthetic.

🛠️ Installation

⚡ The 1-Line Installer (Recommended)

This script will automatically detect your OS, install all required dependencies (mpv, yt-dlp, node), and install yt-cli globally for you!

Mac / Linux / WSL:

curl -fsSL https://raw.githubusercontent.com/hrithick03/yt-cli/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/hrithick03/yt-cli/main/install.ps1 | iex

Manual NPM Install

If you already have Node.js, yt-dlp, and mpv natively installed:

npm install -g @hrithick0330k/yt-cli

(If you are installing locally from source, clone the repo and run npm install -g . )

🎮 Usage

Simply pop open your favorite terminal and type:

yt-cli

The aesthetic main hub will boot up, allowing you to seamlessly dive into your library or search for new videos.

Direct Search (Quick Launch):

yt-cli "lofi hip hop radio"

🗺️ Roadmap & Features

• [x] SponsorBlock Integration
• [x] Local Library & Playlists
• [x] Auto-Fetch Next Recommendations (Infinite Radio)
• [x] Pristine Terminal Interface (Auto-Clean)

📜 License

MIT License. Created by you and open-source forever. Do what you want with the code.