# 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.sr.md) · [Українська](README.uk.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) — основной источник истины. Заметили ошибку? [Pull request приветствуется](../../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 поместила неподписанное приложение в карантин; файлы приложения не повреждены на самом деле. В актуальных версиях macOS надёжное решение — Terminal:
1. Перетащите `Arroxy.app` из смонтированного DMG в `/Applications`.
2. Откройте Terminal и выполните две команды:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
Первая команда удаляет атрибут карантина с установленной копии 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 напрямую влияют на цикл тестирования.
### Почему вы можете увидеть предупреждение
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 — оттуда пакет загружает свой рантайм:
```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 добавит её в очередь с вашим активным профилем, не открывая окно, а уведомление это подтвердит. Включено по умолчанию, сочетание можно изменить
- **Гибкие режимы запуска** — выберите пошаговую одиночную загрузку, выбор плейлиста/канала, массовую вставку URL или Quick Download с сохраненными настройками по умолчанию
- **Центральная очередь загрузок** — каждая одиночная, плейлистная, массовая или быстрая задача попадает в одно место для прогресса, паузы, возобновления, отмены, повтора и управления приоритетом
- **Мониторинг буфера обмена** — скопируйте YouTube-ссылку, и Arroxy автоматически заполнит URL при следующем переключении на приложение (включается в расширенных настройках)
- **Автоочистка URL** — удаляет трекинговые параметры (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) и разворачивает ссылки `youtube.com/redirect`
- **Режим трея** — закрытие окна сохраняет загрузки в фоновом режиме
- **Языки: 30** — автоматически определяет язык системы, можно переключить в любой момент
- **Синхронизация плейлиста** — повторно сверяет плейлист с локальной папкой, чтобы пропускать уже скачанные видео; создает файл плейлиста `.m3u`, который обновляется после каждого скачанного видео
- **Управление скоростью и темпом** — ограничивайте пропускную способность загрузки, задавайте, сколько частей видео скачивается одновременно, и добавляйте задержки между запросами с пресетами (*Выкл · Сбалансированно · Осторожно · Свой*)
- **Шаблоны имён файлов** — называйте загрузки по-своему с помощью `{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) — ровно столько, чтобы понимать сбои, падения, отзывы, ОС и версии приложения. Никаких URL, названий видео, путей к файлам, данных аккаунта, фингерпринтинга или персональных данных. 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 плейлиста или канала (например, `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); выберите, сколько элементов сканировать, затем поставьте в очередь весь список или выберите отдельные видео. Фильтры по диапазону дат появятся скоро.
**macOS сообщает «приложение повреждено» — что делать?**
Это macOS Gatekeeper блокирует неподписанное приложение, а не реальное повреждение. Команды Terminal для снятия карантина и запуска Arroxy смотрите в разделе [macOS first launch](#macos-first-launch).
**Законно ли скачивать видео с YouTube?**
Для личного, частного использования это в целом допустимо в большинстве юрисдикций. Вы несёте ответственность за соблюдение [Условий использования](https://www.youtube.com/t/terms) YouTube и местных законов об авторском праве.
---
## Дорожная карта
Все еще запланировано — примерно в порядке приоритета:
| Функция | Описание |
| ---------------- | ---------------- |
| **Фильтры плейлистов и каналов** | Фильтры по диапазону дат при перечислении плейлиста или канала |
| **Предпочтения аудиодорожек YouTube** | Задать предпочтительную речевую дорожку для всего приложения, с переопределениями в отдельных профилях, когда YouTube предлагает несколько аудиодорожек |
| **Вход через встроенный браузер** | Открывать браузерные окна внутри Arroxy, чтобы входить на сайты и использовать cookies без ручного экспорта |
| **Скачивание видео в один клик** | Запускать скачивание видео в один клик из найденной или вставленной ссылки с активным профилем |
| **Более надежное восстановление повтором** | Новый путь повторной попытки для загрузок, прерванных нестабильным или проблемным интернет-соединением |
| **Полноценный менеджер загрузок в drawer** | Превратить drawer очереди в более полный менеджер, включая смену папок назначения для элементов в очереди |
| **Запланированные загрузки** | Запуск очереди в заданное время (ночные загрузки) |
| **Обрезка клипов** | Скачайте только нужный отрезок, указав начало и конец |
Есть идея? [Откройте запрос](../../issues) — мнение сообщества определяет приоритеты.
---
## Поддержать Arroxy
Arroxy бесплатен и распространяется по лицензии MIT — без рекламы, без платной версии. Если он экономит вам время, вы можете поддержать разработку через Bitcoin или Tron: адреса указаны в [DONATE.md](DONATE.md) — единственном официальном источнике для них. Arroxy никогда не пришлёт вам адрес по электронной почте или в личном сообщении. Звезда репозиторию, сообщения об ошибках и улучшение переводов помогают ничуть не меньше.
---
## Создано на
Стек технологий
- **Electron** — кросс-платформенная десктопная оболочка
- **React 19** + **TypeScript** — UI
- **Tailwind CSS v4** — стили
- **Zustand** — управление состоянием
- **yt-dlp** + **ffmpeg** — движок загрузки и мультиплексирования (yt-dlp подтягивается во время работы; ffmpeg/ffprobe включаются при сборке)
- **Vite** + **electron-vite** — инструменты сборки
- **Vitest** + **Playwright** — юнит- и end-to-end тесты
Сборка из исходников
### Предварительные требования — все платформы
| Инструмент | Версия | Установка |
| ---------- | ------- | --------- |
| 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.sr.md) · [Українська](README.uk.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 экономит вам время — ⭐ поможет другим его найти.
Глобальная горячая клавиша загрузки
