Skip to content

Dvd-Znf/youtty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

youtty

GitHub Release AUR Version

Watch youtube from the tty

Youtty is a simple program that combines: Youtube Data API, yt-dlp and vlc to allow you to easily watch youtube videos from the tty
Screenshot

Dependencies:

  • python
  • python-requests (module)
  • yt-dlp
  • vlc

Build Dependencies:

  • make
  • gcc
  • sudo

How to install (Arch Linux):

The youtty program is now available from the AUR!!!
https://aur.archlinux.org/packages/youtty
If you use an aur helper, then just do that. Here are the steps for manual aur install:

Step 1:

Clone the pkgbase

$ git clone https://aur.archlinux.org/youtty.git

Step 2 (optional):

Verify the that the PKGBUILD is ok

$ cd youtty
$ cat PKGBUILD

Step 3:

Build, install and get all dependencies

$ makepkg -sirc

Step 4:

Check Step 2 from manual install

How to manually install:

Note

The version could be unreleased/unstable!
(Check to see if it ends in "-dev")

Step 0:

Clone this repo :P
And make sure all depencies are installed

Step 1:

Just use the Makefile!
The automated script will create necessary data directories
But it will also compile the main.c file from source

$ make install

Important

Do NOT run make install with elevated privligeas!

Step 2:

Run youtty --change-key once to change your current youtube API key. Creating a youtube data API key is free and somewhat simple
You may also use the --no-key flag instead, but this will limit some functionality(No video selection, No Thumbnail preview)
Using --no-key may also lead to some other non desired behavior, please submit issue if you find one and be ready to CTR+C.

How it works?

The main.c file is really just a glorified script
It will call to the api-caller.py file located under ~/.youtty to then asks the youtube data api for a specific search result
It will then throw that into a file
After that yt-dlp downloads the video
And vlc is used to play it

Why?

Graphics on a plain tty look awsome!!!!

Todo:

  • Add suport for mpv

Credit (for some AWSOME dependencies):

  • yt-dlp (Its amazing)
  • vlc (mindblowing)

Please open an issue in case you find one
<3