Skip to content
A macOS GUI front-end for the youtube-dl video downloader
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
Code Draft Italian localisation file May 10, 2020
Components Old version Feb 23, 2020
images Localisation test Apr 19, 2020 Add coding principles Aug 25, 2019 Rename License to Aug 22, 2019 Add thanks to a number of users. May 1, 2020


MacYTDL is a macOS GUI front end for youtube-dl, the cross-platform video downloader. It runs on any Apple Mac with macOS 10.10 or later. It has been developed in AppleScript. The code is not protected and can be opened in Script Editor. MacYTDL is code signed and notarized.

Download from here.

Main dailog


  • Download individual videos and playlists.
  • Download multiple videos separately (in parallel) or in one process (sequentially).
  • Works with all sites supported by youtube-dl.
  • Can cancel individual downloads.
  • Settings for level of youtube-dl feedback, download folder, file format and remuxing format.
  • Batch downloads.
  • Download a text description of the video.
  • Download and embed subtitles in chosen format and language.
  • Download and optionally embed thumbnail images and metadata.
  • Download or extract audio-only files in chosen format.
  • Download selected episodes from ABC iView (Australia) show pages.
  • Optional macOS Service for use in web browsers which copies the current URL, switches to MacYTDL and pastes URL of video to be downloaded.
  • All components downloaded and/or installed by MacYTDL, which can be controlled by the user. Component updates available in the app.
  • A separate log file is retained for each download enabling problem solving if a download fails.
  • Has a built-in uninstaller which moves all components to Trash.
  • Includes a range of simple utilities.
  • Is 64-bit and so runs in macOS 10.15 Catalina.

How to install

  • Download and open the DMG file.
  • Read the Help file.
  • Click and drag MacYTDL to any location - it's best to use the Applications folder.
  • Run MacYTDL.
  • Click on "Yes" to install various components and create a preferences folder when asked.
  • Provide administrator credentials when asked.
  • Wait.
  • MacYTDL dialog is displayed.

More detail is available in the Help file.

Bugs, problems, questions

To report bugs, problems etc., get a Github account, click on the "Issues" tab above and open a new issue.


MacYTDL would be useless without youtube-dl. It is a remarkable, feature rich utility maintained by the most dedicated group of volunteers.

Much is owed to Shane Stanley, for his many contributions solving problems with MacYTDL. Shane developed Dialog Toolkit Plus which provides the dialogs in MacYTDL. Ideas for this GUI front-end came from many sources including:

MacYTDL is free but...

MacYTDL is a retirement project for me and will always be free. But if you use MacYTDL to download files please consider making a donation to the youtube-dl project. Their donation page is here:

You can’t perform that action at this time.