Skip to content

Latest commit

 

History

History
68 lines (67 loc) · 2.38 KB

README.md

File metadata and controls

68 lines (67 loc) · 2.38 KB
Raw

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
  • make and gcc (Build dependencies)

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:

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

Just make sure you run make install with elevated privligeas

Step 2:

Add your own youtube data api key to the ~/.youtty/key_name.py file
Creating a youtube data key is 100% free and very 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 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):

  • youtube-dl && yt-dlp (Its amazing)
  • vlc (mindblowing)

Please open an issue in case you find one
<3