vmatkovskii/video-dl

Simple terminal tool to download and re-encode videos using yt-dlp and ffmpeg

v1.0.0 2025-05-17 00:59 UTC

This package is auto-updated.

Last update: 2025-05-17 01:28:03 UTC


README

video-dl — это простая CLI-утилита на PHP для скачивания и перекодировки видео с помощью yt-dlp и ffmpeg.

  • 📥 Скачивает видео по URL
  • 🎞️ Проверяет формат и кодеки
  • 🔁 При необходимости перекодирует в .mp4 с H.264
  • 🧰 Работает как библиотека и как CLI-инструмент

📦 Установка

1. Установка через Composer (из GitHub)

Если ты хочешь подключить video-dl в другой проект:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/vlavlamat/video-dl.git"
    }
  ],
  "require": {
    "vmatkovskii/video-dl": "dev-main"
  }
}

Затем:

composer update

CLI-обёртка будет доступна как:

./vendor/bin/video-dl

🔧 Зависимости

Убедись, что у тебя установлены:

  • yt-dlp
  • ffmpeg
  • php >= 8.0
  • ext-fileinfo (PHP-расширение для определения MIME-типов)

🚀 Использование

Просто запусти:

./bin/video-dl

Или если установлен как зависимость:

./vendor/bin/video-dl

Затем следуй инструкции в терминале:

Введите URL для скачивания:

📚 Пример кода как библиотеки

Если хочешь использовать в своём коде:

use VMatkovskii\VideoDl\VideoDownloader;

$downloader = new VideoDownloader();
$downloader->run($argv);

📁 Структура проекта

video-dl/
├── bin/
│   └── video-dl          # CLI обёртка
├── src/
│   └── VideoDownloader.php
├── composer.json
├── README.md
├── LICENSE
└── .gitignore

📄 Лицензия

MIT © Vladimir Matkovskii

🔗 GitHub: https://github.com/vlavlamat/video-dl