YouTube videos on the command line
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Linux and Mac tests Windows tests Coverage Dependencies

yturl gets direct media URLs to YouTube media, freeing you having to view them in your browser.

yturl is still maintained, but is pretty much "done". Outside of changes to match YouTube API changes, bug fixes, and support for newer Python versions, development is complete.


By default, yturl prints the media URL to standard output.

$ yturl ''
Using itag 43.[...]

You can use this URL in the media player of your choice. For media players that can be launched from the command line, this typically means that you can do something like the following to watch it in your preferred player:

$ <your-preferred-player> "$(yturl '')"

There is also a -q option for controlling the quality (for example -q high), see yturl --help for more information.


To install the latest stable version from PyPi:

$ pip install -U yturl

To install the latest development version directly from GitHub:

$ pip install -U git+


$ pip install tox
$ tox
Ran 10 tests in 4.088s