Download youtube videos and audios by title/id/url
n amount of audio/video based on keywordn amount of audio/video related to a particular video id/urlDownload binaries for your system from here.
OR
a. From source
pip install git+https://github.com/Simatwa/y2mate-api.git
b. From pypi
pip install y2mate-api
git clone https://github.com/Simatwa/y2mate-api.git
cd y2mate-api
pip install .
$ 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.*y2mate.com* and click it.cf_clearance. In the proceeding guides I will be referring to this value as CF-CLEARANCE
[!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.
Developer docs
1.Generate download links and other metadata
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"
}
"""
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"
}
"""
api.save()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.
Handler
Handler.run
Handler.auto_save
Handler.runHandler.save
third_query.run()third_query response keysIf you're a Telegram user then purpose to checkout y2mate-bot.
For more info run $ y2mate -h
usage: y2mate [-h] [-v] [-f mp3|mp4]
[-q 4k|1080p|720p|480p|360p|240p|144p|auto|best|worst|mp3|m4a|.m4a|128kbps|192kbps|328kbps]
[-r m4a|3gp|mp4|mp3] [-k [KEYWORD ...]] [-a [AUTHOR ...]] [-l LIMIT]
[-d PATH] [-t TIMEOUT] [-c CHUNK] [-i PATH] [-o FORMAT] [-cf COOKIE]
[-thr THREAD] [--disable-bar] [--confirm] [--unique] [--quiet] [--history]
[--clear] [--resume] [--play]
[query ...]
Download youtube videos and audios by title or link
positional arguments:
query Youtube video title, link or id - None
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-f mp3|mp4, --format mp3|mp4
Specify media type - audio/video
-q 4k|1080p|720p|480p|360p|240p|144p|auto|best|worst|mp3|m4a|.m4a|128kbps|192kbps|328kbps, --quality 4k|1080p|720p|480p|360p|240p|144p|auto|best|worst|mp3|m4a|.m4a|128kbps|192kbps|328kbps
Media quality - auto
-r m4a|3gp|mp4|mp3, --resolver m4a|3gp|mp4|mp3
Other media formats incase of multiple options - mp4/mp3
-k [KEYWORD ...], --keyword [KEYWORD ...]
Media should contain this keywords - None
-a [AUTHOR ...], --author [AUTHOR ...]
Media author i.e YouTube channel name - None
-l LIMIT, --limit LIMIT
Total videos to be downloaded - 1
-d PATH, --dir PATH Directory for saving the contents -
/home/smartwa/git/smartwa/y2mate-api
-t TIMEOUT, --timeout TIMEOUT
Http request timeout in seconds - 30
-c CHUNK, --chunk CHUNK
Chunk-size for downloading files in KB - 256
-i PATH, --input PATH
Path to text file containing query per line - None
-o FORMAT, --output FORMAT
Format for generating filename %(key)s :
[title,vid,fquality,ftype] or 'pretty' - None
-cf COOKIE, --cf-clearance COOKIE
cf_clearance cookie value for y2mate.com
-thr THREAD, --thread THREAD
Download [x] amount of videos/audios at once - 1
--disable-bar Disable download progress bar - False
--confirm Confirm before downloading file - False
--unique Auto-skip any media that you once dowloaded - False
--quiet Not to stdout anything other than logs - False
--history Stdout all media metadata ever downloaded - False
--clear Clear all download histories - False
--resume Resume downloading incomplete downloads
--play Play media after download - False
This script has no official relation with y2mate.com
This repository is intended for educational and personal use only. The use of this repository for any commercial or illegal purposes is strictly prohibited. The repository owner does not endorse or encourage the downloading or sharing of copyrighted material without permission. The repository owner is not responsible for any misuse of the software or any legal consequences that may arise from such misuse.
FAQs
Download youtube videos and audios by title or link
We found that y2mate-api demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.