Skip to content

v1.0.2

Choose a tag to compare

@anshupriyan anshupriyan released this 16 Jul 08:05
· 9 commits to main since this release
51c6aa4

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
  • 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 --fps flag — explicit --fps on the command line still takes priority and skips the prompt
  • Virtual environment cleanup on failed setup, preventing corrupted .venv state 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.