Awesome

Download youtube videos and audios by title/id/url

Features

⬇️ Download audio/video by title/id/url
⬇️ Download n amount of audio/video based on keyword
⬇️ Download n amount of audio/video related to a particular video id/url
↩️ Resume incomplete downloads
⚙️ Download audio/video in a specific quality

Installation

Either of the following ways will get you ready.

Download binaries for your system from here.

a. From source

pip install git+https://github.com/Simatwa/y2mate-api.git

b. From pypi

pip install y2mate-api

Locally

git clone https://github.com/Simatwa/y2mate-api.git
cd y2mate-api
pip install .

Usage

$ y2mate -f <mp3/mp4> <youtube-link or video id or keyword>

Following the introduction of Cloudflare protection on the host, y2mate.com, you have to authenticate you're a human right from your Chrome Browser and then proceed to extract cf_clearance cookie value, which will in turn be passed over to the script.

`cf_clearance` extraction process.

Install Http Tracker Chrome extension using this link.
Using Chrome Browser, navigate to y2mate.com and pass the bot verification stage.
Start the Http Tracker extension.
On the search section of y2mate.com, key-in anything and press <kbd>enter</kbd>
Return to the Http Tracker window and look for any of the recent urls containing *y2mate.com* and click it.
Navigate down to the coookies section and copy the value of key cf_clearance. In the proceeding guides I will be referring to this value as CF-CLEARANCE

CF-CLEARANCE highlighted

[!IMPORTANT] Since the script impersonates only one browser, you will have to use Chrome Browser for CF-CLEARANCE extraction process.

The uncompromised usage will be:

$ y2mate -f <mp3/mp4> -cf <CF-CLEARANCE> <youtube-link or video id or keyword>

To developers:

from y2mate_api import session

session.cookies.update(
  {
    "cf_clearance": cf_clearance_value
  }
)

As a workaround to explicitly declaring the CF-CLEARANCE along with other commands, export it to the environment as Y2MATE_CF_CLEARANCE.

By doing that, something like this will still get the work done:

$ y2mate -f <mp3/mp4> <youtube-link or video id or keyword>

[!WARNING] The CF-CLEARANCE expires after a short while, consider updating it more frequently.

[!TIP] Requests originating from United States are not blocked by Cloudflare security. Using Us proxies might save you from all this loads of cookies etc.

Developer docs

</summary>

1.Generate download links and other metadata

Video

from y2mate_api import Handler
api = Handler("Quantum computing in details")
for video_metadata in api.run():
	print(video_metadata)
"""Output
{
    "size": "13.9 MB",
    "f": "mp4",
    "q": "720p",
    "q_text": "720p (.mp4) <span class=\"label label-primary\"><small>m-HD</small></span>",
    "k": "joQdX4S3z8ShOJWn6qaA9sL4Al7j4vBwhNgqkwx0U/tQ99R4mbX1dYceffBBnNn7",
    "status": "ok",
    "mess": "",
    "c_status": "CONVERTED",
    "vid": "X8MZWCGgIb8",
    "title": "Quantum Computing In 5 Minutes | Quantum Computing Explained | Quantum Computer |Simplilearn",
    "ftype": "mp4",
    "fquality": "720",
    "dlink": "https://rr2---sn-gjo-w43s.googlevideo.com/videoplayback?expire=1686946638&ei=7m6MZK-2NdKQgAepgJGIBg&ip=212.119.40.85&id=o-ADe3hAAtGl6fkEeUD9HKkFNoeQBSwEuttoN5vFPyzLdQ&itag=22&source=youtube&requiressl=yes&mh=Zy&mm=31%2C29&mn=sn-gjo-w43s%2Csn-ab5l6nr6&ms=au%2Crdu&mv=m&mvi=2&pl=23&initcwndbps=1013750&spc=qEK7B_bA4LnIWnJEJPO8Lp__Gz-ysFYRbF7IYj1J5g&vprv=1&svpuc=1&mime=video%2Fmp4&ns=L1NG4wpa6rJJmunA_QDUTswN&cnr=14&ratebypass=yes&dur=298.608&lmt=1682850029743273&mt=1686924560&fvip=1&fexp=24007246&c=WEB&txp=5311224&n=XD35AJLYPy2nng&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Cns%2Ccnr%2Cratebypass%2Cdur%2Clmt&sig=AOq0QJ8wRQIhAJdMdpsMBBByQZCOIglT_EvluXBK2wQ7mH32Ob95WAWJAiAP9PfGRwJKeJcZJXc5ZuVaZMImCAXCnbPcHyoSmRhH4A%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=AG3C_xAwRQIgAMVlWxHYtKeZEzbpKQ9Huqrk-5CQ0kTpSFgAmTIGaE4CIQDR0NJHxHO_TtRbn-HmDOgVD6H3ZUntvgcD1V5yfkngAA%3D%3D&title=Quantum+Computing+In+5+Minutes+%7C+Quantum+Computing+Explained+%7C+Quantum+Computer+%7C+Simplilearn"
}
"""

Audio

from y2mate_api import Handler
api = Handler("Quantum computing in details")
for audio_metadata in api.run(format="mp3"):
	print(audio_metadata)

"""Output

{
    "size": "4.6 MB",
    "f": "mp3",
    "q": "128kbps",
    "q_text": "MP3 - 128kbps",
    "k": "joQdX4S3z8ShOJWn6qaA9sL4Al7j4vBwhNgqlAxyU/NQ99R4mbX1dYceffBBnNn7",
    "status": "ok",
    "mess": "",
    "c_status": "CONVERTED",
    "vid": "X8MZWCGgIb8",
    "title": "Quantum Computing In 5 Minutes | Quantum Computing Explained | Quantum Computer |Simplilearn",
    "ftype": "mp3",
    "fquality": "128",
    "dlink": "https://dl201.dlmate53.xyz/?file=M3R4SUNiN3JsOHJ6WWQ2a3NQS1Y5ZGlxVlZIOCtyZ1ZqZFEwMHdVdVNvaERxNTA2dysydUpJSm1JT3hhaHFlckg4dEE4QzJUT3VHZU1RR2RvNVZ0WVh5TTU4TXBzREhJdUtzNFNjVndYeGo5bjYzb3B5UjNoeFBnYzVQdUdyVkdlR04rc1F0UTJpdUR3UGpZdkJUcXZUT2d0eDdGYWkwR3R3UWJQT0hZck5vYTgzREVldVB4MFpWQS93Q1M4c2tNaU5hWThWUFErK29UZ3V0V2VVTmRjY2dUMUlxbW1mZkpxaG95cGQ4WndsMnR1K2V5RDVNd1FmVElJV0VwYkhwUXVieXBUaDRZOENZVy9XKzFxLzVqL1drVGRQMGhzREhucXFDNElDeU9JOGIwSHNBPQ%3D%3D"
}
"""

Note : To download the media returned, pass the response to api.save()

Auto-download media

from y2mate_api import Handler
api = Handler("Quantum computing in details")
api.auto_save()

This will proceed to download the first video found and save it in the current directory

You can as well specify total videos to be downloaded by using limit argument. For instance:

from y2mate_api import Handler
api = Handler("https://youtu.be/POPoAjWFkGg")
api.auto_save(limit=10)
# This will download the video in path and 9 other videos related to the query specified

Note : You can still use video id such as POPoAjWFkGg as query parameter.

Other parameters

Handler
- author : Video author i.e Youtube Channel
- timeout : http requests timeout
- confirm : Confirm before downloading media
- unique : Auto-ignore previously downloaded media
- thread : Download (x) value of file at a time.
Handler.run
- format : Media format mp4/mp3
- quality : Media quality such as 720p/128kbps
- resolver : Additional format info : [m4a,3gp,mp4,mp3]
- limit : Total videos to be retrieved
- keyword : Phrase(s) that must be in media title
- author : Video author i.e Youtube Channel
Handler.auto_save
- dir : Path to Directory for saving the media files
- iterator : Function that yields third_query object - Handler.run
- progress_bar : Stdout media-name & Display progress bar
Handler.save
- third_dict : Response of third_query.run()
- dir : Directory for saving the contents
- progress_bar : Display download progress bar
- quiet : Not to stdout anything
- naming_format : Format for generating media filename using the third_query response keys
- chunk_size : Size of chunks in KB for downloads
- play : Auto-play media after downloading
- resume : Resume incomplete download

</details>

Telegram bot

If you're a Telegram user then purpose to checkout y2mate-bot.

For more info run $ y2mate -h