README

Packagist: michaelalexeevweb/yt-dlp-gui

Install via Composer:

composer require michaelalexeevweb/yt-dlp-gui

Simple macOS desktop GUI for yt-dlp built with PHP and Boson.

Download videos from YouTube and other sites using a simple desktop interface.

Currently supports macOS only.

Screenshot

Requirements

• PHP 8.4+
• ext-ffi
• Boson compiler
• yt-dlp, ffmpeg, ffprobe (bundled in portable release)

Releases

Two builds are available:

• YtDlpGui-macos-arm64-desktop.zip - Desktop build, requires user-installed tools
• YtDlpGui-macos-arm64-portable.zip - Portable build, includes yt-dlp, ffmpeg, ffprobe

Quick start

Download the portable release and run the app.

Build commands (Docker-first):

release-macos-* targets run inside docker compose by default.

make release-macos-portable
make release-macos-desktop

Outputs to dist/release/.

Work locally (Docker)

Build container image:

docker compose build php

Install dependencies:

docker compose run --rm php composer install

Run checks:

docker compose run --rm php composer check