Skip to main content

List your Youtube subscription videos

Project description


ytsub provides a command-line interface to do things with your Youtube subscriptions. You might find it most useful for filtering those
videos using grep, or setting up an auto-downloader using the excellent
youtube-dl. An example usage might look like this::

$ ytsub list | grep 'FTB\|Feed The Beast' | awk -F"\t" '{print $2}' | tee >(youtube-dl -a /dev/stdin >/dev/tty) | ytsub mark-watched

The above gets list of all unwatched subscription videos, filters out ones that don't include the string 'FTB' or 'Feed The Beast' in their titles, gets youtube-dl to start downloading them, and marks them as watched.


Installing is pretty easy on linux systems
1. Install pip (python package manager) if you don't have it::
$ sudo apt-get install python-pip
2. Download ytsub. To get the latest stable release, head to and click one of the download links for the latest tag.
3. Open archive, take out the archive in /dist -- should look like: ytsub-<version number>.tar.gz. Don't uncompress it.
4. Run pip install with the dist archive::
$ sudo pip install ytsub-<version number>.tar.gz --upgrade

That's it. It's runnable like any other command::
$ ytsub list -c 1 -t 0

Alternatively, you can use git:
1. sudo apt-get install python-pip git
2. git clone -b release
3. sudo pip install ytsub/dist/<press tab -- should be just the one dist archive in here> --upgrade
4. rm -rf ytsub

Project details

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
ytsub-1.2.1-py2.7.egg (27.1 kB) Copy SHA256 hash SHA256 Egg 2.7 Jan 12, 2013
ytsub-1.2.1.tar.gz (22.3 kB) Copy SHA256 hash SHA256 Source None Jan 12, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page