ytplay-cli 0.4.0__tar.gz

ytplay_cli-0.4.0/PKG-INFO

@@ -0,0 +1,61 @@
+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

ytplay_cli-0.4.0/README.md

@@ -0,0 +1,44 @@
+# 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

ytplay_cli-0.4.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61,<70", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ytplay-cli"
+version = "0.4.0"
+description = "Search and play YouTube videos from the terminal using mpv and fzf"
+readme = "README.md"
+requires-python = ">=3.8"
+
+authors = [
+  { name = "Naveen" }
+]
+
+dependencies = [
+  "yt-dlp"
+]
+
+keywords = ["youtube", "cli", "terminal", "mpv", "fzf"]
+
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Environment :: Console",
+  "Operating System :: POSIX :: Linux"
+]
+
+[project.urls]
+Homepage = "https://github.com/naveen07-c/yt-cli"
+Repository = "https://github.com/naveen07-c/yt-cli"
+Issues = "https://github.com/naveen07-c/yt-cli/issues"
+
+[project.scripts]
+yt = "ytcli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["ytcli*"]

ytplay_cli-0.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ytplay_cli-0.4.0/ytcli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

ytplay_cli-0.4.0/ytcli/cli.py

@@ -0,0 +1,179 @@
+import argparse
+import os
+import subprocess
+import webbrowser
+
+from ytcli.search import search_youtube
+from ytcli.player import play_video, play_audio, download_video
+from ytcli.ui import select_video
+from ytcli.utils import format_duration, format_views
+from ytcli.config import load_config
+from ytcli.deps import check_dependencies
+from ytcli import __version__
+
+
+HISTORY_FILE = os.path.expanduser("~/.local/share/yt-cli/history")
+
+
+def save_history(query):
+
+    os.makedirs(os.path.dirname(HISTORY_FILE), exist_ok=True)
+
+    with open(HISTORY_FILE, "a") as f:
+        f.write(query + "\n")
+
+
+def show_history():
+
+    if not os.path.exists(HISTORY_FILE):
+        print("No history yet.")
+        return
+
+    with open(HISTORY_FILE) as f:
+        print(f.read())
+
+
+def fzf_menu(options, prompt):
+
+    fzf = subprocess.Popen(
+        [
+            "fzf",
+            "--height=40%",
+            "--layout=reverse",
+            "--border",
+            "--prompt", prompt
+        ],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        text=True
+    )
+
+    stdout, _ = fzf.communicate("\n".join(options))
+
+    return stdout.strip()
+
+
+def choose_action():
+
+    actions = [
+        "Play Video",
+        "Play Audio Only",
+        "Download Video",
+        "Open in Browser"
+    ]
+
+    return fzf_menu(actions, "Action > ")
+
+
+def choose_quality():
+
+    qualities = [
+        "1080",
+        "720",
+        "480",
+        "best"
+    ]
+
+    return fzf_menu(qualities, "Quality > ")
+
+
+def choose_speed():
+
+    speeds = [
+        "1",
+        "1.25",
+        "1.5",
+        "2"
+    ]
+
+    return fzf_menu(speeds, "Speed > ")
+
+
+def main():
+
+    check_dependencies()
+
+    parser = argparse.ArgumentParser(
+        description="YouTube CLI player"
+    )
+
+    parser.add_argument("query", nargs="*")
+    parser.add_argument("--audio", action="store_true")
+    parser.add_argument("--download", action="store_true")
+    parser.add_argument("--play", type=int)
+    parser.add_argument("--history", action="store_true")
+    parser.add_argument("--version", action="store_true")
+
+    args = parser.parse_args()
+
+    if args.version:
+        print("yt-cli version", __version__)
+        return
+
+    if args.history:
+        show_history()
+        return
+
+    if not args.query:
+        parser.print_help()
+        return
+
+    query = " ".join(args.query)
+
+    save_history(query)
+
+    config = load_config()
+
+    videos = search_youtube(query)
+
+    lines = []
+
+    for v in videos:
+
+        title = v.get("title", "Unknown")
+        channel = v.get("channel", "Unknown")
+        duration = format_duration(v.get("duration"))
+        views = format_views(v.get("view_count"))
+        vid = v.get("id")
+
+        lines.append(
+            f"{title} | {channel} | {duration} | {views} | {vid}"
+        )
+
+    selection = select_video(lines)
+
+    if not selection:
+        return
+
+    index = lines.index(selection)
+    video = videos[index]
+
+    video_id = video["id"]
+
+    # ACTION MENU
+    action = choose_action()
+
+    if action == "Play Audio Only":
+
+        play_audio(video_id)
+        return
+
+    if action == "Download Video":
+
+        download_video(video_id)
+        return
+
+    if action == "Open in Browser":
+
+        webbrowser.open(f"https://youtube.com/watch?v={video_id}")
+        return
+
+    # QUALITY MENU
+    quality = choose_quality()
+
+    # SPEED MENU
+    speed = choose_speed()
+
+    play_video(video_id, quality, speed)
+if __name__ == "__main__":
+    main()

ytplay_cli-0.4.0/ytcli/config.py

@@ -0,0 +1,29 @@
+import os
+import json
+
+CONFIG_DIR = os.path.expanduser("~/.config/yt-cli")
+CONFIG_FILE = os.path.join(CONFIG_DIR, "config.json")
+
+DEFAULT_CONFIG = {
+    "default_quality": "720",
+    "default_speed": "1"
+}
+
+
+def load_config():
+
+    if not os.path.exists(CONFIG_DIR):
+        os.makedirs(CONFIG_DIR)
+
+    if not os.path.exists(CONFIG_FILE):
+
+        with open(CONFIG_FILE, "w") as f:
+            json.dump(DEFAULT_CONFIG, f, indent=2)
+
+        return DEFAULT_CONFIG
+
+    try:
+        with open(CONFIG_FILE) as f:
+            return json.load(f)
+    except Exception:
+        return DEFAULT_CONFIG

ytplay_cli-0.4.0/ytcli/deps.py

@@ -0,0 +1,52 @@
+import shutil
+import subprocess
+import sys
+
+
+def detect_package_manager():
+
+    managers = ["apt", "dnf", "pacman"]
+
+    for m in managers:
+        if shutil.which(m):
+            return m
+
+    return None
+
+
+def install_package(pkg):
+
+    manager = detect_package_manager()
+
+    if manager == "apt":
+        subprocess.run(["sudo", "apt", "install", "-y", pkg])
+
+    elif manager == "dnf":
+        subprocess.run(["sudo", "dnf", "install", "-y", pkg])
+
+    elif manager == "pacman":
+        subprocess.run(["sudo", "pacman", "-S", "--noconfirm", pkg])
+
+    else:
+        print("No supported package manager found.")
+        sys.exit(1)
+
+
+def ensure_tool(tool, package):
+
+    if shutil.which(tool) is None:
+
+        print(f"{tool} not found. Installing {package}...")
+        install_package(package)
+
+
+def check_dependencies():
+
+    ensure_tool("fzf", "fzf")
+    ensure_tool("mpv", "mpv")
+    ensure_tool("jq", "jq")
+
+    if shutil.which("yt-dlp") is None:
+
+        print("Installing yt-dlp via pip...")
+        subprocess.run([sys.executable, "-m", "pip", "install", "yt-dlp"])

ytplay_cli-0.4.0/ytcli/player.py

@@ -0,0 +1,41 @@
+import subprocess
+
+
+def play_video(video_id, quality="720", speed="1"):
+
+    url = f"https://youtube.com/watch?v={video_id}"
+
+    if quality == "best":
+        fmt = "best"
+    else:
+        fmt = f"bestvideo[height<={quality}]+bestaudio/best"
+
+    subprocess.run([
+        "mpv",
+        "--ytdl-format=" + fmt,
+        "--speed=" + speed,
+        url
+    ])
+
+
+
+def play_audio(video_id):
+
+    url = f"https://youtube.com/watch?v={video_id}"
+
+    subprocess.run([
+        "mpv",
+        "--force-window=yes",
+        "--no-video",
+        url
+    ])
+
+
+def download_video(video_id):
+
+    url = f"https://youtube.com/watch?v={video_id}"
+
+    subprocess.run([
+        "yt-dlp",
+        url
+    ])

ytplay_cli-0.4.0/ytcli/search.py

@@ -0,0 +1,20 @@
+import yt_dlp
+
+RESULT_LIMIT = 30
+
+
+def search_youtube(query):
+
+    ydl_opts = {
+        "quiet": True,
+        "extract_flat": "in_playlist",
+        "skip_download": True
+    }
+
+    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        info = ydl.extract_info(
+            f"ytsearch{RESULT_LIMIT}:{query}",
+            download=False
+        )
+
+    return info.get("entries", [])

ytplay_cli-0.4.0/ytcli/ui.py

@@ -0,0 +1,57 @@
+import subprocess
+
+
+def select_video(lines):
+
+    preview_script = r'''
+id=$(echo {} | awk -F'|' '{print $NF}')
+
+json=$(yt-dlp --skip-download --dump-json https://youtube.com/watch?v=$id 2>/dev/null)
+
+title=$(echo "$json" | jq -r ".title")
+channel=$(echo "$json" | jq -r ".channel")
+views=$(echo "$json" | jq -r ".view_count")
+duration=$(echo "$json" | jq -r ".duration")
+date=$(echo "$json" | jq -r ".upload_date")
+
+# format duration
+h=$((duration / 3600))
+m=$(((duration % 3600) / 60))
+s=$((duration % 60))
+
+if [ "$h" -gt 0 ]; then
+    duration_fmt=$(printf "%d:%02d:%02d" "$h" "$m" "$s")
+else
+    duration_fmt=$(printf "%d:%02d" "$m" "$s")
+fi
+
+# format date YYYYMMDD -> YYYY-MM-DD
+date_fmt=$(echo "$date" | sed 's/\(....\)\(..\)\(..\)/\1-\2-\3/')
+
+echo "Title: $title"
+echo
+echo "Channel: $channel"
+echo "Views: $views"
+echo "Duration: $duration_fmt"
+echo "Upload Date: $date_fmt"
+'''
+
+    fzf = subprocess.Popen(
+        [
+            "fzf",
+            "--height=90%",
+            "--layout=reverse",
+            "--border",
+            "--prompt=YouTube > ",
+            "--preview",
+            preview_script,
+            "--preview-window=right:60%"
+        ],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        text=True
+    )
+
+    stdout, _ = fzf.communicate("\n".join(lines))
+
+    return stdout.strip()

ytplay_cli-0.4.0/ytcli/utils.py

@@ -0,0 +1,35 @@
+def format_duration(seconds):
+    """
+    Convert seconds to YouTube-like format:
+    HH:MM:SS or MM:SS
+    """
+
+    if seconds is None:
+        return "??:??"
+
+    seconds = int(seconds)
+
+    minutes, sec = divmod(seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+
+    if hours > 0:
+        return f"{hours}:{minutes:02d}:{sec:02d}"
+
+    return f"{minutes}:{sec:02d}"
+
+
+def format_views(v):
+    """
+    Convert views to readable format
+    """
+
+    if not v:
+        return "0"
+
+    if v >= 1_000_000:
+        return f"{v/1_000_000:.1f}M"
+
+    if v >= 1_000:
+        return f"{v/1_000:.1f}K"
+
+    return str(v)

ytplay_cli-0.4.0/ytplay_cli.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+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

ytplay_cli-0.4.0/ytplay_cli.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+ytcli/__init__.py
+ytcli/cli.py
+ytcli/config.py
+ytcli/deps.py
+ytcli/player.py
+ytcli/search.py
+ytcli/ui.py
+ytcli/utils.py
+ytplay_cli.egg-info/PKG-INFO
+ytplay_cli.egg-info/SOURCES.txt
+ytplay_cli.egg-info/dependency_links.txt
+ytplay_cli.egg-info/entry_points.txt
+ytplay_cli.egg-info/requires.txt
+ytplay_cli.egg-info/top_level.txt

ytplay_cli-0.4.0/ytplay_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ytplay_cli-0.4.0/ytplay_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+yt = ytcli.cli:main

ytplay_cli-0.4.0/ytplay_cli.egg-info/requires.txt

@@ -0,0 +1 @@
+yt-dlp

ytplay_cli-0.4.0/ytplay_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+ytcli