DisTube fork of ytdl-core. This fork is dedicated to fixing bugs and adding features that are not merged into the original repo as soon as possible.
npm install @distube/ytdl-core@latestMake sure you're installing the latest version of @distube/ytdl-core to keep up with the latest fixes.
const ytdl = require("@distube/ytdl-core");
// TypeScript: import ytdl from '@distube/ytdl-core'; with --esModuleInterop
// TypeScript: import * as ytdl from '@distube/ytdl-core'; with --allowSyntheticDefaultImports
// TypeScript: import ytdl = require('@distube/ytdl-core'); with neither of the above
// Download a video
ytdl("http://www.youtube.com/watch?v=aqz-KE-bpKQ").pipe(require("fs").createWriteStream("video.mp4"));
// Get video info
ytdl.getBasicInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ").then(info => {
console.log(info.title);
});
// Get video info with download formats
ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ").then(info => {
console.log(info.formats);
});const ytdl = require("@distube/ytdl-core");
// (Optional) Below are examples, NOT the recommended options
const cookies = [
{ name: "cookie1", value: "COOKIE1_HERE" },
{ name: "cookie2", value: "COOKIE2_HERE" },
];
// (Optional) http-cookie-agent / undici agent options
// Below are examples, NOT the recommended options
const agentOptions = {
pipelining: 5,
maxRedirections: 0,
localAddress: "127.0.0.1",
};
// agent should be created once if you don't want to change your cookie
const agent = ytdl.createAgent(cookies, agentOptions);
ytdl.getBasicInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });
ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });- Install EditThisCookie extension for your browser.
- Go to YouTube.
- Log in to your account. (You should use a new account for this purpose)
- Click on the extension icon and click "Export" icon.
- Your cookie will be added to your clipboard and paste it into your code.
const ytdl = require("@distube/ytdl-core");
const agent = ytdl.createAgent([
{
domain: ".youtube.com",
expirationDate: 1234567890,
hostOnly: false,
httpOnly: true,
name: "LOGIN_INFO",
path: "/",
sameSite: "no_restriction",
secure: true,
session: false,
value: "---xxx---",
},
"...",
]);- Or you can paste it into a file and use
fs.readFileSyncto read it.
const ytdl = require("@distube/ytdl-core");
const fs = require("fs");
const agent = ytdl.createAgent(JSON.parse(fs.readFileSync("cookies.json")));const ytdl = require("@distube/ytdl-core");
const agent = ytdl.createProxyAgent({ uri: "my.proxy.server" });
ytdl.getBasicInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });
ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });Use both proxy and cookies:
const ytdl = require("@distube/ytdl-core");
const agent = ytdl.createProxyAgent({ uri: "my.proxy.server" }, [{ name: "cookie", value: "COOKIE_HERE" }]);
ytdl.getBasicInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });
ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent });Built-in ip rotation (getRandomIPv6) won't be updated and will be removed in the future, create your own ip rotation instead.
To implement IP rotation, you need to assign the desired IP address to the localAddress property within undici.Agent.Options.
Therefore, you'll need to use a different ytdl.Agent for each IP address you want to use.
const ytdl = require("@distube/ytdl-core");
const { getRandomIPv6 } = require("@distube/ytdl-core/lib/utils");
const agentForARandomIP = ytdl.createAgent(undefined, {
localAddress: getRandomIPv6("2001:2::/48"),
});
ytdl.getBasicInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent: agentForARandomIP });
const agentForAnotherRandomIP = ytdl.createAgent(undefined, {
localAddress: getRandomIPv6("2001:2::/48"),
});
ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ", { agent: agentForAnotherRandomIP });You can find the API documentation in the original repo. Except a few changes:
requestOptionsis nowundici'sRequestOptions.agent:ytdl.Agent
cookies: an array of json cookies exported with EditThisCookie.
proxy: ProxyAgentOptions contains your proxy server information.
You can find the example here
ytdl cannot download videos that fall into the following
- Regionally restricted (requires a proxy)
- Private (if you have access, requires cookies)
- Rentals (if you have access, requires cookies)
- YouTube Premium content (if you have access, requires cookies)
- Only HLS Livestreams are currently supported. Other formats will get filtered out in ytdl.chooseFormats
Generated download links are valid for 6 hours, and may only be downloadable from the same IP address.
When doing too many requests YouTube might block. This will result in your requests getting denied with HTTP-StatusCode 429. The following steps might help you:
- Update
@distube/ytdl-coreto the latest version - Use proxies (you can find an example here)
- Extend the Proxy Idea by rotating (IPv6-)Addresses
- read this for more information about this
- Use cookies (you can find an example here)
- for this to take effect you have to FIRST wait for the current rate limit to expire
- Wait it out (it usually goes away within a few days)
The issue of using an outdated version of ytdl-core became so prevalent, that ytdl-core now checks for updates at run time, and every 12 hours. If it finds an update, it will print a warning to the console advising you to update. Due to the nature of this library, it is important to always use the latest version as YouTube continues to update.
If you'd like to disable this update check, you can do so by providing the YTDL_NO_UPDATE env variable.
env YTDL_NO_UPDATE=1 node myapp.js
- DisTube - A Discord.js module to simplify your music commands and play songs with audio filters on Discord without any API key.
- @distube/ytsr - DisTube fork of ytsr.
- @distube/ytpl - DisTube fork of ytpl.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![depfu[bot] avatar](https://avatars.githubusercontent.com/in/715?v=4 "depfu[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent