Обновить Home wiki на русский

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
+- валидирует Netscape cookie file до старта скачивания
-- validates that the URL belongs to YouTube
+- проверяет, что ссылка относится к YouTube
-- downloads the resulting video as MP4 through yt-dlp
+- скачивает итоговое видео как MP4 через yt-dlp
-- exposes a typed Python API for returning MP4 bytes in memory
+- отдаёт типизированный Python API для возврата MP4-байтов из памяти
-- provides a CLI for saving the MP4 to disk
+- предоставляет CLI для сохранения MP4 на диск
-- publishes package builds to Gitea Packages after successful CI on `main`
+- публикует пакет в Gitea Packages после успешного CI на `main`
 
-## Public contract
+## Публичный контракт
 
-- input: YouTube URL and path to a Netscape cookie file
+- вход: ссылка YouTube и путь к cookie-файлу
-- API output: `DownloadedVideo` with MP4 bytes in memory
+- выход для API: `DownloadedVideo` с MP4 в памяти
-- CLI output: filesystem path to the downloaded 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
+- валидный Netscape cookie file
-- Deno or Node.js 22+
+- Deno или Node.js 22+
-- optional but recommended: ffmpeg
+- желательно: ffmpeg
 
-## Documentation
+## Разделы документации
 
 - [API](API)
 - [Session File](Session-File)
-- [Development and CI](Development-and-CI)
+- [Интеграция с FastAPI](FastAPI-Integration)
+- [Разработка и CI](Development-and-CI)
+- [Диагностика и ошибки](Troubleshooting)