Youtube video downloader and info extractor for python.

Overview

Generic badge GitHub issues PyPI download month GitHub followers

tube_dl

Tube_dl is a Simple Youtube video downloader for Python. A Modular approach to bypass and download Youtube Videos and Playlist from Youtube using python.

>>> pip install tube_dl

Features:

What's New (v4.1.0) :

  1. Merge audio and video file.
  2. Get links for streamable file (for Live videos) --> m3u8 file

Existing Features

  1. Convert to mp3 or mp4 (Requires Moviepy - pip install moviepy)
  2. Fetch Comments
  3. Fetch Captions

Usage:

>>>from tube_dl import Youtube
>>>yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k")
>>>yt.formats.first().download()

What is Formats?

formats is a class containing all the Youtube streams.

You can also see all the streams by :

>>> Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").Formats()

** Note that Formats() and formats are different. When you use Formats(), a list of all streams of format class is returned. When you use formats, a list of all streams of list_formats class is returned.

Other Details

Printing Information about the Video:

You can print the info or use them anywhere in your code. Here are the list of Information available:

>>> yt.videoID # ID of the video
>>> yt.availableCountries #List of countries where video is playable
>>> yt.title # Returns the title of the video
>>> yt.views # Return total views
>>> yt.channelName # Returns the name of the channel
>>> yt.views # Returns total number of views
>>> yt.likes # Returns total likes
>>> yt.dislikes # Returns total dislikes
>>> yt.meta # Returns the metadata about video (Songs specifically) 
>>> yt.channelId # Returns url of the channel
>>> yt.length # Returns the total length of the Youtube Video (in seconds)
>>> yt.uploadDate # Returns the upload date of the video
>>> yt.description # Returns long description
>>> yt.keywords # Returns list of keywords if available
>>> yt.is_live # Returns True if format is a live stream
>>> yt.thumbnail # Returns thumbnail URL
>>> yt.category # Category of the video
>>> yt.dashUrl # Returns dashStreamingUrl (if it is a live video)
>>> yt.hlsUrl # Returns hlsStreamingUrl (if it is a live video) 
>>> yt.hashTags # Returns list of hashtags used in a video.
>>> yt.subscribers # Returns total number of subscribers(Aprroximate)

using filter_by option:

Returns : list(list_formats) You can filter the formats according to the itag, adaptive, progressive, fps, quality, only_audio, no_audio. Example:

>>>Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.filter_by(only_audio=True)

Other options:

>>> yt.first()
Returns the first index of list_formats
>>> yt.last()
Returns the last index of list_formats

Example:

>>> Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.filter_by(only_audio=True).first()

Downloading a format:

To download a format, .download() function is used. Params : Download takes following parameters. All are optional .download(convert,onprogress,path,file_name)

  1. convert takes a string as an argument. It converts the video into the extension you want. Ex: 'webm' -> 'mp3'. [mp4 coming soon]
  2. onprogress takes function name as an argument. The function should have three arguments: Ex: def show_progress(Chunk=None,bytes_done=None,total_bytes=None)
  3. path takes full path where you want to save file
  4. file_name takes name of the file. by default, it is .title of the video. It is then processed to safe_filename to strip any invalid character.
  • You can print final filename by using formats.safe_filename() Ex:
>>> filename = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.safe_filename()

Working with Playlist

This Class is responsible for:

  1. Get list of all the Videos
  2. Create Continuation URL if len(videos)>100
  3. Get Continuation data and append all the video IDs to IDS variable

Parameters : url: str - URL of the PlayList start- Define start index of Videos end - Defines end index of videos.

Returns : Tuple : All the Video IDs within the Range variable( if Defined)

  >>> from tube_dl import Playlist, Youtube
  >>> pl = Playlist('https://music.youtube.com/playlist?list=PLTy__vzNAW6C6sqmp6ddhsuaLsodKDEt_').videos
  >>> for i in pl:
  >>>   yt = Youtube(f'https://youtube.com/watch?v={i}')
  >>>   yt.formats.first().download()

Captions

Now you can download captions from youtube. Here's the Sample code.

>>> from tube_dl captions import Captions
>>> caption = Captions('url',language='en') # Use Captions('url').caption_details to get list of languages
>>> caption.fetch_captions() #raw xml output of captions
>>> caption.convert_to_srt(path='c://xample_path//',file_name='captions.srt') # Default filename is youtube id and default path is os.getcwd()

Comments

Yes! It's possible. You can also download comments for a youtube video. It's still in beta but works absolutely file. Here's a simple use case of that.

>>> from tube_dl.comments import Comments
>>> comment = Comments('Your Youtube URL').process_comments(count=45) # Don't define count variable to get all the comments.
  • Fetching Replies for comments are not available yet. But will be there soon. Feel free to raise issues tickets.

Convert Formats

Converting any format to mp3 and mp4 is easy. Here's how to do it:

converting to mp3

>>> from tube_dl import Youtube, extras
>>> yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.filter_by(only_audio=True)[0]
>>> b = a.download() #b variable stores the filename and meta(if available) as object of Output class.
>>> extras.Convert(b,'mp3',add_meta=True) #this will convert the format to mp3 and add meta if var add_meta is True

converting to mp4

>>> from tube_dl import Youtube, extras
>>> yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.filter_by(only_audio=True)[0]
>>> b = a.download() #b variable stores the filename and meta(if available) as object of Output class.
>>> extras.Convert(b,'mp4',kepp_original=True) #this will convert the format to mp4 and add_meta is not available for mp4 files.
#if keep_original is True, previous format will be deleted i.e. the file downloaded

Merging Formats

Please note that the merge should be between an audio and a video file. Merging speed depends on file size and your system processing speed and it completely depends on CPU performance.

>>> from tube_dl import Youtube, extras
>>> yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k")
>>> yt1 = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k")
>>> video=yt.formats.filter_by(adaptive=True)[0].download()
>>> audio = yt1.formats.filter_by(only_audio=True)[0].download()
>>> extras.Merge(audio=audio,video=video,result='output.mp4',keep_original=False) 

The result variable stores the output filename and if keep_original = False, it will delete the raw files keeping only the output file.

Working with Live Streams

With live streams, few extra options are available apart from the normal functions. As live streams are not static, a streaUrl is provided by youtube in manifest format. Here's how to grab them.

>>> yt = Youtube('https://www.youtube.com/watch?v=U_XkCKlRcGQ')
>>> if yt.is_live==True:
>>> 	print(yt.hlsUrl)
>>> 	print(yt.dashUrl)

** This module is built for personal use. Please don't use this in production. I shall not be responsible for any consequences whatsoever.

Comments
  • KeyError: 'sentimentBar'

    KeyError: 'sentimentBar'

    I'm downloading a video, https://m.youtube.com/watch?v=HhV_Y8C5YKo, and get the following error:

    Traceback (most recent call last):
      File "main.py", line 52, in <module>
        download_audio(lin)
      File "main.py", line 27, in download_audio
        yt = Youtube(url).formats.filter_by(only_audio=True)[0]
      File "/Users/jeff/Documents/Projects/pytubedl/venv/lib/python3.8/site-packages/tube_dl/__main__.py", line 75, in __init__
        self.likes, self.dislikes = [i.strip() for i in extraDetails["sentimentBar"]["sentimentBarRenderer"]["tooltip"].split('/')]
    
    opened by jzohrab 4
  • Key Error 'Runs'

    Key Error 'Runs'

    Getting an Error when running the following:

    Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k").formats.filter_by(only_audio=True).first()

    File "[myPath]\env\lib\site-packages\tube_dl_main_.py", line 64, in init self.subscribers=extraDetails[1]['videoSecondaryInfoRenderer']["owner"]["videoOwnerRenderer"]["subscriberCountText"]["runs"][0] KeyError: 'runs'

    opened by RockoonTechnologies 3
  • Tube_dl library import isn't recognized!

    Tube_dl library import isn't recognized!

    Python version>> 3.10.5

    Command used for installation: "pip install tube_dl".

    The tube_dl library was installed, but at the time of import it is not recognized, I imported the same as the usage tutorial, but it is not found or recognized, the command: "from tube_dl import Youtube" I did a search for cmd with the command "pip3 list" and it really said that it was installed, but when looking for the folder in tube_dl on venv, it is not, please help me, I need this library a lot.

    opened by EsdrasUday 2
  • Fixed some causes for exception for not being able to download certain videos

    Fixed some causes for exception for not being able to download certain videos

    Formatting fixed, few extra checks added removed some tokens from song title which raises exceptions for opening a file with that name, dislikes, subscriber count etc maybe zero, hence the key may not be present in metadata

    opened by creepysta 2
  • Error while using the tool. KeyError: 'runs'

    Error while using the tool. KeyError: 'runs'

    I tried the following command:

    print(Youtube('link here'))
    

    and it returned back with the following error:

    Traceback (most recent call last): File "", line 1, in File "/usr/local/lib/python3.8/site-packages/tube_dl/main.py", line 64, in init self.subscribers=extraDetails[1]['videoSecondaryInfoRenderer']["owner"]["videoOwnerRenderer"]["subscriberCountText"]["runs"][0] KeyError: 'runs'

    opened by anirudhbagri 1
  • list index out of range

    list index out of range

    according to your usage

    from tube_dl import Youtube yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k") yt.formats.first().download()

    Error: yt = Youtube("https://youtube.com/watch?v=R2j46bHm6zw&list=RDAMVMd4HYhxlsj5k") File "/usr/local/lib/python3.9/dist-packages/tube_dl/main.py", line 75, in init self.likes=re.findall(r"'label': '(.*?) likes'",str(i))[0].replace(',','') IndexError: list index out of range

    opened by Sekisback 1
  • path separators are os dependent

    path separators are os dependent

    Nice package! Tried under linux and I had to modify formats.py.

    final_path = f'{path}\{file_name}.{extension}' to: final_path = f'{path}' + os.path.sep + f'{file_name}.{extension}'

    I'm sure there are other places that the separator should be fixed.

    opened by tkamm 1
  • KeyError when downloading

    KeyError when downloading

    Traceback (most recent call last):
      File "C:\Users\fixin\PycharmProjects\TTS\main.py", line 58, in <module>
        save_to_file()
      File "C:\Users\fixin\PycharmProjects\TTS\main.py", line 52, in save_to_file
        Youtube(keys[key]).formats.filter_by(only_audio=True).first().download(convert="mp3")
      File "C:\Users\fixin\PycharmProjects\TTS\venv\lib\site-packages\tube_dl\__main__.py", line 73, in __init__
        self.description = ''.join([i["text"] for i in extraDetails[1]['videoSecondaryInfoRenderer']['description']["runs"]])
    KeyError: 'description'
    
    opened by Nebulizer1213 0
  • unable to get number of likes from video

    unable to get number of likes from video

    import tube_dl
    yt = tube_dl.Youtube("https://www.youtube.com/watch?v=eZYtnzODpW4")
    print(yt.likes)  
    
    File "/home/matteo/.local/lib/python3.8/site-packages/tube_dl/__main__.py", line 75, in __init__
        self.likes, self.dislikes = [i.strip() for i in extraDetails["sentimentBar"]["sentimentBarRenderer"]["tooltip"].split('/')]
    KeyError: 'sentimentBar'
    
    opened by cosimopp 0
  • DO NOT fetch full list of video in the playlist (max 200 videos)

    DO NOT fetch full list of video in the playlist (max 200 videos)

    It seems that after the first time using Token extracted from HTML, the author continues to use that token while the token already changed. To fix this problem, update to use new token to get full of playlist.

    In python file containing class Playlist

    In function:

       def fetch_continuation(self, html):
              #same code
              return data
    
    

    In function:

    def __init__(self, url: str, start: int = None, end: int = None):
            # same code
            if total_count > 100:
                start_html = html
                for i in range(0, total_count//100):
                    start_html = self.fetch_continuation(start_html)
                # same code
    
    

    Hope this help.

    opened by hahv 1
Owner
Shekhar Chander
Shekhar Chander
Implementation of Cross-category Video Highlight Detection via Set-based Learning (ICCV 2021).

Cross-category Video Highlight Detection via Set-based Learning Introduction This project is an implementation of ``Cross-category Video Highlight Det

Minghao (Alan) Xu 49 Dec 17, 2022
this is udemy course downloader, before a start you know how to get access token.

udemy_downloader this is udemy course downloader, before a start you know how to get access token. To get the access_token on Google Chrome (once on U

OkUgur 18 Dec 04, 2022
Python software to download videos from Tiktok without rights

download-video-tiktok Python software to download videos from Tiktok without rights to install pip install requests Follow us telegram : https://t.me

muntazir halim 1 Oct 28, 2021
Simple tool downloads public PoC (refer from nomi-sec)

PoC Collection This is the little script to collect the proof-of-concept which is refered from nomi-sec. The repository now is only develop for linux-

2 Aug 17, 2022
A Unit3D Mass Release Downloader

Unit3DMassDL A Unit3D Mass Release Downloader. Currently supports Aither. Installation Ensure Python 3 is installed in your system. Run the following

2 Apr 11, 2022
This project is helps to download contents from Streamtape by utilizing the API

It scrapes Streamtape api and download contents from the site.

Debiprasad Das 5 Dec 28, 2022
A Spotify downloader needing only a python interpreter and ffmpeg.

ZSpotify A Spotify downloader needing only a python interpreter and ffmpeg. Discord Server - Matrix Server - Gitea Mirror - Main Site Requirements: B

2.4k Dec 14, 2021
This is a python based web scraping bot for windows to download all ACCEPTED submissions of any user on Codeforces

CODEFORCES DOWNLOADER This is a python based web scraping bot for windows to download all ACCEPTED submissions of any user on Codeforces Requirements

Mohak 6 Dec 29, 2022
Python module to download all media from a CyberDrop gallery.

CyberDrop Downloader Intro Let's suppose you found out the Eva G (bby_gee) leak on https://cyberdrop.me/a/aWAt4TWY. You wish you could download the en

Quatrecentquatre 1 Dec 12, 2021
Download any video from YouTube playlists

youtube-dl Download any videos from YouTube playlists. Requirements Python 3 BeautifulSoup4 PyQt PyQtWebEngine pytube pyyoutube python-decouple Usage

Antonio Fortin 1 Oct 26, 2021
Script that allows to download portable installers of different versions Adobe software for macOS

What is this and for what This is a script that allows you to download portable installers of programs from Adobe for macOS with different versions. T

715 Jan 06, 2023
YouTube Video Search Engine For Python

YouTube-Video-Search-Engine Introduction With the increasing demand for electronic devices, it is hard for people to choose the best products from mul

1 Dec 21, 2021
Utility for downloading works from AO3 (Archive Of Our Own)

ao3d video preview A small graphical utility for batch downloading works from AO3 (Archive Of Our Own) Features Batch downloading works to supported f

flux 24 Dec 09, 2022
👻🟡 Download all Snapchat video & photo memories from a data export.

Snapchat "Memories" Fetcher In compliance with the California Consumer Privacy Act of 2018 (“CCPA”), businesses which collect and store user data must

Todd Birchard 18 Dec 26, 2022
SABnzbd - The automated Usenet download tool

SABnzbd is an Open Source Binary Newsreader written in Python.

SABnzbd 1.8k Dec 30, 2022
Youtube-downloader-using-Python - Youtube downloader using Python

Youtube-downloader-using-Python Hii guys !! Fancy to see here Welcome! built by

Lakshmi Deepak 2 Jun 09, 2022
Itchio Downloader Tool with python

Itchio Downloader Tool Install pip install git+https://github.com/emersont1/itchio Download All Games in library from account python -m itchio.downloa

Peter Taylor 69 Dec 05, 2022
Organize your downloads easily with DownloadOrganizer

DownloadOrganizer Organize your downloads organize your downloads easily with DownloadOrganizer Instilation how to install DownloadOrganizer Method 1:

1 Dec 02, 2021
Youtube videos and channels scraper python wrapper!

YouTubeCrawle Wrapper for python Why This wrapper? This is wrapper is not limited to videos only it can scrape both channel and videos seperately ;D

Kei 16 Aug 08, 2022
Fully automated download and parsing for Texas A&M University's Registrar's grade distribution PDFs for years 2014+.

Fully automated download and parsing for Texas A&M University's Registrar's grade distribution PDFs for years 2014+. Adds the parsing results to a mySQL database.

TAMU Grade Distribution 1 Sep 28, 2022