roamingwilson/youtube-tools

Project made for Jaafar Aziz UpWork project, to download and cut YouTube videos.

dev-main 2025-08-08 07:33 UTC

Requires

• php: >=7.4

MIT

• Ibrahim Issa

README

GitHub Repository

Download and cut clips from YouTube videos using yt-dlp and ffmpeg, and cut them into smaller clips.

📦 Installation

Requirements

• PHP 7.4+
• yt-dlp installed
• ffmpeg installed

Install on Different OS:

✅ Ubuntu / Debian

sudo apt update
sudo apt install ffmpeg
pip install -U yt-dlp

✅ macOS

brew install ffmpeg
pip install -U yt-dlp

Install the PHP package

composer require roamingwilson/youtube-tools

Usage

use RoamingWilson\YouTubeTools\YouTubeTools;

$tools = new YouTubeTools(
    '/your/temp/dir',                 // Optional temp directory
    '/your/cookies.txt'              // Optional cookies.txt file from browser
);

$result = $tools->downloadAndCut(
    'https://www.youtube.com/watch?v=dQw4w9WgXcQ', 
    [
        ['from' => '00:00:00', 'to' => '00:00:10'],
        ['from' => '00:01:00', 'to' => '00:01:30'],
    ],
    '/your/output/dir'
);

print_r($result);

How to get cookies.txt

To get the cookies.txt file, you can use browser extensions like Get cookies.txt LOCALLY. Visit YouTube and export the cookies.

🛠 Features

• Download any YouTube video with yt-dlp
• Cut multiple time-based clips using ffmpeg
• Optional crop (if crop_x, crop_y, crop_width, crop_height provided)