# Arroxy — Бесплатни open-source 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.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://orionus.dev/arroxy/)   
Преузимајте видео снимке, Shorts, музику, каналe, подкасте или аудио записе са **YouTube-а и 2000+ подржаних сајтова** — до 4K HDR при 60 fps, или у MP3 / AAC / Opus формату. Ради локално на Windows-у, macOS-у и Linux-у. **Без реклама, без непотребног, без додатне продаје.**
[**↓ Преузмите најновије издање**](#install) · [**Веб-сајт**](https://orionus.dev/arroxy/) · [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-10-11._
---
## Садржај
- [Инсталација и прво покретање](#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**
AppImage:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh
```
Flatpak:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh -s -- --flatpak
```
Верзије су само 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: прво покретање
При prvom покретању можете видети **«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 странице. Ако сте добили фајл са другог сајта или вам је неко послао, обришите га и преузмите свежу копију из званичног извора. Изворни код је јаван, тако да га можете сами прегледати или компајлирати ако желите.
Више волите Scoop? `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### macOS: прво покретање
Arroxy још увек није потписан кодом за macOS, па Gatekeeper након инсталације из DMG-а може приказати застрашујући дијалог *"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 покретачима. Ако наиђете на проблеме, [отворите пријаву](../../issues) — повратне информације корисника macOS-а активно обликују циклус тестирања.
### Зашто можете видети упозорење
Arroxy је open-source пројекат са MIT лиценцом. Windows и macOS верзије **нису потписане кодом** — сертификати Apple Developer ID и Windows EV за потписивање кода коштају стотине долара годишње, које независни пројекат плаћа из сопственог џепа. Без тих потписа, Windows SmartScreen и macOS Gatekeeper ће вас упозорити при првом покретању. Упозорења значе *да ваш оперативни систем не препознаје издавача* — не значе да је Arroxy малвер.
Три начина да сами проверите Arroxy, по растућој строгости:
- **Прочитајте изворни код.** Свака линија је на [GitHub](https://github.com/antonio-orionus/Arroxy)-у и можете [изградити апликацију из изворног кода](#tech).
- **Проверите SHA256.** Упоредите свој фајл са објављеним [`SHA256SUMS`](../../releases/latest) — погледајте [Верификујте преузимање](#verify) испод.
- **Покрените скенирање треће стране.** Отпремите фајл на [VirusTotal](https://www.virustotal.com).
### Linux: прво покретање
AppImage-ови се покрећу директно — без инсталације. Само треба означити фајл као извршни.
**Менаџер фајлова:** кликните десним тастером на `.AppImage` → **Своjства** → **Дозволе** → омогућите **Дозволи извршавање фајла као програм**, затим двокликните.
**Терминал:**
```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
```
**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` |
| ------------- | :----------------------: | :---------------------: |
| Потребна инсталација | Да | Не — покрени са било ког места |
| Аутоматска ажурирања | ✅ унутар апликације | ❌ ручно преузимање |
| Брзина покретања | ✅ брже | ⚠️ спорије хладно покретање |
| Додаје у Start мени | ✅ | ❌ |
| Лако деинсталирање | ✅ | ❌ обришите фајл |
**Препорука:** користите 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
- **Zvuk** — izvezi samo audio kao MP3, M4A/AAC, Opus ili WAV. U interaktivnim preuzimanjima izaberi izvorne surround/Dolby trake izvora (AC-3, E-AC-3, 5.1, DRC) kada su dostupne, ili podesi globalnu podrazumevanu opciju **Daj prednost surround / Dolby**
- Брзи предефинисани избори: *Најбољи квалитет* · *Уравнотежено* · *Мали фајл*
### Приватност и контрола
- 100% локална обрада — преузимања иду директно са YouTube-а на ваш диск
- Без пријаве, без колачића, без повезаног Google налога
- Фајлови се чувају директно у фасциклу коју одаберете
### Радни ток
- **Глобална пречица за преузимање** — копирајте линк у било којој апликацији и притисните `Ctrl+Shift+D` (`Cmd+Shift+D` на macOS); Arroxy га ставља у ред са вашим активним профилом без отварања прозора, а обавештење то потврђује. Подразумевано укључено, пречица се може променити
- **Флексибилни начини покретања** — изабери вођено једно преузимање, бирач playlist/channel, bulk URL paste или Quick Download са сачуваним подразумеваним опцијама
- **Централни ред за преузимања** — сваки single, playlist, bulk или quick посао стиже на једно место за напредак, паузу, наставак, отказивање, поновни покушај и контролу приоритета
- **Праћење клипборда** — копирајте YouTube линк и Arroxy аутоматски попуњава URL кад се вратите у апликацију (укључиво у напредним подешавањима)
- **Аутоматско чишћење URL-ова** — уклања параметре праћења (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) и распакује `youtube.com/redirect` линкове
- **Режим трака** — затварање прозора одржава преузимања у позадини
- **30 језика** — аутоматски препознаје системски локалитет, могуће пребацивање у било ком тренутку
- **Синхронизација плејлисте** — поново проверава плејлисту у односу на локални фолдер да би прескочио већ преузете видео снимке; прави `.m3u` фајл плејлисте који се ажурира после сваког преузетог видеа
- **Контроле брзине и pacing-а** — ограничи download bandwidth, подеси колико делова видеа се преузима истовремено и додај кашњења између request-ова уз пресете (*Искључено · Уравнотежено · Опрезно · Прилагођено*)
- **Шаблони назива датотека** — именујте преузимања како желите помоћу `{title}`, `{uploader}`, `{id}`, `{date}`, `{resolution}` и `{playlist_index}`, глобално или по профилу преузимања
- **Истовремена преузимања и аутоматско понављање** — изабери колико преузимања из реда се одвија истовремено и пусти Arroxy да понови преузимање које је наишло на проблем са мрежом или сервером, чекајући дуже пре сваког покушаја
- **Профили по ставци плејлисте** — доделите сваком видеу у плејлисти сопствени профил преузимања уместо једног подешавања за читаву листу, тако да један пролаз може да архивира неке у пуном квалитету, а остале преузме као MP3
### Титлови и постобрада
- **Титлови** у SRT, VTT или ASS формату — ручни или аутоматски генерисани, на свим доступним језицима
- Чувај поред видеа, уграђај у `.mkv`, или организуј у потфасциклу `Subtitles/`
- **Пакети само са титловима** — налепите листу URL адреса или отворите плејлисту, изаберите Титлови и добијте само датотеке титлова за сваки видео
- **SponsorBlock** — прескочи или означи поглављима спонзоре, интра, аутра, самопромоције
- **Уграђени метаподаци** — наслов, датум учитавања, канал, опис, минијатура и маркери поглавља уписани у фајл
### YouTube + 2000 сајтова
- **YouTube — у потпуности** — видео снимци, Shorts, канали, пlejliste, YouTube Music и подкасти обрађени као извори прве класе
- **2000+ других сajтова** преко yt-dlp — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org и многи други
- **Само аудио и титлови** раде на свaком подржаном сaјту, не само на YouTube-у
- Ако сajт промени нешто, yt-dlp испоручује исправке недељно, а Arroxy аутоматски ажурира бинарни фajл при покретању
Глобална пречица за преузимање Копирајте линк било где, притисните једном — улази у ред и преузимање почиње
Профили по ставци плејлисте Дајте сваком видеу сопствени профил — неке у 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?**
Da. Izaberi *samo audio* u meniju formata, pa zatim MP3, M4A/AAC, Opus ili 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 стижу уз апликацију. Након тога није потребно додатно подешавање.
**Могу ли преузети плејлисте или целе канале?**
Да — обоје. Налепи playlist или channel URL (нпр. `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 аудио трака** | Подесите жељену говорну језичку траку за целу апликацију, уз override по профилу када YouTube нуди више аудио трака |
| **Пријава кроз browser у апликацији** | Отварање browser windows унутар Arroxy-ја за пријаву и коришћење site cookies без ручног export-а |
| **Видео преузимање једним кликом** | Покрените video download једним кликом из препознатог или налепљеног URL-а користећи активни профил |
| **Јаче recovery преко retry механизма** | Нова retry путања за преузимања прекинута непоузданом или проблематичном интернет везом |
| **Пун drawer менаџер преузимања** | Претворити queue drawer у потпунији менаџер, укључујући промену одредишних фасцикли за ставке у реду |
| **Заказана преузимања** | Покрените ред у одређено доба (ноћна покретања) |
| **Исецање клипова** | Преузмите само сегмент по времену почетка/краја |
| **AUR пакет** | Инсталација на Arch Linux и Omarchy помоћу `yay -S arroxy-bin` |
Имате функционалност на уму? [Отворите захтев](../../issues) — улаз заједнице обликује приоритет.
---
## Подржи Arroxy
Arroxy је бесплатан и под MIT лиценцом — без реклама, без плаћене верзије. Ако ти штеди време, можеш подржати развој путем Bitcoin-а или Tron-а: адресе се налазе у [DONATE.md](DONATE.md), једином званичном извору за њих. Arroxy ти никада неће послати адресу имејлом или директном поруком. Звездица на репозиторијуму, пријаве грешака и побољшање превода помажу подједнако.
---
## Израђено помоћу
Стек технологија
- **Electron** — кроссплатформна десктоп љуска
- **React 19** + **TypeScript** — кориснички интерфејс
- **Tailwind CSS v4** — стилизовање
- **Zustand** — управљање стањем
- **yt-dlp** + **ffmpeg** — машина за преузимање и мешање (yt-dlp се преузима у runtime-у; ffmpeg/ffprobe се укључују при build-у)
- **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 могу бити потребни за нативне rebuild-ове.
### 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
# Зависности за build и Electron runtime
sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64
# E2E tests only (Electron needs a display)
sudo apt install -y xvfb
```
### Клонирање и покретање
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # препоручено; прескочите ако су pinned алати ручно активирани
bun run bootstrap
bun run doctor
bun run dev # Electron апликација са Vite renderer-ом
```
### Изградња дистрибутивне верзије
```bash
bun run build # typecheck + compile
bun run dist # package for current OS
bun run dist:win # пакетирање Windows циљева на подржаном хосту
```
> `bun run bootstrap` инсталира зависности, поново гради зависности Electron апликације, проверава Electron, припрема уграђене ffmpeg/ffprobe за развој и инсталира Playwright Chromium. yt-dlp се управља у runtime-у у фасцикли података апликације; 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 — Бесплатни open-source 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.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://orionus.dev/arroxy/)   
Преузимајте видео снимке, Shorts, музику, каналe, подкасте или аудио записе са **YouTube-а и 2000+ подржаних сајтова** — до 4K HDR при 60 fps, или у MP3 / AAC / Opus формату. Ради локално на Windows-у, macOS-у и Linux-у. **Без реклама, без непотребног, без додатне продаје.**
[**↓ Преузмите најновије издање**](#install) · [**Веб-сајт**](https://orionus.dev/arroxy/) · [Windows: прво покретање](#windows-first-launch) · [macOS: прво покретање](#macos-first-launch) · [Linux: прво покретање](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Ако вам Arroxy уштеди времена, ⭐ помаже другима да га пронађу.
Глобална пречица за преузимање
