Skip to main content

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

Project description


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

Check It Out


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


This project has only been tested on Windows 10.


pip install git+


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.


python -m vlcyt "" -a "EXAMPLEAPIKEY" -v "C:\Program Files\VideoLAN\VLC"

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


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.


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

copy, c, url

Copies the current song's YouTube URL.


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

exit, quit, q

Closes the program.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

VLCYT-1.9.tar.gz (9.7 kB view hashes)

Uploaded source

Built Distribution

VLCYT-1.9-py3-none-any.whl (10.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page