Repository navigation
v1.0.2
TermTube v1.0.2
Adds full Linux and macOS support with automatic dependency installation, an interactive FPS selection option, and a black-background rendering fix for ASCII mode.
Added
- Cross-platform setup script (
play.sh) with automatic dependency installation for:- Debian/Ubuntu and derivatives (Linux Mint, Pop!_OS, Elementary OS) via
apt-get - Fedora/RHEL/CentOS derivatives (Rocky Linux, AlmaLinux) via
dnf - Arch Linux and derivatives (Manjaro, EndeavourOS) via
pacman - macOS (Apple Silicon and Intel) via Homebrew, with architecture-aware Deno binary selection
- Debian/Ubuntu and derivatives (Linux Mint, Pop!_OS, Elementary OS) via
- Safe fallback for unsupported distributions (e.g. openSUSE, Gentoo, Alpine) — prints clear manual installation instructions instead of crashing
- Portable Deno auto-downloader for systems missing the Deno JS runtime, fetched directly from Deno's official GitHub releases
- Interactive FPS selection prompt (15 / 24 / 30) in the guided playback flow, so users can pick smoother or safer playback without needing to know the
--fpsflag — explicit--fpson the command line still takes priority and skips the prompt - Virtual environment cleanup on failed setup, preventing corrupted
.venvstate from blocking future runs - Version-aware Python venv package detection (fixes install failures on newer Python versions where Ubuntu splits the venv package by version, e.g.
python3.14-venv)
Fixed
- ASCII render mode (
--style ascii) now forces a solid black background behind every character, removing terminal-theme-colored gaps between characters while preserving true per-pixel video colors - Improved handling of YouTube extraction failures related to missing JS runtime support
Notes
- The Debian/Ubuntu install path has been directly tested end-to-end on a clean VM
- Fedora/Arch/macOS install paths are implemented but less thoroughly tested — feedback and bug reports from users on these platforms are welcome
- See the README for guidance on balancing rendering detail (
--cols), FPS, and playback smoothness based on your terminal and hardware
Built solo as part of the protagonist.lab project series.