From 9719c5e4cb87183c4f969644bca1000143262a79 Mon Sep 17 00:00:00 2001 From: CREATIVE_tg1 <1+creative_tg1@noreply.localhost> Date: Wed, 27 May 2026 14:55:42 +0000 Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20Home=20wiki=20=D0=BD=D0=B0=20=D1=80=D1=83=D1=81=D1=81?= =?UTF-8?q?=D0=BA=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 42 ++++++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/Home.md b/Home.md index f5ffeaa..a4607af 100644 --- a/Home.md +++ b/Home.md @@ -1,23 +1,23 @@ # yt-shorts-downloader -Typed Python library and CLI for downloading YouTube Shorts as MP4 using a Netscape cookie session file. +Библиотека и CLI для скачивания YouTube Shorts в формате MP4 через Netscape cookie session file. -## What this project does +## Что делает проект -- validates a Netscape cookie file before download -- validates that the URL belongs to YouTube -- downloads the resulting video as MP4 through yt-dlp -- exposes a typed Python API for returning MP4 bytes in memory -- provides a CLI for saving the MP4 to disk -- publishes package builds to Gitea Packages after successful CI on `main` +- валидирует Netscape cookie file до старта скачивания +- проверяет, что ссылка относится к YouTube +- скачивает итоговое видео как MP4 через yt-dlp +- отдаёт типизированный Python API для возврата MP4-байтов из памяти +- предоставляет CLI для сохранения MP4 на диск +- публикует пакет в Gitea Packages после успешного CI на `main` -## Public contract +## Публичный контракт -- input: YouTube URL and path to a Netscape cookie file -- API output: `DownloadedVideo` with MP4 bytes in memory -- CLI output: filesystem path to the downloaded MP4 +- вход: ссылка YouTube и путь к cookie-файлу +- выход для API: `DownloadedVideo` с MP4 в памяти +- выход для CLI: путь к скачанному MP4 на диске -## Quick start +## Быстрый старт ### Python API @@ -33,7 +33,7 @@ assert video.media_type == 'video/mp4' content = video.content ``` -### Save directly to disk +### Сохранение сразу на диск ```python from yt_shorts_downloader import download_to_path @@ -54,15 +54,17 @@ uv run yt-shorts-downloader \ --output-dir downloads ``` -## Requirements +## Требования - Python 3.12+ -- valid Netscape cookie file -- Deno or Node.js 22+ -- optional but recommended: ffmpeg +- валидный Netscape cookie file +- Deno или Node.js 22+ +- желательно: ffmpeg -## Documentation +## Разделы документации - [API](API) - [Session File](Session-File) -- [Development and CI](Development-and-CI) +- [Интеграция с FastAPI](FastAPI-Integration) +- [Разработка и CI](Development-and-CI) +- [Диагностика и ошибки](Troubleshooting)