ytdownloader 0.1.14

An automation service to download videos from Youtube

YoutubeDownloader is an automated service to download multiple youtube videos at a time.

About

YoutubeDownloader is written in Python. It uses Asynchronous Python Multiprocessing at its heart which facilitates user to download more than one video at a time.

YoutubeDownloader must use a configuration file. It supports a YAML / JSON format of configuration file. This configuration file gives structure and usability to the service. It defines what videos/playlists needs to be downloaded and how they are going to be stored.

Configuration Syntax

YoutubeDownloader supports YAML / JSON configuration formats. YoutubeDownloader prefers YAML more than JSON. Below is the snippet of sample configurations in YAML / JSON format.

settings:
  process: 2
download:
  mostlyinsane:
    dirname: '../mostlyinsane'
    videos:
      - 'https://www.youtube.com/watch?v=vcKPjDUc5EQ'
  trippling:
    dirname: 'trippling'
    playlists: 'https://www.youtube.com/watch?list=PLTB0eCoUXEraZe3d7fJRdB-znE5D0cMZ7'
  official-ceogiri:
    dirname: 'official-ceogiri'
    playlists:
        - 'https://www.youtube.com/watch?list=PLTB0eCoUXEraZe3d7fJRdB-znE5D0cMZ7'

{
    "settings": {
        "process": 5
    },
    "download": {
        "mostlyinsane": {
            "dirname": "../mostlyinsane",
            "videos": [
                "https://www.youtube.com/watch?v=vcKPjDUc5EQ"
            ]

        },
        "trippling": {
            "dirname": "trippling",
            "playlists": "https://www.youtube.com/watch?list=PLTB0eCoUXEraZe3d7fJRdB-znE5D0cMZ7"

        },
        "official-ceogiri": {
            "dirname": "official-ceogiri",
            "playlists": [
                "https://www.youtube.com/watch?list=PLTB0eCoUXEraZe3d7fJRdB-znE5D0cMZ7"
            ]

        }
    }
}

settings defines service level variables. - process to force YoutubeDownloader to use Asynchronous Python Multiprocessing and tells how many processes should be deployed to download videos/playlists at a time.

download defines what videos/playlists to download. It tags dirnames with videos/playlists internally and store the downloaded videos/playlists in the respective directory.

• dirname relative / absolute directory path to store videos in.
• videos single / array of youtube videos link to download.
• playlists single / array of youtube playlists link to download.

Install

This is a pure-Python package built for Python 2.6+ and Python 3.0+. To set up:

sudo pip install ytdownloader

Options

ytdownloader --help

• config specifies the location for the configuration file to YoutubeDownloader. If it omits, YoutubeDownloader looks in the current directory for the configuration file.
• --version specifies the currect version of YoutubeDownloader.
• --about about text for YoutubeDownloader

Usage

ytdownloader --version    // latest version of ytdownloader

ytdownloader --about      // about text for ytdownloader

ytdownloader              // start the ytdownloader and search config file in current directory

ytdownloader docs/config.yaml // start the ytdownloader and use docs/config.yaml as config file