VLCYT

Stream your YouTube playlist in VLC behind the scenes from the command line.

Check It Out

https://streamable.com/43qzjl

Requirements

YouTube Data V3 API Key 64-bit VLC Media Player
64-bit Python 3.8

Note

This project has only been tested on Windows 10.

Installation

pip install git+https://github.com/hillt03/VLCYT

Usage

Be sure to include quotes around arguments.

python -m vlcyt ["<youtube_playlist_url>" -a "<YouTube V3 API Key>" -v "<VLC Install directory>" ]

If you have VLC installed and get a FileNotFound Error, use the -v switch to include the path to your VLC install directory. Otherwise, don't forget to install VLC (64-bit). VLCYT will look for VLC in C:\Program Files\VideoLAN\VLC by default.

After running for the first time, you can then simply enter python -m vlcyt and the last playlist you passed in will begin playing.
VLCYT user data (playlist url, API key, and VLC directory) is stored in %APPDATA%\Local\VLCYT.

Example

python -m vlcyt "https://www.youtube.com/watch?v=8jrN6Kz2XbU&list=PLPVigFOpn3YjTdJ3-hIILmeP3jsjXntOU&index=1" -a "EXAMPLEAPIKEY" -v "C:\Program Files\VideoLAN\VLC"

After this initial command, do the following to load your stored settings: python -m vlcyt

Commands

NOTE: Most commands have multiple aliases separated by commas, use whichever you prefer.

?, help

Opens the help menu and shows whether or not looping and shuffling are enabled.

volume, v

Adjust the volume (0 - 100).

skip, s, next, n, forward, f

Skips song(s).
For example: Entering "skip" will skip one song, entering "skip 5" will skip 5 songs.

play, pause, p

Plays/Pauses the current song.

repeat, replay, r

Repeats the current song one time.

back, b

Skips to the last song played.

loop, l

Enables looping. The current song will keep playing until looping is disabled.

shuffle

Shuffles the playlist without repeating until every song has been played.

copy, c, url

Copies the current song's YouTube URL.

lyrics

EXPERIMENTAL: Attempts to retrieve the current song's lyrics.
Needs to be improved.

exit, quit, q

Closes the program.

Links

GitHub
PyPI