Package: tube-dl
tube_dlTube_dl is a Simple Youtube video downloader for Python.
A Modular approach to bypass and download Youtube Videos and Playlist from Youtube using python.>>>pipinstalltube_dlFeatures:What's New (v4.1.0) :Merge audio and video file.Get links for streamable file (for Live videos)--> m3u8 fileExisting FeaturesConvert to mp3 or mp4(Requires Moviepy - pip install moviepy)Fetch CommentsFetch CaptionsUsage:>>>fromtube_dlimportYoutube>>>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 DetailsPrinting 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_formatsExample:>>>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)convert takes a string as an argument. It converts the video into the extension you want. Ex: 'webm' -> 'mp3'. [mp4 coming soon]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)path takes full path where you want to save filefile_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 PlaylistThis Class is responsible for:Get list of all the VideosCreate Continuation URL if len(videos)>100Get Continuation data and append all the video IDs to IDS variableParameters :
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)>>>fromtube_dlimportPlaylist,Youtube>>>pl=Playlist('https://music.youtube.com/playlist?list=PLTy__vzNAW6C6sqmp6ddhsuaLsodKDEt_').videos>>>foriinpl:>>>yt=Youtube(f'https://youtube.com/watch?v={i}')>>>yt.formats.first().download()CaptionsNow you can download captions from youtube.
Here's the Sample code.>>>fromtube_dlcaptionsimportCaptions>>>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()CommentsYes! 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.>>>fromtube_dl.commentsimportComments>>>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 FormatsConverting any format tomp3andmp4is easy. Here's how to do it:converting to mp3>>>fromtube_dlimportYoutube,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 Trueconverting to mp4>>>fromtube_dlimportYoutube,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 downloadedMerging FormatsPlease 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.>>>fromtube_dlimportYoutube,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 StreamsWith 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')>>>ifyt.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.