gydl (Graphical Youtube-dl) is a GUI wrapper around the already existing youtube-dl program.

JannikHv JannikHv Last update: May 26, 2023


Gydl (Graphical Youtube-dl) is a GUI wrapper around the already existing youtube-dl program.

It's developed with a dialog driven experience in mind. This provides a quick and easy video or audio downloads without disturbances.

Big thank you to the developer(s) of youtube-dl! Check out their project:


Fellow users,

Gydl is currently in a state where it is not worth enhancing/developing it in any way.

I currently don't have the resources to develop Gydl myself - thus the amount of open issues.

I plan on keeping Gydl stable for how it currently is/works and rewrite it completely in about half a year at the latest.


GNU/Linux Packages


Packaging status

  • Flatpak packages support multiple distributions and are sandboxed.

Stable releases are hosted on Flathub:

flatpak remote-add --if-not-exists flathub
flatpak install flathub com.github.JannikHv.Gydl
  • Fedora: sudo dnf install gydl


Gydl is written in Python3 and uses the GTK+3 toolkit.


To run it you need to have installed:

  • gtk+3
  • python3
  • pygobject
  • youtube-dl

Build & Install

Meson installs to /usr/local as the default prefix.

meson build
cd build
ninja install

Build Options

Use meson --help to get all build options. You may specify any option when you initially run meson.

# Example
meson build --prefix=/app

If you already have a build directory, you must use instead use meson configure, from within the build directory.

# Example
cd build
meson configure -Dprefix=/app

Meson also supports the DESTDIR environment variable, which is useful for building a package.

See Meson documentation for more


Gydl itself is currently not translatable, but the appdata and the desktop entry is.

Use the build system to generate a POT template file from the latest commit.

meson build
ninja -C build Gydl-pot
rm -rf build

Copy the POT file into a PO file matching your language code and translate all strings. Alternatively follow the above steps and use a tool like Poedit.


When using Gydl, you have the option to download your Youtube Video as a Video or Audio.

Each of these options have a text entry, as well as 2 combo-boxes managing quality and the format.

alt tag

When clicking on Download there are 3 scenarios you can face:

  • Download Finished - When your download has finished successfully.

alt tag

  • Download Unsuccessful - When a bad URL was entered or similar errors occured.

alt tag

  • Connection Error - When no internet connection could be established.

alt tag

These dialogues will be presented to you as a little windows.

Notice that not every combination of settings will work.

Thanks for any involvement in this project, I hope you like it.

Kind regards, Jannik Hauptvogel.

Subscribe to our newsletter