208 lines
6.9 KiB
Markdown
208 lines
6.9 KiB
Markdown
# YouTube Tools
|
||
|
||
Набор PowerShell-скриптов для Windows для скачивания видео и аудио с YouTube, а также создания видео с закадровым переводом.
|
||
|
||
> Используйте утилиты только для контента, который вы имеете право скачивать и обрабатывать.
|
||
|
||
## Возможности
|
||
|
||
В репозитории находятся три скрипта:
|
||
|
||
| Скрипт | Назначение |
|
||
| ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
|
||
| `Get-YouTubeAudio.ps1` | Скачивание лучшей аудиодорожки и конвертация в FLAC |
|
||
| `Get-YouTubeVideo.ps1` | Скачивание видео в максимально доступном качестве |
|
||
| `Get-YouTubeVideoTranslate.ps1` | Скачивание видео, получение закадрового перевода через `vot-cli` и смешивание перевода с оригинальным звуком |
|
||
|
||
Все готовые файлы сохраняются в папку:
|
||
|
||
```text
|
||
output/
|
||
```
|
||
|
||
## Структура проекта
|
||
|
||
```text
|
||
youtube-tools/
|
||
├── scripts/
|
||
│ ├── Get-YouTubeAudio.ps1
|
||
│ ├── Get-YouTubeVideo.ps1
|
||
│ └── Get-YouTubeVideoTranslate.ps1
|
||
│
|
||
├── tools/
|
||
│ ├── yt-dlp.exe
|
||
│ ├── ffmpeg.exe
|
||
│ └── ...
|
||
│
|
||
├── output/
|
||
│ └── .gitkeep
|
||
│
|
||
├── README.md
|
||
├── LICENSE
|
||
└── .gitignore
|
||
```
|
||
|
||
Бинарные зависимости в Git не добавляются. Папка `tools` предназначена для локального размещения необходимых программ.
|
||
|
||
## Поиск зависимостей
|
||
|
||
Каждый скрипт ищет необходимые программы в следующем порядке:
|
||
|
||
1. В локальной папке `tools`.
|
||
2. В системной переменной `PATH`.
|
||
3. Если программа не найдена нигде, скрипт показывает ошибку и завершает работу.
|
||
|
||
Таким образом, можно использовать как локальные версии утилит, так и программы, установленные в Windows.
|
||
|
||
## Зависимости
|
||
|
||
Скачать всё с облака:
|
||
|
||
[Скачать (.zip)](https://cloud.kolbox.duckdns.org/lib/b5d0b4e0-fd0c-40fe-b799-3ab0015550d0/file/Gitea%20%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8/youtube-tools/tools.zip?dl=1)
|
||
|
||
### yt-dlp
|
||
|
||
Используется для скачивания видео и аудио с YouTube.
|
||
|
||
Последняя версия:
|
||
|
||
https://github.com/yt-dlp/yt-dlp/releases/latest
|
||
|
||
Для локального использования положите `yt-dlp.exe` в:
|
||
|
||
```text
|
||
tools/yt-dlp.exe
|
||
```
|
||
|
||
### FFmpeg
|
||
|
||
Используется для конвертации аудио, объединения потоков и обработки звуковых дорожек.
|
||
|
||
Сборка FFmpeg для Windows:
|
||
|
||
https://www.gyan.dev/ffmpeg/builds/
|
||
|
||
После распаковки архива возьмите из папки `bin` файл:
|
||
|
||
```text
|
||
ffmpeg.exe
|
||
```
|
||
|
||
и положите его в:
|
||
|
||
```text
|
||
tools/ffmpeg.exe
|
||
```
|
||
|
||
`ffprobe.exe` текущим скриптам напрямую не требуется.
|
||
|
||
### vot-cli
|
||
|
||
Используется только скриптом `Get-YouTubeVideoTranslate.ps1`.
|
||
|
||
Репозиторий:
|
||
|
||
https://github.com/FOSWLY/vot-cli
|
||
|
||
Установка:
|
||
|
||
```powershell
|
||
npm install -g vot-cli
|
||
```
|
||
|
||
После установки должна быть доступна команда:
|
||
|
||
```powershell
|
||
vot-cli
|
||
```
|
||
|
||
Скрипт также умеет искать локальный `vot-cli.cmd`, `vot-cli.exe` или `vot-cli.ps1` в папке `tools`.
|
||
|
||
### Node.js и npm
|
||
|
||
Необходимы для установки и работы `vot-cli`.
|
||
|
||
Проверка:
|
||
|
||
```powershell
|
||
node --version
|
||
npm --version
|
||
```
|
||
|
||
Скрипт перевода проверяет `node` и `npm` как в папке `tools`, так и в системном `PATH`.
|
||
|
||
## Зависимости по скриптам
|
||
|
||
| Скрипт | yt-dlp | FFmpeg | Node.js / npm | vot-cli |
|
||
| ------------------------------- |:------:|:------:|:-------------:|:-------:|
|
||
| `Get-YouTubeAudio.ps1` | ✓ | ✓ | — | — |
|
||
| `Get-YouTubeVideo.ps1` | ✓ | ✓ | — | — |
|
||
| `Get-YouTubeVideoTranslate.ps1` | ✓ | ✓ | ✓ | ✓ |
|
||
|
||
## Использование
|
||
|
||
### Скачивание аудио
|
||
|
||
Запустите:
|
||
|
||
```powershell
|
||
.\scripts\Get-YouTubeAudio.ps1
|
||
```
|
||
|
||
Введите ссылку на YouTube. Результат будет сохранён в `output` в формате FLAC.
|
||
|
||
### Скачивание видео
|
||
|
||
Запустите:
|
||
|
||
```powershell
|
||
.\scripts\Get-YouTubeVideo.ps1
|
||
```
|
||
|
||
Введите ссылку на YouTube. Скрипт скачает видео в максимально доступном качестве и сохранит результат в `output`.
|
||
|
||
### Видео с закадровым переводом
|
||
|
||
Запустите:
|
||
|
||
```powershell
|
||
.\scripts\Get-YouTubeVideoTranslate.ps1
|
||
```
|
||
|
||
Можно ввести одну ссылку или несколько ссылок через запятую.
|
||
|
||
Скрипт:
|
||
|
||
1. скачивает исходное видео;
|
||
2. получает переведённую дорожку через `vot-cli`;
|
||
3. уменьшает громкость оригинального звука до `20%`;
|
||
4. смешивает оригинальный звук с переводом;
|
||
5. сохраняет итоговый MP4 в `output`;
|
||
6. удаляет временные файлы.
|
||
|
||
## Политика выполнения PowerShell
|
||
|
||
Если Windows запрещает запуск `.ps1`, можно разрешить выполнение локальных скриптов для текущего пользователя:
|
||
|
||
```powershell
|
||
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
|
||
```
|
||
|
||
Изменяйте политику выполнения только если понимаете последствия этой настройки.
|
||
|
||
## Выходные файлы
|
||
|
||
Все результаты находятся в:
|
||
|
||
```text
|
||
youtube-tools/output/
|
||
```
|
||
|
||
Папка создаётся автоматически, если отсутствует.
|
||
|
||
Содержимое `output` исключено из Git.
|
||
|
||
## Лицензия
|
||
|
||
MIT. См. файл `LICENSE`.
|