Repository navigation
β‘ TermTube v1.1.0 β The Interactive & Aesthetic Update
Stream YouTube videos directly inside your terminal with ANSI truecolor or ASCII rendering and synchronized audio. This release introduces seamless live hotkeys (no playback interruption), vibrant color themes, robust stream extraction with Deno, and a streamlined zero-install workflow.
π Highlights & What's New
1. β¨οΈ Live In-Flight Hotkey Controls
Switch styles, tweak lighting, or change colors on the fly without stopping playback:
S/Tab/Space: Cycle through all rendering styles with automatic wrap-around.1-6: Jump directly to Binary 0101, Block Shades (ββββ), High-Contrast, Classic ASCII, Matrix Code, or Dots.0/H: Switch straight into Half-Block HD Truecolor (β).C: Cycle color modes (RGB β Matrix β Cyberpunk β Glitch β Rainbow β Amber β Fire β Gray).G&M: Instant one-key toggles for VHS Glitch and Matrix Neon Green.+/-&[/]: Dial contrast and brightness up or down in real time.A/I: Instant toggle for Dynamic Auto-Contrast and Ramp Inversion.- On-Screen Display (OSD): Visual badge overlay displays current settings whenever modified.
2. π Aesthetic Color Palettes & Custom Ramps
Transform any video stream to match your terminal setup:
glitch: Multicolor chromatic aberration with VHS scanline fringe splits.rainbow: Psychedelic neon spectrum mapped across luminance levels.matrix&cyberpunk: Cyberpunk green phosphor monitor and electric cyan/magenta hues.amber&fire: Vintage CRT amber glow and thermal flame gradients.- Preset Ramps: Built-in artistic ramps for Binary, Braille, Dots, Math symbols, and more.
3. π‘οΈ Bulletproof YouTube Extraction (Deno Runtime + Auto-Repair)
- Integrated embedded Deno JS runtime support to handle YouTube's latest signature challenges and anti-bot checks smoothly without throttling.
- Auto-healing stream resolver: Automatically detects yt-dlp stream errors and updates components dynamically.
4. π Zero-Install & One-Click Launchers
- Windows (
play.bat): Automatically bootstraps an isolated, portable Python 3.11 environment, FFmpeg, ffplay, and Denoβno manual installer or admin rights required. - Linux & macOS (
play.sh): Auto-installs missing packages throughaptorbrewand sets up the audio/video pipes out of the box.
5. π οΈ Stability & Terminal Performance
- Fixed Windows terminal freezing when clicking the console window or switching focus (QuickEdit console mode auto-disabled).
- Non-blocking input polling prevents missed frames or keyboard buffer accumulation.
- Automatic 16:9 terminal scaling with scroll/buffer overflow protection.
β¨οΈ Live Hotkey Cheat Sheet
| Key | Action | Description |
|---|---|---|
S / Tab |
Cycle Styles | Cycles through all 7 styles smoothly |
0 / H |
HD Half-Block | 24-bit Truecolor half-block (β) mode |
1 |
Binary 0101 | Matrix binary stream |
2 |
Block Shades | Smooth density blocks ( ββββ) |
3 |
High-Contrast | Deep blacks with bright highlights |
4 - 6 |
ASCII / Matrix / Dots | Classic ASCII, Matrix characters, or Dots (Β·β’βββ) |
C |
Cycle Colors | RGB β Matrix β Cyberpunk β Glitch β Rainbow β Amber β Fire β Gray |
G / M |
Glitch / Matrix | Quick toggle VHS chromatic aberration or Green Phosphor |
+ / - |
Contrast | Boost or decrease contrast dynamically |
] / [ |
Brightness | Increase or decrease brightness |
A |
Auto-Contrast | Toggle dynamic range stretching ON/OFF |
I |
Invert | Invert dark/light character mapping |
Q |
Quit | Clean exit and pipe termination |