{"id":13554358,"url":"https://github.com/yt-dlg/yt-dlg","last_synced_at":"2025-04-03T06:31:38.602Z","repository":{"id":44441517,"uuid":"358022500","full_name":"yt-dlg/yt-dlg","owner":"yt-dlg","description":"A cross platform front-end GUI of the popular youtube-dl written in wxPython.","archived":false,"fork":false,"pushed_at":"2024-03-19T11:09:53.000Z","size":30902,"stargazers_count":357,"open_issues_count":20,"forks_count":23,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-11-04T02:32:51.459Z","etag":null,"topics":["gui-application","hacktoberfest","python","python3","wxpython","wxpython-phoenix","youtube-dl"],"latest_commit_sha":null,"homepage":"https://yt-dlg.github.io/yt-dlg/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yt-dlg.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"oleksis","liberapay":"oleksis","buy_me_a_coffee":"oleksis","custom":["https://www.paypal.me/oleksis"]}},"created_at":"2021-04-14T19:40:08.000Z","updated_at":"2024-11-01T05:45:59.000Z","dependencies_parsed_at":"2024-03-19T12:31:27.382Z","dependency_job_id":"1e950146-b31d-4328-a0dd-4b7cc9d8e0cd","html_url":"https://github.com/yt-dlg/yt-dlg","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yt-dlg%2Fyt-dlg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yt-dlg%2Fyt-dlg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yt-dlg%2Fyt-dlg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yt-dlg%2Fyt-dlg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yt-dlg","download_url":"https://codeload.github.com/yt-dlg/yt-dlg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246948064,"owners_count":20859373,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gui-application","hacktoberfest","python","python3","wxpython","wxpython-phoenix","youtube-dl"],"created_at":"2024-08-01T12:02:45.801Z","updated_at":"2025-04-03T06:31:36.368Z","avatar_url":"https://github.com/yt-dlg.png","language":"Python","funding_links":["https://github.com/sponsors/oleksis","https://liberapay.com/oleksis","https://buymeacoffee.com/oleksis","https://www.paypal.me/oleksis","https://www.buymeacoffee.com/oleksis"],"categories":["Python"],"sub_categories":[],"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\u0026branchName=master)\n[![Build Status](https://dev.azure.com/oleksis/yt-dlg/_apis/build/status/yt-dlg?repoName=yt-dlg\u0026branchName=master)](https://dev.azure.com/oleksis/yt-dlg/_build/latest?definitionId=1\u0026repoName=yt-dlg\u0026branchName=master)\n[![yt-dlg](https://snapcraft.io/yt-dlg/badge.svg)](https://snapcraft.io/yt-dlg)\n[![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)\n\n# yt-dlg\nA 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)\n\n## Screenshots\n![youtube-dl-gui main window](https://raw.githubusercontent.com/oleksis/youtube-dl-gui/master/docs/img/yt-dlg_ui.gif)\n\n## Requirements\n* [Python 3](https://www.python.org/downloads)\n* [wxPython 4 Phoenix](https://wxpython.org/download.php)\n* [PyPubSub](https://pypi.org/project/PyPubSub)\n* [FFmpeg](https://ffmpeg.org/download.html) (optional, to postprocess video files)\n\n### Requirement for build Binaries/Executables\n* [polib](https://pypi.org/project/polib)\n* [PyInstaller](https://www.pyinstaller.org/)\n\n### Optionals\n* [GNU gettext](https://www.gnu.org/software/gettext/)\n\n## Downloads\n* [SHA2-256SUMS](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/SHA2-256SUMS)\n* [yt-dlg](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg)\n* [yt-dlg.exe](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg.exe)\n* [yt-dlg-20230224.1.msi](https://github.com/oleksis/youtube-dl-gui/releases/download/v1.8.5/yt-dlg-20230224.1.msi)\n* [Source (.zip)](https://github.com/oleksis/youtube-dl-gui/archive/refs/tags/v1.8.5.zip)\n* [Source (.tar.gz)](https://github.com/oleksis/youtube-dl-gui/archive/refs/tags/v1.8.5.tar.gz)\n\n## Installation\n\n### Windows 10 / 11\n[\u003cimg src=\"https://get.microsoft.com/images/en-us%20dark.svg\" alt=\"Get it from Microsoft\" height=\"104\"\u003e](https://apps.microsoft.com/store/detail/ytdlg/XP9CCFSWS911F5)\n\n### Microsoft Store\nYou 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.\n\n### Winget\n```pwsh\nwinget install -e --id yt-dlg.yt-dlg\n```\n\n### Snap Store\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/yt-dlg)\n\n### Install From Source\n\u003e **Note**\n\u003e 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)\n\nIn Windows we have the following options:\n- Use the [Dev Container](.devcontainer/devcontainer.json) configuration file\n- Windows [Development](https://github.com/oleksis/youtube-dl-gui/wiki/development#windows-development-environment) Environment\n- Set up a [WSL development environment](https://learn.microsoft.com/en-us/windows/wsl/setup/environment)\n\nIn GNU/Linux install `make`. Ubuntu:\n```bash\nsudo apt install make\n```\n\n* Download \u0026 extract the source\n* Change directory into *yt-dlg-1.8.5*\n* Create virtual environment\n```bash\nmake clean-requirements\nmake venv\n```\n* Activate virtual environment\n```bash\nsource venv/bin/activate\n```\n* Install requirements, build translations and install\n```bash\nmake install\n```\n\n### Binaries\nCreate binaries using [PyInstaller](https://www.pyinstaller.org/)\n* Install requirements, build translations and create binaries\n```bash\nmake pyinstaller\n```\n\n### Run yt-dlg\n* Activate virtual environment and run\n```bash\nsource venv/bin/activate\nyt-dlg\n```\n\n\u003e **Note**\n\u003e The default CLI Backend is `yt-dlp` you can change to `youtube-dl` CLI Backend in:\n\u003e\n\u003e   Settings -\u003e Options -\u003e Extra and change/select `youtube-dl`\n\n## Debian 11\nInstall the following packages and their dependences:\n\n```bash\nsudo apt-get update\nsudo apt-get install -y apt-utils build-essential dpkg-dev \\\n    freeglut3 freeglut3-dev libgl1-mesa-dev libglu1-mesa-dev \\\n    libgstreamer-plugins-base1.0-dev libgtk-3-dev libjpeg-dev \\\n    libnotify-dev libsdl2-dev libsm-dev libtiff-dev \\\n    libwebkit2gtk-4.0-dev libxtst-dev\n```\n\n### Setting the virtual environment and activate\n```bash\nsudo apt-get install -y python3.9 python3.9-dev libpython3.9-dev python3.9-venv\npython3.9 -m venv venv\nsource venv/bin/activate\npython3 -m pip install --upgrade pip setuptools wheel\n```\n\n### Install wxPython , requirements and yt-dlg\n\u003e * See **[Notes](#notes)** for install wxPython on Ubuntu\n\u003e\n\u003e * For install **wxPython on Debian 11 \"bullseye\"** download the wheel from the release:\n\u003e\n\u003e   [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)\n\u003e\n\u003e * For install **wxPython on Ubuntu 22.04.1 \"jammy\"** download the wheel from the release:\n\u003e\n\u003e   [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)\n\u003e\n\u003e * For install **wxPython on Ubuntu 21.04 \"hirsute\"** download the wheel from the release:\n\u003e\n\u003e   [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)\n\u003e\n\u003e * For install **wxPython on Ubuntu 20.04.5 \"focal\"** download the wheel from the release:\n\u003e\n\u003e   [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)\n\u003e\n\u003e * For install **wxPython ManyLinux 2.28** download the wheel from the release:\n\u003e\n\u003e   [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)\n\n```bash\npython3 -m pip install wxPython-4.1.1-cp39-cp39-linux_x86_64.whl\npython3 -m pip install -r requirements/requirements.in\npython3 -m pip install --no-deps yt-dlg\nyt-dlg\n```\n\n### Comprobar wxPython 4\n```bash\npython3 -c \"import wx ; print(wx.__version__)\"\n```\n\n### List and configure Locales\n```bash\nlocale -a\nsudo dpkg-reconfigure locales\n```\n\n## openSUSE Tumbleweed\nInstall using `zypper`\n\n### Open Build Service\n```bash\nsudo zypper ar -cfp 90 https://download.opensuse.org/repositories/home:oleksis/openSUSE_Tumbleweed/home:oleksis.repo\nsudo zypper install python38-yt-dlg\nyt-dlg\n```\n\n### With Python 3.8\nThe following steps can be executed if you use the Python version of the system (3.8, 3.9, 3.10)\n\n```bash\nsudo zypper dup  # Distribition Upgrade\nsudo zypper -n update  # Non Interactive\nsudo zypper -n install yum-utils\n```\n\n### Add openSUSE Factory repository for wxPython 4\n```bash\nsudo zypper addrepo -f http://download.opensuse.org/tumbleweed/repo/oss/ openSUSE-Factory\n```\n\n### Install wxPython 4 global (system level)\n\n\u003e * For install **wxPython on openSUSE Tumbleweed** download the wheel from the release:\n\u003e\n\u003e   [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)\n\nNeed at least one font installed\n\n```bash\nsudo zypper -n install python38-wxPython google-opensans-fonts\n```\n\n### Install other dev packages/tools for Python 3.8\n```bash\nsudo zypper -n install python38-pip python38-setuptools python38-devel python38-tools python38-virtualenv python38-requests\n```\n\n### Install `yt-dlg` global from PyPI\n```bash\npip3 install yt-dlg\n```\n\n### Add `yt-dlg` executable to the PATH and run\n```bash\nPATH=$HOME/.local/bin:$PATH\nyt-dlg\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eopenSUSE 15.3\u003c/summary\u003e\nWe need build **wxPython 4.1.1** for **Python 3.6**\n\n\u003e * For install **wxPython on openSUSE 15.3** download the wheel from the release:\n\u003e\n\u003e   [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)\n\n### Dev Tools\n```bash\nsudo zypper -n install -t pattern devel_basis\nsudo zypper -n install gcc-c++\nsudo zypper -n install git wget\n```\n\n### Requirement for install Python from source (Build dependencies)\n```bash\nsudo zypper -n install \\\n    readline-devel sqlite3-devel libbz2-devel \\\n    zlib-devel libopenssl-devel libffi-devel \\\n    ncurses-devel tk-devel libgdbm4 \\\n    ca-certificates gcc\n```\n\n### Install wxPython 4 Dependencies\n```bash\nsudo zypper -n install \\\n    gtk3-devel gtk3-tools webkit2gtk3-devel \\\n    libjbig2 libjbig-devel libjpeg8 libjpeg8-devel \\\n    libpng16-16 libpng16-devel libtiff-devel \\\n    libSDL2-2_0-0 libSDL2-devel libSM6 libSM-devel\\\n    gstreamer gstreamer-devel gstreamer-plugins-base-devel \\\n    freeglut-devel libnotify4 libnotify-devel \\\n    libSM6 libSM-devel liblzma5 libXtst6 libXv1 \\\n    gdk-pixbuf-loader-rsvg gdk-pixbuf-query-loaders \\\n```\n\n### Install Pyenv\n```bash\ncurl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash\necho 'export PYENV_ROOT=\"$HOME/.pyenv\"' \u003e\u003e $HOME/.bashrc\necho 'export PATH=\"$HOME/.pyenv/bin:$PATH\"' \u003e\u003e $HOME/.bashrc\necho 'eval \"$(pyenv init -)\"' \u003e\u003e $HOME/.bashrc\necho 'eval \"$(pyenv virtualenv-init -)\"' \u003e\u003e $HOME/.bashrc\nsource $HOME/.bashrc\n```\n\n### Custom Python build with `--enable-shared`\n```bash\nPYTHON_CONFIGURE_OPTS=\"--enable-shared\" \\\n    pyenv install 3.6.13\n\npyenv shell 3.6.13\n```\n\n### Add python-config to the PATH\n```bash\nPATH=$(pyenv root)/versions/${PYENV_VERSION}/bin:$PATH\n```\n\n### Install requirements and run `yt-dlg`\n```bash\npython -m pip install --upgrade pip six setuptools wheel\npython -m pip install -r requirements/requirements.in\npip install yt-dlg\nyt-dlg\n```\n\n### List locales\n```bash\nlocale  -av\n```\n\n### Windows Subsystem for Linux\nSome 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/)\n\n```bash\nsudo zypper -n install --no-recommends -t pattern gnome\nsudo /usr/bin/gdk-pixbuf-query-loaders-64 --update-cache\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eMageia 8\u003c/summary\u003e\nExists a third-party repository for Mageia 8 that have a rpm package for youtube-dl-gui.\nThe repository comes from [BlogDrake](https://blogdrake.net/) The Official Community for Spanish Talking Users\n\n### Instructions\nFirst you have to configure the Official Mageia repositories then\n\nFor i586 - 32bit systems\n```\nsu -\nurpmi.addmedia --wget --distrib https://ftp.blogdrake.net/mageia/mageia8/i586\nurpmi yt-dlg\nexit\n```\nFor x86_64 - 64bit systems\n```\nsu -\nurpmi.addmedia --wget --distrib https://ftp.blogdrake.net/mageia/mageia8/x86_64\nurpmi yt-dlg\nexit\n```\n\n### Source and RPM on Mageia 8\n* [SRC](https://ftp.blogdrake.net/mageia/mageia8/free/SRPMS/yt-dlg-1.8.5-1bdk_mga8.src.rpm)\n* [RPM](https://ftp.blogdrake.net/mageia/mageia8/free/noarch/yt-dlg-1.8.5-1bdk_mga8.noarch.rpm)\n\u003c/details\u003e\n\n## macOS Monterey\n* Install Pyenv using [Homebrew](https://github.com/pyenv/pyenv#homebrew-in-macos)\n* Suggested [build environment](https://github.com/pyenv/pyenv/wiki#suggested-build-environment)\n\n\n### Custom Python build with `--enable-framework`\n* [How to use wxPython with virtualenv on Mac OSX](https://wiki.wxpython.org/wxPythonVirtualenvOnMac)\n\n```bash\nPYTHON_CONFIGURE_OPTS=\"--enable-framework\" pyenv install 3.10.6\npyenv shell 3.10.6\npython -m pip install -r requirements/requirements.in\npip install yt-dlg\nyt-dlg\n```\n\n## Notes\nAn alternative to install wxPython 4 **Phoenix** from the Extras section\n\nFor Ubuntu 20.04\n\n```bash\nwget https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04/wxPython-4.1.1-cp38-cp38-linux_x86_64.whl\npip3 install wxPython-4.1.1-cp38-cp38-linux_x86_64.whl\n```\n\n* [wxPython 4 builds on various linux distros with Vagrant](https://github.com/wxWidgets/Phoenix/blob/wxPy-4.0.x/vagrant/debian-9/bootstrap.sh)\n\n* [Building wxPython for Linux via Pip](https://wxpython.org/blog/2017-08-17-builds-for-linux-with-pip/index.html)\n\n* [wxPython Phoenix Snapshot Builds](https://github.com/wxWidgets/Phoenix/blob/af85b5811b53ffe09153d357a3f515e90e4afdfa/packaging/README-snapshots.txt#L71)\n\n* [Building wxPython4 with Docker](https://github.com/wxWidgets/Phoenix/blob/master/docker/build/debian-10/Dockerfile#L25)\n\n* [Compile wxPython 4.1.2a1 using Microsoft C++ Build Tools 2019](https://gist.github.com/oleksis/8637f096b97e18e00786e46465e97b34)\n\n* [Compile wxPython 4.1.1 using Ubuntu on Windows Community Preview](https://gist.github.com/oleksis/2d84b9eefe1fef038619439168f3768e)\n\n* [Compile wxPython 4.1.2a1 on openSUSE Tumbleweed](https://gist.github.com/oleksis/0746bff4db6e2fc58c3bddf3f2672887)\n\n* [wxPython Windows artifacts for Python 3.7 to 3.11](https://dev.azure.com/oleksis/wxPython/_build/results?buildId=132\u0026view=artifacts\u0026pathAsName=false\u0026type=publishedArtifacts)\n\n## Contributing\n* **Add support for new language:** See [Localization Howto](https://yt-dlg.github.io/yt-dlg/Localization-Howto.html)\n* **Report a bug:** See [issues](https://github.com/oleksis/youtube-dl-gui/issues)\n* **Check how contribute:** [contribuite](https://github.com/oleksis/youtube-dl-gui/contribute)\n\n\u003ca href=\"https://www.buymeacoffee.com/oleksis\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-blue.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\nYou can send me bitcoins to the following address:\n\u003ca href=\"https://blockchain.info/address/bc1qnlea6zlfca9fpk62pzedrh6z20w0pxn2ujslztw8t84spprlr4cqdeg8u5\" target=\"_blank\"\u003ebc1qnlea6zlfca9fpk62pzedrh6z20w0pxn2ujslztw8t84spprlr4cqdeg8u5\u003c/a\u003e\n\n![Bitcoin Address](https://github.com/oleksis/youtube-dl-gui/raw/master/docs/img/qr-bitcoin.png)\n\n## Authors\nSee [AUTHORS](AUTHORS) file\n\n## License\nThe [Public Domain License](LICENSE)\n\n## Frequently Asked Questions\nSee [FAQs](https://yt-dlg.github.io/yt-dlg/Faq.html)\n\n## Thanks\nThanks to everyone who contributed to this project and to [@philipzae](https://github.com/philipzae) for designing the new UI layout.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyt-dlg%2Fyt-dlg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyt-dlg%2Fyt-dlg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyt-dlg%2Fyt-dlg/lists"}