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: 4 months ago
JSON representation
gydl (Graphical YouTube-Download) is a GUI wrapper around yt-dlp.
- Host: GitHub
- URL: https://github.com/JannikHv/gydl
- Owner: JannikHv
- License: gpl-2.0
- Created: 2017-04-02T20:35:19.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-12-04T11:06:37.000Z (almost 2 years ago)
- Last Synced: 2024-08-16T16:22:35.140Z (over 1 year ago)
- Topics: audio, dialog, gtk3, gui-wrapper, linux, pygtk3, python, video, youtube-dl, yt-dlp, yt-dlp-gui, yt-dlp-wrapper
- Language: Python
- Homepage:
- Size: 120 KB
- Stars: 149
- Watchers: 11
- Forks: 22
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gtk - Gydl - GUI wrapper around [youtube-dl](https://github.com/ytdl-org/youtube-dl) `#python` `#gtk3`. (Multimedia / Media Downloaders)
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
[](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.
When clicking on **Download** there are 3 scenarios you can face:
* Download Finished - When your download has finished successfully.
* Download Unsuccessful - When a bad URL was entered or similar errors occured.
* Connection Error - When no internet connection could be established.
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.