# Arroxy — безкоштовний завантажувач YouTube (+ 2000 сайтів) із відкритим кодом для Windows, macOS та Linux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Мова:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Kiswahili](README.sw.md) · [O'zbekcha](README.uz.md) · [Polski](README.pl.md) · [Português](README.pt.md) · [Tiếng Việt](README.vi.md) · [Türkçe](README.tr.md) · [አማርኛ](README.am.md) · [العربية](README.ar.md) · [اردو](README.ur.md) · [پښتو](README.ps.md) · [فارسی](README.fa.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [ไทย](README.th.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · **Українська** · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-Hant.md)
[](https://github.com/antonio-orionus/Arroxy/releases/latest) [](https://github.com/antonio-orionus/Arroxy/actions/workflows/release.yml) [](https://arroxy.orionus.dev/)   
Завантажуйте відео, Shorts, музику, канали, подкасти або аудіодоріжки з **YouTube та 2000+ підтримуваних сайтів** — до 4K HDR при 60 fps або у форматі MP3 / AAC / Opus. Працює локально на Windows, macOS та Linux. **Без реклами, без зайвого, без апселів.**
[**↓ Завантажити останній реліз**](#install) · [**Сайт**](https://arroxy.orionus.dev/) · [Windows: перший запуск](#windows-first-launch) · [macOS: перший запуск](#macos-first-launch) · [Linux: перший запуск](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Якщо Arroxy економить ваш час, ⭐ допомагає іншим його знайти.
> **What is Arroxy?** Arroxy is a free, open-source desktop GUI that downloads videos, audio, playlists, and subtitles from YouTube and 2000+ other [yt-dlp](https://github.com/yt-dlp/yt-dlp)-supported sites. It runs on Windows 10/11, macOS 11+ (Intel + Apple Silicon), and Linux (AppImage, Flatpak, tar.gz). MIT licensed. No account, no ads, no usage limits. Distributed via [Winget](https://winget.run/pkg/AntonioOrionus/Arroxy), [Scoop](https://github.com/antonio-orionus/scoop-bucket), [Homebrew Cask](https://github.com/antonio-orionus/homebrew-arroxy), Flatpak, AppImage, and direct download.
>
> _Last updated: 2026-09-14._
> 🌐 Це переклад за допомогою ШІ. [README англійською](README.md) — основне джерело істини. Помітили помилку? [PR вітаються](../../pulls).
---
## Зміст
- [Встановлення та перший запуск](#install)
- [Windows: перший запуск](#windows-first-launch)
- [macOS: перший запуск](#macos-first-launch)
- [Чому ви можете побачити попередження](#why-warning)
- [Linux: перший запуск](#linux-first-launch)
- [Перевірте своє завантаження (SHA256)](#verify)
- [Чому Arroxy](#why)
- [Можливості](#features)
- [Конфіденційність](#privacy)
- [Часті запитання](#faq)
- [Дорожня карта](#roadmap)
- [Підтримати Arroxy](#support)
- [Технології](#tech)
---
## Встановлення та перший запуск
**Windows**
```bash
winget install AntonioOrionus.Arroxy
```
**macOS**
```bash
brew install --cask antonio-orionus/arroxy/arroxy
```
**Linux**
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh
```
Скрипт для Linux звіряє завантаження з опублікованими `SHA256SUMS` і додає Arroxy до меню програм. Збірки лише x86_64. Немає `curl`? Замініть `curl -fsSL` на `wget -qO-`.
| Платформа | Формат |
| --- | --- |
| Windows | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Setup.exe) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Portable.exe) |
| macOS | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-arm64.dmg) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-x64.dmg) |
| Linux | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.AppImage) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.flatpak) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.tar.gz) |
| Verify | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/SHA256SUMS) |
[**Завантажити останній реліз →**](https://github.com/antonio-orionus/Arroxy/releases/latest)
### Windows: перший запуск
При першому запуску ви можете побачити **«Windows protected your PC»** або **«Unknown publisher»**. Це стосується як `Arroxy-win-x64-Setup.exe`, так і `Arroxy-win-x64-Portable.exe`. Arroxy є безкоштовним і відкритим, а Windows-збірки не підписані платним сертифікатом — саме тому SmartScreen їх позначає. Це **не** означає автоматично, що Arroxy небезпечний. Щоб продовжити:
1. Натисніть **More info**.
2. Натисніть **Run anyway**.
#### Якщо Windows Defender позначив або видалив файл
Евристика Defender іноді позначає непідписані інсталятори NSIS і портативні версії Electron як підозрілі. Якщо Defender помістив у карантин `Arroxy-win-x64-Setup.exe` або `Arroxy-win-x64-Portable.exe`, відновіть файл із **Windows Security → Virus & threat protection → Protection history**, а потім додайте виконуваний файл Arroxy до списку дозволених елементів у розділі **Manage settings → Add or remove exclusions**. Як і у випадку зі SmartScreen, причиною є відсутній підпис видавця, а не виявлення шкідливого ПЗ.
> Завантажуйте Arroxy лише з офіційної сторінки GitHub Releases. Якщо ви отримали файл з іншого сайту або хтось надіслав його вам — видаліть його та завантажте свіжу копію з офіційного джерела. Вихідний код відкритий, тому за бажанням ви можете перевірити його або зібрати Arroxy самостійно.
Віддаєте перевагу Scoop? `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### macOS: перший запуск
Arroxy ще не підписаний кодом для macOS, тому після встановлення з DMG Gatekeeper може показати страшний діалог *"Arroxy.app is damaged and can't be opened"*. Це означає, що macOS помістила непідписаний застосунок у quarantine; файли застосунку насправді не пошкоджені. У сучасних версіях macOS надійне рішення — Terminal:
1. Перетягніть `Arroxy.app` зі змонтованого DMG до `/Applications`.
2. Відкрийте Terminal і виконайте ці дві команди:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
Перша команда видаляє атрибут quarantine з установленої копії Arroxy. Друга запускає застосунок. `sudo` може попросити пароль Mac; Terminal не показує символи під час введення.
**Apple Silicon vs Intel:** на Mac із процесором серії M (M1 / M2 / M3 / M4) завантажуйте DMG для `arm64`. На Intel Mac — DMG для `x64`. Неправильна збірка також запускатиметься через Rosetta, але помітно повільніше.
> Збірки macOS виробляються через CI на Apple Silicon та Intel рушіях. Якщо виникнуть проблеми, будь ласка, [відкрийте issue](../../issues) — зворотний зв'язок від користувачів macOS активно впливає на цикл тестування macOS.
### Чому ви можете побачити попередження
Arroxy — проєкт із відкритим кодом і ліцензією MIT. Збірки для Windows та macOS **не підписані кодом** — сертифікати Apple Developer ID та Windows EV для підпису коду коштують сотні доларів на рік, і незалежний проєкт сплачує їх із власної кишені. Без цих підписів Windows SmartScreen і macOS Gatekeeper попереджатимуть вас при першому запуску. Попередження означають *що ваша ОС не розпізнає видавця* — вони не означають, що Arroxy є шкідливим ПЗ.
Три способи самостійно перевірити Arroxy, у порядку зростання строгості:
- **Прочитайте вихідний код.** Кожен рядок є на [GitHub](https://github.com/antonio-orionus/Arroxy), і ви можете [зібрати Arroxy з джерел](#tech).
- **Перевірте SHA256.** Порівняйте свій файл із опублікованим [`SHA256SUMS`](../../releases/latest) — дивіться [Перевірте своє завантаження](#verify) нижче.
- **Запустіть стороннє сканування.** Завантажте файл на [VirusTotal](https://www.virustotal.com).
### Linux: перший запуск
AppImage запускаються безпосередньо — без встановлення. Потрібно лише позначити файл як виконуваний.
**Файловий менеджер:** клацніть правою кнопкою на `.AppImage` → **Властивості** → **Права** → увімкніть **Дозволити виконання файлу як програми**, потім подвійний клік.
**Термінал:**
```bash
chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage
```
Якщо запуск все одно не вдається — запустіть без монтування, пакунок FUSE не потрібен:
```bash
./Arroxy-linux-x64.AppImage --appimage-extract-and-run
```
**Необов'язкова інтеграція з робочим столом:** встановіть [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) один раз, і будь-який AppImage, на який ви двічі клацнете, автоматично реєструватиметься в меню запуску — без ручного створення `.desktop`-файлів.
**Звичайний архів (без FUSE, без встановлення):**
Збірка `.tar.gz` — той самий застосунок без оболонки AppImage: розпакуйте будь-куди й запустіть. Ані інсталятора, ані пакунка FUSE.
```bash
tar xzf Arroxy-linux-x64.tar.gz
./Arroxy-linux-x64/arroxy
```
**Flatpak (ізольована альтернатива):** завантажте `Arroxy-*.flatpak` з тієї ж сторінки релізу.
В Ubuntu замість Flatpak постачається Snap, тож спершу встановіть Flatpak і додайте Flathub — звідти пакунок завантажує свій runtime:
```bash
# Ubuntu / Debian
sudo apt install -y flatpak
# Fedora
sudo dnf install -y flatpak
# Arch
sudo pacman -S flatpak
```
```bash
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user ./Arroxy-linux-x64.flatpak
flatpak run io.github.antonio_orionus.Arroxy
```
**Завантаження для Linux на сторінці релізів лише x86_64.** На машинах ARM64 (Raspberry Pi, Asahi Linux) Flatpak встановиться, але не запуститься: `bwrap: execvp ldconfig: Exec format error`.
Перевірте своє завантаження (SHA256)
До кожного релізу публікується файл `SHA256SUMS` поруч із бінарними файлами. Щоб переконатися, що ваш файл не було пошкоджено або підмінено під час передачі, обчисліть хеш файлу локально та порівняйте його з рядком у `SHA256SUMS`. Відкрийте сторінку останнього релізу → **Assets** → завантажте `SHA256SUMS`.
**Windows (PowerShell or Command Prompt):**
```powershell
certutil -hashfile Arroxy-win-x64-Setup.exe SHA256
```
**macOS (Terminal):**
```bash
shasum -a 256 Arroxy-mac-arm64.dmg
```
**Linux (Terminal):**
```bash
sha256sum Arroxy-linux-x64.AppImage
```
Хочете стороннє сканування на шкідливе ПЗ? Завантажте файл на [VirusTotal](https://www.virustotal.com). Кілька спрацьовувань узагальненої евристики у другорядних рушіях — норма для непідписаних Electron-застосунків; масові виявлення у великих рушіях були б справжнім приводом для занепокоєння.
Windows: Інсталятор vs Портативна версія
| | Інсталятор NSIS | Портативний `.exe` |
| ------------- | :----------------------: | :---------------------: |
| Потрібне встановлення | Так | Ні — запускається будь-звідки |
| Авто-оновлення | ✅ у застосунку | ❌ ручне завантаження |
| Швидкість запуску | ✅ швидше | ⚠️ повільніший холодний старт |
| Додається до меню «Пуск» | ✅ | ❌ |
| Зручне видалення | ✅ | ❌ просто видаліть файл |
**Рекомендація:** використовуйте інсталятор NSIS для авто-оновлень і швидкого запуску. Використовуйте портативний `.exe` для варіанту без встановлення та без змін реєстру.
---
## Чому Arroxy
Порівняння з найпоширенішими альтернативами:
| | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions |
| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |
| Безкоштовно, без преміум-рівня | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| Відкритий код | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| Лише локальна обробка | ✅ | ✅ | ✅ | ❌ | ✅ |
| Без логіну та експорту кук | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ |
| Без обмежень використання | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ |
| Крос-платформний настільний застосунок | ✅ | ✅ | ✅ | N/A | ❌ |
| Субтитри + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ |
Arroxy створений для однієї задачі: вставте URL — отримайте чистий локальний файл. Без акаунтів, без апселів, без збору даних.
---
## Можливості
### Якість і формати
- До **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p
- **Висока частота кадрів** збережена як є — 60 fps, 120 fps, HDR
- **Аудіо** — експорт лише аудіо в MP3, M4A/AAC, Opus або WAV. В інтерактивних завантаженнях вибирайте нативні surround/Dolby доріжки джерела (AC-3, E-AC-3, 5.1, DRC), коли вони доступні, або задайте глобальне значення за замовчуванням **Надавати перевагу surround / Dolby**
- Швидкі пресети: *Найкраща якість* · *Збалансовано* · *Малий файл*
### Конфіденційність і контроль
- 100% локальна обробка — завантаження потрапляють прямо з YouTube на ваш диск
- Без логіну, без кук, без прив'язки акаунта Google
- Файли зберігаються прямо у вибрану вами теку
### Робочий процес
- **Глобальна гаряча клавіша завантаження** — скопіюйте посилання в будь-якому застосунку й натисніть `Ctrl+Shift+D` (`Cmd+Shift+D` на macOS); Arroxy додасть його до черги з вашим активним профілем, не відкриваючи вікно, а сповіщення це підтвердить. Увімкнено за замовчуванням, комбінацію можна змінити
- **Гнучкі режими старту** — оберіть покрокове одиночне завантаження, вибір playlist/channel, масове вставлення URL або Quick Download зі збереженими стандартами
- **Центральна черга завантажень** — кожне single, playlist, bulk або quick завдання потрапляє в одне місце для прогресу, паузи, відновлення, скасування, повтору та керування пріоритетом
- **Моніторинг буфера обміну** — скопіюйте посилання YouTube, і Arroxy автоматично заповнить поле URL при наступному переключенні на застосунок (вимикається в розширених налаштуваннях)
- **Автоочищення URL** — видаляє трекінгові параметри (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) і розгортає посилання `youtube.com/redirect`
- **Режим трею** — закриття вікна залишає завантаження працювати у фоні
- **30 мов** — автоматично визначає локаль системи, можна перемкнути будь-коли
- **Синхронізація плейлиста** — повторно звіряє плейлист із локальною папкою, щоб пропускати вже завантажені відео; створює файл плейлиста `.m3u`, який оновлюється після кожного завантаженого відео
- **Керування швидкістю та pacing** — обмежуйте download bandwidth, задавайте, скільки частин відео завантажується одночасно, і додавайте затримки між запитами з пресетами (*Вимк · Збалансовано · Обережно · Власний*)
- **Шаблони імен файлів** — називайте завантаження на свій смак за допомогою `{title}`, `{uploader}`, `{id}`, `{date}`, `{resolution}` та `{playlist_index}`, глобально або для кожного профілю завантаження
- **Завантажень одночасно та автоповтор** — обирайте, скільки завантажень із черги йде одночасно, і дозвольте Arroxy повторити завантаження після збою мережі або сервера, збільшуючи паузу перед кожною спробою
- **Профілі для кожного відео плейлиста** — призначайте кожному відео в плейлисті власний профіль завантаження замість одного налаштування для всього списку, щоб за один прохід частину відео зберегти в повній якості, а решту — як MP3
### Субтитри та постобробка
- **Субтитри** у SRT, VTT або ASS — ручні або авто-згенеровані, будь-якою доступною мовою
- Зберігайте поруч із відео, вбудовуйте в `.mkv` або складайте в підпапку `Subtitles/`
- **SponsorBlock** — пропускайте або позначайте розділами спонсорські вставки, вступи, кінцівки, самопіар
- **Вбудовані метадані** — назва, дата завантаження, канал, опис, мініатюра та маркери розділів записуються у файл
### YouTube + 2000 сайтів
- **YouTube — у повному обсязі** — відео, Shorts, канали, плейлисти, YouTube Music і подкасти обробляються як першокласні джерела
- **2000+ інших сайтів** через yt-dlp — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org та багато іншого
- **Лише аудіо та субтитри** працюють на кожному підтримуваному сайті, а не лише на YouTube
- Якщо сайт змінюється, yt-dlp щотижня випускає виправлення, а Arroxy оновлює бінарний файл при запуску
Глобальна гаряча клавіша завантаження Скопіюйте посилання будь-де, натисніть один раз — воно потрапляє в чергу й починає завантажуватися
Профілі для кожного відео плейлиста Власний профіль для кожного відео — частину в 4K, решту як MP3
Головна швидкого завантаження Вставте URL і одразу завантажте з активним профілем
Багаторазові профілі завантаження Зберігайте формат, якість і вивід як пресети — використовуйте для кожного завантаження
Багатомовні аудіодоріжки Виберіть саме ту мову звуку, що є у відео
Об'ємний / Dolby звук Доріжки 5.1 і Dolby розпізнаються та зберігаються
Режим масових URL Вставте список, авто-вилучення дублікатів, поставте все в чергу одразу
Паралельна черга завантажень Кілька завантажень одночасно з живим прогресом
---
## Конфіденційність
Завантаження виконуються безпосередньо через [yt-dlp](https://github.com/yt-dlp/yt-dlp) з YouTube у вибрану вами теку — нічого не маршрутизується через сторонні сервери. Історія перегляду, історія завантажень, URL та вміст файлів залишаються на вашому пристрої.
Arroxy надсилає анонімну агрегатну телеметрію через [OpenPanel](https://openpanel.dev) — рівно стільки, щоб розуміти збої, падіння, відгуки, OS та версії застосунку. Без URL, назв відео, шляхів до файлів, даних акаунта, fingerprinting чи персональних даних. ID установки випадковий і не пов’язаний із вашою особою. Можна вимкнути в Налаштуваннях.
---
## Часті запитання
**Це справді безкоштовно?**
Так — ліцензія MIT, без преміум-рівня, без заблокованих функцій.
**Які якості відео можна завантажувати?**
Будь-які, що пропонує YouTube: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p, а також лише аудіо. Потоки з частотою 60 fps, 120 fps та HDR зберігаються як є.
**Чи можна витягти лише аудіо як MP3?**
Так. Обери *лише аудіо* в меню форматів, а потім MP3, M4A/AAC, Opus або WAV.
**Чи потрібен акаунт YouTube або куки?**
За замовчуванням — ні. Arroxy працює без акаунта YouTube, без логіну та без експорту кук. Опціональна підтримка кук доступна в розділі «Розширені налаштування» (Джерело кук: файл або браузер) для вмісту, який потребує автентифікації, наприклад відео з віковим обмеженням або лише для учасників. За замовчуванням ця опція вимкнена. Якщо ви її увімкнете, у вікі yt-dlp зазначено, що [автоматизація на основі кук може позначити акаунт Google](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies); у такому випадку безпечніше використовувати одноразовий акаунт.
**Чи продовжить він працювати, якщо YouTube щось зміниться?**
yt-dlp автоматично оновлюється під час запуску, а Arroxy оперативно випускає виправлення, коли YouTube щось змінює. Якщо ви все ж зіткнетеся з проблемою, як запасний варіант доступна опціональна підтримка кук у розділі «Розширені налаштування».
**Якими мовами доступний Arroxy?**
30 мов доступні одразу: Afaan Oromoo · Bahasa Indonesia · Deutsch · English · Español · Français · Italiano · Kiswahili · O'zbekcha · Polski · Português · Tiếng Việt · Türkçe · አማርኛ · العربية · اردو · پښتو · فارسی · বাংলা · हिन्दी · ไทย · မြန်မာဘာသာ · Ελληνικά · Русский · Српски · Українська · 中文 · 日本語 · 한국어 · 繁體中文. Arroxy автоматично визначає мову операційної системи під час першого запуску, а перемкнути її можна будь-коли через вибір мови на панелі інструментів. Runtime locale JSON зберігається в src/shared/i18n/locales/, а PO-каталоги для перекладачів — в i18n/locales/ — відкрийте PR на GitHub, щоб долучитися.
**Чи потрібно щось встановлювати додатково?**
Ні. yt-dlp автоматично завантажується при першому запуску й кешується на вашій машині; ffmpeg і ffprobe постачаються разом із застосунком. Після цього жодних додаткових налаштувань не потрібно.
**Чи можна завантажувати плейлисти або цілі канали?**
Так — і те, й інше. Вставте URL playlist або channel (наприклад, `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); виберіть, скільки entries сканувати, а потім додайте весь список у queue або виберіть окремі відео. Date-range filters з’являться незабаром.
**macOS каже «застосунок пошкоджений» — що робити?**
Це macOS Gatekeeper блокує непідписаний застосунок, а не реальне пошкодження. Команди Terminal для зняття quarantine і запуску Arroxy дивіться в [macOS first launch](#macos-first-launch).
**Чи законно завантажувати відео YouTube?**
Для особистого, приватного використання це загалом прийнято в більшості юрисдикцій. Ви несете відповідальність за дотримання [Умов використання](https://www.youtube.com/t/terms) YouTube та місцевого авторського права.
---
## Дорожня карта
Досі заплановано — приблизно за пріоритетом:
| Функція | Опис |
| ---------------- | ---------------- |
| **Фільтри плейлистів і каналів** | Date-range filters під час переліку playlist або channel |
| **Пріоритети аудіодоріжок YouTube** | Задати бажану мовну аудіодоріжку для всього застосунку, із перевизначеннями в окремих профілях, коли YouTube надає кілька аудіотреків |
| **Вхід через браузер у застосунку** | Відкривати браузерні вікна всередині Arroxy, щоб входити на сайти й використовувати cookies без ручного експорту |
| **Завантаження відео в один клік** | Запускати завантаження відео в один клік із виявленого або вставленого URL за активним профілем |
| **Надійніше відновлення повтором** | Новий шлях повторної спроби для завантажень, перерваних нестабільним або проблемним інтернет-з'єднанням |
| **Повноцінний менеджер завантажень у drawer** | Перетворити drawer черги на повніший менеджер, включно зі зміною папок призначення для елементів у черзі |
| **Заплановані завантаження** | Запускайте чергу в заданий час (нічні запуски) |
| **Обрізання кліпів** | Завантажуйте лише фрагмент за часом початку та кінця |
Маєте ідею? [Відкрийте запит](../../issues) — голос спільноти визначає пріоритети.
---
## Підтримати Arroxy
Arroxy безкоштовний і має ліцензію MIT — без реклами, без платної версії. Якщо він заощаджує ваш час, ви можете підтримати розробку через Bitcoin або Tron: адреси наведені в [DONATE.md](DONATE.md) — єдиному офіційному джерелі для них. Arroxy ніколи не надішле вам адресу електронною поштою чи в особистому повідомленні. Зірка репозиторію, повідомлення про помилки та покращення перекладів допомагають не менше.
---
## Технології
Stack
- **Electron** — крос-платформна настільна оболонка
- **React 19** + **TypeScript** — інтерфейс
- **Tailwind CSS v4** — стилізація
- **Zustand** — керування станом
- **yt-dlp** + **ffmpeg** — рушій завантаження та мультиплексування (yt-dlp отримується під час роботи; ffmpeg/ffprobe вбудовуються під час збірки)
- **Vite** + **electron-vite** — збірка
- **Vitest** + **Playwright** — модульні та наскрізні тести
Збірка з вихідного коду
### Передумови — всі платформи
| Інструмент | Версія | Встановлення |
| ---------- | ------- | ------------ |
| Git | будь-яка | [git-scm.com](https://git-scm.com) |
| Node.js | 24.16.0 | `mise install` або `.node-version` |
| Bun | 1.2.23 | `mise install` або `package.json` `packageManager` |
Рекомендовано: встановіть `mise`, а потім запустіть `mise install` у checkout. Без mise вручну активуйте Node.js з `.node-version` і Bun з `package.json` перед `bun run bootstrap`.
### Windows
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
Visual Studio Build Tools і Python можуть знадобитися для нативних перебудов.
### macOS
```bash
brew install mise
xcode-select --install
```
Після клонування запустіть `mise trust && mise install` у checkout. Якщо ваш shell уже використовує `fnm`, `nvm` або Bun з Homebrew, активуйте mise у `~/.zshrc`, щоб Arroxy отримав Node.js 24.16.0 і Bun 1.2.23:
```bash
printf '
# mise
if command -v mise >/dev/null 2>&1; then
eval "$(mise activate zsh)"
fi
' >> ~/.zshrc
exec zsh
```
### Linux (Ubuntu / Debian)
```bash
curl -fsSL https://bun.sh/install | bash
# Залежності збірки та середовища виконання Electron
sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64
# Лише для E2E-тестів (Electron потребує дисплея)
sudo apt install -y xvfb
```
### Клонування та запуск
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # рекомендовано; пропустіть, якщо закріплені інструменти активовані вручну
bun run bootstrap
bun run doctor
bun run dev # Electron-застосунок із Vite-рендерером
```
### Збірка дистрибутиву
```bash
bun run build # перевірка типів + компіляція
bun run dist # пакування для поточної ОС
bun run dist:win # пакування Windows-цілей на підтримуваному хості
```
> `bun run bootstrap` встановлює залежності, перебудовує залежності Electron-застосунку, перевіряє Electron, готує вбудовані ffmpeg/ffprobe для розробки та встановлює Playwright Chromium. yt-dlp керується під час роботи в папці даних застосунку; ffmpeg і ffprobe входять до кожного релізу Arroxy.
---
## Troubleshooting
### App won't open / no window appears
The Arroxy process starts but no window shows up. Most often this is a GPU driver hang during startup. Try, in order:
**1. Check the log.** It records startup, GPU info, and any crash. Path:
| Platform | Path |
| -------- | -------------------------------- |
| Windows | `%APPDATA%\Arroxy\logs\main.log` |
| macOS | `~/Library/Logs/Arroxy/main.log` |
| Linux | `~/.config/Arroxy/logs/main.log` |
**2. Launch with hardware acceleration disabled.** Open a terminal / Command Prompt and run the executable with a flag:
```bash
# Windows (Portable) — PowerShell, run from the folder containing the exe
.\Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Portable) — Command Prompt (cmd.exe), from the same folder
Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Installed) — works in both PowerShell and cmd.exe
"%LOCALAPPDATA%\Programs\Arroxy\Arroxy.exe" --disable-gpu
# macOS
/Applications/Arroxy.app/Contents/MacOS/Arroxy --disable-gpu
# Linux (AppImage)
./Arroxy-linux-x64.AppImage --disable-gpu
```
If that works, the GPU/driver is the cause. Make the change permanent (next step).
**3. Persist the flag via `argv.json`.** Create the file at:
| Platform | Path |
| -------- | ------------------------------------------------ |
| Windows | `%APPDATA%\Arroxy\argv.json` |
| macOS | `~/Library/Application Support/Arroxy/argv.json` |
| Linux | `~/.config/Arroxy/argv.json` |
With contents:
```json
{ "disable-hardware-acceleration": true }
```
Arroxy reads this before opening any window, so it works even when the window never appeared.
**4. Other flags worth trying** (combine if needed): `--disable-software-rasterizer`, `--disable-gpu-sandbox`, `--in-process-gpu`.
**5. Stale window position.** If the window may be opening off-screen (multi-monitor change since last run), delete `\window-state.json` and relaunch.
**6. Still stuck?** Open an issue with your OS version and any output from running with `--enable-logging --v=1`. If the app window does open, attach the file from **Settings → Save diagnostics file**: it holds both logs and your app details, with your user folder name removed. Otherwise attach `main.log`.
---
## Умови використання
Arroxy — інструмент виключно для особистого, приватного використання. Ви одноосібно відповідаєте за те, щоб ваші завантаження відповідали [Умовам використання](https://www.youtube.com/t/terms) YouTube та авторському праву вашої юрисдикції. Не використовуйте Arroxy для завантаження, відтворення чи розповсюдження контенту, на який ви не маєте прав. Розробники не несуть відповідальності за зловживання.
## Star History
# Arroxy — безкоштовний завантажувач YouTube (+ 2000 сайтів) із відкритим кодом для Windows, macOS та Linux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Мова:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Kiswahili](README.sw.md) · [O'zbekcha](README.uz.md) · [Polski](README.pl.md) · [Português](README.pt.md) · [Tiếng Việt](README.vi.md) · [Türkçe](README.tr.md) · [አማርኛ](README.am.md) · [العربية](README.ar.md) · [اردو](README.ur.md) · [پښتو](README.ps.md) · [فارسی](README.fa.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [ไทย](README.th.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · **Українська** · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-Hant.md)
[](https://github.com/antonio-orionus/Arroxy/releases/latest) [](https://github.com/antonio-orionus/Arroxy/actions/workflows/release.yml) [](https://arroxy.orionus.dev/)   
Завантажуйте відео, Shorts, музику, канали, подкасти або аудіодоріжки з **YouTube та 2000+ підтримуваних сайтів** — до 4K HDR при 60 fps або у форматі MP3 / AAC / Opus. Працює локально на Windows, macOS та Linux. **Без реклами, без зайвого, без апселів.**
[**↓ Завантажити останній реліз**](#install) · [**Сайт**](https://arroxy.orionus.dev/) · [Windows: перший запуск](#windows-first-launch) · [macOS: перший запуск](#macos-first-launch) · [Linux: перший запуск](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Якщо Arroxy економить ваш час, ⭐ допомагає іншим його знайти.
Глобальна гаряча клавіша завантаження
