https://github.com/peab-dev/you-terminal-player

Watch YouTube in your terminal — half-block video with live, synchronized sound (yt command).
https://github.com/peab-dev/you-terminal-player

ansi ascii-art cli ffmpeg half-blocks macos stream terminal terminal-app terminal-video video video-player youtube yt-dlp

Last synced: 21 days ago
JSON representation

Watch YouTube in your terminal — half-block video with live, synchronized sound (yt command).

• Host: GitHub
• URL: https://github.com/peab-dev/you-terminal-player
• Owner: peab-dev
• License: mit
• Created: 2026-05-30T09:35:27.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-05-30T17:11:11.000Z (about 1 month ago)
• Last Synced: 2026-05-30T17:22:37.151Z (about 1 month ago)
• Topics: ansi, ascii-art, cli, ffmpeg, half-blocks, macos, stream, terminal, terminal-app, terminal-video, video, video-player, youtube, yt-dlp
• Language: Python
• Homepage: https://peab-dev.github.io/you-terminal-player/
• Size: 69.3 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  





  

  

  

  

  





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





  Developed with ❤️ in 🇦🇹 by 



📖 Full documentation


## Quick start

```bash

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

```bash

yt                                         # default video

yt "https://www.youtube.com/watch?v=..."   # a specific video

yt --res 1080 ""                       # higher resolution

yt --no-audio ""                       # silent

yt --cookies-from-browser safari ""    # 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](https://peab-dev.github.io/you-terminal-player/) for options, internals

and troubleshooting.

Developed with ❤️ in 🇦🇹 by