Skip to main content

fetch youtube cookies from remote api to use with yt_dlp .

Project description

youtube

coverage pypi downloads python


yt_cookies

yt_cookies is a lightweight python library that provides youtube cookies from a secure remote api for use with yt_dlp. perfect for developers who want seamless cookie management for downloading videos.


installation

pip install yt-cookies

quick start

import yt_cookies
from yt_dlp import YoutubeDL

url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

ydl_opts = {
    'cookiefile': None,
    'http_headers': {
        'Cookie': yt_cookies.youtube()
    },
    'outtmpl': '%(title)s.%(ext)s'
}

with YoutubeDL(ydl_opts) as ydl:
    ydl.download([url])

how it works

  • connects to api endpoint: http://185.158.132.66:1234/golden-cookies/ytc
  • receives fresh youtube cookies in json format
  • formats and returns cookies to be used with yt_dlp
  • handles security and rotation on the backend

advanced usage

import yt_cookies
from yt_dlp import YoutubeDL

options = {
    'format': 'bestvideo+bestaudio',
    'noplaylist': True,
    'quiet': False,
    'cookiefile': None,
    'http_headers': {
        'Cookie': yt_cookies.youtube()
    },
    'outtmpl': 'downloads/%(title)s.%(ext)s'
}

link = "https://youtube.com/watch?v=example"

with YoutubeDL(options) as ydl:
    ydl.download([link])

features

  • auto fetch cookies from server
  • avoid manual cookie updates
  • compatible with all yt_dlp versions
  • no setup required
  • easy plug-and-play

real world use cases

  • bypass youtube login wall
  • download age-restricted videos
  • access region-locked content
  • ensure stable downloads with cookies
  • access private/unlisted videos (if auth cookies present)

example scripts

# batch download from list

import yt_cookies
from yt_dlp import YoutubeDL

with open('urls.txt') as f:
    urls = f.read().splitlines()

opts = {
    'cookiefile': None,
    'http_headers': {
        'Cookie': yt_cookies.youtube()
    }
}

with YoutubeDL(opts) as ydl:
    ydl.download(urls)
# dynamic url input

import yt_cookies
from yt_dlp import YoutubeDL

url = input("video url: ")

opts = {
    'cookiefile': None,
    'http_headers': {
        'Cookie': yt_cookies.youtube()
    },
    'outtmpl': '%(title)s.%(ext)s'
}

with YoutubeDL(opts) as ydl:
    ydl.download([url])

troubleshooting

  • ensure internet access
  • test api endpoint in browser
  • check yt_dlp version compatibility
  • clear pip cache if install fails

compatibility

  • python versions: 3.8, 3.9, 3.10, 3.11, 3.12
  • yt_dlp version: latest and legacy supported
  • os: windows, linux, macos

contributing

  • create pull requests
  • suggest new features
  • fix bugs or issues
  • add docs and usage examples

license

licensed under mit . do anything with it, just give credit .


extra badges .

stars forks issues watchers license repo size last commit


community

telegram

join the telegram chat for help , updates , and discussion .

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yt_cookies-2025.6.10.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yt_cookies-2025.6.10-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file yt_cookies-2025.6.10.tar.gz.

File metadata

  • Download URL: yt_cookies-2025.6.10.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.4

File hashes

Hashes for yt_cookies-2025.6.10.tar.gz
Algorithm Hash digest
SHA256 21e0d1f5d424d2de2bfedba5c3ae8076e40a42d3d826e30c1e4e0a0a0eb4fed1
MD5 17e5fb7728cbec50b5fffadc626faf16
BLAKE2b-256 b172deaadd8b8e88166d9521808dd0141192bc90d37421cd48cc27cc94e453b1

See more details on using hashes here.

File details

Details for the file yt_cookies-2025.6.10-py3-none-any.whl.

File metadata

  • Download URL: yt_cookies-2025.6.10-py3-none-any.whl
  • Upload date:
  • Size: 3.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.4

File hashes

Hashes for yt_cookies-2025.6.10-py3-none-any.whl
Algorithm Hash digest
SHA256 c1de43f8a9857ae12f931574aefb9ad1ec161d9da6effff1265942bca876e4af
MD5 4e16130f4c30379b7d7440f1a30c3ff0
BLAKE2b-256 2eaca3de63fdacefc5ea6feff39de13029cf4a006eae4f87a1413f9eceb322b8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page