Repository navigation
v1.0.0
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.
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) andascii(classic density-character text art), plus custom--rampsupport - 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