yt2term 0.1.0__tar.gz

yt2term-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henri Nuortila
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yt2term-0.1.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: yt2term
+Version: 0.1.0
+Summary: YouTube video playback in terminal as ASCII
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python
+Requires-Dist: asciifyy
+Requires-Dist: pillow
+Requires-Dist: yt-dlp
+Dynamic: license-file
+
+# yt2term
+
+`yt2term` streams YouTube videos (or direct video links) as real-time ASCII art directly inside your terminal.
+
+## Entirely impractical - Weirdly meaningful
+
+---
+
+![example frame](images/cat_ascii.png)
+
+---
+
+## Features
+
+- Real-time video → ASCII conversion
+- ~30 FPS rendering loop
+- Optional color rendering
+- Adjustable output width
+- Optional audio playback via `ffplay`
+- Automatic FFmpeg detection
+
+---
+
+## Installation
+
+### Development install (recommended)
+
+```bash
+git clone https://github.com/<your-username>/yt2term.git
+cd yt2term
+
+pip install -e .
+```
+
+This installs the CLI command:
+
+```bash
+yt2term
+```
+
+### Standard install
+
+```bash
+pip install .
+```
+
+Use this if you just want a normal installed package.
+
+---
+
+## Python Version
+
+- Requires Python ≥ 3.10
+- Tested on Python 3.10+ / 3.12
+
+---
+
+## Dependencies
+
+Installed automatically via `pyproject.toml`:
+
+- `opencv-python`
+- `yt-dlp`
+- `pillow`
+- `asciifyy`
+
+---
+
+## Audio Support
+
+Audio playback uses `ffplay` from FFmpeg.
+
+Audio is disabled by default.
+
+Enable it with:
+
+```bash
+yt2term <link> --audio
+```
+
+If FFmpeg is missing, the application will:
+
+1. Detect it automatically
+2. Explain what is missing
+3. Prompt installation
+4. Attempt installation using the system package manager
+
+No digging through random forum posts from 2014 required.
+
+---
+
+## Usage
+
+### Basic playback
+
+```bash
+yt2term <youtube-or-video-url>
+```
+
+### Enable audio
+
+```bash
+yt2term <url> --audio
+```
+
+### Disable color output
+
+```bash
+yt2term <url> --no-color
+```
+
+### Set ASCII width
+
+```bash
+yt2term <url> --width 120
+```
+
+### Combined options
+
+```bash
+yt2term <url> --audio --width 100 --no-color
+```
+
+---
+
+## Notes
+
+- Uses `yt-dlp` to resolve streaming URLs
+- Requires an internet connection during playback
+- Performance depends heavily on terminal rendering speed
+- Audio/video sync is approximate
+- Designed for fun, experimentation, and terminal abuse
+
+---
+
+## Exit
+
+Press `Ctrl+C` to stop playback and return to reality.
+
+---
+
+## Project Structure
+
+```text
+yt2term/
+├── src/
+│   └── yt2term/
+│       ├── main.py
+│       ├── cli.py
+│       ├── video.py
+│       ├── audio.py
+│       ├── render.py
+```
+
+---
+
+## License
+
+MIT
+

yt2term-0.1.0/README.md

@@ -0,0 +1,160 @@
+# yt2term
+
+`yt2term` streams YouTube videos (or direct video links) as real-time ASCII art directly inside your terminal.
+
+## Entirely impractical - Weirdly meaningful
+
+---
+
+![example frame](images/cat_ascii.png)
+
+---
+
+## Features
+
+- Real-time video → ASCII conversion
+- ~30 FPS rendering loop
+- Optional color rendering
+- Adjustable output width
+- Optional audio playback via `ffplay`
+- Automatic FFmpeg detection
+
+---
+
+## Installation
+
+### Development install (recommended)
+
+```bash
+git clone https://github.com/<your-username>/yt2term.git
+cd yt2term
+
+pip install -e .
+```
+
+This installs the CLI command:
+
+```bash
+yt2term
+```
+
+### Standard install
+
+```bash
+pip install .
+```
+
+Use this if you just want a normal installed package.
+
+---
+
+## Python Version
+
+- Requires Python ≥ 3.10
+- Tested on Python 3.10+ / 3.12
+
+---
+
+## Dependencies
+
+Installed automatically via `pyproject.toml`:
+
+- `opencv-python`
+- `yt-dlp`
+- `pillow`
+- `asciifyy`
+
+---
+
+## Audio Support
+
+Audio playback uses `ffplay` from FFmpeg.
+
+Audio is disabled by default.
+
+Enable it with:
+
+```bash
+yt2term <link> --audio
+```
+
+If FFmpeg is missing, the application will:
+
+1. Detect it automatically
+2. Explain what is missing
+3. Prompt installation
+4. Attempt installation using the system package manager
+
+No digging through random forum posts from 2014 required.
+
+---
+
+## Usage
+
+### Basic playback
+
+```bash
+yt2term <youtube-or-video-url>
+```
+
+### Enable audio
+
+```bash
+yt2term <url> --audio
+```
+
+### Disable color output
+
+```bash
+yt2term <url> --no-color
+```
+
+### Set ASCII width
+
+```bash
+yt2term <url> --width 120
+```
+
+### Combined options
+
+```bash
+yt2term <url> --audio --width 100 --no-color
+```
+
+---
+
+## Notes
+
+- Uses `yt-dlp` to resolve streaming URLs
+- Requires an internet connection during playback
+- Performance depends heavily on terminal rendering speed
+- Audio/video sync is approximate
+- Designed for fun, experimentation, and terminal abuse
+
+---
+
+## Exit
+
+Press `Ctrl+C` to stop playback and return to reality.
+
+---
+
+## Project Structure
+
+```text
+yt2term/
+├── src/
+│   └── yt2term/
+│       ├── main.py
+│       ├── cli.py
+│       ├── video.py
+│       ├── audio.py
+│       ├── render.py
+```
+
+---
+
+## License
+
+MIT
+

yt2term-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yt2term"
+version = "0.1.0"
+description = "YouTube video playback in terminal as ASCII"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "opencv-python",
+    "asciifyy",
+    "pillow",
+    "yt-dlp",
+]
+
+[project.scripts]
+yt2term = "yt2term.main:main"

yt2term-0.1.0/setup.cfg

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

yt2term-0.1.0/src/yt2term/audio.py

@@ -0,0 +1,67 @@
+import platform
+import shutil
+import subprocess
+import time
+
+
+def ensure_ffplay() -> bool:
+    if shutil.which("ffplay") is not None:
+        return True
+
+    print("ffplay not found.")
+
+    answer: str = input(
+        "Would you like to install FFmpeg? (y/n): "
+    ).strip().lower()
+
+    if answer != "y":
+        return False
+
+    system: str = platform.system()
+
+    try:
+        if system == "Windows":
+            subprocess.run(
+                ["winget", "install", "Gyan.FFmpeg"],
+                check=True
+            )
+
+        elif system == "Darwin":
+            subprocess.run(
+                ["brew", "install", "ffmpeg"],
+                check=True
+            )
+
+        elif system == "Linux":
+            subprocess.run(
+                ["sudo", "apt", "install", "-y", "ffmpeg"],
+                check=True
+            )
+
+        else:
+            print("Unsupported operating system.")
+            return False
+
+    except Exception as e:
+        print(f"Installation failed: {e}")
+        return False
+
+    return shutil.which("ffplay") is not None
+
+
+def get_audio_process(stream_url: str) -> subprocess.Popen | None:
+    if not ensure_ffplay():
+        print("Resuming play without audio.")
+        time.sleep(2)
+        return None
+
+    return subprocess.Popen(
+        [
+            "ffplay",
+            "-nodisp",
+            "-autoexit",
+            "-loglevel",
+            "quiet",
+            stream_url
+        ]
+    )

yt2term-0.1.0/src/yt2term/cli.py

@@ -0,0 +1,41 @@
+import argparse
+import shutil
+
+
+def get_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser()
+
+    parser.add_argument(
+        "link",
+        type=str,
+        nargs="?",
+        default="https://www.youtube.com/watch?v=IxX_QHay02M",
+        help="YouTube/video link"
+    )
+
+    parser.add_argument(
+        "--no-color",
+        action="store_true",
+        help="Disable color output"
+    )
+
+    parser.add_argument(
+        "--width",
+        type=int,
+        help="ASCII width"
+    )
+
+    parser.add_argument(
+        "--audio",
+        action="store_true",
+        help="Enable audio playback (requires ffplay)"
+    )
+
+    return parser.parse_args()
+
+
+def get_width(args: argparse.Namespace) -> int:
+    if args.width is not None:
+        return args.width
+
+    return shutil.get_terminal_size().columns

yt2term-0.1.0/src/yt2term/main.py

@@ -0,0 +1,47 @@
+import argparse
+import subprocess
+
+import cv2
+import numpy as np
+
+from yt2term import (
+    cli,
+    audio,
+    video,
+    render,
+)
+
+
+def main() -> None:
+    args: argparse.Namespace = cli.get_args()
+    color: bool = not args.no_color
+
+    stream_url: str = video.get_stream_url(link=args.link)
+
+    cap: cv2.VideoCapture = cv2.VideoCapture(stream_url)
+
+    audio_process: subprocess.Popen | None = None
+    if args.audio:
+        audio_process = audio.get_audio_process(stream_url)
+
+    render.clear_screen()
+    try:
+        while True:
+            width: int = cli.get_width(args)
+
+            frame: np.ndarray | None = video.read_frame(cap)
+
+            if not render.process_frame(frame, width, color):
+                break
+
+    except KeyboardInterrupt:
+        pass
+
+    finally:
+        cap.release()
+        if audio_process is not None:
+            audio_process.kill()
+
+
+if __name__ == "__main__":
+    main()

yt2term-0.1.0/src/yt2term/render.py

@@ -0,0 +1,73 @@
+import time
+from typing import Callable
+
+import cv2
+import asciify
+import numpy as np
+from PIL import Image
+
+
+# CONSTANTS
+TARGET_HZ: int = 30
+FRAME_DELTA_TIME: float = 1.0 / TARGET_HZ
+
+
+def clear_screen() -> None:
+    print("\033[2J\033[H", end="")
+
+
+def control_frame_rate(func: Callable) -> Callable:
+    def wrapper(*args, **kwargs):
+        start: float = time.perf_counter()
+
+        result = func(*args, **kwargs)
+
+        elapsed: float = time.perf_counter() - start
+        sleep_time: float = FRAME_DELTA_TIME - elapsed
+
+        if sleep_time > 0:
+            time.sleep(sleep_time)
+
+        return result
+
+    return wrapper
+
+
+def frame_to_ascii(
+    frame: np.ndarray,
+    width: int,
+    color: bool
+) -> str:
+
+    rgb: np.ndarray = cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)
+
+    pil_image: Image.Image = Image.fromarray(rgb)
+
+    image = asciify.resize_image(pil_image, width)
+
+    return asciify.pixels_to_colored_ascii(
+        image,
+        color
+    )
+
+
+def render_frame(art: str) -> None:
+    print("\033[H", end="") # Clear
+    print(art, end="", flush=True)
+
+
+@control_frame_rate
+def process_frame(
+    frame: np.ndarray | None,
+    width: int,
+    color: bool
+) -> bool:
+
+    if frame is None:
+        return False
+
+    art: str = frame_to_ascii(frame, width, color)
+
+    render_frame(art)
+
+    return True

yt2term-0.1.0/src/yt2term/video.py

@@ -0,0 +1,27 @@
+import cv2
+import numpy as np
+from yt_dlp import YoutubeDL
+
+
+def read_frame(cap: cv2.VideoCapture) -> np.ndarray | None:
+    ret, frame = cap.read()
+
+    if not ret:
+        return None
+
+    return frame
+
+
+def get_stream_url(link: str) -> str:
+    ydl_opts = {
+        "format": "best[ext=mp4]",
+        "quiet": True,
+        "no_warnings": True,
+    }
+
+    with YoutubeDL(ydl_opts) as ydl:
+        info = ydl.extract_info(link, download=False)
+
+        stream_url: str = info["url"]
+
+    return stream_url

yt2term-0.1.0/src/yt2term.egg-info/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: yt2term
+Version: 0.1.0
+Summary: YouTube video playback in terminal as ASCII
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python
+Requires-Dist: asciifyy
+Requires-Dist: pillow
+Requires-Dist: yt-dlp
+Dynamic: license-file
+
+# yt2term
+
+`yt2term` streams YouTube videos (or direct video links) as real-time ASCII art directly inside your terminal.
+
+## Entirely impractical - Weirdly meaningful
+
+---
+
+![example frame](images/cat_ascii.png)
+
+---
+
+## Features
+
+- Real-time video → ASCII conversion
+- ~30 FPS rendering loop
+- Optional color rendering
+- Adjustable output width
+- Optional audio playback via `ffplay`
+- Automatic FFmpeg detection
+
+---
+
+## Installation
+
+### Development install (recommended)
+
+```bash
+git clone https://github.com/<your-username>/yt2term.git
+cd yt2term
+
+pip install -e .
+```
+
+This installs the CLI command:
+
+```bash
+yt2term
+```
+
+### Standard install
+
+```bash
+pip install .
+```
+
+Use this if you just want a normal installed package.
+
+---
+
+## Python Version
+
+- Requires Python ≥ 3.10
+- Tested on Python 3.10+ / 3.12
+
+---
+
+## Dependencies
+
+Installed automatically via `pyproject.toml`:
+
+- `opencv-python`
+- `yt-dlp`
+- `pillow`
+- `asciifyy`
+
+---
+
+## Audio Support
+
+Audio playback uses `ffplay` from FFmpeg.
+
+Audio is disabled by default.
+
+Enable it with:
+
+```bash
+yt2term <link> --audio
+```
+
+If FFmpeg is missing, the application will:
+
+1. Detect it automatically
+2. Explain what is missing
+3. Prompt installation
+4. Attempt installation using the system package manager
+
+No digging through random forum posts from 2014 required.
+
+---
+
+## Usage
+
+### Basic playback
+
+```bash
+yt2term <youtube-or-video-url>
+```
+
+### Enable audio
+
+```bash
+yt2term <url> --audio
+```
+
+### Disable color output
+
+```bash
+yt2term <url> --no-color
+```
+
+### Set ASCII width
+
+```bash
+yt2term <url> --width 120
+```
+
+### Combined options
+
+```bash
+yt2term <url> --audio --width 100 --no-color
+```
+
+---
+
+## Notes
+
+- Uses `yt-dlp` to resolve streaming URLs
+- Requires an internet connection during playback
+- Performance depends heavily on terminal rendering speed
+- Audio/video sync is approximate
+- Designed for fun, experimentation, and terminal abuse
+
+---
+
+## Exit
+
+Press `Ctrl+C` to stop playback and return to reality.
+
+---
+
+## Project Structure
+
+```text
+yt2term/
+├── src/
+│   └── yt2term/
+│       ├── main.py
+│       ├── cli.py
+│       ├── video.py
+│       ├── audio.py
+│       ├── render.py
+```
+
+---
+
+## License
+
+MIT
+

yt2term-0.1.0/src/yt2term.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+src/yt2term/__init__.py
+src/yt2term/audio.py
+src/yt2term/cli.py
+src/yt2term/main.py
+src/yt2term/render.py
+src/yt2term/video.py
+src/yt2term.egg-info/PKG-INFO
+src/yt2term.egg-info/SOURCES.txt
+src/yt2term.egg-info/dependency_links.txt
+src/yt2term.egg-info/entry_points.txt
+src/yt2term.egg-info/requires.txt
+src/yt2term.egg-info/top_level.txt

yt2term-0.1.0/src/yt2term.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

yt2term-0.1.0/src/yt2term.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+yt2term = yt2term.main:main

yt2term-0.1.0/src/yt2term.egg-info/requires.txt

@@ -0,0 +1,4 @@
+opencv-python
+asciifyy
+pillow
+yt-dlp

yt2term-0.1.0/src/yt2term.egg-info/top_level.txt

@@ -0,0 +1 @@
+yt2term