@hrithick0330k/yt-cli 1.0.0

package/README.md

@@ -0,0 +1,72 @@
+<div align="center">
+
+# `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.
+
+[![npm version](https://badge.fury.io/js/yt-cli.svg)](https://badge.fury.io/js/yt-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## 🚀 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:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/hrithick03/yt-cli/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/hrithick03/yt-cli/main/install.ps1 | iex
+```
+
+### Manual NPM Install
+If you already have [Node.js](https://nodejs.org/), [yt-dlp](https://github.com/yt-dlp/yt-dlp), and [mpv](https://mpv.io/) natively installed:
+```bash
+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:
+```bash
+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):**
+```bash
+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.

package/bin/yt-cli.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const inquirer = require("inquirer");
+const chalk = require("chalk");
+const { searchYouTube } = require("../src/search");
+const { getLibrary, saveToLibrary, removeFromLibrary } = require("../src/storage");
+
+function printBanner() {
+  console.clear();
+  console.log(chalk.bold.greenBright(`
+██╗   ██╗████████╗      ██████╗ ██╗     ██╗
+╚██╗ ██╔╝╚══██╔══╝     ██╔════╝ ██║     ██║
+ ╚████╔╝    ██║  █████╗██║      ██║     ██║
+  ╚██╔╝     ██║  ╚════╝██║      ██║     ██║
+   ██║      ██║        ╚██████╗ ███████╗██║
+   ╚═╝      ╚═╝         ╚═════╝ ╚══════╝╚═╝
+`));
+  console.log(chalk.gray(`Launch infinite media streams from your terminal.  v1.0.0\n`));
+}
+
+async function startHub() {
+  printBanner();
+
+  let query = process.argv.slice(2).join(" ");
+  
+  if (query) {
+    await handleSearch(query);
+    return;
+  }
+
+  const { action } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "action",
+      message: "Main Menu:",
+      choices: [
+        { name: "🔍 Search YouTube", value: "search" },
+        { name: "📚 My Library (Favorites)", value: "library" },
+        { name: "❌ Exit", value: "exit" }
+      ]
+    }
+  ]);
+
+  if (action === "search") {
+    const answer = await inquirer.prompt([{
+      type: 'input',
+      name: 'query',
+      message: 'Enter a YouTube search query:',
+      validate: (input) => input.trim() ? true : 'Please enter a search term'
+    }]);
+    await handleSearch(answer.query);
+  } else if (action === "library") {
+    await showLibrary();
+  } else {
+    console.log(chalk.gray("Goodbye."));
+    process.exit(0);
+  }
+}
+
+async function showLibrary() {
+  const lib = getLibrary();
+  if (lib.favorites.length === 0) {
+    console.log(chalk.cyan(`\n[INFO] `) + chalk.white(`Your library is empty. Go search and save some videos!`));
+    setTimeout(startHub, 2000);
+    return;
+  }
+
+  const choices = lib.favorites.map((song) => ({
+    name: `${chalk.bold.cyan(song.title)} ${chalk.dim(`[${song.duration}] by ${song.uploader}`)}`,
+    value: song,
+  }));
+
+  choices.push(new inquirer.Separator());
+  choices.push({ name: "🔙 Back to Main Menu", value: "back" });
+
+  const { selectedVideo } = await inquirer.prompt([{
+    type: "list",
+    name: "selectedVideo",
+    message: "Your Favorites:",
+    choices: choices,
+    pageSize: 15,
+  }]);
+
+  if (selectedVideo === "back") {
+    return startHub();
+  }
+
+  await handleVideoSelection(selectedVideo, true);
+}
+
+async function handleSearch(query) {
+  printBanner();
+  console.log(chalk.bold.greenBright(`[1/3] YouTube Resolution`));
+  console.log(chalk.gray(`-----------------------------------------------------------------------------------------`));
+  console.log(chalk.cyan(`[INFO] `) + chalk.white(`Resolving query: ${query}...`));
+
+  let results = [];
+  try {
+    results = await searchYouTube(query, 15);
+  } catch (error) {
+    console.log(chalk.redBright(`[ERROR] `) + chalk.white(`Failed to search. Verify your yt-dlp installation.`));
+    process.exit(1);
+  }
+
+  if (results.length === 0) {
+    console.log(chalk.yellowBright(`[WARN] `) + chalk.white(`No results found for your query.`));
+    process.exit(1);
+  }
+
+  console.log(chalk.greenBright(`  ✔ Search completed. Found ${results.length} valid results.\n`));
+
+  const choices = results.map((song) => ({
+    name: `${chalk.bold.green(song.title)} ${chalk.dim(`[${song.duration}] by ${song.uploader}`)}`,
+    value: song,
+  }));
+
+  choices.push(new inquirer.Separator());
+  choices.push({ name: "🔙 Back to Main Menu", value: "back" });
+
+  const { selectedVideo } = await inquirer.prompt([{
+    type: "list",
+    name: "selectedVideo",
+    message: "Select a video:",
+    choices: choices,
+    pageSize: 15,
+  }]);
+
+  if (selectedVideo === "back") {
+    return startHub();
+  }
+
+  await handleVideoSelection(selectedVideo, false);
+}
+
+async function handleVideoSelection(video, fromLibrary = false) {
+  const { action } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "action",
+      message: "What would you like to do?",
+      choices: [
+        { name: "▶️  Play Video / Audio", value: "play" },
+        { name: "📻 Start Infinite Radio", value: "radio" },
+        { name: "⬇️  Download to PC", value: "download" },
+        fromLibrary 
+          ? { name: "🗑️  Remove from Library", value: "remove" }
+          : { name: "❤️ Save to Library", value: "save" },
+        { name: "🔙 Back", value: "back" }
+      ]
+    }
+  ]);
+
+  if (action === "save") {
+    const saved = saveToLibrary(video);
+    if (saved) console.log(chalk.bold.greenBright(`\n  ✔ Saved to your library!`));
+    else console.log(chalk.cyan(`\n[INFO] `) + chalk.white(`Already in your library.`));
+    setTimeout(startHub, 1500);
+    return;
+  }
+
+  if (action === "remove") {
+    removeFromLibrary(video.id);
+    console.log(chalk.bold.greenBright(`\n  ✔ Removed from library.`));
+    setTimeout(() => showLibrary(), 1500);
+    return;
+  }
+
+  if (action === "back") {
+    if (fromLibrary) return showLibrary();
+    return startHub();
+  }
+
+  if (action === "download") {
+    downloadVideo(video, fromLibrary);
+    return;
+  }
+
+  const { playbackOptions } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "playbackOptions",
+      message: "Select quality / format:",
+      choices: [
+        { name: "🎬 Auto (Best Quality)", value: "bestvideo+bestaudio/best" },
+        { name: "🎬 1080p", value: "bestvideo[height<=1080]+bestaudio/best" },
+        { name: "🎬 720p", value: "bestvideo[height<=720]+bestaudio/best" },
+        { name: "🎵 Audio Only (Background)", value: "bestaudio/best" },
+      ]
+    }
+  ]);
+
+  playVideo(video, playbackOptions, true, action === "radio", fromLibrary);
+}
+
+function downloadVideo(video, fromLibrary) {
+  printBanner();
+  console.log(chalk.bold.greenBright(`[2/3] Downloading Media`));
+  console.log(chalk.gray(`-----------------------------------------------------------------------------------------`));
+  console.log(chalk.cyan(`[INFO] `) + chalk.white(`Target: ${video.title}`));
+  console.log(chalk.cyan(`[INFO] `) + chalk.white(`Starting yt-dlp fetch...\n`));
+  
+  const ydlpArgs = [video.url, "-o", "%(title)s.%(ext)s"];
+  const dl = spawn("yt-dlp", ydlpArgs, { stdio: "inherit" });
+
+  dl.on("close", (code) => {
+    if (code === 0) console.log(chalk.bold.greenBright(`\n  ✔ Download completed successfully!`));
+    else console.log(chalk.bold.redBright(`\n[ERROR] `) + chalk.white(`Download failed or interrupted.`));
+    showPostMenu(fromLibrary);
+  });
+}
+
+function playVideo(video, formatStr, skipSponsors, isRadio, fromLibrary) {
+  printBanner();
+  console.log(chalk.bold.greenBright(`[2/3] Launching Media Sandbox`));
+  console.log(chalk.gray(`-----------------------------------------------------------------------------------------`));
+  console.log(chalk.cyan(`[INFO] `) + chalk.white(`Target Title: ${video.title}`));
+  if (isRadio) console.log(chalk.cyan(`[INFO] `) + chalk.greenBright(`Mode: Infinite Radio Stream ACTIVE`));
+  if (skipSponsors) console.log(chalk.cyan(`[INFO] `) + chalk.white(`SponsorBlock Engine: ENABLED`));
+  console.log(chalk.cyan(`[INFO] `) + chalk.white(`Handing off control to MPV...\n`));
+  
+  // For infinite radio, use the YouTube Auto-generated Mix RD[id]
+  const targetUrl = isRadio ? `https://www.youtube.com/watch?v=${video.id}&list=RD${video.id}` : video.url;
+
+  const mpvArgs = [
+    targetUrl,
+    `--ytdl-format=${formatStr}`,
+    "--really-quiet",
+    "--title=" + video.title,
+  ];
+
+  if (formatStr.includes("bestaudio") && !formatStr.includes("bestvideo")) {
+    mpvArgs.push("--no-video");
+  }
+
+  if (skipSponsors) {
+    mpvArgs.push("--ytdl-raw-options=sponsorblock-remove=sponsor");
+  }
+
+  const mpv = spawn("mpv", mpvArgs, { stdio: "inherit" });
+
+  mpv.on("close", (code) => {
+    console.log(chalk.cyan(`\n[INFO] `) + chalk.white(`Sandbox session closed. (Exit Code: ${code})`));
+    showPostMenu(fromLibrary);
+  });
+}
+
+function showPostMenu(fromLibrary) {
+  inquirer.prompt([{
+    type: "list",
+    name: "action",
+    message: "What next?",
+    choices: [
+      { name: "🏠 Back to Main Menu", value: "hub" },
+      { name: "❌ Quit", value: "quit" }
+    ]
+  }]).then((answers) => {
+    if (answers.action === "hub") {
+      process.argv = process.argv.slice(0, 2); // reset args for clean hub
+      startHub();
+    } else {
+      process.exit(0);
+    }
+  });
+}
+
+// Ignore initial arguments on unhandled rejections
+process.on("unhandledRejection", (r) => { 
+  console.log(chalk.red("Terminated."));
+  process.exit();
+});
+
+// Start app
+startHub().catch((err) => {
+  console.error(chalk.red("\nAn error occurred: " + err.message));
+});

package/install.ps1

@@ -0,0 +1,36 @@
+# yt-cli One-Line Installer Script for Windows
+Write-Host ""
+Write-Host "██╗   ██╗████████╗      ██████╗ ██╗     ██╗" -ForegroundColor Green
+Write-Host "╚██╗ ██╔╝╚══██╔══╝     ██╔════╝ ██║     ██║" -ForegroundColor Green
+Write-Host " ╚████╔╝    ██║  █████╗██║      ██║     ██║" -ForegroundColor Green
+Write-Host "  ╚██╔╝     ██║  ╚════╝██║      ██║     ██║" -ForegroundColor Green
+Write-Host "   ██║      ██║        ╚██████╗ ███████╗██║" -ForegroundColor Green
+Write-Host "   ╚═╝      ╚═╝         ╚═════╝ ╚══════╝╚═╝" -ForegroundColor Green
+Write-Host ""
+Write-Host "Initializing yt-cli installation..." -ForegroundColor Cyan
+
+# Install dependencies via Winget if available
+Write-Host "[INFO] Checking dependencies (Node.js, MPV, yt-dlp)..." -ForegroundColor Cyan
+$wingetPath = Get-Command winget -ErrorAction SilentlyContinue
+
+if ($null -ne $wingetPath) {
+    winget install --id=Nodejs.Nodejs -e --accept-package-agreements --accept-source-agreements
+    winget install --id=mpv.mpv -e --accept-package-agreements --accept-source-agreements
+    winget install --id=yt-dlp.yt-dlp -e --accept-package-agreements --accept-source-agreements
+} else {
+    Write-Host "[WARN] winget is not installed. Please install Node.js, mpv, and yt-dlp manually." -ForegroundColor Yellow
+}
+
+# Clone and install globally
+Write-Host "[INFO] Fetching yt-cli source code and installing globally..." -ForegroundColor Cyan
+$tempDir = Join-Path $env:TEMP "yt-cli-install"
+if (Test-Path $tempDir) { Remove-Item -Recurse -Force $tempDir }
+git clone https://github.com/hrithick03/yt-cli.git $tempDir
+Set-Location $tempDir
+npm install -g .
+
+Write-Host ""
+Write-Host "  ✔ Installation Complete! " -ForegroundColor Green -NoNewline
+Write-Host "You can now run " -NoNewline
+Write-Host "yt-cli " -ForegroundColor Magenta -NoNewline
+Write-Host "from your terminal."

package/install.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# yt-cli One-Line Installer Script
+set -e
+
+echo -e "\033[1;32m"
+echo "██╗   ██╗████████╗      ██████╗ ██╗     ██╗"
+echo "╚██╗ ██╔╝╚══██╔══╝     ██╔════╝ ██║     ██║"
+echo " ╚████╔╝    ██║  █████╗██║      ██║     ██║"
+echo "  ╚██╔╝     ██║  ╚════╝██║      ██║     ██║"
+echo "   ██║      ██║        ╚██████╗ ███████╗██║"
+echo "   ╚═╝      ╚═╝         ╚═════╝ ╚══════╝╚═╝"
+echo -e "\033[0m"
+echo "Initializing yt-cli installation..."
+
+# Install dependencies based on OS
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    echo "[INFO] macOS detected. Checking required dependencies..."
+    if ! command -v brew &> /dev/null; then
+        echo "[ERROR] Homebrew is required but not installed."
+        exit 1
+    fi
+    brew install mpv yt-dlp node
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux
+    echo "[INFO] Linux detected. Checking required dependencies..."
+    if command -v apt &> /dev/null; then
+        sudo apt update
+        sudo apt install -y mpv yt-dlp nodejs npm
+    elif command -v pacman &> /dev/null; then
+        sudo pacman -Sy --noconfirm mpv yt-dlp nodejs npm
+    else
+        echo "[WARN] Unsupported package manager. Please install mpv, yt-dlp, and nodejs manually."
+    fi
+else
+    echo "[WARN] Unsupported OS for this script. Please install manually."
+fi
+
+# Clone and install yt-cli
+echo "[INFO] Fetching yt-cli source code..."
+TMP_DIR=$(mktemp -d)
+git clone https://github.com/hrithick03/yt-cli.git "$TMP_DIR"
+cd "$TMP_DIR"
+
+echo "[INFO] Installing yt-cli globally via NPM..."
+sudo npm install -g .
+
+echo -e "\n\033[1;32m ✔ Installation Complete! \033[0m"
+echo "You can now run yt-cli from anywhere by typing: yt-cli"

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hrithick0330k/yt-cli",
+  "version": "1.0.0",
+  "description": "A CLI tool to search and play videos from YouTube",
+  "main": "src/search.js",
+  "bin": {
+    "yt-cli": "bin/yt-cli.js"
+  },
+  "scripts": {
+    "start": "node bin/yt-cli.js"
+  },
+  "keywords": [
+    "music",
+    "youtube",
+    "cli",
+    "player",
+    "mpv",
+    "yt-dlp",
+    "terminal"
+  ],
+  "author": "hrith",
+  "license": "MIT",
+  "dependencies": {
+    "inquirer": "^8.2.6",
+    "chalk": "^4.1.2"
+  }
+}

package/src/search.js

@@ -0,0 +1,60 @@
+const { spawn } = require("child_process");
+
+function searchYouTube(query, limit = 10) {
+  return new Promise((resolve, reject) => {
+    // Run yt-dlp to output JSON metadata
+    // --dump-json outputs a strict JSON object per line.
+    const args = [
+      `ytsearch${limit}:${query}`,
+      "--dump-json",
+      "--no-playlist",
+      "--default-search", "ytsearch"
+    ];
+
+    const ytdlp = spawn("yt-dlp", args);
+
+    let output = "";
+    let errorOutput = "";
+
+    ytdlp.stdout.on("data", (data) => {
+      output += data.toString();
+    });
+
+    ytdlp.stderr.on("data", (data) => {
+      errorOutput += data.toString();
+    });
+
+    ytdlp.on("close", (code) => {
+      if (code !== 0 && !output.trim()) {
+        console.error("yt-dlp error:", errorOutput);
+        return reject(new Error("Failed to fetch search results from yt-dlp."));
+      }
+
+      // Parse JSON lines
+      const songs = [];
+      const lines = output.trim().split("\n");
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        try {
+          const v = JSON.parse(line);
+          songs.push({
+            id: v.id,
+            title: v.title,
+            uploader: v.uploader || "Unknown",
+            duration: v.duration_string || "Unknown",
+            url: v.webpage_url || `https://www.youtube.com/watch?v=${v.id}`
+          });
+        } catch (e) {
+          // skip invalid json line (could be a warning if pushed to stdout stream)
+        }
+      }
+      resolve(songs);
+    });
+
+    ytdlp.on("error", (err) => {
+      reject(err);
+    });
+  });
+}
+
+module.exports = { searchYouTube };

package/src/storage.js

@@ -0,0 +1,40 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const libraryPath = path.join(os.homedir(), '.yt-cli-library.json');
+
+function initLibrary() {
+  if (!fs.existsSync(libraryPath)) {
+    fs.writeFileSync(libraryPath, JSON.stringify({ favorites: [] }, null, 2));
+  }
+}
+
+function getLibrary() {
+  initLibrary();
+  try {
+    const data = fs.readFileSync(libraryPath, 'utf8');
+    return JSON.parse(data);
+  } catch (error) {
+    return { favorites: [] };
+  }
+}
+
+function saveToLibrary(video) {
+  const lib = getLibrary();
+  // check if already exists
+  if (!lib.favorites.find(v => v.id === video.id)) {
+    lib.favorites.push(video);
+    fs.writeFileSync(libraryPath, JSON.stringify(lib, null, 2));
+    return true;
+  }
+  return false;
+}
+
+function removeFromLibrary(videoId) {
+  const lib = getLibrary();
+  lib.favorites = lib.favorites.filter(v => v.id !== videoId);
+  fs.writeFileSync(libraryPath, JSON.stringify(lib, null, 2));
+}
+
+module.exports = { getLibrary, saveToLibrary, removeFromLibrary };