Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/oleksis/youtube-dl-gui

A cross platform front-end GUI of the popular youtube-dl written in wxPython.
https://github.com/oleksis/youtube-dl-gui

gui-application hacktoberfest python python3 wxpython wxpython-phoenix youtube-dl

Last synced: about 1 month ago
JSON representation

A cross platform front-end GUI of the popular youtube-dl written in wxPython.

Awesome Lists containing this project

README 

        
[![Azure DevOps coverage](https://img.shields.io/azure-devops/coverage/oleksis/yt-dlg/1/master.svg)](https://dev.azure.com/oleksis/yt-dlg/_build/latest?definitionId=1&branchName=master)

[![Build Status](https://dev.azure.com/oleksis/yt-dlg/_apis/build/status/yt-dlg?repoName=yt-dlg&branchName=master)](https://dev.azure.com/oleksis/yt-dlg/_build/latest?definitionId=1&repoName=yt-dlg&branchName=master)

[![yt-dlg](https://snapcraft.io/yt-dlg/badge.svg)](https://snapcraft.io/yt-dlg)

[![build result](https://build.opensuse.org/projects/home:oleksis/packages/yt-dlg/badge.svg?type=default)](https://build.opensuse.org/package/show/home:oleksis/yt-dlg)



# yt-dlg

A cross platform front-end GUI of the popular [youtube-dl](https://github.com/ytdl-org/youtube-dl/) media downloader written in wxPython. [Supported sites](http://ytdl-org.github.io/youtube-dl/supportedsites.html)



## Screenshots

![youtube-dl-gui main window](https://raw.githubusercontent.com/oleksis/youtube-dl-gui/master/docs/img/yt-dlg_ui.gif)



## Requirements

* [Python 3](https://www.python.org/downloads)

* [wxPython 4 Phoenix](https://wxpython.org/download.php)

* [PyPubSub](https://pypi.org/project/PyPubSub)

* [FFmpeg](https://ffmpeg.org/download.html) (optional, to postprocess video files)



### Requirement for build Binaries/Executables

* [polib](https://pypi.org/project/polib)

* [PyInstaller](https://www.pyinstaller.org/)



### Optionals

* [GNU gettext](https://www.gnu.org/software/gettext/)



## Downloads

* [SHA2-256SUMS](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/SHA2-256SUMS)

* [yt-dlg](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg)

* [yt-dlg.exe](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg.exe)

* [yt-dlg-20230224.1.msi](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg-20230224.1.msi)

* [Source (.zip)](https://github.com/oleksis/youtube-dl-gui/archive/refs/tags/v1.8.5.zip)

* [Source (.tar.gz)](https://github.com/oleksis/youtube-dl-gui/archive/refs/tags/v1.8.5.tar.gz)



## Installation



### Windows 10 / 11

[Get it from Microsoft](https://apps.microsoft.com/store/detail/ytdlg/XP9CCFSWS911F5)



### Microsoft Store

You can download the program for free from the [Microsoft Store](https://apps.microsoft.com/store/detail/ytdlg/XP9CCFSWS911F5) and take advantage of its features like background auto-updates.



### Winget

```pwsh

winget install -e --id yt-dlg.yt-dlg

```



### Snap Store

[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/yt-dlg)



### Install From Source

> **Note**

> The latest version compatible with Python 3.6.1 is [yt-dlg v1.8.2](https://github.com/oleksis/youtube-dl-gui/releases/tag/v1.8.2)



In Windows we have the following options:

- Use the [Dev Container](.devcontainer/devcontainer.json) configuration file

- Windows [Development](https://github.com/oleksis/youtube-dl-gui/wiki/development#windows-development-environment) Environment

- Set up a [WSL development environment](https://learn.microsoft.com/en-us/windows/wsl/setup/environment)



In GNU/Linux install `make`. Ubuntu:

```bash

sudo apt install make

```



* Download & extract the source

* Change directory into *yt-dlg-1.8.5*

* Create virtual environment

```bash

make clean-requirements

make venv

```

* Activate virtual environment

```bash

source venv/bin/activate

```

* Install requirements, build translations and install

```bash

make install

```



### Binaries

Create binaries using [PyInstaller](https://www.pyinstaller.org/)

* Install requirements, build translations and create binaries

```bash

make pyinstaller

```



### Run yt-dlg

* Activate virtual environment and run

```bash

source venv/bin/activate

yt-dlg

```



> **Note**

> The default CLI Backend is `yt-dlp` you can change to `youtube-dl` CLI Backend in:

>

>   Settings -> Options -> Extra and change/select `youtube-dl`



## Debian 11

Install the following packages and their dependences:



```bash

sudo apt-get update

sudo apt-get install -y apt-utils build-essential dpkg-dev \

    freeglut3 freeglut3-dev libgl1-mesa-dev libglu1-mesa-dev \

    libgstreamer-plugins-base1.0-dev libgtk-3-dev libjpeg-dev \

    libnotify-dev libsdl2-dev libsm-dev libtiff-dev \

    libwebkit2gtk-4.0-dev libxtst-dev

```



### Setting the virtual environment and activate

```bash

sudo apt-get install -y python3.9 python3.9-dev libpython3.9-dev python3.9-venv

python3.9 -m venv venv

source venv/bin/activate

python3 -m pip install --upgrade pip setuptools wheel

```



### Install wxPython , requirements and yt-dlg

> * See **[Notes](#notes)** for install wxPython on Ubuntu

>

> * For install **wxPython on Debian 11 "bullseye"** download the wheel from the release:

>

>   [wxPython-4.2.1a1-cp310-cp310-linux_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.4/wxPython-4.2.1a1-cp310-cp310-linux_x86_64.whl)

>

> * For install **wxPython on Ubuntu 22.04.1 "jammy"** download the wheel from the release:

>

>   [wxPython-4.2.1a1-cp310-cp310-linux_x86_64-jammy.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.4/wxPython-4.2.1a1-cp310-cp310-linux_x86_64-jammy.whl)

>

> * For install **wxPython on Ubuntu 21.04 "hirsute"** download the wheel from the release:

>

>   [wxPython-4.1.1-cp39-cp39-linux_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.3/wxPython-4.1.1-cp39-cp39-linux_x86_64.whl)

>

> * For install **wxPython on Ubuntu 20.04.5 "focal"** download the wheel from the release:

>

>   [wxPython-4.2.0-cp310-cp310-linux_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.4/wxPython-4.2.0-cp310-cp310-linux_x86_64.whl)

>

> * For install **wxPython ManyLinux 2.28** download the wheel from the release:

>

>   [wxPython-4.2.1a1-cp310-cp310-manylinux_2_28_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.3/wxPython-4.2.1a1-cp310-cp310-manylinux_2_28_x86_64.whl)



```bash

python3 -m pip install wxPython-4.1.1-cp39-cp39-linux_x86_64.whl

python3 -m pip install -r requirements/requirements.in

python3 -m pip install --no-deps yt-dlg

yt-dlg

```



### Comprobar wxPython 4

```bash

python3 -c "import wx ; print(wx.__version__)"

```



### List and configure Locales

```bash

locale -a

sudo dpkg-reconfigure locales

```



## openSUSE Tumbleweed

Install using `zypper`



### Open Build Service

```bash

sudo zypper ar -cfp 90 https://download.opensuse.org/repositories/home:oleksis/openSUSE_Tumbleweed/home:oleksis.repo

sudo zypper install python38-yt-dlg

yt-dlg

```



### With Python 3.8

The following steps can be executed if you use the Python version of the system (3.8, 3.9, 3.10)



```bash

sudo zypper dup  # Distribition Upgrade

sudo zypper -n update  # Non Interactive

sudo zypper -n install yum-utils

```



### Add openSUSE Factory repository for wxPython 4

```bash

sudo zypper addrepo -f http://download.opensuse.org/tumbleweed/repo/oss/ openSUSE-Factory

```



### Install wxPython 4 global (system level)



> * For install **wxPython on openSUSE Tumbleweed** download the wheel from the release:

>

>   [wxPython-4.1.2a1-cp38-cp38-linux_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.3/wxPython-4.1.2a1-cp38-cp38-linux_x86_64.whl)



Need at least one font installed



```bash

sudo zypper -n install python38-wxPython google-opensans-fonts

```



### Install other dev packages/tools for Python 3.8

```bash

sudo zypper -n install python38-pip python38-setuptools python38-devel python38-tools python38-virtualenv python38-requests

```



### Install `yt-dlg` global from PyPI

```bash

pip3 install yt-dlg

```



### Add `yt-dlg` executable to the PATH and run

```bash

PATH=$HOME/.local/bin:$PATH

yt-dlg

```



openSUSE 15.3

We need build **wxPython 4.1.1** for **Python 3.6**



> * For install **wxPython on openSUSE 15.3** download the wheel from the release:

>

>   [wxPython-4.1.1-cp36-cp36m-linux_x86_64.whl](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.1/wxPython-4.1.1-cp36-cp36m-linux_x86_64.whl)



### Dev Tools

```bash

sudo zypper -n install -t pattern devel_basis

sudo zypper -n install gcc-c++

sudo zypper -n install git wget

```



### Requirement for install Python from source (Build dependencies)

```bash

sudo zypper -n install \

    readline-devel sqlite3-devel libbz2-devel \

    zlib-devel libopenssl-devel libffi-devel \

    ncurses-devel tk-devel libgdbm4 \

    ca-certificates gcc

```



### Install wxPython 4 Dependencies

```bash

sudo zypper -n install \

    gtk3-devel gtk3-tools webkit2gtk3-devel \

    libjbig2 libjbig-devel libjpeg8 libjpeg8-devel \

    libpng16-16 libpng16-devel libtiff-devel \

    libSDL2-2_0-0 libSDL2-devel libSM6 libSM-devel\

    gstreamer gstreamer-devel gstreamer-plugins-base-devel \

    freeglut-devel libnotify4 libnotify-devel \

    libSM6 libSM-devel liblzma5 libXtst6 libXv1 \

    gdk-pixbuf-loader-rsvg gdk-pixbuf-query-loaders \

```



### Install Pyenv

```bash

curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> $HOME/.bashrc

echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> $HOME/.bashrc

echo 'eval "$(pyenv init -)"' >> $HOME/.bashrc

echo 'eval "$(pyenv virtualenv-init -)"' >> $HOME/.bashrc

source $HOME/.bashrc

```



### Custom Python build with `--enable-shared`

```bash

PYTHON_CONFIGURE_OPTS="--enable-shared" \

    pyenv install 3.6.13



pyenv shell 3.6.13

```



### Add python-config to the PATH

```bash

PATH=$(pyenv root)/versions/${PYENV_VERSION}/bin:$PATH

```



### Install requirements and run `yt-dlg`

```bash

python -m pip install --upgrade pip six setuptools wheel

python -m pip install -r requirements/requirements.in

pip install yt-dlg

yt-dlg

```



### List locales

```bash

locale  -av

```



### Windows Subsystem for Linux

Some issues is possible. Can read more in: [Troubleshooting GUI Linux apps on openSUSE on WSLg](https://boxofcables.dev/why-do-apps-look-weird-on-wslg-on-opensuse/)



```bash

sudo zypper -n install --no-recommends -t pattern gnome

sudo /usr/bin/gdk-pixbuf-query-loaders-64 --update-cache

```



Mageia 8

Exists a third-party repository for Mageia 8 that have a rpm package for youtube-dl-gui.

The repository comes from [BlogDrake](https://blogdrake.net/) The Official Community for Spanish Talking Users



### Instructions

First you have to configure the Official Mageia repositories then



For i586 - 32bit systems

```

su -

urpmi.addmedia --wget --distrib https://ftp.blogdrake.net/mageia/mageia8/i586

urpmi yt-dlg

exit

```

For x86_64 - 64bit systems

```

su -

urpmi.addmedia --wget --distrib https://ftp.blogdrake.net/mageia/mageia8/x86_64

urpmi yt-dlg

exit

```



### Source and RPM on Mageia 8

* [SRC](https://ftp.blogdrake.net/mageia/mageia8/free/SRPMS/yt-dlg-1.8.5-1bdk_mga8.src.rpm)

* [RPM](https://ftp.blogdrake.net/mageia/mageia8/free/noarch/yt-dlg-1.8.5-1bdk_mga8.noarch.rpm)



## macOS Monterey

* Install Pyenv using [Homebrew](https://github.com/pyenv/pyenv#homebrew-in-macos)

* Suggested [build environment](https://github.com/pyenv/pyenv/wiki#suggested-build-environment)



### Custom Python build with `--enable-framework`

* [How to use wxPython with virtualenv on Mac OSX](https://wiki.wxpython.org/wxPythonVirtualenvOnMac)



```bash

PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install 3.10.6

pyenv shell 3.10.6

python -m pip install -r requirements/requirements.in

pip install yt-dlg

yt-dlg

```



## Notes

An alternative to install wxPython 4 **Phoenix** from the Extras section



For Ubuntu 20.04



```bash

wget https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04/wxPython-4.1.1-cp38-cp38-linux_x86_64.whl

pip3 install wxPython-4.1.1-cp38-cp38-linux_x86_64.whl

```



* [wxPython 4 builds on various linux distros with Vagrant](https://github.com/wxWidgets/Phoenix/blob/wxPy-4.0.x/vagrant/debian-9/bootstrap.sh)



* [Building wxPython for Linux via Pip](https://wxpython.org/blog/2017-08-17-builds-for-linux-with-pip/index.html)



* [wxPython Phoenix Snapshot Builds](https://github.com/wxWidgets/Phoenix/blob/af85b5811b53ffe09153d357a3f515e90e4afdfa/packaging/README-snapshots.txt#L71)



* [Building wxPython4 with Docker](https://github.com/wxWidgets/Phoenix/blob/master/docker/build/debian-10/Dockerfile#L25)



* [Compile wxPython 4.1.2a1 using Microsoft C++ Build Tools 2019](https://gist.github.com/oleksis/8637f096b97e18e00786e46465e97b34)



* [Compile wxPython 4.1.1 using Ubuntu on Windows Community Preview](https://gist.github.com/oleksis/2d84b9eefe1fef038619439168f3768e)



* [Compile wxPython 4.1.2a1 on openSUSE Tumbleweed](https://gist.github.com/oleksis/0746bff4db6e2fc58c3bddf3f2672887)



* [wxPython Windows artifacts for Python 3.7 to 3.11](https://dev.azure.com/oleksis/wxPython/_build/results?buildId=132&view=artifacts&pathAsName=false&type=publishedArtifacts)



## Contributing

* **Add support for new language:** See [Localization Howto](https://yt-dlg.github.io/yt-dlg/Localization-Howto.html)

* **Report a bug:** See [issues](https://github.com/oleksis/youtube-dl-gui/issues)

* **Check how contribute:** [contribuite](https://github.com/oleksis/youtube-dl-gui/contribute)



Buy Me A Coffee



You can send me bitcoins to the following address:

bc1qnlea6zlfca9fpk62pzedrh6z20w0pxn2ujslztw8t84spprlr4cqdeg8u5



![Bitcoin Address](https://github.com/oleksis/youtube-dl-gui/raw/master/docs/img/qr-bitcoin.png)



## Authors

See [AUTHORS](AUTHORS) file



## License

The [Public Domain License](LICENSE)



## Frequently Asked Questions

See [FAQs](https://yt-dlg.github.io/yt-dlg/Faq.html)



## Thanks

Thanks to everyone who contributed to this project and to [@philipzae](https://github.com/philipzae) for designing the new UI layout.