Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/JannikHv/gydl

gydl (Graphical YouTube-Download) is a GUI wrapper around yt-dlp.
https://github.com/JannikHv/gydl

audio dialog gtk3 gui-wrapper linux pygtk3 python video youtube-dl yt-dlp yt-dlp-gui yt-dlp-wrapper

Last synced: about 1 month ago
JSON representation

gydl (Graphical YouTube-Download) is a GUI wrapper around yt-dlp.

Awesome Lists containing this project

README

        

# About

Gydl (Graphical yt-dlp) is a GUI wrapper around the already existing
yt-dlp 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 yt-dlp! Check out their project:

https://github.com/yt-dlp/yt-dlp

based on youtube-dl:

https://github.com/rg3/youtube-dl

# News!

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.

# Installation

## GNU/Linux Packages

* [Arch Linux](https://aur.archlinux.org/packages/gydl-git/)
(Credit: [AffeAli](https://github.com/AffeAli))

## Flatpak

[![Packaging status](https://repology.org/badge/vertical-allrepos/gydl.svg)](https://repology.org/project/gydl/versions)

- [Flatpak](http://flatpak.org) packages support multiple distributions and are sandboxed.

Stable releases are hosted on [Flathub](https://flathub.org):

```
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub com.github.JannikHv.Gydl
```

- [Fedora](https://apps.fedoraproject.org/packages/gydl): `sudo dnf install gydl`

## Source

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

### Dependencies

To run it you need to have installed:

* gtk+3
* python3
* pygobject
* yt-dlp

### 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](http://mesonbuild.com)

# Translation

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.

# Usage

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](http://i.imgur.com/o4pYQrX.png)

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

* Download Finished - When your download has finished successfully.

![alt tag](http://i.imgur.com/yVrmyPH.png)

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

![alt tag](http://i.imgur.com/P7ZIWaX.png)

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

![alt tag](http://i.imgur.com/Vrys4YO.png)

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.