Skip to content

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grabby

grabby logo

grabby Electron React

Modern GUI for yt-dlp with support for 1000+ services

Download videos and audio from YouTube, Twitch, TikTok and other platforms with a sleek UI

EnglishУкраїнська


English

✨ Features

  • 🎨 Modern Dark UI — Minimalist design with IBM Plex Mono
  • 🎬 Flexible Settings — Choose video quality (360p-4K), audio (96-320kbps) and formats
  • 🎵 Download Modes — Video+audio, video only, or audio only
  • 📝 Subtitles — Auto-download Ukrainian and English subtitles
  • 🖼️ Thumbnails — Embed thumbnails into media files
  • 📋 Playlists — Support for downloading specific playlist items
  • Quick Launch — Execute commands directly from the app
  • 🔧 Command Generator — Copy ready-to-use terminal commands
  • 💾 Settings Persistence — Your preferences are saved automatically

🖥️ Supported Platforms

  • ✅ Windows 10/11
  • ✅ macOS (requires build)
  • ✅ Linux (requires build)

📦 Installation

Prerequisites

First, install yt-dlp:

Windows:

winget install yt-dlp

macOS:

brew install yt-dlp

Linux / pip:

pip install -U yt-dlp

Download the App

  1. Download the latest version from Releases
  2. Run the installer
  3. Done! The app will automatically detect installed yt-dlp

🚀 Usage

  1. Paste URL — Link to video or playlist
  2. Choose mode — Video+audio, video only, or audio only
  3. Set quality — Select desired quality and format
  4. Additional options — Subtitles, thumbnails, playlist items
  5. Run — Click "Run" or copy the command

Command Examples

Download 1080p video in MP4:

yt-dlp -f "bestvideo[height<=1080][ext=mp4]+bestaudio/best[abr<=192]/bestvideo[height<=1080]+bestaudio" --merge-output-format mp4 -o "Downloads/%(title)s.%(ext)s" "URL"

Extract audio to MP3 320kbps:

yt-dlp -x --audio-format mp3 --audio-quality 320k -o "Downloads/%(title)s.%(ext)s" "URL"

🛠️ Development

Install Dependencies

npm install

Run in Development Mode

npm run electron-dev

This will start React dev server and Electron simultaneously with hot reload.

Build

Windows:

npm run dist-win

macOS:

npm run dist-mac

Built files will be in the dist/ folder.

📁 Project Structure

grabby/
├── electron/          # Electron main process
│   ├── main.js       # Main process
│   └── preload.js    # Preload script
├── src/              # React app
│   ├── App.jsx       # Main component
│   ├── App.css       # Styles
│   └── index.js      # Entry point
├── public/           # Static files
└── package.json      # Project config

🎨 Technologies

  • Frontend: React 18, CSS
  • Desktop: Electron 27
  • Build: electron-builder
  • Fonts: IBM Plex Mono, Space Grotesk

🤝 Contributing

Contributions are welcome! Open issues or pull requests.

  1. Fork the project
  2. Create feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add some AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open Pull Request

📄 License

MIT License - see LICENSE

🙏 Acknowledgments

  • yt-dlp — Powerful video download tool
  • Electron — Desktop app framework
  • React — UI library

Українська

✨ Особливості

  • 🎨 Сучасний темний UI — Мінімалістичний дизайн з IBM Plex Mono
  • 🎬 Гнучкі налаштування — Вибір якості відео (360p-4K), аудіо (96-320kbps) та форматів
  • 🎵 Режими завантаження — Відео+аудіо, тільки відео, тільки аудіо
  • 📝 Субтитри — Автоматичне завантаження українських та англійських субтитрів
  • 🖼️ Обкладинки — Вбудовування thumbnail у медіафайли
  • 📋 Плейлисти — Підтримка завантаження окремих елементів плейлиста
  • Швидкий запуск — Виконання команд безпосередньо з програми
  • 🔧 Генератор команд — Копіювання готових команд для терміналу
  • 💾 Збереження налаштувань — Ваші налаштування зберігаються автоматично

🖥️ Підтримувані платформи

  • ✅ Windows 10/11
  • ✅ macOS (потребує збірки)
  • ✅ Linux (потребує збірки)

📦 Встановлення

Передумови

Спочатку встанови yt-dlp:

Windows:

winget install yt-dlp

macOS:

brew install yt-dlp

Linux / pip:

pip install -U yt-dlp

Завантаження програми

  1. Завантаж останню версію з Releases
  2. Запусти інсталятор
  3. Готово! Програма автоматично визначить встановлений yt-dlp

🚀 Використання

  1. Вставте URL — Посилання на відео або плейлист
  2. Оберіть режим — Відео+аудіо, тільки відео або тільки аудіо
  3. Налаштуйте якість — Виберіть бажану якість та формат
  4. Додаткові опції — Субтитри, обкладинки, елементи плейлиста
  5. Запустіть — Натисніть "Запустити" або скопіюйте команду

Приклади команд

Завантажити відео 1080p у форматі MP4:

yt-dlp -f "bestvideo[height<=1080][ext=mp4]+bestaudio/best[abr<=192]/bestvideo[height<=1080]+bestaudio" --merge-output-format mp4 -o "Downloads/%(title)s.%(ext)s" "URL"

Витягнути аудіо у MP3 320kbps:

yt-dlp -x --audio-format mp3 --audio-quality 320k -o "Downloads/%(title)s.%(ext)s" "URL"

🛠️ Розробка

Встановлення залежностей

npm install

Запуск у режимі розробки

npm run electron-dev

Це запустить React dev server та Electron одночасно з hot reload.

Збірка

Windows:

npm run dist-win

macOS:

npm run dist-mac

Готові файли будуть у папці dist/.

📁 Структура проєкту

grabby/
├── electron/          # Electron main process
│   ├── main.js       # Головний процес
│   └── preload.js    # Preload скрипт
├── src/              # React додаток
│   ├── App.jsx       # Головний компонент
│   ├── App.css       # Стилі
│   └── index.js      # Entry point
├── public/           # Статичні файли
└── package.json      # Конфігурація проєкту

🎨 Технології

  • Frontend: React 18, CSS
  • Desktop: Electron 27
  • Build: electron-builder
  • Fonts: IBM Plex Mono, Space Grotesk

🤝 Внесок

Contributions are welcome! Відкривай issues або pull requests.

  1. Fork проєкт
  2. Створи feature branch (git checkout -b feature/AmazingFeature)
  3. Commit зміни (git commit -m 'Add some AmazingFeature')
  4. Push у branch (git push origin feature/AmazingFeature)
  5. Відкрий Pull Request

📄 Ліцензія

MIT License - дивись LICENSE

🙏 Подяки

  • yt-dlp — Потужний інструмент завантаження відео
  • Electron — Фреймворк для десктопних застосунків
  • React — Бібліотека для UI

Made with ❤️ using AI

Зроблено з ❤️ за допомогою AI

⬆ Back to top⬆ Повернутися до початку

About

React + Electron GUI for yt-dlp with quality presets and format selection

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages