Table of Contents

yt-shorts-downloader

Что делает проект
Публичный контракт
Быстрый старт

Python API
Сохранение сразу на диск
CLI

Требования
Разделы документации

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

yt-shorts-downloader

Библиотека и CLI для скачивания YouTube Shorts в формате MP4 через Netscape cookie session file.

Что делает проект

валидирует Netscape cookie file до старта скачивания
проверяет, что ссылка относится к YouTube
скачивает итоговое видео как MP4 через yt-dlp
отдаёт типизированный Python API для возврата MP4-байтов из памяти
предоставляет CLI для сохранения MP4 на диск
публикует пакет в Gitea Packages после успешного CI на main

Публичный контракт

вход: ссылка YouTube и путь к cookie-файлу
выход для API: DownloadedVideo с MP4 в памяти
выход для CLI: путь к скачанному MP4 на диске

Быстрый старт

Python API

from yt_shorts_downloader import download

video = download(
    'https://www.youtube.com/shorts/VIDEO_ID',
    'cookies.txt',
)

assert video.media_type == 'video/mp4'
content = video.content

Сохранение сразу на диск

from yt_shorts_downloader import download_to_path

path = download_to_path(
    'https://www.youtube.com/shorts/VIDEO_ID',
    'cookies.txt',
    output_dir='downloads',
)

CLI

uv run yt-shorts-downloader \
  'https://www.youtube.com/shorts/VIDEO_ID' \
  cookies.txt \
  --output-dir downloads

Требования

Python 3.12+
валидный Netscape cookie file
Deno или Node.js 22+
желательно: ffmpeg