# Arroxy — Descargador gratuito de YouTube (+ 2000 sitios) de código abierto para Windows, macOS y Linux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Leer en:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · **Español** · [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.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/)   
Descarga videos, Shorts, música, canales, podcasts o pistas de audio de **YouTube y más de 2000 sitios compatibles** — hasta 4K HDR a 60 fps, o como MP3 / AAC / Opus. Se ejecuta localmente en Windows, macOS y Linux. **Sin anuncios, sin bloatware, sin ventas adicionales.**
[**↓ Descargar la última versión**](#install) · [**Sitio web**](https://arroxy.orionus.dev/) · [Primer arranque en Windows](#windows-first-launch) · [Primer arranque en macOS](#macos-first-launch) · [Primer arranque en Linux](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Si Arroxy te ahorra tiempo, una ⭐ ayuda a que otros lo encuentren.
> **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._
> 🌐 Esta es una traducción asistida por IA. El [README en inglés](README.md) es la fuente de verdad. ¿Encontraste un error? [Las PRs son bienvenidas](../../pulls).
---
## Contenido
- [Instalar y primer inicio](#install)
- [Primer arranque en Windows](#windows-first-launch)
- [Primer arranque en macOS](#macos-first-launch)
- [Por qué puedes ver una advertencia](#why-warning)
- [Primer arranque en Linux](#linux-first-launch)
- [Verifica tu descarga (SHA256)](#verify)
- [¿Por qué Arroxy?](#why)
- [Características](#features)
- [Privacidad](#privacy)
- [Preguntas frecuentes](#faq)
- [Hoja de ruta](#roadmap)
- [Apoyar a Arroxy](#support)
- [Construido con](#tech)
---
## Instalar y primer inicio
**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
```
El script de Linux verifica la descarga con los `SHA256SUMS` publicados y añade Arroxy a tu menú de aplicaciones. Solo hay versiones x86_64. ¿Sin `curl`? Cambia `curl -fsSL` por `wget -qO-`.
| Plataforma | Formato |
| --- | --- |
| 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) |
[**Obtén la última versión →**](https://github.com/antonio-orionus/Arroxy/releases/latest)
### Primer arranque en Windows
En el primer arranque puede aparecer **"Windows protected your PC"** o **"Unknown publisher."** Esto aplica tanto a `Arroxy-win-x64-Setup.exe` como a `Arroxy-win-x64-Portable.exe`. Arroxy es gratuito y de código abierto, y las compilaciones de Windows no están firmadas con un certificado de pago, por lo que SmartScreen las marca. Eso **no** significa automáticamente que Arroxy sea inseguro. Para continuar:
1. Haz clic en **More info**.
2. Haz clic en **Run anyway**.
#### Si Windows Defender marca o elimina el archivo
La heurística de Defender a veces marca los instaladores NSIS sin firmar y los portables de Electron como sospechosos. Si Defender pone en cuarentena `Arroxy-win-x64-Setup.exe` o `Arroxy-win-x64-Portable.exe`, recupéralo desde **Windows Security → Virus & threat protection → Protection history**, y añade el ejecutable de Arroxy como elemento permitido en **Manage settings → Add or remove exclusions**. Al igual que con SmartScreen, el motivo es la firma del editor ausente, no malware detectado.
> Descarga Arroxy solo desde la página oficial de GitHub Releases. Si obtuviste el archivo de otro sitio web o alguien te lo envió, bórralo y descarga una copia nueva desde la fuente oficial. El código fuente es público, así que puedes inspeccionarlo o compilar Arroxy tú mismo si lo prefieres.
¿Prefieres Scoop? `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### Primer arranque en macOS
Arroxy aún no está firmado digitalmente para macOS, así que Gatekeeper puede mostrar el aviso alarmante *"Arroxy.app is damaged and can't be opened"* después de instalarlo desde el DMG. Ese mensaje significa que macOS puso en cuarentena una app sin firmar; no significa que los archivos estén dañados. En macOS actual, la solución fiable es Terminal:
1. Arrastra `Arroxy.app` desde el DMG montado a `/Applications`.
2. Abre Terminal y ejecuta estos dos comandos:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
El primer comando elimina el atributo de cuarentena de tu copia instalada de Arroxy. El segundo inicia la app. `sudo` puede pedir la contraseña de tu Mac; Terminal no mostrará caracteres mientras la escribes.
**Apple Silicon vs Intel:** en un Mac de la serie M (M1 / M2 / M3 / M4), descarga el DMG `arm64`. En Macs Intel, descarga el DMG `x64`. El build incorrecto funciona igualmente mediante Rosetta, pero es notablemente más lento.
> Las compilaciones de macOS se producen mediante CI en runners de Apple Silicon e Intel. Si encuentras algún problema, por favor [abre un issue](../../issues) — los comentarios de usuarios de macOS influyen activamente en el ciclo de pruebas de macOS.
### Por qué puedes ver una advertencia
Arroxy es de código abierto y con licencia MIT. Las compilaciones de Windows y macOS **no están firmadas digitalmente** — los certificados Apple Developer ID y Windows EV de firma de código cuestan cada uno cientos de dólares al año, que un proyecto independiente paga de su bolsillo. Sin esas firmas, Windows SmartScreen y macOS Gatekeeper te advertirán en el primer arranque. Las advertencias significan *tu sistema operativo no reconoce al editor* — no significan que Arroxy sea malware.
Tres formas de verificar Arroxy tú mismo, en orden creciente de rigor:
- **Lee el código fuente.** Cada línea está en [GitHub](https://github.com/antonio-orionus/Arroxy) y puedes [compilarlo desde el código fuente](#tech).
- **Comprueba el SHA256.** Compara tu archivo con el [`SHA256SUMS`](../../releases/latest) publicado — consulta [Verifica tu descarga](#verify) a continuación.
- **Realiza un análisis de terceros.** Sube el archivo a [VirusTotal](https://www.virustotal.com).
### Primer arranque en Linux
Los AppImages se ejecutan directamente — sin instalación. Solo necesitas marcar el archivo como ejecutable.
**Gestor de archivos:** haz clic derecho en el `.AppImage` → **Propiedades** → **Permisos** → activa **Permitir ejecutar el archivo como programa**, luego doble clic.
**Terminal:**
```bash
chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage
```
Si el arranque sigue fallando, ejecútalo sin montar — no hace falta el paquete FUSE:
```bash
./Arroxy-linux-x64.AppImage --appimage-extract-and-run
```
**Integración de escritorio opcional:** instala [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) una sola vez, y cualquier AppImage en la que hagas doble clic quedará registrada automáticamente en tu menú de aplicaciones — sin necesidad de crear manualmente un archivo `.desktop`.
**Tarball simple (sin FUSE, sin instalación):**
La versión `.tar.gz` es la misma app sin el envoltorio AppImage: descomprímela donde quieras y ejecútala. Sin instalador y sin paquete FUSE.
```bash
tar xzf Arroxy-linux-x64.tar.gz
./Arroxy-linux-x64/arroxy
```
**Flatpak (alternativa con sandbox):** descarga `Arroxy-*.flatpak` desde la misma página de release.
Ubuntu trae Snap en lugar de Flatpak, así que instala Flatpak y añade Flathub primero — el paquete descarga su runtime de ahí:
```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
```
**Las descargas de Linux en la página de versiones son solo x86_64.** En equipos ARM64 (Raspberry Pi, Asahi Linux) el Flatpak se instala pero falla al arrancar con `bwrap: execvp ldconfig: Exec format error`.
Verifica tu descarga (SHA256)
Cada versión publica un archivo `SHA256SUMS` junto a los binarios. Para comprobar que tu descarga no está corrompida ni fue manipulada en tránsito, calcula el hash de tu archivo localmente y compáralo con la línea en `SHA256SUMS`. Abre la página de la última versión → **Assets** → descarga `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
```
¿Quieres un análisis de malware de terceros? Sube el archivo en [VirusTotal](https://www.virustotal.com). Un puñado de alertas heurísticas genéricas de motores menores es normal en apps Electron sin firmar; detecciones generalizadas por motores principales serían una preocupación real.
Windows: Instalador vs Portátil
| | Instalador NSIS | `.exe` portátil |
| ------------- | :----------------------: | :---------------------: |
| Requiere instalación | Sí | No — ejecútalo desde donde quieras |
| Auto-actualizaciones | ✅ en la app | ❌ descarga manual |
| Velocidad de inicio | ✅ más rápido | ⚠️ inicio en frío más lento |
| Aparece en el menú Inicio | ✅ | ❌ |
| Desinstalación fácil | ✅ | ❌ solo borra el archivo |
**Recomendación:** usa el instalador NSIS para obtener auto-actualizaciones y un arranque más rápido. Usa el `.exe` portátil si prefieres no instalar ni tocar el registro.
---
## ¿Por qué Arroxy?
Una comparación directa con las alternativas más comunes:
| | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions |
| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |
| Gratis, sin nivel premium | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| Código abierto | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| Procesamiento 100% local | ✅ | ✅ | ✅ | ❌ | ✅ |
| Sin inicio de sesión ni exportación de cookies | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ |
| Sin límites de uso | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ |
| Aplicación de escritorio multiplataforma | ✅ | ✅ | ✅ | N/A | ❌ |
| Subtítulos + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ |
Arroxy está diseñado para una sola cosa: pega una URL y obtén un archivo local limpio. Sin cuentas, sin ventas adicionales, sin recolección de datos.
---
## Características
### Calidad y formatos
- Hasta **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p
- **Alta frecuencia de fotogramas** conservada tal cual — 60 fps, 120 fps, HDR
- **Audio** — exporta solo audio como MP3, M4A/AAC, Opus o WAV. En las descargas interactivas, elige las pistas nativas surround/Dolby de la fuente (AC-3, E-AC-3, 5.1, DRC) cuando estén disponibles, o configura un valor global **Preferir surround / Dolby**
- Presets rápidos: *Mejor calidad* · *Equilibrado* · *Archivo pequeño*
### Privacidad y control
- Procesamiento 100% local — las descargas van directamente de YouTube a tu disco
- Sin inicio de sesión, sin cookies, sin cuenta de Google vinculada
- Archivos guardados directamente en la carpeta que elijas
### Flujo de trabajo
- **Atajo de descarga global** — copia un enlace en cualquier app y pulsa `Ctrl+Shift+D` (`Cmd+Shift+D` en macOS); Arroxy lo pone en cola con tu perfil activo sin abrir la ventana, y una notificación lo confirma. Activo por defecto y reasignable
- **Modos de inicio flexibles** — elige una descarga individual guiada, selector de playlist/canal, pegado masivo de URLs o Quick Download con tus valores guardados
- **Cola central de descargas** — cada trabajo individual, de playlist, masivo o rápido llega a un solo lugar para ver progreso, pausar, reanudar, cancelar, reintentar y controlar prioridad
- **Monitoreo del portapapeles** — copia un enlace de YouTube y Arroxy rellena automáticamente la URL al volver a enfocar la app (actívalo en la Configuración avanzada)
- **Limpieza automática de URLs** — elimina parámetros de seguimiento (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) y desempaqueta los enlaces `youtube.com/redirect`
- **Modo bandeja** — cerrar la ventana mantiene las descargas en segundo plano
- **30 idiomas**: detecta automáticamente la configuración regional del sistema y se puede cambiar en cualquier momento
- **Sincronización de playlists** — vuelve a escanear una playlist contra una carpeta local para omitir vídeos ya descargados; genera un archivo de playlist `.m3u` que se actualiza con cada vídeo descargado
- **Controles de velocidad y ritmo** — limita el ancho de banda de descarga, define cuántas partes de un vídeo se descargan a la vez y añade pausas entre solicitudes con ajustes (*Desactivado · Equilibrado · Cuidadoso · Personalizado*)
- **Plantillas de nombre de archivo** — nombra las descargas a tu manera con `{title}`, `{uploader}`, `{id}`, `{date}`, `{resolution}` y `{playlist_index}`, de forma global o por perfil de descarga
- **Descargas a la vez y reintento automático** — elige cuántas descargas de la cola se ejecutan al mismo tiempo y deja que Arroxy reintente una descarga que sufrió un problema de red o del servidor, esperando más antes de cada intento
- **Perfiles por elemento de playlist** — asigna a cada vídeo de una playlist su propio perfil de descarga en lugar de un único ajuste para toda la lista, para archivar algunos en calidad máxima y sacar el resto como MP3 en una sola pasada
### Subtítulos y posprocesamiento
- **Subtítulos** en SRT, VTT o ASS — manuales o generados automáticamente, en cualquier idioma disponible
- Guárdalos junto al video, incrústalos en `.mkv` u organízalos en una subcarpeta `Subtitles/`
- **SponsorBlock** — omite o marca como capítulos patrocinadores, intros, outros y autopromociones
- **Metadatos incrustados** — título, fecha de subida, canal, descripción, miniatura y marcadores de capítulo escritos en el archivo
### YouTube + 2000 sitios
- **YouTube, al completo** — Videos, Shorts, Canales, Playlists, YouTube Music y Podcasts tratados como fuentes de primera clase
- **Más de 2000 sitios adicionales** via yt-dlp — Vimeo, Twitch, Twitter/X, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org y muchos más
- **Solo audio y subtítulos** funcionan en todos los sitios compatibles, no solo en YouTube
- Si un sitio cambia, yt-dlp publica correcciones semanalmente y Arroxy actualiza el binario automáticamente al iniciar
Atajo de descarga global Copia un enlace donde sea y pulsa una vez — entra en la cola y empieza a descargarse
Perfiles por elemento de playlist Da a cada vídeo su propio perfil — archiva algunos en 4K y saca el resto como MP3
Inicio de Descarga rápida Pega una URL y descárgala al instante con tu perfil activo
Perfiles de descarga reutilizables Guarda formato, calidad y salida como preajustes — reutiliza en cada descarga
Pistas de audio multiidioma Elige el idioma de audio exacto que trae el vídeo
Audio Surround / Dolby Pistas 5.1 y Dolby detectadas y conservadas
Modo de URLs en lote Pega una lista, elimina duplicados y encólalas todas a la vez
Cola de descargas en paralelo Varias descargas a la vez con progreso en vivo
---
## Privacidad
Las descargas se obtienen directamente a través de [yt-dlp](https://github.com/yt-dlp/yt-dlp) desde YouTube hacia la carpeta que elijas — nada pasa por un servidor de terceros. El historial de visualización, el historial de descargas, las URLs y el contenido de los archivos permanecen en tu dispositivo.
Arroxy envía telemetría anónima y agregada a través de [OpenPanel](https://openpanel.dev) — lo justo para entender fallos, errores, comentarios, OS y versiones de la app. Sin URLs, títulos de video, rutas de archivo, datos de cuenta, fingerprinting ni datos personales. El ID por instalación es aleatorio y no está ligado a tu identidad. Puedes desactivarlo en Configuración.
---
## Preguntas frecuentes
**¿Es realmente gratis?**
Sí — licencia MIT, sin nivel premium, sin funciones bloqueadas.
**¿Qué calidades de video puedo descargar?**
Cualquiera que sirva YouTube: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p, más solo audio. Los streams de 60 fps, 120 fps y HDR se conservan tal cual.
**¿Puedo extraer solo el audio como MP3?**
Sí. Elige *solo audio* en el menú de formatos y luego MP3, M4A/AAC, Opus o WAV.
**¿Necesito una cuenta de YouTube o cookies?**
Por defecto, no — Arroxy funciona sin cuenta de YouTube, sin inicio de sesión y sin exportación de cookies. Hay soporte opcional de cookies disponible en la configuración avanzada (Origen de cookies: archivo o navegador) para contenido que requiere autenticación, como videos con restricción de edad o solo para miembros. Está desactivado por defecto. Si lo activas, la wiki de yt-dlp señala que [la automatización basada en cookies puede marcar una cuenta de Google](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies); en ese caso, una cuenta desechable es la opción más segura.
**¿Seguirá funcionando cuando YouTube cambie algo?**
yt-dlp se actualiza automáticamente al iniciar, y Arroxy publica correcciones rápidamente cuando YouTube cambia algo. Si alguna vez tienes algún problema, hay soporte opcional de cookies disponible en la configuración avanzada como alternativa.
**¿En qué idiomas está disponible Arroxy?**
30 idiomas, listos para usar: 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 detecta automáticamente el idioma de tu sistema operativo en el primer inicio y puedes cambiarlo en cualquier momento desde el selector de idioma de la barra de herramientas. Los JSON de locale en runtime viven en src/shared/i18n/locales/, y los catálogos PO para traductores viven en i18n/locales/ — abre un PR en GitHub para contribuir.
**¿Necesito instalar algo más?**
No. yt-dlp se descarga automáticamente en el primer arranque y se guarda en caché en tu máquina; ffmpeg y ffprobe vienen incluidos con la app. Después de eso, no se necesita configuración adicional.
**¿Puedo descargar listas de reproducción o canales completos?**
Sí — ambas cosas. Pega una URL de playlist o canal (p. ej. `youtube.com/@handle`, `/channel/UC…`, `/c/Name`, `/user/Old`); elige cuántas entradas escanear y luego pon toda la lista en cola o selecciona videos concretos. Los filtros por fecha llegarán pronto.
**macOS dice "la aplicación está dañada" — ¿qué hago?**
Es Gatekeeper de macOS bloqueando una app sin firmar, no un daño real. Consulta [macOS first launch](#macos-first-launch) para ver los comandos de Terminal que eliminan la cuarentena e inician Arroxy.
**¿Es legal descargar videos de YouTube?**
Para uso personal y privado, generalmente se acepta en la mayoría de jurisdicciones. Eres responsable de cumplir con los [Términos de Servicio](https://www.youtube.com/t/terms) de YouTube y las leyes de propiedad intelectual de tu jurisdicción.
---
## Hoja de ruta
Todavía planeado — aproximadamente por orden de prioridad:
| Función | Descripción |
| ---------------- | ---------------- |
| **Filtros de listas y canales** | Filtros por rango de fechas al enumerar una playlist o un canal |
| **Preferencias de pistas de audio de YouTube** | Define una pista de idioma hablado predeterminada para toda la app, con sobrescrituras por perfil cuando YouTube ofrece varias pistas de audio |
| **Inicio de sesión con navegador integrado** | Abrir ventanas de navegador dentro de Arroxy para iniciar sesión y usar cookies del sitio sin exportarlas manualmente |
| **Descarga de video con un clic** | Inicia una descarga de video con un clic desde una URL detectada o pegada usando tu perfil activo |
| **Recuperación de reintentos más fuerte** | Una nueva ruta de reintento para descargas interrumpidas por conexiones de internet inestables o problemáticas |
| **Cajón de gestor de descargas completo** | Convertir el cajón de cola en un gestor más completo, incluido cambiar carpetas de destino para elementos en cola |
| **Descargas programadas** | Inicia una cola a una hora fijada (ejecuciones nocturnas) |
| **Recorte de clips** | Descarga solo un segmento especificando tiempo de inicio y fin |
¿Tienes alguna función en mente? [Abre una solicitud](../../issues) — la opinión de la comunidad guía la prioridad.
---
## Apoyar a Arroxy
Arroxy es gratuito y con licencia MIT: sin anuncios, sin versión de pago. Si te ahorra tiempo, puedes apoyar el desarrollo con Bitcoin o Tron: las direcciones están en [DONATE.md](DONATE.md), la única fuente oficial para ellas. Arroxy nunca te enviará una dirección por correo electrónico ni por mensaje directo. Dar una estrella al repositorio, informar de errores y mejorar las traducciones ayudan igual de mucho.
---
## Construido con
Stack
- **Electron** — shell de escritorio multiplataforma
- **React 19** + **TypeScript** — interfaz de usuario
- **Tailwind CSS v4** — estilos
- **Zustand** — gestión de estado
- **yt-dlp** + **ffmpeg** — motor de descarga y muxing (yt-dlp se obtiene en runtime; ffmpeg/ffprobe se incluyen al compilar)
- **Vite** + **electron-vite** — herramientas de compilación
- **Vitest** + **Playwright** — pruebas unitarias y de extremo a extremo
Compilar desde el código fuente
### Requisitos previos — todas las plataformas
| Herramienta | Versión | Instalación |
| ----------- | -------- | ----------- |
| Git | cualquiera | [git-scm.com](https://git-scm.com) |
| Node.js | 24.16.0 | `mise install` o `.node-version` |
| Bun | 1.2.23 | `mise install` o `package.json` `packageManager` |
Recomendado: instala `mise` y luego ejecuta `mise install` en el checkout. Sin mise, activa manualmente Node.js desde `.node-version` y Bun desde `package.json` antes de `bun run bootstrap`.
### Windows
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
Visual Studio Build Tools y Python pueden ser necesarios para recompilaciones nativas.
### macOS
```bash
brew install mise
xcode-select --install
```
Después de clonar, ejecuta `mise trust && mise install` desde el checkout. Si tu shell ya usa `fnm`, `nvm` o Bun instalado con Homebrew, activa mise en `~/.zshrc` para que Arroxy use Node.js 24.16.0 y 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
# Dependencias de build y runtime de Electron
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
```
### Clonar y ejecutar
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # recomendado; omite si activaste manualmente las herramientas fijadas
bun run bootstrap
bun run doctor
bun run dev # app Electron contra el renderer de Vite
```
### Crear un distribuible
```bash
bun run build # typecheck + compile
bun run dist # package for current OS
bun run dist:win # empaqueta objetivos Windows en un host compatible
```
> `bun run bootstrap` instala dependencias, recompila dependencias de la app Electron, verifica Electron, prepara ffmpeg/ffprobe embebidos para desarrollo e instala Playwright Chromium. yt-dlp se gestiona en runtime dentro de la carpeta de datos de la app; ffmpeg y ffprobe vienen incluidos en cada release de 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`.
---
## Términos de uso
Arroxy es una herramienta para uso personal y privado únicamente. Eres el único responsable de garantizar que tus descargas cumplan con los [Términos de Servicio](https://www.youtube.com/t/terms) de YouTube y las leyes de propiedad intelectual de tu jurisdicción. No uses Arroxy para descargar, reproducir o distribuir contenido sobre el que no tengas derechos. Los desarrolladores no se hacen responsables del mal uso.
## Star History
# Arroxy — Descargador gratuito de YouTube (+ 2000 sitios) de código abierto para Windows, macOS y Linux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**Leer en:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · **Español** · [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.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/)   
Descarga videos, Shorts, música, canales, podcasts o pistas de audio de **YouTube y más de 2000 sitios compatibles** — hasta 4K HDR a 60 fps, o como MP3 / AAC / Opus. Se ejecuta localmente en Windows, macOS y Linux. **Sin anuncios, sin bloatware, sin ventas adicionales.**
[**↓ Descargar la última versión**](#install) · [**Sitio web**](https://arroxy.orionus.dev/) · [Primer arranque en Windows](#windows-first-launch) · [Primer arranque en macOS](#macos-first-launch) · [Primer arranque en Linux](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
Si Arroxy te ahorra tiempo, una ⭐ ayuda a que otros lo encuentren.
Atajo de descarga global
