[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2977":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":43,"readmeContent":44,"aiSummary":45,"trendingCount":15,"starSnapshotCount":15,"syncStatus":46,"lastSyncTime":47,"discoverSource":48},2977,"Arroxy","antonio-orionus\u002FArroxy","antonio-orionus","Free open-source YouTube and +2000 sites downloader GUI based on yt-dlp for Windows, macOS, and Linux. Download videos, Shorts, 4K, 1080p60, HDR, playlists, channels, and subtitles with no ads, tracking, cookies, or login. Supports 21 languages.","https:\u002F\u002Fantonio-orionus.github.io\u002FArroxy\u002F",null,"TypeScript",209,37,1,0,14,20,51,42,4.74,"MIT License",false,"main",true,[26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"audio-downloader","cross-platform","desktop-app","downloader-for-youtube","media-downloader","mp4-downloader","video-download","video-download-tool","video-downloader","youtube-4k-downloader","youtube-download","youtube-downloader","youtube-downloader-gui","youtube-shorts-download","youtube-videos-downloader","yt-dlp","yt-dlp-gui","2026-06-12 02:00:45","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"src\u002Frenderer\u002Fsrc\u002Fassets\u002FApp-icon-HQ.png\" alt=\"Arroxy mascot\" width=\"180\" \u002F>\n\n# Arroxy — Free Open-Source YouTube (+ 2000 sites) Downloader for Windows, macOS & Linux\n\n**4K · 1080p60 · HDR · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**\n\n**Read in:** [Afaan Oromoo](README.om.md) · [Deutsch](README.de.md) · **English** · [Español](README.es.md) · [Français](README.fr.md) · [Kiswahili](README.sw.md) · [O'zbekcha](README.uz.md) · [Tiếng Việt](README.vi.md) · [አማርኛ](README.am.md) · [العربية](README.ar.md) · [اردو](README.ur.md) · [پښتو](README.ps.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · [Українська](README.uk.md) · [中文](README.zh.md) · [日本語](README.ja.md)\n\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fantonio-orionus\u002FArroxy?label=Release&color=blueviolet)](https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002FArroxy\u002Freleases\u002Flatest) [![Build](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fantonio-orionus\u002FArroxy\u002Frelease.yml?label=Build)](https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002FArroxy\u002Factions\u002Fworkflows\u002Frelease.yml) [![Website](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fwebsite-arroxy.orionus.dev-blueviolet)](https:\u002F\u002Farroxy.orionus.dev\u002F) ![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green) ![Platforms](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-cross--platform-1f2937?logo=github&logoColor=white) ![Languages](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fi18n-21_languages-blue)\n\nDownload videos, Shorts, music, channels, podcasts, or audio tracks from **YouTube and 2000+ supported sites** — up to 4K HDR at 60 fps, or as MP3 \u002F AAC \u002F Opus. Runs locally on Windows, macOS, and Linux. **No ads, no bloat, no upsells.**\n\n[**↓ Download Latest Release**](..\u002F..\u002Freleases\u002Flatest)  ·  [**Website**](https:\u002F\u002Farroxy.orionus.dev\u002F)  ·  [Windows](#download) · [macOS](#download) · [Linux](#download)\n\n\u003Cimg src=\"build\u002Fdemo.gif\" alt=\"Arroxy demo\" width=\"720\" \u002F>\n\nIf Arroxy saves you time, a ⭐ helps others find it.\n\n\u003C\u002Fdiv>\n\n> **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:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp)-supported sites. It runs on Windows 10\u002F11, macOS 11+ (Intel + Apple Silicon), and Linux (AppImage, Flatpak, tar.gz). MIT licensed. No account, no ads, no usage limits. Distributed via [Winget](https:\u002F\u002Fwinget.run\u002Fpkg\u002FAntonioOrionus\u002FArroxy), [Scoop](https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002Fscoop-bucket), [Homebrew Cask](https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002Fhomebrew-arroxy), Flatpak, AppImage, and direct download.\n>\n> _Last updated: 2026-05-14._\n\n---\n\n## Contents\n\n- [Why Arroxy](#why)\n- [Features](#features)\n- [Download](#download)\n- [Privacy](#privacy)\n- [FAQ](#faq)\n- [Roadmap](#roadmap)\n- [Built with](#tech)\n\n---\n\n## \u003Ca id=\"why\">\u003C\u002Fa>Why Arroxy\n\nA side-by-side comparison with the most common alternatives:\n\n|            | Arroxy | 4K Video Downloader | JDownloader | Y2Mate \u002F online converters | Browser extensions |\n| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |\n| Free, no premium tier |   ✅   |         ⚠️          |     ✅      |             ⚠️             |         ⚠️         |\n| Open source |   ✅   |         ❌          |     ❌      |             ❌             |         ⚠️         |\n| Local processing only |   ✅   |         ✅          |     ✅      |             ❌             |         ✅         |\n| No login or cookie export |   ✅   |         ⚠️          |     ⚠️      |             ⚠️             |         ✅         |\n| No usage caps |   ✅   |         ⚠️          |     ✅      |             🚫             |         ⚠️         |\n| Cross-platform desktop app |   ✅   |         ✅          |     ✅      |            N\u002FA             |         ❌         |\n| Subtitles + SponsorBlock |   ✅   |         ⚠️          |     ❌      |             ❌             |         ❌         |\n\nArroxy is built for one thing: paste a URL, get a clean local file. No accounts, no upsells, no data collection.\n\n---\n\n## \u003Ca id=\"features\">\u003C\u002Fa>Features\n\n### Quality & formats\n\n- Up to **4K UHD (2160p)**, 1440p, 1080p, 720p, 480p, 360p\n- **High frame rate** preserved as-is — 60 fps, 120 fps, HDR\n- **Audio-only** export to MP3, M4A\u002FAAC, Opus, or WAV\n- Quick presets: *Best quality* · *Balanced* · *Small file*\n\n### Privacy & control\n\n- 100% local processing — downloads go straight from YouTube to your disk\n- **Open source** — every line auditable, MIT licensed\n- Files saved straight to the folder you choose\n\n### Workflow\n\n- **Paste any link** — YouTube videos, Shorts, channels, playlists, podcasts, and Music, plus 2000+ other sites yt-dlp supports; download the whole playlist or pick specific videos first\n- **Multi-download queue** — track several downloads in parallel\n- **Clipboard watch** — copy a YouTube link and Arroxy auto-fills the URL when you refocus the app (toggle in Advanced settings)\n- **Auto-clean URLs** — strips tracking params (`si`, `pp`, `utm_*`, `fbclid`, `gclid`) and unwraps `youtube.com\u002Fredirect` links\n- **Tray mode** — closing the window keeps downloads running in the background\n- **21 languages** — auto-detects system locale, switchable any time\n\n### Subtitles & post-processing\n\n- **Subtitles** in SRT, VTT, or ASS — manual or auto-generated, in any available language\n- Save next to the video, embed into `.mkv`, or organize into a `Subtitles\u002F` subfolder\n- **SponsorBlock** — skip or chapter-mark sponsors, intros, outros, self-promos\n- **Embedded metadata** — title, upload date, channel, description, thumbnail, and chapter markers written into the file\n\n### YouTube + 2000 sites\n\n- **YouTube, in full** — Videos, Shorts, Channels, Playlists, YouTube Music, and Podcasts handled as first-class sources\n- **2000+ other sites** via yt-dlp — Vimeo, Twitch, Twitter\u002FX, TikTok, SoundCloud, Bandcamp, Bilibili, BBC iPlayer, archive.org, and many more\n- **Audio-only and subtitles** work across every supported site, not just YouTube\n- If a site changes, yt-dlp ships fixes weekly and Arroxy auto-updates the binary on launch\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"build\u002FMain-screenshot.png\" width=\"48%\" alt=\"Paste a URL\" \u002F>\n  \u003Cimg src=\"build\u002FChoosing-format-screenshot.png\" width=\"48%\" alt=\"Pick your quality\" \u002F>\n  \u003Cbr\u002F>\n  \u003Cimg src=\"build\u002FChoosing-destination-screenshot.png\" width=\"48%\" alt=\"Choose where to save\" \u002F>\n  \u003Cimg src=\"build\u002FDownloading-in-parallel-screenshot.png\" width=\"48%\" alt=\"Download queue in action\" \u002F>\n  \u003Cbr\u002F>\n  \u003Cimg src=\"build\u002FSubtitles-screenshot.png\" width=\"48%\" alt=\"Subtitle language and format picker\" \u002F>\n\u003C\u002Fdiv>\n\n---\n\n## \u003Ca id=\"download\">\u003C\u002Fa>Download\n\n| Platform | Format   |\n| ------------------- | ------------------- |\n| Windows             | Installer (NSIS) or Portable `.exe`   |\n| macOS               | `.dmg` (Intel + Apple Silicon)   |\n| Linux               | `.AppImage` or `.flatpak` (sandboxed) |\n\n[**Grab the latest release →**](..\u002F..\u002Freleases\u002Flatest)\n\n### \u003Ca id=\"why-warning\">\u003C\u002Fa>Why you may see a warning\n\nArroxy is open-source and MIT-licensed. The Windows and macOS builds are **not code-signed** — Apple Developer ID and Windows EV code-signing certificates each cost hundreds of dollars per year, which an indie project pays out of pocket. Without those signatures, Windows SmartScreen and macOS Gatekeeper will warn you on first launch. The warnings mean *your OS doesn't recognize the publisher* — they don't mean Arroxy is malware.\n\nThree ways to verify Arroxy yourself, in increasing rigor:\n\n- **Read the source.** Every line is on [GitHub](https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002FArroxy) and you can [build it from source](#tech).\n- **Check the SHA256.** Match your file against the published [`SHA256SUMS`](..\u002F..\u002Freleases\u002Flatest) — see [Verify your download](#verify) below.\n- **Run a third-party scan.** Upload the file to [VirusTotal](https:\u002F\u002Fwww.virustotal.com).\n\n### \u003Ca id=\"windows-first-launch\">\u003C\u002Fa>Windows first launch\n\nOn first launch you may see **\"Windows protected your PC\"** or **\"Unknown publisher.\"** This applies to both `Arroxy-Setup-*.exe` and `Arroxy-Portable-*.exe`. Arroxy is free and open-source and the Windows builds are not code-signed with a paid certificate, which is why SmartScreen flags them. It does **not** automatically mean Arroxy is unsafe. To continue:\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"build\u002Fwin-smartscreen-more-info.png\" width=\"46%\" alt=\"SmartScreen \"Windows protected your PC\" dialog with the \"More info\" link highlighted\" \u002F>\n  \u003Cimg src=\"build\u002Fwin-smartscreen-run-anyway.png\" width=\"46%\" alt=\"SmartScreen dialog after expanding More info, showing the \"Run anyway\" button\" \u002F>\n\u003C\u002Fdiv>\n\n1. Click **More info**.\n2. Click **Run anyway**.\n\n#### If Windows Defender flags or removes the file\n\nDefender heuristics sometimes flag unsigned NSIS installers and Electron portables as suspicious. If Defender quarantines `Arroxy-Setup-*.exe` or `Arroxy-Portable-*.exe`, restore it from **Windows Security → Virus & threat protection → Protection history**, then add the Arroxy executable as an allowed item under **Manage settings → Add or remove exclusions**. As with SmartScreen, the trigger is the missing publisher signature, not detected malware.\n\n> Only download Arroxy from the official GitHub Releases page. If you got the file from another website or someone sent it to you, delete it and download a fresh copy from the official source. The source code is public, so you can inspect it or build Arroxy yourself if you prefer.\n\n### \u003Ca id=\"macos-first-launch\">\u003C\u002Fa>macOS first launch\n\nArroxy is not yet code-signed for macOS, so Gatekeeper will block the first launch. The exact path to allow it depends on your macOS version — Sequoia 15 tightened the old right-click → Open bypass.\n\n#### macOS Sequoia 15 and later (current)\n\nOn Sequoia 15 and newer, right-click → Open no longer bypasses Gatekeeper for many quarantined apps. Use the System Settings panel instead:\n\n1. Drag `Arroxy.app` from the mounted DMG into `\u002FApplications`.\n2. Double-click Arroxy. The block dialog appears — click **Done** (don't click *Move to Trash*).\n3. Open **System Settings → Privacy & Security** and scroll to the **Security** section. You'll see *\"Arroxy was blocked to protect your Mac\"* (or a near-identical message).\n4. Click **Open Anyway**, confirm with your password or Touch ID, then re-launch Arroxy from `\u002FApplications`.\n\n#### macOS Sonoma 14 and earlier\n\n1. Drag `Arroxy.app` from the mounted DMG into `\u002FApplications`.\n2. Right-click (or Control-click) `Arroxy.app` in `\u002FApplications` and choose **Open**.\n3. The warning dialog now has an **Open** button — click it and confirm. Arroxy opens normally and the warning never appears again.\n\n#### \"App is damaged\" or persistent Gatekeeper block — Terminal fix\n\nIf macOS says *\"Arroxy is damaged and can't be opened\"*, or none of the steps above clear the block, the quarantine attribute on the DMG is the cause (some browsers and macOS's own translocation behavior set it). Strip it from the installed app:\n\n```bash\nxattr -dr com.apple.quarantine \u002FApplications\u002FArroxy.app\n```\n\n**Apple Silicon vs Intel:** on an M-series Mac (M1 \u002F M2 \u002F M3 \u002F M4), download the `arm64` DMG. On Intel Macs, download the `x64` DMG. Running the wrong build still works via Rosetta but is noticeably slower.\n\n> macOS builds are produced via CI on Apple Silicon and Intel runners. If you hit issues, please [open an issue](..\u002F..\u002Fissues) — feedback from macOS users actively shapes the macOS testing cycle.\n\n### \u003Ca id=\"linux-first-launch\">\u003C\u002Fa>Linux first launch\n\nAppImages run directly — no installation. You just need to mark the file as executable.\n\n**File manager:** right-click the `.AppImage` → **Properties** → **Permissions** → enable **Allow executing file as program**, then double-click.\n\n**Terminal:**\n\n```bash\nchmod +x Arroxy-*.AppImage\n.\u002FArroxy-*.AppImage\n```\n\nIf launch still fails, you may be missing FUSE:\n\n```bash\n# Ubuntu \u002F Debian\nsudo apt install -y libfuse2\n\n# Fedora\nsudo dnf install -y fuse-libs\n\n# Arch\nsudo pacman -S fuse2\n```\n\n**Optional desktop integration:** install [AppImageLauncher](https:\u002F\u002Fgithub.com\u002FTheAssassin\u002FAppImageLauncher) once, and any AppImage you double-click gets registered into your launcher menu automatically — no manual `.desktop` file needed.\n\n**Flatpak (sandboxed alternative):** download `Arroxy-*.flatpak` from the same release page.\n\n```bash\nflatpak install --user Arroxy-*.flatpak\nflatpak run io.github.antonio_orionus.Arroxy\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>\u003Ca id=\"verify\">\u003C\u002Fa>Verify your download (SHA256)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nEvery release publishes a `SHA256SUMS` file alongside the binaries. To check that your download wasn't corrupted or tampered with in transit, hash your file locally and match the line in `SHA256SUMS`. Open the latest release page → **Assets** → download `SHA256SUMS`.\n\n**Windows (PowerShell or Command Prompt):**\n\n```powershell\ncertutil -hashfile Arroxy-Setup-\u003Cversion>.exe SHA256\n```\n\n**macOS (Terminal):**\n\n```bash\nshasum -a 256 Arroxy-\u003Cversion>-arm64.dmg\n```\n\n**Linux (Terminal):**\n\n```bash\nsha256sum Arroxy-*.AppImage\n```\n\nWant a third-party malware scan? Upload the file at [VirusTotal](https:\u002F\u002Fwww.virustotal.com). A handful of generic-heuristic flags from minor engines is normal for unsigned Electron apps; widespread detections from major engines would be a real concern.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Install via package manager\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAlready use a package manager? You can skip the manual download path.\n\n| Channel | Command                                                                                |\n| ------------------ | ------------------------------------------------------------------------------------------------- |\n| Winget             | `winget install AntonioOrionus.Arroxy`                                                            |\n| Scoop              | `scoop bucket add arroxy https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002Fscoop-bucket && scoop install arroxy` |\n| Homebrew           | `brew tap antonio-orionus\u002Farroxy && brew install --cask arroxy`                                   |\n| Flatpak            | `flatpak install --user Arroxy-*.flatpak`                                                         |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windows: Installer vs Portable\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n|               | NSIS Installer | Portable `.exe` |\n| ------------- | :----------------------: | :---------------------: |\n| Installation required | Yes  | No — run from anywhere  |\n| Auto-updates | ✅ in-app  | ❌ manual download  |\n| Startup speed | ✅ faster  | ⚠️ slower cold start  |\n| Adds to Start Menu |            ✅            |           ❌            |\n| Easy uninstall |            ✅            | ❌ delete the file  |\n\n**Recommendation:** use the NSIS installer for auto-updates and faster startup. Use the portable `.exe` for a no-install, no-registry option.\n\n\u003C\u002Fdetails>\n\n---\n\n## \u003Ca id=\"privacy\">\u003C\u002Fa>Privacy\n\nDownloads are fetched directly via [yt-dlp](https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp) from YouTube to the folder you pick — nothing routed through a third-party server. Watch history, download history, URLs, and file contents stay on your device.\n\nArroxy sends anonymous, aggregate telemetry via [OpenPanel](https:\u002F\u002Fopenpanel.dev) — just enough for an indie project to understand launches, OS, app versions, and crashes. No URLs, video titles, file paths, account info, fingerprinting, or personal data. The per-install ID is random and not tied to your identity. You can opt out in Settings.\n\n---\n\n## \u003Ca id=\"faq\">\u003C\u002Fa>FAQ\n\n**Is it really free?**\nYes — MIT licensed, no premium tier, no feature gating.\n\n**What video qualities can I download?**\nAnything YouTube serves: 4K UHD (2160p), 1440p, 1080p, 720p, 480p, 360p, plus audio-only. 60 fps, 120 fps, and HDR streams are preserved as-is.\n\n**Can I extract just the audio as MP3?**\nYes. Pick *audio-only* in the format menu and choose MP3, M4A\u002FAAC, Opus, or WAV.\n\n**Do I need a YouTube account or cookies?**\nBy default, no — Arroxy works without a YouTube account, login, or cookie export. Optional cookie support is available in Advanced settings (Cookies source: file or browser) for content that requires authentication, such as age-restricted or members-only videos. It is off by default. If you enable it, yt-dlp's wiki notes that [cookie-based automation can flag a Google account](https:\u002F\u002Fgithub.com\u002Fyt-dlp\u002Fyt-dlp\u002Fwiki\u002FExtractors#exporting-youtube-cookies); a throwaway account is the safer choice in that case.\n\n**Will it keep working when YouTube changes something?**\nyt-dlp is updated automatically on launch, and Arroxy ships fixes promptly when YouTube changes something. If you ever do hit an issue, optional cookie support is available in Advanced settings as a fallback.\n\n**What languages is Arroxy available in?**\nTwenty-one, out of the box: English, Español (Spanish), Deutsch (German), Français (French), 日本語 (Japanese), 中文 (Chinese), Русский (Russian), Українська (Ukrainian), हिन्दी (Hindi), Afaan Oromoo, Kiswahili, O'zbekcha (Uzbek), Tiếng Việt (Vietnamese), አማርኛ (Amharic), العربية (Arabic), اردو (Urdu), پښتو (Pashto), বাংলা (Bengali), မြန်မာဘာသာ (Burmese), Ελληνικά (Greek), and Српски (Serbian). Arroxy auto-detects your operating system's language on first launch and you can switch at any time from the language picker in the toolbar. Translations live as plain TypeScript objects in src\u002Fshared\u002Fi18n\u002Flocales\u002F — open a PR on GitHub to contribute.\n\n**Do I need to install anything else?**\nNo. yt-dlp is downloaded automatically on first launch and cached on your machine; ffmpeg and ffprobe ship with the app. After that, no extra setup is needed.\n\n**Can I download playlists or whole channels?**\nYes — both. Paste a playlist URL or a channel URL (e.g. `youtube.com\u002F@handle`, `\u002Fchannel\u002FUC…`, `\u002Fc\u002FName`, `\u002Fuser\u002FOld`); Arroxy enumerates up to 500 entries, then you queue the whole list or pick specific videos. Date-range and count filters are coming soon.\n\n**macOS says \"the app is damaged\" — what do I do?**\nThat's macOS Gatekeeper blocking an unsigned app, not actual damage. See [\"App is damaged\" — Terminal fix](#macos-first-launch) for the one-line `xattr` command that clears it.\n\n**Is downloading YouTube videos legal?**\nFor personal, private use it is generally accepted in most jurisdictions. You are responsible for complying with YouTube's [Terms of Service](https:\u002F\u002Fwww.youtube.com\u002Ft\u002Fterms) and your local copyright laws.\n\n---\n\n## \u003Ca id=\"roadmap\">\u003C\u002Fa>Roadmap\n\nComing up — roughly in priority order:\n\n| Feature    | Description    |\n| ---------------- | ---------------- |\n| **Playlist & channel filters** | Date-range and count filters when enumerating a playlist or channel (today the cap is a fixed 500 entries) |\n| **Batch URL input** | Paste multiple URLs at once and run them in one go |\n| **Custom filename templates** | Name files by title, uploader, date, resolution — with live preview |\n| **Scheduled downloads** | Start a queue at a set time (overnight runs) |\n| **Speed limits** | Cap bandwidth so downloads don't saturate your connection |\n| **Clip trimming** | Download only a segment by start\u002Fend time |\n\nHave a feature in mind? [Open a request](..\u002F..\u002Fissues) — community input shapes priority.\n\n---\n\n## \u003Ca id=\"tech\">\u003C\u002Fa>Built with\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Stack\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **Electron** — cross-platform desktop shell\n- **React 19** + **TypeScript** — UI\n- **Tailwind CSS v4** — styling\n- **Zustand** — state management\n- **yt-dlp** + **ffmpeg** — download and mux engine (yt-dlp fetched at runtime; ffmpeg\u002Fffprobe bundled at build time)\n- **Vite** + **electron-vite** — build tooling\n- **Vitest** + **Playwright** — unit and end-to-end tests\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Build from source\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Prerequisites — all platforms\n\n| Tool | Version | Install |\n| ---- | ------- | ------- |\n| Git  | any     | [git-scm.com](https:\u002F\u002Fgit-scm.com) |\n| Bun  | latest  | see per-OS below |\n\n### Windows\n\n```powershell\npowershell -c \"irm bun.sh\u002Finstall.ps1 | iex\"\n```\n\nNo native build tools required — the project has no native Node addons.\n\n### macOS\n\n```bash\nxcode-select --install\ncurl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n```\n\n### Linux (Ubuntu \u002F Debian)\n\n```bash\ncurl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n\n# Electron runtime deps\nsudo apt install -y libgtk-3-0 libnss3 libasound2t64\n\n# E2E tests only (Electron needs a display)\nsudo apt install -y xvfb\n```\n\n### Clone & run\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fantonio-orionus\u002FArroxy\ncd arroxy\nbun install\nbun run dev          # hot-reload dev build\n```\n\n### Build a distributable\n\n```bash\nbun run build        # typecheck + compile\nbun run dist         # package for current OS\nbun run dist:win     # cross-compile Windows portable exe\n```\n\n> yt-dlp is fetched from GitHub on first launch and cached in your app data folder. ffmpeg and ffprobe are bundled with every Arroxy release.\n\n\u003C\u002Fdetails>\n\n---\n\n## \u003Ca id=\"troubleshooting\">\u003C\u002Fa>Troubleshooting\n\n### App won't open \u002F no window appears\n\nThe Arroxy process starts but no window shows up. Most often this is a GPU driver hang during startup. Try, in order:\n\n**1. Check the log.** It records startup, GPU info, and any crash. Path:\n\n| Platform | Path                             |\n| -------- | -------------------------------- |\n| Windows  | `%APPDATA%\\Arroxy\\logs\\main.log` |\n| macOS    | `~\u002FLibrary\u002FLogs\u002FArroxy\u002Fmain.log` |\n| Linux    | `~\u002F.config\u002FArroxy\u002Flogs\u002Fmain.log` |\n\n**2. Launch with hardware acceleration disabled.** Open a terminal \u002F Command Prompt and run the executable with a flag:\n\n```bash\n# Windows (Portable) — PowerShell, run from the folder containing the exe\n.\\Arroxy-Portable-\u003Cversion>.exe --disable-gpu\n\n# Windows (Portable) — Command Prompt (cmd.exe), from the same folder\nArroxy-Portable-\u003Cversion>.exe --disable-gpu\n\n# Windows (Installed) — works in both PowerShell and cmd.exe\n\"%LOCALAPPDATA%\\Programs\\Arroxy\\Arroxy.exe\" --disable-gpu\n\n# macOS\n\u002FApplications\u002FArroxy.app\u002FContents\u002FMacOS\u002FArroxy --disable-gpu\n\n# Linux (AppImage)\n.\u002FArroxy-*.AppImage --disable-gpu\n```\n\nIf that works, the GPU\u002Fdriver is the cause. Make the change permanent (next step).\n\n**3. Persist the flag via `argv.json`.** Create the file at:\n\n| Platform | Path                                             |\n| -------- | ------------------------------------------------ |\n| Windows  | `%APPDATA%\\Arroxy\\argv.json`                     |\n| macOS    | `~\u002FLibrary\u002FApplication Support\u002FArroxy\u002Fargv.json` |\n| Linux    | `~\u002F.config\u002FArroxy\u002Fargv.json`                     |\n\nWith contents:\n\n```json\n{ \"disable-hardware-acceleration\": true }\n```\n\nArroxy reads this before opening any window, so it works even when the window never appeared.\n\n**4. Other flags worth trying** (combine if needed): `--disable-software-rasterizer`, `--disable-gpu-sandbox`, `--in-process-gpu`.\n\n**5. Stale window position.** If the window may be opening off-screen (multi-monitor change since last run), delete `\u003CuserData>\\window-state.json` and relaunch.\n\n**6. Still stuck?** Open an issue with: OS version, the contents of `main.log`, and any output from running with `--enable-logging --v=1`.\n\n---\n\n## Terms of use\n\nArroxy is a tool for personal, private use only. You are solely responsible for ensuring your downloads comply with YouTube's [Terms of Service](https:\u002F\u002Fwww.youtube.com\u002Ft\u002Fterms) and the copyright laws of your jurisdiction. Do not use Arroxy to download, reproduce, or distribute content you do not have the right to use. The developers are not liable for any misuse.\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=antonio-orionus%2FArroxy&type=timeline&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=antonio-orionus\u002FArroxy&type=timeline&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=antonio-orionus\u002FArroxy&type=timeline&legend=top-left\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=antonio-orionus\u002FArroxy&type=timeline&legend=top-left\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003Cdiv align=\"center\">\n  \u003Csub>MIT License · Made with care by \u003Ca href=\"https:\u002F\u002Fx.com\u002FOrionusAI\">@OrionusAI\u003C\u002Fa>\u003C\u002Fsub>\n\u003C\u002Fdiv>\n","Arroxy 是一款基于 yt-dlp 的免费开源跨平台下载工具，支持从 YouTube 和 2000 多个网站下载视频、短片、音乐、频道和字幕。其核心功能包括支持高达 4K HDR 60fps 的视频质量，以及 MP3、AAC 和 Opus 格式的音频下载，同时具备无广告、无追踪、无需登录的特点。该应用适用于 Windows、macOS 和 Linux 操作系统，并提供了简洁直观的图形用户界面。Arroxy 适合需要离线保存在线多媒体内容的个人用户或小型团队使用，尤其对于那些希望避免网页广告干扰并追求高质量媒体文件的人群而言是一个理想选择。",2,"2026-06-11 02:51:59","CREATED_QUERY"]