Skip to content

v1.0.0

Choose a tag to compare

@anshupriyan anshupriyan released this 15 Jul 10:56
· 21 commits to main since this release

TermTube v1.0.0

Stream any YouTube video straight into your terminal — real-time video rendered as colored text, with fully synced audio. No browser, no video player, no GUI. Just Python, ffmpeg, and numpy turning pixels into characters, live.

ascii_demo

Features

  • Live YouTube resolution via yt-dlp — no downloading, prefers 720p with locked 16:9 aspect ratio
  • Two render styles: halfblock (high-density colored blocks) and ascii (classic density-character text art), plus custom --ramp support
  • Synced audio playback via ffplay, waits for audio to finish naturally instead of cutting it off early
  • Clock-driven AV sync with automatic frame-drop recovery to prevent drift on longer videos
  • Fast numpy-vectorized rendering, well under 2ms/frame even at 720p
  • Auto-detects terminal size to fill your window (or set manually with --cols)
  • Startup benchmark + live drift logging + frame-drop summary at exit

Requirements

  • Python 3.10+
  • ffmpeg and ffplay on PATH
  • yt-dlp, numpy

Known Limitations

  • Minor drift possible on long videos under heavy load or unstable network
  • Tested mainly on Windows Terminal / PowerShell
  • No seek/pause controls yet, no playlist support