Watch YouTube in your terminal in the highest possible resolution, with live, synchronized sound. 📺🔊

Developed with ❤️ in 🇦🇹 by

📖 Full documentation

Quick start

git clone https://github.com/peab-dev/you-terminal-player.git
cd you-terminal-player
./install.sh
yt           # play the default video

install.sh is idempotent — it installs ffmpeg/ffplay, Node.js, the Python venv, the yt-dlp + PO-token pieces, the bgutil Docker server, and a global yt command on your PATH. Re-run it anytime.

Requires Docker Desktop (for the PO-token server). Everything else is self-contained.

Usage

yt                                         # default video
yt "https://www.youtube.com/watch?v=..."   # a specific video
yt --res 1080 "<url>"                       # higher resolution
yt --no-audio "<url>"                       # silent
yt --cookies-from-browser safari "<url>"    # if YouTube says "confirm you're not a bot"

Controls: space = pause/resume · v = display mode · r = source resolution (240→1080) · f = frame rate (15→60, incl. original) · q / ESC = quit Resize the window anytime — the picture refits to fill it (aspect preserved, no stretching). Tip: enlarge the window + shrink the font (Cmd -) for a sharper picture.

Uninstall with ./uninstall.sh. See the docs for options, internals and troubleshooting.

Developed with ❤️ in 🇦🇹 by