ytDownloader Documentation

Desktop app to download audio/video from hundreds of sites

10,514 stars JavaScript JavaScript 1 file Β· ~2,216 tokens #appimage#compressor#downloader#electron#ffmpeg#flatpak#javascript#linux
RAW Doc

Technical Documentation: aandrew-me/ytDownloader

ℹ️ Provenance: Multi-Tier Ingestion Β· CodeWiki Reference

Overview (`README.md`)

ytDownloader





A modern GUI video and audio downloader supporting hundreds of sites



[](https://flathub.org/apps/io.github.aandrew_me.ytdn) [](https://github.com/aandrew-me/ytDownloader/releases/latest/download/YTDownloader_Win.exe ) [](https://github.com/aandrew-me/ytDownloader/releases/latest/download/YTDownloader_Mac_arm64.dmg) [](https://github.com/aandrew-me/ytDownloader/releases/latest/download/YTDownloader_Mac_x64.dmg) [](https://community.chocolatey.org/packages/ytdownloader)

Features πŸš€

βœ… Supports hundreds of sites including Youtube, Facebook, Instagram, Tiktok, Twitter and so on.

βœ… Multiple themes

βœ… Video Compressor with Hardware Acceleration

βœ… Advanced options like Range Selection, Subtitles

βœ… Download playlists

βœ… Available on Linux, Windows & macOS

βœ… Fast download speeds

βœ… And of-course no trackers or ads

Screenshots

More screenshots

Installation

Windows πŸͺŸ

  • Microsoft Store

    Download app from Microsoft Store.

  • Traditional way

    Download and install the exe or msi file. Exe file lets you choose custom download location, msi file doesn't ask for location. Windows defender may show a popup saying Windows Protected Your PC. Just click on More info and click on Run Anyway

  • Chocolatey
    App can be installed from Chocolatey using the following command

    text
    choco install ytdownloader
  • Scoop
    App can be installed with Scoop using the following command

    text
    scoop install https://raw.githubusercontent.com/aandrew-me/ytDownloader/main/ytdownloader.json
  • Winget

    App can be installed with Winget using the following command

    text
    winget install aandrew-me.ytDownloader

Linux 🐧

Linux has several options available - Flatpak, AppImage and Snap.
Flatpak is recommended. For arm processors, download from flathub.

  • AppImage

    AppImage format is supported on most Linux distros and has Auto-Update support.
    It just needs to be executed after downloading. See more about AppImages here.

    AppImageLauncher is recommended for integrating AppImages.

  • Flatpak

    text
    flatpak install flathub io.github.aandrew_me.ytdn
  • Snapcraft

    text
    sudo snap install ytdownloader

macOS 🍎

Since the app is not signed, when you will try to open the app, macOS will not allow you to open it.

You need to open terminal and execute:

text
sudo xattr -r -d com.apple.quarantine /Applications/YTDownloader.app

You will also need to install yt-dlp with homebrew

text
brew install yt-dlp

Internationalization (Localization) 🌍

Translations into other languages would be highly appreciated. If you want to help translating the app to other languages, you can join from here. Open a new issue and that language will be added to Crowdin. Please don't make pull requests with json files, instead use Crowdin.

βœ… Available languages

Name Status
Arabic βœ”οΈ
Basque βœ”οΈ
Bengali βœ”οΈ
English βœ”οΈ
Chinese Simplified βœ”οΈ
Chinese Traditional βœ”οΈ
Finnish βœ”οΈ
Hindi βœ”οΈ
French βœ”οΈ
Nepali βœ”οΈ
German βœ”οΈ
Greek βœ”οΈ
Hungarian βœ”οΈ
Italian βœ”οΈ
Japanese βœ”οΈ
Persian βœ”οΈ
Polish βœ”οΈ
Portuguese (Brazil) βœ”οΈ
Russian βœ”οΈ
Spanish βœ”οΈ
Turkish βœ”οΈ
Ukrainian βœ”οΈ
Vietnamese βœ”οΈ

Thanks to nxjosephofficial, LINUX-SAUNA, Proxycon, albanobattistella, TheBlueQuasar, MrQuerter, KotoWhiskas, AndrΓ©, haggen88, XfedeX, Jok3r, TitouanReal, soredake, yoi, HowlingWerewolf, Kum, Mohammed Bakry, Huang Bingfeng, Abhinav, CodWiz, Bovirus and others for helping.

Used technologies

For building or running from source code

Nodejs (along with npm) needs to be installed.

Required commands to get started.

text
git clone https://github.com/aandrew-me/ytDownloader.git
cd ytDownloader
npm i

To run with Electron :

text
npm start

You need to download ffmpeg and put it in the root directory of the project. If you don't need to build for arm processor, you can download ffmpeg by executing any of the files - linux.sh / mac.sh / windows.sh depending on the platform. Otherwise you need to download ffmpeg from here for windows/linux and from here for mac (not tested)

To build for Linux (It will create packages as specified in package.json). The builds are stored in release folder.

text
npm run linux

To build for Windows

text
npm run windows

To build for macOS

text
npm run mac

If you only want to build for one format, you can do

text
npx electron-builder -l appimage

It will just create a linux appimage build.


--- METRICS ---