michaelalexeevweb/yt-dlp-gui

Desktop GUI wrapper around yt-dlp on PHP with Boson runtime.

1.0.0 2026-05-02 16:05 UTC

Requires

• php: ^8.4
• ext-ffi: *
• boson-php/runtime: ^0.19.5

Requires (Dev)

• boson-php/compiler: ^0.19
• phpstan/phpstan: ^2.1
• symfony/console: ^7.3

MIT

• Michael Alexeev

• php
• gui
• downloader
• desktop
• boson
• yt-dlp

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