@distube/ytdl-core 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. ## Installation bash npm install @distube/ytdl-core@latest Make sure you're installing the latest version of @distube/ytdl-core to keep up with the latest fixes. ## Usage js 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.videoDetails.title); }); // Get video info with download formats ytdl.getInfo("http://www.youtube.com/watch?v=aqz-KE-bpKQ").then(info => { console.log(info.formats); }); ### Cookies Support js 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 }); #### How to get cookies - 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 cookies will be added to your clipboard and paste it into your code. > [!WARNING] > Don't logout it by clicking logout button on youtube/google account manager, it will expire your cookies. > You can delete your browser's cookies to log it out on your browser. > Or use incognito mode to get your cookies then close it. > [!WARNING] > Paste all the cookies array from clipboard into createAgent function. Don't remove/edit any cookies if you don't know what you're doing. > [!WARNING] > Make sure your account, which logged in when you getting your cookies, use 1 IP at the same time only. It will make your cookies alive longer. js const ytdl = require("@distube/ytdl-core"); const agent = ytdl.createAgent([ { domain: ".youtube.com", expirationDate: 1234567890, hostOnly: false, httpOnly: true, name: "---xxx---", path: "/", sameSite: "no_restriction", secure: true, session: false, value: "---xxx---", }, { "...": "...", }, ]); - Or you can paste your cookies array into a file and use fs.readFileSync to read it. js const ytdl = require("@distube/ytdl-core"); const fs = require("fs"); const agent = ytdl.createAgent(JSON.parse(fs.readFileSync("cookies.json"))); ### Proxy Support js 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: js 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 }); ### IP Rotation 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. ```js 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",