https://github.com/mathiasvr/youtube-terminal

:tv: Stream YouTube videos as ascii art in the terminal!
https://github.com/mathiasvr/youtube-terminal

ascii-art terminal video-player youtube

Last synced: about 2 months ago
JSON representation

:tv: Stream YouTube videos as ascii art in the terminal!

• Host: GitHub
• URL: https://github.com/mathiasvr/youtube-terminal
• Owner: mathiasvr
• License: mit
• Created: 2016-01-14T01:04:16.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2018-11-20T00:30:54.000Z (almost 6 years ago)
• Last Synced: 2024-04-23T18:38:31.018Z (5 months ago)
• Topics: ascii-art, terminal, video-player, youtube
• Language: JavaScript
• Homepage:
• Size: 61.5 KB
• Stars: 104
• Watchers: 8
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# YouTube Terminal

[![npm](https://img.shields.io/npm/v/youtube-terminal.svg)](https://npm.im/youtube-terminal)

![downloads](https://img.shields.io/npm/dt/youtube-terminal.svg)

[![dependencies](https://david-dm.org/mathiasvr/youtube-terminal.svg)](https://david-dm.org/mathiasvr/youtube-terminal)

[![license](https://img.shields.io/:license-MIT-blue.svg)](https://mvr.mit-license.org)

Stream YouTube videos as ascii art in the terminal!

## usage

YouTube Terminal will play the first found search result:

```shell 

$ youtube-terminal [options] 'cyanide and happiness'

```

### options

    -l, --link [url]         Use YouTube link instead of searching

    -i, --invert             Invert brightness, recommended on white background

        --color              Use 16 terminal colors [experimental]

    -c, --contrast [percent] Adjust video contrast [default: 35]

    -w, --width [number]     ASCII video character width

    -m, --mute               Disable audio playback

        --fps [number]       Adjust playback frame rate

    -h, --help               Display this usage information

> Note that setting the `--invert` flag had the opposite effect in earlier releases, and was changed based on [this poll](https://github.com/mathiasvr/youtube-terminal/tree/v0.5.2#which-background-color-does-your-terminal-have).

## install

```shell

$ npm install -g youtube-terminal

```

Be sure to have [FFmpeg](https://www.ffmpeg.org) installed as well.

Ubuntu/Debian users should have ALSA installed as well:

```shell

$ sudo apt-get install libasound2-dev

```

## related

[ascii-pixels](https://github.com/mathiasvr/ascii-pixels)

## license

MIT